The voiage command-line interface exposes calculation, plotting, and configuration helpers for the core VOI workflows.
Representative commands:
- voiage calculate-evpi
- voiage calculate-evppi
- voiage calculate-evsi
- voiage calculate-enbs
- voiage calculate-structural-evpi
- voiage calculate-structural-evppi
- voiage calculate-perspective
- voiage calculate-distributional-equity
- voiage calculate-implementation
- voiage calculate-dynamic-real-options
- voiage plot-ceac
- voiage plot-ceaf
- voiage plot-voi-curves
- voiage plot-dominance
Sample inputs:
- examples/cli_example.py
- examples/evpi_validation.ipynb
- examples/evppi_validation.ipynb
- examples/evsi_validation.ipynb
- examples/cli_samples/evpi_net_benefit.csv
- examples/cli_samples/evppi_parameters.csv
- examples/cli_samples/evsi_trial_design.json
Common errors:
- Missing input files usually mean the CLI path arguments need to point at the repo-local examples or the generated CSV/JSON artifact.
- Invalid JSON input is rejected early by the CLI invariants tests.
- If a command reports a backend or approximation warning, the payload should include the method metadata and diagnostics fields described in specs/core-api/.
See also:
- docs/user_guide/features/cli.md
- CONTRIBUTING.md