Module sub 

PSS/E subsystem description files (.sub).

A .sub file names the bus groups a contingency analysis works over. An automatic specification in a .con file and a monitored element statement in a .mon file both name a subsystem stated here.

SUBSYSTEM 'WOA'
   AREA 1
END
END

SubsystemSet::parse reads UTF-8 text and touches no filesystem. Statements outside the grammar keep their trimmed line and are reported, so a file a tool wrote for itself still reads. SubsystemSet::to_sub writes the set back in one canonical spelling. Subsystem::select_buses is the separate step that names the buses of a subsystem in a BalancedNetwork.

The grammar, its evidence, and the writer’s spellings are in FORMAT.md next to this file.

Structs

SelectorGroup

One group of selectors whose bus sets intersect across selector types.

Subsystem

One named subsystem: the union of its selector groups.

SubsystemParsed

Output of a tolerant subsystem read: the set plus the reader’s notes on statements it kept as text.

SubsystemSet

One subsystem description file.

Enums

JoinName

What a JOIN statement stated after the keyword.

SubsystemSelector

One bus selector. A statement naming a single value reads as a range whose from and to are equal; both ends are inclusive.