vyges-char — CLI reference
Generated from vyges-char --help. Do not edit by hand — run scripts/gen-cli-reference.sh.
vyges-char — standard-cell timing characterization (SPICE -> Liberty)
usage:
vyges-char run JOB [-o OUT] [--json] [--jobs N]
[--sparse RxC [--verify K]] | [--auto [--target PCT]]
characterize one cell. --sparse: simulate a
coarse RxC grid, surrogate-fill the rest.
--auto: self-tuning — keep sampling the
biggest gap until CV error <= target, fill.
--jobs: parallelize the per-point sweep.
vyges-char library MANIFEST [-o DIR] characterize many cells (parallel) -> merged .lib
vyges-char dataset [JOB] [-o OUT] [--format csv|jsonl] [--clean]
flatten characterization to a tidy
training table (no JOB = offline demo)
vyges-char surrogate [JOB] [--degree D] [--metric M] [--log] [--json]
fit a CPU surrogate on a grid subset,
report held-out error (no JOB = demo)
vyges-char check JOB
vyges-char demo [-o OUT] [--json]
flags:
-o FILE write output to FILE (default: stdout)
--json characterization summary as JSON instead of Liberty
--format FMT dataset format: csv (default) or jsonl
--clean dataset: drop flagged (non-physical, e.g. negative-delay) rows
--degree D surrogate polynomial degree per axis (default 2)
--metric M surrogate: restrict to one metric (e.g. cell_rise)
--log surrogate: fit in log-log space (NLDM grids are log-spaced)
--sparse RxC run: simulate only a coarse RxC grid, surrogate-fill the dense .lib
--verify K run --sparse: re-simulate K un-fitted points, report the real error
--jobs N run: parallelize the per-point ngspice sweep across N threads (N=auto: all cores)
--auto run: self-tuning active sampling to a target accuracy, then surrogate-fill
--target PCT run --auto: stop when LOO-CV error <= PCT% of peak (default 2.0)
--max-points N run --auto: cap simulated points (default: the full grid)
--seed RxC run --auto: initial seed grid (default 3x3)
-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-char --describe.
char
standard-cell timing characterization (SPICE -> Liberty)
Maturity: structured
run {job}
| Input | Type | Required | Description |
|---|---|---|---|
job | string | yes | path to the characterization job file (JOB) |
out | string | no | write output to FILE instead of stdout |
jobs | string | no | parallelize the per-point ngspice sweep across N threads (N or ‘auto’) |
sparse | string | no | simulate only a coarse RxC grid, surrogate-fill the dense .lib |
verify | string | no | with –sparse: re-simulate K un-fitted points, report the real error |
auto | boolean | no | self-tuning active sampling to a target accuracy, then surrogate-fill |
target | string | no | with –auto: stop when LOO-CV error <= PCT% of peak (default 2.0) |
max_points | string | no | with –auto: cap simulated points (default: the full grid) |
seed | string | no | with –auto: initial seed grid (default 3x3) |
degree | string | no | surrogate polynomial degree per axis, used with –sparse or –auto (default 2) |
Consumes: spice
Artifacts: liberty (out)
Assertion: characterization — none; this operation establishes no engineering claim
Provenance limitations
- The job names the SPICE decks; input_hash covers the job path and arguments, not their contents, and
.includechains are not followed.