Motor

Create Function

pandapower.create.create_motor(net, bus, pn_mech_mw, cos_phi, efficiency_percent=get_default_value('motor', 'efficiency_percent'), loading_percent=get_default_value('motor', 'loading_percent'), name=None, lrc_pu=nan, scaling=get_default_value('motor', 'scaling'), vn_kv=nan, rx=nan, index=None, in_service=get_default_value('motor', 'in_service'), cos_phi_n=nan, efficiency_n_percent=nan, **kwargs)

Adds a motor to the network.

Parameters:

net (pandapowerNet) – The net within this motor should be created
bus (int | integer) – The bus id to which the motor is connected
pn_mech_mw (float) – Mechanical rated power of the motor
cos_phi (float) – cosine phi at current operating point
name (str | None) – The name for this motor
efficiency_percent (float) – Efficiency in percent at current operating point
loading_percent (float) – The mechanical loading in percentage of the rated mechanical power
scaling (float) – scaling factor which for the active power of the motor
cos_phi_n (float) – cosine phi at rated power of the motor for short-circuit calculation
efficiency_n_percent (float) – Efficiency in percent at rated power for short-circuit calculation
lrc_pu (float) – locked rotor current in relation to the rated motor current
rx (float) – R/X ratio of the motor for short-circuit calculation.
vn_kv (float) – Rated voltage of the motor for short-circuit calculation
in_service (bool) – True for in_service or False for out of service
index (int | integer | None) – Force a specified ID if it is available. If None, the index one higher than the highest already existing index is selected.

Returns:

The ID of the created motor

Return type:

int | integer

Example

>>> create_motor(
>>>     net, 1, pn_mech_mw=0.120, cos_ph=0.9, vn_kv=0.6, efficiency_percent=90, loading_percent=40, lrc_pu=6.0
>>> )

Table Structure

net.motor

Parameter	Datatype	Value Range	Explanation	nullable	required	short circuit
name			name of the motor	✓
bus	int	>=0	index of connected bus		✓
pn_mech_mw	float	>=0	Mechanical rated power of the motor [MW]		✓
cos_phi	float	[0, 1]	cosine phi at current operating point		✓
cos_phi_n	float	[0, 1]	cosine phi at rated power of the motor for short-circuit calculation			✓
efficiency_percent	float	[0, 100]	Efficiency in percent at current operating point[%]		✓
efficiency_n_percent	float	[0, 100]	Efficiency in percent at rated power for short-circuit calculation [%]			✓
loading_percent	float	[0, 100]	The mechanical loading in percentage of the rated mechanical power		✓
scaling	float	>=0	scaling factor for active and reactive power		✓
lrc_pu	float	>=0	locked rotor current in relation to the rated motor current [pu]			✓
rx	float	>=0	R/X ratio of the motor for short-circuit calculation.			✓
vn_kv	float	>=0	Rated voltage of the motor for short-circuit calculation			✓
in_service	bool		specifies if the motor is in service.		✓

Electric Model

\[\begin{split}P_{motor, n} &= \frac{pn\_mech\_mw}{\mathit{efficiency}\_percent/100} \\ P_{motor} &= P_{motor, n} * (loading\_percent / 100) * scaling \\ S_{motor} &= \frac{P_{motor}}{cos\_phi} \\ Q_{motor} &= \sqrt{S_{motor}^2 - P_{motor}^2}\end{split}\]

Result Parameters

net.res_motor

Parameter	Datatype	Explanation	nullable	required
p_mw	float	resulting active power demand [MW]	✓	✓
q_mvar	float	resulting reactive power demand [MVar]	✓	✓

The power values in the net.res_motor table are equivalent to \(P_{motor}\) and \(Q_{motor}\).