NetworkMV

Medium-voltage network model supporting symmetrical analysis.

Manages electrical elements in GUID-indexed collections for efficient access and supports balanced three-phase power system modeling using sequence components.

Import

from pyptp import NetworkMV

Quick Start

# Load from file
network = NetworkMV.from_file("input.vnf")

# Access elements
for node in network.nodes.values():
    print(node.general.name)

# Save to file
network.save("output.vnf")

Properties

The network's global properties are stored in the properties attribute:

• properties: PropertiesMV

Element Collections

The network stores elements in typed collections:

Dict Collections

Elements indexed by key (typically GUID):

Collection	Key Type	Element Type
asynchronous_generators	Guid	AsynchronousGeneratorMV
asynchronous_motors	Guid	AsynchronousMotorMV
batteries	Guid	BatteryMV
cables	Guid	CableMV
circuit_breakers	Guid	CircuitBreakerMV
earthing_transformers	Guid	EarthingTransformerMV
frames	Guid	FrameMV
fuses	Guid	FuseMV
growths	Guid	GrowthMV
indicators	Guid	IndicatorMV
legends	Guid	LegendMV
lines	Guid	LineMV
links	Guid	LinkMV
load_behaviours	Guid	LoadBehaviourMV
load_switches	Guid	LoadSwitchMV
loads	Guid	LoadMV
measure_fields	Guid	MeasureFieldMV
mutuals	str	MutualMV
nodes	Guid	NodeMV
profiles	Guid	ProfileMV
pvs	Guid	PVMV
rail_systems	Guid	RailSystemMV
reactance_coils	Guid	ReactanceCoilMV
scenarios	str	ScenarioMV
sheets	Guid	SheetMV
shunt_capacitors	Guid	ShuntCapacitorMV
shunt_coils	Guid	ShuntCoilMV
sources	Guid	SourceMV
special_transformers	Guid	SpecialTransformerMV
synchronous_generators	Guid	SynchronousGeneratorMV
synchronous_motors	Guid	SynchronousMotorMV
texts	Guid	TextMV
threewinding_transformers	Guid	ThreewindingTransformerMV
transformer_loads	Guid	TransformerLoadMV
transformers	Guid	TransformerMV
variants	str	VariantMV
windturbines	Guid	WindTurbineMV

List Collections

Elements stored in ordered lists:

Collection	Element Type
calc_cases	CalculationCaseMV
comments	CommentMV
hyperlinks	HyperlinkMV
selections	SelectionMV
variables	VariableMV

Methods

Class Methods

Method	Description
from_file(path: str | Path) -> NetworkMV	Create MV network from VNF file.

Instance Methods

Method	Description
get_cable_guid_by_name(name: str) -> str	Find cable GUID by name.
get_node_guid_by_name(name: str) -> str	Find node GUID by name.
get_sheet_guid_by_name(name: str) -> str	Find sheet GUID by name.
save(path: str | Path) -> None	Save network to VNF file.