Docs / Command Reference

Invocation patterns

python3 opentest --genus <command> [options]
python3 opentest --yosys <command> [options]

Use help for command-specific details:

python3 opentest --genus help
python3 opentest --yosys help

Genus mode commands

Command Purpose
parse Parse Verilog into intermediate netlist formats
convert Convert parsed text to JSON
dag Build DAG representation
cop Run COP metrics
scoap Run SCOAP metrics
auto-cop COP with integrated reconvergence flow
auto-scoap SCOAP with integrated reconvergence flow
tpi Insert test points from metrics
analyze_and_add_tp End-to-end analysis plus insertion
reconv / simple / advanced Reconvergence detection variants
compare Compare reconvergence algorithms
visualize Generate graph visualization
status Show current project status
help Show help text

Yosys mode commands

Command Purpose
cop COP on Yosys JSON
scoap SCOAP on Yosys JSON
analyze_and_add_tp Full Yosys-mode TPI pipeline
help Show help text

Common options

Option Meaning
-i, --input Input netlist or design file
-o, --output Output file name
-v, --verbose Detailed logs and reports
-j, --json Write JSON output where supported
-r Enable reconvergence support
-a, --algorithm Select reconvergence algorithm
-t, --threshold TPI threshold
-n or -m Max test points (mode-dependent command syntax)

Quick recipes

COP plus TPI in genus mode:

python3 opentest --genus cop -i designs/priority_enc.v -j
python3 opentest --genus tpi -i <netlist.json> -m <metrics.json> -t 50 -n 10

SCOAP plus TPI in yosys mode:

python3 opentest --yosys scoap -i <design.json>
python3 opentest --yosys analyze_and_add_tp -i <design.json> --scoap -t 50 -m 10