Motor

Create Function

pandapower.create.create_motor(net, bus, pn_mech_mw, cos_phi, efficiency_percent=100.0, loading_percent=100.0, name=None, lrc_pu=nan, scaling=1.0, vn_kv=nan, rx=nan, index=None, in_service=True, 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
>>> )

Input Parameters

net.motor

Parameter

Datatype

Value Range

Explanation

name

string

name of the motor

bus *

integer

index of connected bus

pn_mech_mw*

float

\(\geq 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\)

Efficiency in percent at rated power for short-circuit calculation [%] [%]

scaling *

float

\(\geq 0\)

scaling factor for active and reactive power

lrc_pu *

float

\(\geq 0\)

locked rotor current in relation to the rated motor current [pu]

rx *

float

\(\geq 0\)

R/X ratio of the motor for short-circuit calculation.

vn_kv *

float

\(\geq 0\)

Rated voltage of the motor for short-circuit calculation

in_service*

boolean

True / False

specifies if the motor is in service.

*necessary for executing a power flow calculation.

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

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}\).