Expansion

expand_case(case)

Expand case features to solver-compatible primitives.

Currently expands:

• 3W transformers -> star bus + 3 x 2W transformers

• Bakes impedance-correction (ICT) factors into the 3W star leg impedances. The created 2W records carry tab1=0 because the correction is already applied.

Returns:

Expanded case and tracking metadata.

Return type:

(expanded_case, metadata)

class ExpansionMetadata(transformers_3w=<factory>)

Bases: object

Metadata tracking all expansions applied to a case.

Used to map virtual-bus results back to the original 3W transformer.

property n_virtual_buses

Number of virtual buses created.

property virtual_buses

All virtual bus numbers created during expansion.

class Transformer3WMetadata(original_buses, virtual_bus, ckt, winding_ckt_ids)

Bases: object

Metadata for a single 3W transformer expansion.

gpf.VIRTUAL_BUS_BASE: int