Unit System and ConventionsΒΆ

Naming Conventions

Parameters are always named in the form of <parameter>_<unit>,

However, for three phase load flow the notation is like <parameter>_<phase>_<unit>:

 Parameter read as vm_pu $$v_m [pu]$$ vm_a_pu $$v_m (A) [pu]$$ loading_percent $$loading [\%]$$ pl_mw $$p_l [mw]$$ pl_a_mw $$p_l(A) [mw]$$ r_ohm_per_km $$r [\Omega / km]$$ r0_ohm_per_km $$r_0 [\Omega / km]$$

Constraint parameters are always named with max or min as the prefix to the variable which is constrained, for example:

 Parameter read as min_vm_pu $$v_m^{min} [pu]$$ max_loading_percent $$loading^{max} [\%]$$ max_p_mw $$p^{max} [mw]$$ min_q_mvar $$q^{min} [mvar]$$

It is advised to keep consistent with these naming conventions when extending the framework and introducing new parameters.

Three Phase System (Balanced Load Flow)

For balanced three phase systems, the following conventions apply:

• voltage values are given as phase-to-phase voltages
• current values are given as phase currents
• power values are given as aggregated three-phase power

So for balanced system, three-phase power is three times the single phase power i.e. :

$$S = 3 \cdot V_{ph-e} \cdot I_{ph-e}$$

Assuming Wye connected loads, phase-to-earth voltage $$v_{ph-e} = \frac{V_{ph-ph}}{\sqrt3}$$

The power equation in the balanced three phase system is therefore given as $$S = \sqrt3 \cdot V_{ph-ph} \cdot I_{ph-ph}$$.

Three Phase System (Unbalanced Load Flow)

For unbalanced three phase systems, the following conventions apply:
• voltage values are entered as phase-to-phase voltages
• current values are entered as phase currents
• But, Phase power values can be entered seperately in the new element asymmetric_load

The power equation in each phase is therefore given as $$S_{ph-e} = \frac{V_{ph-ph} \cdot I_{ph-ph}}{\sqrt3 }$$.

Note

• Even though voltage values are fed as phase-phase voltage for simplicity, internally its converted to phase-earth for calculation.
• So, if you want to take out actual voltage values from p.u values , you need to divide base_kv value by $$\sqrt3$$ :

$$v_{an} = \frac{V_{ab}}{\sqrt3}$$

• All power values are given in MW / MVA / MVar except the iron losses of transformers which are given in kW (pfe_kw).

Per Unit System

Bus voltages are given in the per unit system. The per unit values are relative to the phase-to-phase voltages defined in net.bus.vn_kv for each bus.

The rated apparent power for the per unit system can be defined with the net.sn_mva parameter when creating an empty network. The default value is $$S_{N} = 1 MVA$$. The value should not be relevant in most applications since all power values are given in physical units.

Signing System

There are three elements that have power values based on the generator viewpoint (positive active power means power generation), which are:
• gen
• sgen
• ext_grid
For all other bus elements the signing is based on the consumer viewpoint (positive active power means power consumption):
• bus
The frequency can be defined when creating an empty network. The frequency is only used to calculate the shunt admittance of lines, since the line reactance is given directly in ohm per kilometer. The frequency is also relevant when calculating the peak factor $$\kappa$$ in the short circuit calculation.