AsynchronousMotorMV

Medium-voltage asynchronous motor with starting characteristics.

Supports induction motor analysis including DOL, soft starter, and converter starting methods with earthing configuration for balanced three-phase network studies.

Inherits from: ExtrasNotesMixin, HasPresentationsMixin

Import

from pyptp.elements.mv import AsynchronousMotorMV

Properties

Property	Type	Required	Default	Description
general	General	Yes	-
presentations	list[ElementPresentation]	Yes	-
type	AsynchronousMotorType	Yes	-
harmonics	HarmonicsType | None	No	None
extras	list[Extra]	No	[]
notes	list[Note]	No	[]

AsynchronousMotorType

Asynchronous motor type properties.

Property	Type	Required	Default	Description
unom	float	No	0.0
pnom	float	No	0.0
r_x	float	No	0.0
istart_inom	float	No	0.0
poles	int	No	0
cosnom	float	No	0.0	Power factor at nominal power (dimensionless).
efficiency	float	No	0.0
p2	float	No	0.0	Curve point 2: mechanical power in pu.
cos2	float	No	0.0	Curve point 2: power factor (dimensionless).
n2	float	No	0.0	Curve point 2: efficiency in %.
p3	float	No	0.0	Curve point 3: mechanical power in pu.
cos3	float	No	0.0	Curve point 3: power factor (dimensionless).
n3	float	No	0.0	Curve point 3: efficiency in %.
p4	float	No	0.0	Curve point 4: mechanical power in pu.
cos4	float	No	0.0	Curve point 4: power factor (dimensionless).
n4	float	No	0.0	Curve point 4: efficiency in %.
p5	float	No	0.0	Curve point 5: mechanical power in pu.
cos5	float	No	0.0	Curve point 5: power factor (dimensionless).
n5	float	No	0.0	Curve point 5: efficiency in %.
starting_torque	float	No	0.0	Locked rotor torque in %.
nom_speed	float	No	0.0	Nominal speed in rpm.
critical_speed	float	No	0.0	Critical speed in rpm.
critical_torque	float	No	0.0	Critical torque in %.
j	float	No	0.0	Inertia in kg⋅m².
k2	float	No	0.0	K-factor 2 in %.
k1	float	No	0.0	K-factor 1 in %.
k0	float	No	0.0	K-factor 0 in %.
double_cage	bool	No	False
own_parameters	bool	No	False
rs	float	No	0.0	Stator resistance in pu.
xsl	float	No	0.0	Stator leakage reactance in pu.
xm	float	No	0.0	Magnetizing reactance in pu.
rr	float	No	0.0	Rotor resistance in pu.
xrl	float	No	0.0	Rotor leakage reactance in pu.
rr2	float	No	0.0	Rotor resistance 2 (double cage) in pu.
xr2l	float	No	0.0	Rotor leakage reactance 2 (double cage) in pu.
mechanical_torque_speed_characteristic	bool	No	False
electrical_torque_speed_characteristic	bool	No	False
m1	list[float] | None	No	(factory)
m2	list[float] | None	No	(factory)
e1	list[float] | None	No	(factory)
e2	list[float] | None	No	(factory)

General

Core electrical and operational properties for MV asynchronous motors.

Encompasses connection node, mechanical power, starting method, earthing configuration, and reliability statistics.

Property	Type	Required	Default	Description
node	Guid	No	NIL_GUID
guid	Guid	No	(auto UUID)
creation_time	float	No	0.0
mutation_date	int	No	0
revision_date	int	No	0
variant	bool	No	False
name	str	No	""
switch_state	int	No	0
field_name	str	No	""	Name of the connection field.
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
number_of	int	No	0	Number of motors in parallel.
p_mechanic	float	No	0.0	Actual mechanical power per motor in MW.
earthing	bool	No	False
earthing_resistance	float	No	0.0
earthing_reactance	float	No	0.0
connection_type	int	No	0	Motor starter type: 0=DOL, 1=soft starter, 2=converter (VSDS).
cos_inverter	float	No	0.0	Power factor during motor start (dimensionless).
istart_inom	float	No	0.0
ta	float	No	0.0	Time constant parameter.
no_short_circuit_contribution	bool	No	False
profile	Guid	No	UUID(...)
type	str	No	""
harmonics_type	str	No	""

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)