StaticACDC#

AC DC device for power flow

Common Parameters: u, name

Available models: VSCShunt

VSCShunt#

Data for VSC Shunt in power flow

Parameters#

Name

Symbol

Description

Default

Unit

Properties

idx

unique device idx

u

\(u\)

connection status

1

bool

name

device name

bus

idx of connected bus

mandatory

node1

Node 1 index

mandatory

node2

Node 2 index

mandatory

Vn

\(V_n\)

AC voltage rating

110

non_zero

Vdcn1

\(V_{dcn1}\)

DC voltage rating on node 1

100

kV

non_zero

Vdcn2

\(V_{dcn2}\)

DC voltage rating on node 2

100

kV

non_zero

Idcn

\(I_{dcn}\)

DC current rating

1

kA

non_zero

rsh

\(r_{sh}\)

AC interface resistance

0.003

ohm

z

xsh

\(x_{sh}\)

AC interface reactance

0.060

ohm

z

control

Control method: 0-PQ, 1-PV, 2-vQ or 3-vV

mandatory

v0

AC voltage setting (PV or vV) or initial guess (PQ or vQ)

1

p0

AC active power setting

0

pu

q0

AC reactive power setting

0

pu

vdc0

\(v_{dc0}\)

DC voltage setting

1

pu

k0

Loss coefficient - constant

0

k1

Loss coefficient - linear

0

k2

Loss coefficient - quadratic

0

droop

Enable dc voltage droop control

0

boolean

K

Droop coefficient

0

vhigh

Upper voltage threshold in droop control

9999

pu

vlow

Lower voltage threshold in droop control

0

pu

vshmax

Maximum ac interface voltage

1.100

pu

vshmin

Minimum ac interface voltage

0.900

pu

Ishmax

Maximum ac current

2

pu

Variables#

Name

Symbol

Type

Description

Unit

Properties

ash

\(\theta_{sh}\)

Algeb

voltage phase behind the transformer

rad

v_str

vsh

\(V_{sh}\)

Algeb

voltage magnitude behind transformer

p.u.

v_str

psh

\(P_{sh}\)

Algeb

active power injection into VSC

p.u.

v_str

qsh

\(Q_{sh}\)

Algeb

reactive power injection into VSC

v_str

pdc

\(P_{dc}\)

Algeb

DC power injection

v_str

a

\(a\)

ExtAlgeb

AC bus voltage phase

v

\(v\)

ExtAlgeb

AC bus voltage magnitude

v1

\(v_{1}\)

ExtAlgeb

DC node 1 voltage

v2

\(v_{2}\)

ExtAlgeb

DC node 2 voltage

Initialization Equations#

Name

Symbol

Type

Initial Value

ash

\(\theta_{sh}\)

Algeb

\(a\)

vsh

\(V_{sh}\)

Algeb

\(v_{0}\)

psh

\(P_{sh}\)

Algeb

\(p_{0} \left(s_{0}^{mode} + s_{1}^{mode}\right)\)

qsh

\(Q_{sh}\)

Algeb

\(q_{0} \left(s_{0}^{mode} + s_{2}^{mode}\right)\)

pdc

\(P_{dc}\)

Algeb

\(0\)

a

\(a\)

ExtAlgeb

v

\(v\)

ExtAlgeb

v1

\(v_{1}\)

ExtAlgeb

v2

\(v_{2}\)

ExtAlgeb

Algebraic Equations#

Name

Symbol

Type

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

ash

\(\theta_{sh}\)

Algeb

\(- P_{sh} + u \left(V_{sh} b_{sh} v \sin{\left(\theta_{sh} - a \right)} - V_{sh} g_{sh} v \cos{\left(\theta_{sh} - a \right)} + g_{sh} v^{2}\right)\)

vsh

\(V_{sh}\)

Algeb

\(- Q_{sh} + u \left(V_{sh} b_{sh} v \cos{\left(\theta_{sh} - a \right)} + V_{sh} g_{sh} v \sin{\left(\theta_{sh} - a \right)} - b_{sh} v^{2}\right)\)

psh

\(P_{sh}\)

Algeb

\(u \left(- P_{sh} + p_{0}\right) \left(s_{0}^{mode} + s_{1}^{mode}\right) + u \left(s_{2}^{mode} + s_{3}^{mode}\right) \left(v_{1} - v_{2} - v_{dc0}\right)\)

qsh

\(Q_{sh}\)

Algeb

\(u \left(- Q_{sh} + q_{0}\right) \left(s_{0}^{mode} + s_{2}^{mode}\right) + u \left(s_{1}^{mode} + s_{3}^{mode}\right) \left(- v + v_{0}\right)\)

pdc

\(P_{dc}\)

Algeb

\(P_{dc} + u \left(V_{sh}^{2} g_{sh} - V_{sh} b_{sh} v \sin{\left(\theta_{sh} - a \right)} - V_{sh} g_{sh} v \cos{\left(\theta_{sh} - a \right)}\right)\)

a

\(a\)

ExtAlgeb

\(- P_{sh}\)

v

\(v\)

ExtAlgeb

\(- Q_{sh}\)

v1

\(v_{1}\)

ExtAlgeb

\(- \frac{P_{dc}}{v_{1} - v_{2}}\)

v2

\(v_{2}\)

ExtAlgeb

\(\frac{P_{dc}}{v_{1} - v_{2}}\)

Services#

Name

Symbol

Equation

Type

gsh

\(g_{sh}\)

\(\frac{\operatorname{re}{\left(r_{sh}\right)} - \operatorname{im}{\left(x_{sh}\right)}}{\left(\operatorname{re}{\left(r_{sh}\right)} - \operatorname{im}{\left(x_{sh}\right)}\right)^{2} + \left(\operatorname{re}{\left(x_{sh}\right)} + \operatorname{im}{\left(r_{sh}\right)}\right)^{2}}\)

ConstService

bsh

\(b_{sh}\)

\(\frac{- \operatorname{re}{\left(x_{sh}\right)} - \operatorname{im}{\left(r_{sh}\right)}}{\left(\operatorname{re}{\left(r_{sh}\right)} - \operatorname{im}{\left(x_{sh}\right)}\right)^{2} + \left(\operatorname{re}{\left(x_{sh}\right)} + \operatorname{im}{\left(r_{sh}\right)}\right)^{2}}\)

ConstService

Discretes#

Name

Symbol

Type

Info

mode

\(mode\)

Switcher

Config Fields in [VSCShunt]

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)