Data Provenance

The demo cases are synthetic grids from TAMU ACTIVSg and CATS. They are fictional networks built on geographic footprints. ACTIVSg200 and ACTIVSg500 coordinates come from PowerWorld aux exports. ACTIVSg7000 and CATS coordinates come from GIS bus CSVs. These positions are not surveyed infrastructure locations.

The MATPOWER file feeds the DC OPF. For ACTIVSg200 and ACTIVSg500, the aux file supplies the coordinates. For ACTIVSg7000, the bus coordinate CSV supplies latitude and longitude. Operators download the ACTIVSg distributions from electricgrids.engr.tamu.edu and stage them with scripts/stage-data.sh; the repository does not vendor them.

CATS comes from the WISPO POP CATS repository. The server reads CaliforniaTestSystem.m for the network, CATS_buses.csv for bus latitude and longitude, and CATS_lines.json for branch paths. The staging script also copies CATS_gens.csv when present; the current map does not render a separate generator geometry layer.

Aux coordinates

PowerWorld aux exports have used two coordinate layouts:

• ACTIVSg complete case exports repeat substation latitude and longitude on each bus row in Latitude:1 and Longitude:1.
• Later exports can leave the bus latitude and longitude columns empty and reference the Substation table through SubNumber.

PowerIO promotes the bus columns (Latitude:1/Longitude:1) into the typed Bus.location at parse; tellegen keeps the two fallbacks upstream does not cover — bare Latitude/Longitude bus columns and the Substation table join — so dropped files using either layout resolve when the data is present.

Buses Sharing Coordinates

Multiple buses can share one substation coordinate. tellegen spreads each group on a deterministic ring of about 400 m around the substation point, ordered by bus id. The group remains visually associated with the substation at network zoom, and individual buses remain hoverable at street zoom.

Explicit Fallback

The embedded fallback (deployment) serves two PGLib cases whose coordinates are synthetic and labeled as synthetic.

Prepared generator costs

The Texas7k demo selects Tellegen’s reusable convex quadratic/linear fitting option. It fits each piecewise curve by least squares and retains a linear fit when the quadratic fit is nonconvex or singular. Other demo cases keep their declared costs. Model details retain the source and prepared cost rows and report RMS and maximum errors at the source breakpoints.

All four configured cases must load and solve for the deployment health check to pass. Unavailable cases remain in the catalogue with an explanation.

Synthetic generation inputs

Generated grids read the Natural Earth populated places table shipped with tellegen-synth: 7342 places with name, position, pop_max and country. Bus anchors come from the most populous places in a region, and peak demand from their population. Generated buses are labelled with coordinate provenance synthetic. OpenStreetMap mode reads the Overpass answer the caller fetched and labels its buses source. Its electrical parameters and loads are modelled, so its buses and lines are mapped, not surveyed. See Synthetic Grid Generation.