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

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

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
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	TextRotation	No	NONE
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	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.
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	Guid('00000000-0000-0000-00...	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.
style	str	No	""
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	10	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.
icon_x	int	No	0	X offset relative to the object coordinates for the icon.
icon_y	int	No	0	Y offset relative to the object coordinates for the icon.
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	Guid('00000000-0000-0000-00...
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	Guid('00000000-0000-0000-00...
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

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)

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
cos_ref	float	No	0.0
inductive	bool	No	False
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

SymbolSegment

Segment of a branch route that gets the branch symbol and the middle text.

Member	Value	Description
MIDDLE	middle	The segment at the halfway point of the route.
LONGEST	longest	The longest segment, or the first of them on a tie.

TextRotation

Text rotation angles.

Member	Value	Description
NONE	0	No text rotation.
DEGREES_45	-1	Rotate the text 45° clockwise.
DEGREES_90	-2	Rotate the text 90° clockwise.
DEGREES_270	2	Rotate the text 270° clockwise.
DEGREES_315	1	Rotate the text 315° clockwise.

LineStyle

Line drawing styles for visual elements.

Member	Value	Description
SOLID	Solid
DASH	Dash
DOT	Dot
DASH_DOT	DashDot
DASH_DOT_DOT	DashDotDot

FrameShape

Frame shape types for container elements.

Member	Value	Description
RECTANGLE	Rectangle
POLYGON	Polygon
ELLIPSE	Ellipse
PICTURE	Picture

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.

Earthing

Neutral point earthing of an MV element.

Member	Value	Description
NONE	0	Neutral point is not earthed.
OWN	1	Neutral point is earthed through the element's own Re and Xe.
EXTERNAL	2	Neutral point is earthed through an external earthing node.

ThreewindingEarthing

Neutral point earthing of a three-winding transformer winding.

Member	Value	Description
NONE	0	Neutral point is not earthed.
OWN	1	Neutral point is earthed through the winding's own Re and Xe.

SpecialTransformerEarthing

Neutral point earthing of a special transformer.

Member	Value	Description
NONE	0	Neutral point is not earthed.
OWN	1	Neutral point is earthed through the transformer's own Re and Xe.

EnclosureType

Transformer enclosure type classification.

Determines the cooling conditions for thermal modeling.

Member	Value	Description
OUTSIDE	Outside
VAULT_NATURAL	VaultNat
BASEMENT_POOR_VENT	BasementPoor
VAULT_BASEMENT_FORCED	ForcedVent
KIOSK	Kiosk

InsulationCondition

Insulation condition classification for transformer paper.

Describes the paper insulation condition based on whether it was produced air-free, and its moisture content percentage.

Member	Value	Description
AIR_FREE_MOIST_0_5	Free0.5
AIR_FREE_MOIST_1_5	Free1.5
AIR_FREE_MOIST_3_5	Free3.5
WITH_AIR_MOIST_0_5	Air0.5

VoltageControlStatus

Operating status of the voltage control.

Member	Value	Description
OFF	0	Voltage control is off.
OWN	1	Voltage control operates on its own measurement.
MASTER	2	Voltage control acts as master.
MASTER_OWN	3	Voltage control acts as master with own standby

VoltageControlSort

Voltage control type for tap-changing transformers.

Member	Value	Description
COMPOUNDING	0	Compounding control - adjusts setpoint based on current flow.
LOAD1	1	Load-based control - adjusts voltage based on load conditions 1.
LOAD2	2	Load-based control - adjusts voltage based on load conditions 2.
LOAD3	3	Load-based control - adjusts voltage based on load conditions 3.
LOAD4	4	Load-based control - adjusts voltage based on load conditions 4.

SpecialVoltageControlStatus

Operating status of the special transformer voltage control.

Member	Value	Description
OFF	0	Voltage control is off.
ON	1	Voltage control is on.

SpecialVoltageControlSort

Voltage control type for special transformers.

Member	Value	Description
COMPOUNDING	0	Compounding control - adjusts setpoint based on current flow.
LOAD	1	Load-based control - adjusts voltage based on load conditions.

VnfVersion

VNF (Vision/MV) file format versions supported for saving.

Values correspond to version strings written to the first line of VNF files. Only versions with save modules in the migrator DLL are included.

Member	Value	Description
V9_7	V9.7
V9_8	V9.8
V9_9	V9.9
V9_10	V9.10
V9_11	V9.11
V9_12	V9.12