Science Score: 57.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 2 DOI reference(s) in README
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (8.2%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: domhnallc
  • License: agpl-3.0
  • Language: Java
  • Default Branch: main
  • Size: 1.41 MB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 1
Created about 1 year ago · Last pushed 12 months ago
Metadata Files
Readme License Citation

README.md

Opcode Analyser

Copyright (C) Queen's University of Belfast 2015-2022. This file is subject to the terms and conditions defined in file 'LICENSE.md', which is part of this source code package.

Author: Domhnall Carlin
Email: D.Carlin at qub.ac.uk

About

This program takes a folder of runtrace files and parses them for instruction sets specified. It then writes out a CSV file of the count of each instruction in the trace, with one instruction per column and one runtrace per row. This is used for dynamic opcode analysis research at Queen's University Belfast. See https://doi.org/10.1109/ACCESS.2017.2749538 for further details.

Requirements

Working Java installation (JRE and SDK) above Java 8.

Usage

  1. Set opcodelist in Runner.java to whatever list of words you wish to count. The default is /<path>/<to>/<folder>/opcodeAnalyser/fullRawOpCodeList.txt, which is the x86-64 instruction set.
  2. Set file in Parser.java to the csv file you'd like to write out to. It will be created if it doesn't exist and be appended to if it does. The default is /<path>/<to>/<folder>/opcodeAnalyser/sample.csv.

If running from the commandline:

  1. Compile the Java source files javac /<path>/<to>/<folder>/opcodeAnalyser/src/opcodeAnalyser/*.java.
  2. Move to the /<path>/<to>/<folder>/opcodeAnalyser/src/ folder.
  3. Run java opcodeAnalyser.Runner.
  4. Enter the folder containing the file(s) to be parsed.
  5. The analyser will check the directory and all of the files are valid paths, then proceed to count all occurrences of the list specified in 1. in all files in 6. and write this one line at a time (following headers) to the CSV specified in 2.

Example

The sample folder contains a runtrace file. To run the example, follow the steps above (keeping defaults in steps 1 and 2).

Owner

  • Login: domhnallc
  • Kind: user

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Carlin"
  given-names: "Domhnall"
  orcid: "https://orcid.org/0000-0002-8424-2757"
title: "opcode_parser"
version: 0.1.0
doi: 10.5281/zenodo.15011233
date-released: 2025-03-12
url: "https://github.com/domhnallc/opcode_parser"

GitHub Events

Total
  • Release event: 2
  • Push event: 1
  • Create event: 4
Last Year
  • Release event: 2
  • Push event: 1
  • Create event: 4