DynLoad#

Dynamic load group.

Common Parameters: u, name

Available models: ZIP, FLoad

ZIP#

ZIP load model (polynomial load). This model is initialized after power flow.

Please check the config of PQ to avoid double counting. If this ZIP model is in use, one should typically set p2p=1.0 and q2q=1.0 while leaving the others (p2i, p2z, q2i, q2z, and pq2z) as zeros. This setting allows one to impose the desired powers by the static PQ and to convert them based on the percentage specified in the ZIP.

The percentages for active power, (kpp, kpi, and kpz) must sum up to 100. Otherwise, initialization will fail. The same applies to the reactive power percentages.

Parameters#

Name

Symbol

Description

Default

Unit

Properties

idx

unique device idx

u

\(u\)

connection status

1

bool

name

device name

pq

idx of the PQ to replace

mandatory

kpp

\(K_{pp}\)

Percentage of active power

mandatory

kpi

\(K_{pi}\)

Percentage of active current

mandatory

kpz

\(K_{pz}\)

Percentage of conductance

mandatory

kqp

\(K_{qp}\)

Percentage of reactive power

mandatory

kqi

\(K_{qi}\)

Percentage of reactive current

mandatory

kqz

\(K_{qz}\)

Percentage of susceptance

mandatory

bus

retrieved bux idx

0

Variables#

Name

Symbol

Type

Description

Unit

Properties

a

\(\theta\)

ExtAlgeb

v

\(V\)

ExtAlgeb

Initialization Equations#

Name

Symbol

Type

Initial Value

a

\(\theta\)

ExtAlgeb

v

\(V\)

ExtAlgeb

Algebraic Equations#

Name

Symbol

Type

RHS of Equation "0 = g(x, y)"

a

\(\theta\)

ExtAlgeb

\(P_{i0} V + P_{p0} + P_{z0} V^{2}\)

v

\(V\)

ExtAlgeb

\(Q_{i0} V + Q_{p0} + Q_{z0} V^{2}\)

Services#

Name

Symbol

Equation

Type

kps

\(K_{psum}\)

\(K_{pi} + K_{pp} + K_{pz}\)

ConstService

kqs

\(K_{qsum}\)

\(K_{qi} + K_{qp} + K_{qz}\)

ConstService

rpp

\(r_{pp}\)

\(\frac{K_{pp} u}{100}\)

ConstService

rpi

\(r_{pi}\)

\(\frac{K_{pi} u}{100}\)

ConstService

rpz

\(r_{pz}\)

\(\frac{K_{pz} u}{100}\)

ConstService

rqp

\(r_{qp}\)

\(\frac{K_{qp} u}{100}\)

ConstService

rqi

\(r_{qi}\)

\(\frac{K_{qi} u}{100}\)

ConstService

rqz

\(r_{qz}\)

\(\frac{K_{qz} u}{100}\)

ConstService

pp0

\(P_{p0}\)

\(P_{0} r_{pp}\)

ConstService

pi0

\(P_{i0}\)

\(\frac{P_{0} r_{pi}}{V_{0}}\)

ConstService

pz0

\(P_{z0}\)

\(\frac{P_{0} r_{pz}}{V_{0}^{2}}\)

ConstService

qp0

\(Q_{p0}\)

\(Q_{0} r_{qp}\)

ConstService

qi0

\(Q_{i0}\)

\(\frac{Q_{0} r_{qi}}{V_{0}}\)

ConstService

qz0

\(Q_{z0}\)

\(\frac{Q_{0} r_{qz}}{V_{0}^{2}}\)

ConstService

Config Fields in [ZIP]

Option

Symbol

Value

Info

Accepted values

allow_adjust

1

allow adjusting upper or lower limits

(0, 1)

adjust_lower

0

adjust lower limit

(0, 1)

adjust_upper

1

adjust upper limit

(0, 1)

FLoad#

Voltage and frequency dependent load.

Parameters#

Name

Symbol

Description

Default

Unit

Properties

idx

unique device idx

u

\(u\)

connection status

1

bool

name

device name

pq

idx of the PQ to replace

mandatory

busf

optional idx of the BusFreq device to use

kp

active power percentage

100

%

kq

active power percentage

100

%

Tf

filter time constant

0.020

s

non_negative

ap

active power voltage exponent

1

aq

reactive power voltage exponent

0

bp

active power frequency exponent

0

bq

reactive power frequency exponent

0

bus

0

Variables#

Name

Symbol

Type

Description

Unit

Properties

f

\(f\)

ExtAlgeb

a

\(\theta\)

ExtAlgeb

v

\(V\)

ExtAlgeb

Initialization Equations#

Name

Symbol

Type

Initial Value

f

\(f\)

ExtAlgeb

a

\(\theta\)

ExtAlgeb

v

\(V\)

ExtAlgeb

Algebraic Equations#

Name

Symbol

Type

RHS of Equation "0 = g(x, y)"

f

\(f\)

ExtAlgeb

\(0\)

a

\(\theta\)

ExtAlgeb

\(V^{ap} f^{bp} pv_{0}\)

v

\(V\)

ExtAlgeb

\(V^{aq} f^{bq} qv_{0}\)

Services#

Name

Symbol

Equation

Type

pv0

\(pv0\)

\(\frac{P_{0} V_{0}^{- ap} kp u}{100}\)

ConstService

qv0

\(qv0\)

\(\frac{Q_{0} V_{0}^{- aq} kq u}{100}\)

ConstService

Config Fields in [FLoad]

Option

Symbol

Value

Info

Accepted values

allow_adjust

1

allow adjusting upper or lower limits

(0, 1)

adjust_lower

0

adjust lower limit

(0, 1)

adjust_upper

1

adjust upper limit

(0, 1)