Generator

Note

A generator with positive active power represents a voltage controlled generator. If you want to model constant generation without voltage control, use the Static Generator element.

Create Function

Input Parameters

net.gen

Parameter

Datatype

Value Range

Explanation

name

string

name of the generator

type

string

naming conventions:
“sync” - synchronous generator
“async” - asynchronous generator

type variable to classify generators

bus*

integer

index of connected bus

p_mw*

float

\(\leq\) 0

the real power of the generator [MW]

vm_pu*

float

voltage set point of the generator [p.u]

sn_mva

float

\(>\) 0

nominal power of the generator [MVA]

min_q_mvar

float

minimal reactive power of the generator [MVar]

max_q_mvar

float

maximal reactive power of the generator [MVar]

scaling*

float

\(\leq\) 0

scaling factor for the active power

max_p_mw**

float

Maximum active power

min_p_mw**

float

Minimum active power

max_q_mvar**

float

Maximum reactive power

min_q_mvar**

float

Minimum reactive power

vn_kv***

float

Rated voltage of the generator

xdss_pu***

float

\(>\) 0

Subtransient generator reactance in per unit

rdss_ohm***

float

\(>\) 0

Subtransient generator resistence in ohm

cos_phi***

float

\(0 \leq\) 1

Rated generator cosine phi

in_service*

boolean

True / False

specifies if the generator is in service

power_station_trafo*

integer

index of the power station trafo (short-circuit relevant).

*necessary for executing a power flow calculation
**optimal power flow parameter
***short-circuit calculation parameter

Electric Model

Generators are modelled as PV-nodes in the power flow:

alternate Text

Voltage magnitude and active power are defined by the input parameters in the generator table:

\begin{align*} P_{gen} &= p\_mw * scaling \\ v_{bus} &= vm\_pu \end{align*}

Result Parameters

net.res_gen

Parameter

Datatype

Explanation

p_mw

float

resulting active power demand after scaling [MW]

q_mvar

float

resulting reactive power demand after scaling [MVar]

va_degree

float

generator voltage angle [degree]

vm_pu

float

voltage at the generator [p.u]

The power flow returns reactive generator power and generator voltage angle:

\begin{align*} p\_mw &= P_{gen} \\ q\_mvar &= Q_{gen} \\ va\_degree &= \angle \underline{v}_{bus} \\ vm\_degree &= |\underline{v}_{bus}| \end{align*}

Note

If the power flow is run with the enforce_qlims option and the generator reactive power exceeds / underruns the maximum / minimum reactive power limit, the generator is converted to a static generator with the maximum / minimum reactive power as constant reactive power generation. The voltage at the generator bus is then no longer equal to the voltage set point defined in the parameter table.