LV Shared Types

Shared types used across LV elements.

Mixins

Extra

Extra text annotation for electrical network elements.

Provides additional metadata or documentation that extends the core electrical properties of network elements.

Property	Type	Required	Default	Description
text	str	No	""

Note

A free-text annotation attached to a network element.

Notes are persisted as a single block of text with one note per line. As a result, a note containing line breaks is split into one note per line when the network is reloaded, which may change the number of notes in the list. To keep the list identical across a save and reload, limit each note to a single line.

Attributes: text: The note's text content.

Property	Type	Required	Default	Description
text	str	No	""

Geography

Geographical coordinate data for network elements.

Stores coordinate pairs for geographical positioning of elements in GNF/VNF network files. Used for mapping and GIS integration.

Property	Type	Required	Default	Description
coordinates	list[tuple]	No	[]

Presentations

NodePresentation

Presentation properties for a node on a specific sheet.

Property	Type	Required	Default	Description
sheet	Guid	No	Guid('00000000-0000-0000-00...
x	int	No	0
y	int	No	0
symbol	NodePresentationSymbol	No	CLOSED_CIRCLE	Visual symbol shape for node representation on diagrams.
color	DelphiColor	No	"$000000"
size	int	No	1
width	int	No	1	Thickness of the lines that draw the symbol.
text_color	DelphiColor	No	"$000000"	Color of the text.
text_size	int	No	10	Size of the text.
font	str	No	"Arial"
text_style	int	No	0
no_text	bool	No	False	Hides all text when True.
upside_down_text	bool	No	False	Makes text upside down when True.
text_rotation	int	No	0
upstrings_x	int	No	0
upstrings_y	int	No	0
fault_strings_x	int	No	0
fault_strings_y	int	No	0
note_x	int	No	0	X offset relative to the object coordinates for the note text.
note_y	int	No	0	Y offset relative to the object coordinates for the note text.

BranchPresentation

Presentation properties for a branch on a specific sheet.

Property	Type	Required	Default	Description
sheet	Guid	No	Guid('00000000-0000-0000-00...
color	DelphiColor	No	"$000000"
size	int	No	1
width	int	No	1	Thickness of the lines that draw the symbol.
text_color	DelphiColor	No	"$000000"	Color of the text.
text_size	int	No	10	Size of the text.
font	str	No	"Arial"
text_style	int	No	0
no_text	bool	No	False	Hides all text when True.
upside_down_text	bool	No	False	Makes text upside down when True.
strings1_x	int	No	0	X offset of the text relative to object.
strings1_y	int	No	0	Y offset of the text relative to object.
strings2_x	int	No	0
strings2_y	int	No	0
mid_strings_x	int	No	0
mid_strings_y	int	No	0
fault_strings_x	int	No	0
fault_strings_y	int	No	0
note_x	int	No	0	X offset relative to the object coordinates for the note text.
note_y	int	No	0	Y offset relative to the object coordinates for the note text.
flag_flipped1	bool	No	False
flag_flipped2	bool	No	False
first_corners	list[tuple]	No	[]
second_corners	list[tuple]	No	[]

ElementPresentation

Presentation properties for an element on a specific sheet.

Property	Type	Required	Default	Description
sheet	Guid	No	Guid('00000000-0000-0000-00...
x	int	No	0
y	int	No	0
color	DelphiColor	No	"$000000"
size	int	No	1
width	int	No	1	Thickness of the lines that draw the symbol.
text_color	DelphiColor	No	"$000000"	Color of the text.
text_size	int	No	10	Size of the text.
font	str	No	"Arial"
text_style	int	No	0
no_text	bool	No	False	Hides all text when True.
upside_down_text	bool	No	False	Makes text upside down when True.
strings1_x	int	No	0	X offset of the text relative to object.
strings1_y	int	No	0	Y offset of the text relative to object.
symbol_strings_x	int	No	0
symbol_strings_y	int	No	0
note_x	int	No	0	X offset relative to the object coordinates for the note text.
note_y	int	No	0	Y offset relative to the object coordinates for the note text.
flag_flipped	bool	No	False

SecundairPresentation

Presentation properties for a secondary on a specific sheet.

Property	Type	Required	Default	Description
sheet	Guid	No	Guid('00000000-0000-0000-00...
distance	int	No	0
otherside	bool	No	False
color	DelphiColor	No	"$000000"
size	int	No	1
width	int	No	1	Thickness of the lines that draw the symbol.
text_color	DelphiColor	No	"$000000"	Color of the text.
text_size	int	No	10	Size of the text.
font	str	No	"Arial"
text_style	int	No	0
no_text	bool	No	False	Hides all text when True.
upside_down_text	bool	No	False	Makes text upside down when True.
strings_x	int	No	0	X offset of the text relative to object.
strings_y	int	No	0	Y offset of the text relative to object.
note_x	int	No	0	X offset relative to the object coordinates for the note text.
note_y	int	No	0	Y offset relative to the object coordinates for the note text.

Shared Data Types

HarmonicsType

Shared Harmonics type for LV and MV elements.

Property	Type	Required	Default	Description
h	list[float] | None	No	(factory)
angle	list[float] | None	No	(factory)

Fields

Field information.

Property	Type	Required	Default	Description
values	list	Yes	(required)

CableType

Electrical and thermal characteristics for LV cable types.

Defines comprehensive cable parameters including impedance, current capacity, thermal limits, and frequency response for accurate asymmetrical load flow modeling.

Property	Type	Required	Default	Description
short_name	str	Yes	(required)
unom	float | int	No	0
price	float	No	0
C	float	No	0
C0	float	No	0
Inom0	float	No	0
G1	float	No	0
Inom1	float	No	0
G2	float	No	0
Inom2	float	No	0
G3	float	No	0
Inom3	float	No	0
Ik1s	float	No	0
TR	int	No	0
TInom	float	No	0
TIk1s	float	No	0
frequency	float	No	0
R_c	float	No	0
X_c	float	No	0
R_cc_n	float	No	0
X_cc_n	float	No	0
R_cc_o	float	No	0
X_cc_o	float	No	0
R_e	float	No	0
X_e	float	No	0
R_ce	float	No	0
X_ce	float	No	0
R_h	float	No	0
X_h	float	No	0
R_ch_n	float	No	0
X_ch_n	float	No	0
R_ch_o	float	No	0
X_ch_o	float	No	0
R_hh_n	float	No	0
X_hh_n	float	No	0
R_hh_o	float	No	0
X_hh_o	float	No	0
R_he	float	No	0
X_he	float	No	0
Inom_e	float	No	0
Ik1s_e	float	No	0
Inom_h	float	No	0
Ik1s_h	float	No	0
R_cR_n	float	No	1.0

FuseType

Electrotechnical properties of a fuse.

Property	Type	Required	Default	Description
short_name	str	No	""
unom	float	No	0
inom	float	No	0
I	list[float]	No	(factory)
T	list[float]	No	(factory)

CurrentType

Current type.

Property	Type	Required	Default	Description
short_name	str	No	""
inom	float | int	No	0
setting_sort	int	No	0
I	list[int] | None	No	(factory)
T	list[int] | None	No	(factory)
I_great	float | int | None	No	0
T_great	float | int | None	No	0
I_greater	float | int | None	No	0
T_greater	float | int | None	No	0
I_greatest	float | int | None	No	0
T_greatest	float | int | None	No	0
M	float | int | None	No	0
Id	float | int | None	No	0
alpha	float | int | None	No	0
beta	float | int | None	No	0
c	float | int | None	No	0
d	float | int | None	No	0
e	float | int | None	No	0
ilt	float | int | None	No	0
ist	float | int | None	No	0

Enums

NodePresentationSymbol

Node presentation symbol types for graphical network display.

Defines the visual symbol shapes used to represent nodes in electrical network diagrams within Gaia (LV) and Vision (MV) software. Integer values are non-sequential to maintain compatibility with the native file format encoding.

Symbol categories:

• 1-2: Line symbols
• 11-13: Circle variants
• 21-23: Square variants
• 31-32: Triangle variants
• 41-42: Diamond variants
• 51-53: Rectangle variants

The "open", "closed", and "half-open" terminology refers to whether the symbol is filled (closed), outlined only (open), or partially filled (half-open).

Member	Value	Description
VERTICAL_LINE	1
HORIZONTAL_LINE	2
CLOSED_CIRCLE	11
OPEN_CIRCLE	12
HALF_OPEN_CIRCLE	13
CLOSED_SQUARE	21
OPEN_SQUARE	22
HALF_OPEN_SQUARE	23
CLOSED_TRIANGLE	31
OPEN_TRIANGLE	32
CLOSED_DIAMOND	41
OPEN_DIAMOND	42
CLOSED_RECTANGLE	51
OPEN_RECTANGLE	52
HALF_OPEN_RECTANGLE	53

SpecialTransformerSort

Special transformer type classification.

Integer values are non-sequential to maintain compatibility with Vision/Gaia file formats. The groupings reflect functional categories:

• 0-4: Standard and autotransformer variants
• 11-14: Regulating transformers (booster, phase-shifting)
• 21, 31: Specialized types

Member	Value	Description
NONE	0	No special transformer type.
AUTO_YD11	1	Autotransformer with Yd11 vector group.
AUTO_YA0	2	Autotransformer with Ya0 vector group.
AUTO_YNA0	3	Autotransformer with YNa0 vector group (neutral accessible).
AUTO_YNA0_ASYM	4	Autotransformer with YNa0 vector group, asymmetric configuration.
BOOSTER	11	Booster transformer for voltage regulation.
QUADRATURE_BOOSTER	12	Quadrature booster (phase-shifting transformer).
SCOTT_RS	13	Scott transformer, RS configuration.
SCOTT_RT	14	Scott transformer, RT configuration.
AXA	21	Axa type transformer.
RELO	31	Relo type transformer.