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
  -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 ⭐