There is a newer version of the record available.

Published October 4, 2026 | Version v0.1.0

SCR-Screen: open-source short-circuit ratio screening for inverter-based resource interconnection (v0.1.0)

Authors/Creators

Description

[0.1.0] - 2026-10-04

First public release.

Screening

  • Short-circuit ratio (SCR) for single plants and weighted SCR (WSCR) for groups of plants assumed fully interacting (ERCOT/NERC formulation).
  • Rating basis in MW (default) or MVA.
  • Flags with user-configurable thresholds; defaults below 2 very weak, 2 to below 3 weak (HVDC planning practice, IEEE Std 1204-1997).
  • Largest plant each location can host before a weak flag (SCMVA ÷ weak threshold).

Short-circuit calculation (network mode)

  • Classical flat-start method (1.0 pu pre-fault, no correction factors), built on the network impedance matrix.
  • IEC 60909 method via pandapower (max and min cases).
  • Inverter-based resource contribution always excluded, as NERC's SCR definition requires.
  • Buses with no path to any source are skipped and listed, instead of stopping the scan.
  • Bus scan: SCR at every bus for a hypothetical plant size.

Your own network

  • Reads pandapower JSON (.json), pandapower Excel (.xlsx), and MATPOWER (.m, .mat).
  • scr-screen check lists missing short-circuit data and unsupported elements before scanning.
  • scr-screen convert turns any supported file into Excel or JSON, adding empty short-circuit columns to fill in.

Cost screening

  • Screening-level interconnection cost per candidate bus: synchronous condenser to reach a target SCR, gen-tie line, and POI substation. All costs are user inputs; network upgrades are excluded.
  • scr-screen sites-template creates the per-bus site cost file.
  • Target check: buses below the target SCR are listed in an alert, each with the largest plant that meets the target and the condenser alternative; "SCR after condenser" shown for every bus.

SCR-Screen Lite

  • Browser calculator for direct mode (SCR, WSCR, flags, largest plant, target check, condenser and cost), responsive and theme-safe for embedding in other websites. Published under docs/lite/.

Reports and interfaces

  • Self-contained HTML report (works offline; print to PDF from any browser): summary cards, network map from bus coordinates or an automatic layout, SCR chart, method comparison (classical vs IEC 60909), largest-plant chart, cost ranking, results tables, method notes, and disclaimer.
  • Interactive what-if inputs in scan reports: plant size slider, flag thresholds, target SCR, condenser parameters and costs, and per-bus gen-tie distance and POI cost, all recalculated instantly in the browser.
  • Animations that respect the reader's reduced-motion setting and are disabled when printing.
  • Command line: scr-screen example | template | run | scan | check | convert | sites-template, with --open to show the report when ready.
  • scr-screen example copies bundled example files (IEEE 39-bus network with assumed data, illustrative site costs, plant template) so a scan can be tried right after installing.
  • CSV and JSON results; Python API.

Documentation and verification

  • README, design specification, walkthrough notebook, IEEE 39-bus example with documented assumed short-circuit data.
  • Automated tests on Python 3.10 and 3.13 for every change, with hand-calculated expected values.
  • Verification record (docs/verification.md), including an independent hand check of IEEE 39-bus bus 12.

Files

ishaibu/scr-screen-v0.1.0.zip

Files (142.4 kB)

Name Size
md5:027860e75322bace48b8dd210e6d5da2
142.4 kB Preview Download

Additional details

Related works