cobre-bridge 0.10.0

Anything-to-Cobre converter

cobre-bridge

Convert power system data formats to Cobre input format.

Installation

# Recommended: isolated, on-PATH CLI
uv tool install cobre-bridge

# Alternative
pipx install cobre-bridge

# With cobre-python, so `convert --validate` can validate the output
uv tool install "cobre-bridge[validation]"

Requires Python >= 3.12.

Usage

Command	What it does
cobre-bridge convert newave <SRC> <DST>	Convert a NEWAVE case to Cobre input format.
cobre-bridge check newave <SRC>	Preflight-validate NEWAVE inputs (no conversion).
cobre-bridge compare newave <NEWAVE_DIR> <COBRE_DIR>	Compare simulation results against Cobre output.
cobre-bridge dashboard <CASE_DIR>	Build an interactive HTML dashboard from Cobre results.

Every command accepts --json (a single machine-readable verdict {schema_version, command, status, summary, diagnostics} on stdout) and -v/-vv, --log-file PATH, --no-color, --quiet. convert adds --validate, --force, --dry-run, --diagnostics-json PATH. dashboard adds --open. compare newave adds --tolerance, --format, --out-dir.

See docs/cli.md for the full per-command reference.

Cobre version. convert newave targets cobre 0.10.0. Every converted case requires cobre >= 0.10.0 — all system entities now carry an operational_start_date (introduced in cobre 0.10.0). NEWAVE NE (future, will-be-built) plants are converted via cobre's dead-volume filling schema. With cobre-python >= 0.10 installed, convert --validate validates the output; an older cobre-python that predates the schema is skipped gracefully.

Configuration

Defaults for compare newave tolerance, format, and out_dir can be set in a cobre-bridge.toml file (discovered from the working directory upward, then $XDG_CONFIG_HOME/cobre-bridge/config.toml, then ~/.config/cobre-bridge/config.toml) or via COBRE_BRIDGE_* environment variables (e.g. COBRE_BRIDGE_RESULTS_TOLERANCE, COBRE_BRIDGE_FORMAT, COBRE_BRIDGE_OUT_DIR). Precedence is flag > env > config file > default.

Shell completion

cobre-bridge --install-completion   # install for your shell
cobre-bridge --show-completion      # print the script

Development

pip install -e ".[dev]"
pytest
ruff check src/

License

Apache-2.0