Case analysis#

analyze_case(case)#

Analyze a case without changing it.

Parameters:: case -- Case to analyze.
Returns:: Feature counts, voltage-control conflicts, and potential solve problems.

class CaseAnalysis(counts=<factory>, isolated_buses=<factory>, orphan_slack_buses=<factory>, control_model=None, device_origins=None, extreme_taps=<factory>, low_impedance_branches=<factory>, has_unsupported_facts_modes=False, has_blocked_vsc_dc_lines=False)#

Describe case features and conditions that need user review.

The result includes equipment counts, isolated areas, network data that can affect solution quality, unsupported records, and available customer repairs. Bus and equipment identifiers use the original case values.

property all_v_controllers#: Return all voltage-control claims.

property controllers_by_target#: Map each regulated bus to its local and remote controllers.

property conflicts#: Return buses that have multiple voltage controllers.

summary()#: Return a one-line feature summary.

issues_summary()#: Return descriptions of potential solve problems.

render_report(max_items=10)#: Return a multi-line diagnostic report.

class FeatureCounts(n_buses=0, n_isolated_buses=0, n_generators=0, n_generators_remote=0, n_generators_wind=0, n_loads=0, n_loads_zip=0, n_branches=0, n_transformers_2w=0, n_transformers_3w=0, n_tap_controls=0, n_phase_shift_controls=0, n_switched_shunts=0, n_switched_shunts_fixed=0, n_statcoms=0, n_upfcs=0, n_vsc_dc_lines=0, n_two_terminal_dc=0, n_two_terminal_dc_ccc=0)#

Count case features that affect power-flow construction.

Isolated buses use declared IDE=4 rather than connectivity. Remote generators regulate another bus. DC counts include in-service links and the unsupported capacitor-commutated subset.