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.
See also
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:
Voltage magnitude and active power are defined by the input parameters in the generator table:
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:
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.