SynchronousGeneratorMV

Medium-voltage synchronous generator with control mode modeling.

Supports distributed generation analysis with configurable P-f droop, Q-V droop, reactive power limits, and voltage control for balanced three-phase network studies.

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.mv import SynchronousGeneratorMV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
presentations	list[ElementPresentation]	Yes	-
type	SynchronousGeneratorType	Yes	-
harmonics_type	HarmonicsType	No	(factory)
pq_diagram	PQDiagram | None	No	None
restrictions	list[Restriction]	No	[]
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

General

Core electrical and operational properties for MV synchronous generators.

Encompasses connection node, power reference, control mode settings, reactive limits, earthing configuration, and reliability statistics.

Property	Type	Required	Default	Description
node	Guid	No	NIL_GUID
guid	Guid	No	(auto UUID)
creation_time	float | int	No	0
mutation_date	int	No	0
revision_date	float | int	No	0
variant	bool	No	False
name	str	No	""
switch_state	int	No	0
field_name	str	No	""
failure_frequency	float	No	0.0
repair_duration	float	No	0.0
maintenance_frequency	float	No	0.0
maintenance_duration	float	No	0.0
maintenance_cancel_duration	float	No	0.0
not_preferred	bool	No	False
pref	float | int	No	0
fp_droop	float | int	No	0
isochronous_control	bool	No	False
control_sort	str	No	"C"
q_ref	float | int	No	0
cos_ref	float	No	0.95
absorbs_q	bool	No	False
uref	float	No	1.0
uq_droop	float	No	1.0
q_limiting_type	int	No	1
control_node	Guid | NoneType	No	None
control_measure_field	Guid | NoneType	No	None
earthing	int	No	0
re	float | int	No	0
xe	float | int	No	0
earthing_node	Guid | NoneType	No	None
emergency_generator	bool	No	False
pnom	float | int	No	0
profile	Guid	No	UUID(...)
type	str	No	""

HarmonicsType

Harmonics properties.

Property	Type	Required	Default	Description
h2	float	No	0.0
h3	float	No	0.0
h4	float	No	0.0
h5	float	No	0.0
h6	float	No	0.0
h7	float	No	0.0
h8	float	No	0.0
h9	float	No	0.0
h10	float	No	0.0
h11	float	No	0.0
h12	float	No	0.0
h13	float	No	0.0
h14	float	No	0.0
h15	float	No	0.0
h16	float	No	0.0
h17	float	No	0.0
h18	float	No	0.0
h19	float	No	0.0
h20	float	No	0.0
h21	float	No	0.0
h22	float	No	0.0
h23	float	No	0.0
h24	float	No	0.0
h25	float	No	0.0
angle2	float	No	0.0
angle3	float	No	0.0
angle4	float	No	0.0
angle5	float	No	0.0
angle6	float	No	0.0
angle7	float	No	0.0
angle8	float	No	0.0
angle9	float	No	0.0
angle10	float	No	0.0
angle11	float	No	0.0
angle12	float	No	0.0
angle13	float	No	0.0
angle14	float	No	0.0
angle15	float	No	0.0
angle16	float	No	0.0
angle17	float	No	0.0
angle18	float	No	0.0
angle19	float	No	0.0
angle20	float	No	0.0
angle21	float	No	0.0
angle22	float	No	0.0
angle23	float	No	0.0
angle24	float	No	0.0
angle25	float	No	0.0

PQDiagram

Diagram.

Property	Type	Required	Default	Description
p_limit	list[float] | None	No	(factory)
q_limit	list[float] | None	No	(factory)

Restriction

Restriction.

Property	Type	Required	Default	Description
sort	str	No	""
begin_date	int	No	0
end_date	int	No	0
begin_time	float | int	No	0
end_time	float | int	No	0
p_max	float | int	No	0

SynchronousGeneratorType

Electrotechnical properties of a synchronous generator.

Property	Type	Required	Default	Description
unom	float | int	No	0
snom	float | int	No	0
cos_nom	float	No	0.95
qmin	float | int	No	0
qmax	float | int	No	0
rg	float | int	No	0
xd2sat	float	No	0.2
excitation_type	int	No	0
rotor	int	No	0
ikp	float | int	No	0
uf_max	float	No	1.3
xd_sat	float	No	1.6
Xl	float | int	No	0
Xd	float | int	No	0
Xq	float | int	No	0
X0	float | int	No	0
Xds	float | int	No	0
Xqs	float | int	No	0
Xdss	float | int	No	0
Xqss	float | int	No	0
open_circuit_time_constants	bool	No	False
Tds	float | int	No	0
Tqs	float | int	No	0
Tdss	float | int	No	0
Tqss	float | int	No	0
inertia	bool	No	False
h	float | int	No	0
J	float | int	No	0
KD	float | int	No	0
Nnom	float	No	3000.0
tdc	float | int	No	0
tdc_unknown	bool	No	False
ikd	float | int	No	0

Referenced Types

HarmonicsType

Shared Harmonics type for LV and MV elements.

Defined in pyptp.elements.lv.shared

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