vyges loom power — CLI reference

Generated from vyges loom power --help — this page is the tool’s own output, verbatim.

vyges loom power — gate-level power analysis (leakage + dynamic) with a CI gate

usage:
  vyges loom power run   JOB [-o OUT] [--json] [--fail-on-budget]
  vyges loom power check JOB
  vyges loom power demo       [-o OUT] [--json]

A JOB is a small declarative `.pwr` file (netlist + lib(s) + clock + activity).
With `vcd:` or `saif:` it uses measured per-net toggle rates; otherwise a
vectorless `activity:` factor × clock. With `emit_activity:` it writes the
per-instance map that vyges-em-ir consumes (closing char -> power -> em-ir).

With `activity_sweep: <from> <to> <window> [<step>]` (VCD only; `to` may be
`end`) the same run reports power over the workload — one row per window, from
a single parse of the dump — names the PEAK window, and hands em-ir the peak's
activity map rather than the dump average. `emit_power_vcd:` then writes that
curve as a copy of the dump, viewable beside the workload in any VCD viewer.

flags:
  -o FILE             write the report to FILE (default: stdout)
  --json              machine-readable JSON instead of the text report
  --fail-on-budget    exit 3 if total power exceeds the job's power_budget_mw
  -q, --quiet         suppress non-essential output
  -v, --verbose       extra detail on stderr
  --describe          print a machine-readable JSON description of the command
  -h, --help          show this help
  -V, --version       show version
  --bug-report        file a bug (central: vyges/community)
  --feature-request   request a feature (central)
  --sponsor           sponsor Vyges (github.com/sponsors/vyges-ip)
  --star              star this tool on GitHub ⭐

Contract

Generated from vyges loom power --describe.

power

gate-level power analysis (leakage + dynamic), per-group and over time, with a CI gate

Maturity: workflow-validated

run {job}

Consumes: netlist, liberty, vcd

Artifacts: power_report (out)

Assertion: power-analysis — none; this operation establishes no engineering claim

Provenance limitations

• The job names the netlist, Liberty and any VCD/SAIF activity; input_hash covers the job path and arguments, not their contents.