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 compare decomp <DECOMP_DIR> <COBRE_DIR>`	Compare a DECOMP run against its converted 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 and compare decomp add --tolerance, --format, --out-dir — with --format html both write a full multi-tab comparison report (Overview/cost, System, Energy Balance, Network, Convergence, Performance, plant detail, Productivity, FPHA; compare decomp adds REE, constraints, and evaporation sections).

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

Cobre version. convert newave targets cobre 0.14.1. Every converted case requires cobre >= 0.14.1 — this release adopts cobre 0.14's input-contract changes (sense-free generic constraints, constraints/generic_parameters.json, and the NCS availability_factor column), alongside the training.parallelism.backward_scheduler block (opening-block scheduler) and the operational_start_date all system entities carry. NEWAVE NE (future, will-be-built) plants are converted via cobre's dead-volume filling schema. With cobre-python >= 0.14.1 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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cobre_bridge-0.14.1.tar.gz (1.4 MB view details)

Uploaded Aug 18, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

cobre_bridge-0.14.1-py3-none-any.whl (788.2 kB view details)

Uploaded Aug 18, 2026 Python 3

File details

Details for the file cobre_bridge-0.14.1.tar.gz.

File metadata

Download URL: cobre_bridge-0.14.1.tar.gz
Upload date: Aug 18, 2026
Size: 1.4 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for cobre_bridge-0.14.1.tar.gz
Algorithm	Hash digest
SHA256	`060a9be7901b5b05a2c64eb5f473ab689f3140241c77074efd60ce3a9aa69d47`
MD5	`981d2b517fc88e6901a9aa537323c1f9`
BLAKE2b-256	`41d199f9c447bd5a6b8abc735c5fe94786a16c94bf8a0781bbecadf4effd8170`

See more details on using hashes here.

Provenance

The following attestation bundles were made for cobre_bridge-0.14.1.tar.gz:

Publisher: release.yml on cobre-rs/cobre-bridge

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: cobre_bridge-0.14.1.tar.gz
- Subject digest: 060a9be7901b5b05a2c64eb5f473ab689f3140241c77074efd60ce3a9aa69d47
- Sigstore transparency entry: 2502357178
- Sigstore integration time: Aug 18, 2026
Source repository:
- Permalink: cobre-rs/cobre-bridge@8fc760c3d93a2ce791db04bf05908cb0eda882a6
- Branch / Tag: refs/tags/v0.14.1
- Owner: https://github.com/cobre-rs
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@8fc760c3d93a2ce791db04bf05908cb0eda882a6
- Trigger Event: push