NodeMV

Network node representing a rail or busbar.

Nodes define electrical connection points with nominal voltage and simultaneity factors applied to connected loads. Optional rail properties support short-circuit analysis (dynamic/thermal current limits).

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.mv import NodeMV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
presentations	list[NodePresentation]	Yes	-
railtype	Railtype	No	(factory)
fields	list[Field] | None	No	None
customer	Customer | None	No	None
installation	Installation	No	(factory)
icon	Icon | None	No	None
differential_protection	DifferentialProtection | None	No	None
differential_protection_switches	list[DifferentialProtectionSwitch]	No	[]
differential_protection_transfer_trip_switch	DifferentialProtectionTransferTripSwitch | None	No	None
geo_area	list[Geography]	No	[]
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

Customer

Informational customer data associated with the node.

Property	Type	Required	Default	Description
ean	str	No	""
name	str	No	""
address	str	No	""
postal_code	str	No	""
city	str	No	""
physical_network_area	str	No	""
connection_capacity	float	No	0.0
contracted_power	float	No	0.0
contracted_power_returned	float	No	0.0
contract	str	No	""

DifferentialProtection

Rail differential protection settings.

When tripped, all involved circuit breakers switch off. The sum of currents through the protected zone must be zero during normal operation (no direction or ratio correction applied).

Property	Type	Required	Default	Description
present	bool	No	False
type_name	str	No	""
t_input	float	No	0.0
t_output	float	No	0.0
setting_sort	int	No	0
dIg	float	No	0.0
tg	float	No	0.0
dIgg	float	No	0.0
tgg	float	No	0.0
m	float	No	0.0
dId	float	No	0.0
k1	float	No	0.0
k2	float	No	0.0

DifferentialProtectionSwitch

Circuit breaker involved in the rail differential protection.

Property	Type	Required	Default	Description
switch	Guid	No	Guid('00000000-0000-0000-00...

DifferentialProtectionTransferTripSwitch

Transfer trip circuit breaker for the rail differential protection.

Property	Type	Required	Default	Description
transfer_circuit_breaker	Guid	No	Guid('00000000-0000-0000-00...

Field

Feeder bay on the rail structure.

Fields represent physical feeder positions. The order should match the real arrangement on the busbar. Includes optional arc flash calculation parameters.

Property	Type	Required	Default	Description
name	str	No	""
sort	str	No	""
installation_type	int	No	0
conductor_distance	int | float	No	0
electrode_configuration	int	No	0
enclosed_height	float	No	0.0
enclosed_width	float	No	0.0
enclosed_depth	float	No	0.0
to	str	No	""
info	str	No	""

General

Core node identification, electrical parameters, and reliability data.

Key fields:

• unom: Nominal voltage (kV)
• simultaneity_factor: Multiplier for connected load P and Q in calculations
• gx, gy: Geographical coordinates (degrees)
• earthing, re, xe: External neutral point grounding impedance

Property	Type	Required	Default	Description
guid	Guid	No	(auto UUID)
creation_time	float | int	No	0
mutation_date	int	No	0
revision_date	float | int	No	0.0
variant	bool	No	False
name	str	No	""
short_name	str	No	""
id	str	No	""
unom	float | int	No	0.4
simultaneity_factor	float	No	1.0
function	str	No	""
railtype	str	No	""
failure_frequency	float	No	0.0
repair_duration	float	No	0.0
maintenace_frequency	float	No	0.0
maintenace_duration	float	No	0.0
maintenace_cancel_duration	float	No	0.0
remote_status_indication	bool	No	False
gx	float | int	No	0
gy	float | int	No	0
badly_accessible	bool	No	False
ripple_control_frequency	float | int	No	0
ripple_control_voltage	float | int	No	0
ripple_control_angle	float | int	No	0
earthing	bool	No	False
re	float	No	0.0
xe	float	No	0.0
no_voltage_check	int	No	0
umin	float	No	0.0
umax	float	No	0.0
d_umax	float	No	0.0
loadrate_max	float	No	0.0
loadrate_maxmax	float	No	0.0

Icon

Optional icon displayed near the node in diagrams.

A short text in a shaped background (configurable color, shape, size).

Property	Type	Required	Default	Description
text	str	No	""
text_color	DelphiColor	No	"$000000"
background_color	DelphiColor	No	"$000000"
shape	int	No	0
size	int	No	0

Installation

Installation data for arc flash calculation.

Includes earthing configuration, conductor/working distances, enclosure dimensions, and electrode configuration.

Property	Type	Required	Default	Description
type	int	No	0
earthed	bool	No	False
conductor_distance	float	No	0.0
person_distance	float	No	0.0
enclosed	bool	No	False
kb	float	No	0.5
kp	float	No	0.0
kp_max	bool	No	True
kp_auto	bool	No	True
kt	float	No	1.0
electrode_configuration	int	No	0
enclosed_height	float	No	0.0
enclosed_width	float	No	0.0
enclosed_depth	float	No	0.0
light_arc_protection	bool	No	False

Railtype

Busbar type and short-circuit current limits.

Rated values (unom, inom) are informational. Short-circuit limits are used for validation: ik_dynamic for mechanical stress (peak current Ip), ik_thermal for thermal stress (Ik"), with t_thermal as the rated duration.

Property	Type	Required	Default	Description
name	str	No	""
unom	float	No	0.0
inom	float	No	0.0
ik_dynamic	float	No	0.0
ik_thermal	float	No	0.0
t_thermal	float	No	0.0