NetworkLV

Low-voltage network model supporting unbalanced analysis.

Import

from pyptp import NetworkLV

Quick Start

# Load from file
network = NetworkLV.from_file("input.gnf")

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

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

Properties

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

• properties: PropertiesLV

Element Collections

The network stores elements in typed collections:

Dict Collections

Elements indexed by key (typically GUID):

Collection	Key Type	Element Type
frames	Guid	FrameLV
texts	Guid	TextLV
profiles	Guid	ProfileLV
gmtypes	int	GMTypeLV
sheets	Guid	SheetLV
nodes	Guid	NodeLV
cables	Guid	CableLV
links	Guid	LinkLV
homes	Guid	ConnectionLV
legends	Guid	LegendLV
sources	Guid	SourceLV
fuses	Guid	FuseLV
transformers	Guid	TransformerLV
special_transformers	Guid	SpecialTransformerLV
reactance_coils	Guid	ReactanceCoilLV
syn_generators	Guid	SynchronousGeneratorLV
async_generators	Guid	AsynchronousGeneratorLV
async_motors	Guid	AsynchronousMotorLV
earthing_transformers	Guid	EarthingTransformerLV
shunt_capacitors	Guid	ShuntCapacitorLV
batteries	Guid	BatteryLV
loads	Guid	LoadLV
circuit_breakers	Guid	CircuitBreakerLV
pvs	Guid	PVLV
load_switches	Guid	LoadSwitchLV
measure_fields	Guid	MeasureFieldLV

List Collections

Elements stored in ordered lists:

Collection	Element Type
comments	CommentLV
hyperlinks	HyperlinkLV
profile_files	ProfileFileLV
measurement_files	MeasurementFileLV
selections	SelectionLV

Methods

Class Methods

Method	Description
from_file(path: str | Path, *, native_check: bool = True) -> NetworkLV	Create LV network from GNF file.

Instance Methods

Method	Description
add(element) -> element	Register an element in this network and return it.
delete_transformer(guid: str) -> bool	Remove transformer from network by GUID string.
get_cable_guid_by_name(name: str) -> str	Find cable GUID by name.
get_link(guid: Guid) -> LinkLV | None	Find link by GUID.
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.
get_transformer(guid: str) -> TransformerLV | None	Find transformer by GUID string.
save(path: str | Path, version: GnfVersion = <GnfVersion.G8_12: G8.12>, *, validate_on_migration_failure: bool = True, native_check: bool = True) -> None	Save network to GNF file.

Adding Elements

add() registers an element and returns it, so you can create and keep it in one line:

node = network.add(NodeLV(NodeLV.General(name="Kerkstraat 1")))

A connection refers to its GM type by number, which add() fills in when you register a GM type:

from pyptp.type_reader import Types

household = network.add(Types().get_lv_gm_type("sjv2500")).general.number
connection = ConnectionLV(..., gms=[ConnectionLV.GM(gm_type_number=household)])

A GM type with number 0 gets the number after the highest one in use. A number that is already in use raises ValueError. Loading a file follows the same rules: two GM types with one number raise ValueError.