CLI Reference

GeoSC installs geosc and the compatibility alias geolift. Both dispatch to the same parser.

geosc {power,donors,infer,pipeline} --config PATH [shared options]

Shared options

Option Meaning
--config PATH Required YAML path. For pipeline, it is an anchor in a directory containing all three canonical configs.
--output-dir PATH Overrides a stage output directory, or the pipeline output root.
--jobs N Overrides n_jobs; for power and donors it also enables parallel execution.
--use-gpu Requests supported GPU work. It does not enable GPU inference.
--no-progress Disables progress displays.
--quiet Reduces non-critical terminal output; artefacts are still written.

Inference-only options

Option Meaning
--data PATH Overrides data_path.
--create-plots Forces plot generation.
--no-create-plots Disables plot generation.

Pipeline-only options

Option Meaning
--skip-power Omits the power stage.
--skip-donor Omits donor evaluation.
--only-inference Omits both design stages.
--report / --no-report Enables or disables compact Markdown and HTML reports. Reports are enabled by default.

Exit codes

0 means the requested stage completed under its software contract. 1 means a stage failed during validation or execution, including inference returning status: failed. 2 means argument parsing or initial CLI configuration resolution failed. An ok exit does not establish causal validity. See Errors and Exit Codes.