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.