MV Shared Types

Shared types used across MV 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

Free-text note annotation for electrical network elements.

Provides descriptive commentary or operational notes for electrical elements that aid in network understanding.

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 (MV).

Property	Type	Required	Default	Description
sheet	Guid	No	NIL_GUID
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
style	str	No	"Solid"
text_color	DelphiColor	No	"$000000"
text_size	int	No	10
font	str	No	"Arial"
text_style	int	No	0
is_text_hidden	bool	No	False
is_text_upside_down	bool	No	False
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
note_y	int	No	0
icon_x	int	No	0
icon_y	int	No	0

BranchPresentation

Presentation properties for a branch (object between two nodes) (MV).

Property	Type	Required	Default	Description
sheet	Guid	No	NIL_GUID
color	DelphiColor	No	"$000000"
size	int	No	1
width	int	No	1	Thickness of the lines that draw the symbol.
style	str	No	"Solid"
text_color	DelphiColor	No	"$000000"	Color of the text.
text_size	int	No	7	Size of the text.
font	str	No	"Arial"
text_style	int	No	1
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	X offset of the text relative to object.
strings2_y	int	No	0	Y offset of the text relative to object.
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 (object attached to a singular node) (MV).

Controls the visual appearance and positioning of MV network elements on the diagram, including colors, sizes, text formatting, and coordinate positioning on sheets.

Property	Type	Required	Default	Description
sheet	Guid	No	NIL_GUID	The sheet where the element is visible.
x	int	No	0	X coordinate on the sheet.
y	int	No	0	Y coordinate on the sheet.
color	DelphiColor	No	"$000000"	Color of the object.
size	int	No	1	Size of the object, scales it bigger.
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	7	Size of the text.
font	str	No	"Arial"	Font for the text by the object.
text_style	int	No	1	Text style (cursive, bold, etc.).
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	Flips the flag upside down if the switch is opened.

SecondaryPresentation

Presentation properties for a secundairy (modelled on top of a branch or element) (MV).

Property	Type	Required	Default	Description
sheet	Guid	No	NIL_GUID
distance	int	No	0
otherside	bool	No	False
color	DelphiColor	No	"$808080"
size	int	No	1
width	int	No	1
style	str	No	""
text_color	DelphiColor	No	"$000000"
text_size	int	No	10
font	str	No	"Arial"
text_style	int	No	1
no_text	bool	No	False
upside_down_text	bool	No	False
strings_x	int	No	0
strings_y	int	No	0
note_x	int	No	0
note_y	int	No	0

DWPresentation

Presentation properties for a three winding transformer (MV).

Property	Type	Required	Default	Description
sheet	Guid	No	NIL_GUID
color	DelphiColor	No	"$000000"
size	int	No	1
width	int	No	1
style	str	No	"Solid"
text_color	DelphiColor	No	"$000000"
text_size	int	No	7
font	str	No	"Arial"
text_style	int	No	1
no_text	bool	No	False
upside_down_text	bool	No	False
strings1_x	int	No	0
strings1_y	int	No	0
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
note_y	int	No	0
flag_flipped1	bool	No	False
flag_flipped2	bool	No	False
first_corners	list[tuple]	No	[]
second_corners	list[tuple]	No	[]
x	int	No	0
y	int	No	0
strings3_x	int	No	0
strings3_y	int	No	0
third_corners	list[tuple]	No	[]

Shared Data Types

CableType

Cable type.

Property	Type	Required	Default	Description
short_name	str	No	""
info	str	No	""
unom	float | int	No	0
price	float | int	No	0.0
r	float	No	0
x	float	No	0
c	float	No	0
c0	float	No	0
tan_delta	float	No	0
r0	float	No	0
x0	float	No	0
inom0	float	No	0
g1	int | float	No	0.0
inom1	int | float	No	0.0
g2	int | float	No	0.0
inom2	int | float	No	0.0
g3	int | float	No	0
inom3	int | float	No	0.0
ik1s	int | float	No	0.0
tr	int | float	No	0.0
TInom	int | float	No	0.0
TIk1s	int | float	No	0.0
frequency	int | float	No	0
pulse_velocity	int | float	No	0

FuseType

Fuse Type.

Property	Type	Required	Default	Description
short_name	str	No	""
unom	int | float	No	0
inom	int | float	No	0
I	list[int] | None	No	(factory)
T	list[int] | None	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

EfficiencyType

Efficiency characteristics for battery charging and discharging.

Defines efficiency curves as a function of input/output power levels. Used for both charging efficiency (as function of input power) and discharging efficiency (as function of output power) in battery systems. Supports up to 5 points to define the efficiency curve.

Property	Type	Required	Default	Description
input1	float	No	0.0
output1	float	No	0.0
input2	float	No	0.0
output2	float	No	0.0
input3	float	No	0.0
output3	float	No	0.0
input4	float	No	0.0
output4	float	No	0.0
input5	float	No	0.0
output5	float	No	0.0

Fields

Fields.

Property	Type	Required	Default	Description
values	list	Yes	(required)

PControl

Active power control for batteries and generators.

Supports three control modes:

• P(U): Voltage-dependent active power control for voltage regulation
• P(t): Time-based active power control with start/end times for scheduled operation
• P(I): Current-dependent active power control based on measured field current

The P(U) and P(I) controls override the generally specified P and profile values. The P(t) control overrides these values only when the time is known.

Property	Type	Required	Default	Description
sort	int	No	0
start_time1	float	No	0.0
end_time1	float	No	0.0
input1	float	No	0.0
output1	float	No	0.0
start_time2	float	No	0.0
end_time2	float	No	0.0
input2	float	No	0.0
output2	float	No	0.0
start_time3	float	No	0.0
end_time3	float	No	0.0
input3	float	No	0.0
output3	float	No	0.0
start_time4	float	No	0.0
end_time4	float	No	0.0
input4	float	No	0.0
output4	float	No	0.0
start_time5	float	No	0.0
end_time5	float	No	0.0
input5	float	No	0.0
output5	float	No	0.0
measure_field	str	No	""

QControl

Reactive power control for batteries and generators.

Provides Q(U) voltage-dependent reactive power control or constant cos phi control. The Q(U) control adjusts reactive power output based on voltage levels to support grid voltage regulation. Constant cos phi control maintains a fixed power factor.

Property	Type	Required	Default	Description
sort	int	No	0
cosref	float	No	0.0
no_p_no_q	bool	No	True
input1	float	No	1.0
output1	float	No	0.0
input2	float	No	0.0
output2	float	No	0.0
input3	float	No	0.0
output3	float	No	0.0
input4	float	No	0.0
output4	float	No	0.0
input5	float	No	0.0
output5	float	No	0.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.