ACShort#
Common Parameters: u, name, bus1, bus2
Common Variables: v1, v2, a1, a2
Available models: Jumper
Jumper#
Jumper is a device to short two buses (merging two buses into one).
Jumper can connect two buses satisfying one of the following conditions:
neither bus is voltage-controlled
either bus is voltage-controlled
both buses are voltage-controlled, and the voltages are the same.
If the buses are controlled in different voltages, power flow will not solve (as the power flow through the jumper will be infinite).
In the solutions, the p and q are flowing out of bus1
and flowing into bus2.
Setting a Jumper's connectivity status u to zero will disconnect the two
buses. In the case of a system split, one will need to call
System.connectivity() immediately following the split to detect islands.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
bus1 |
idx of from bus |
||||
bus2 |
idx of to bus |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
p |
\(p\) |
Algeb |
active power (1 to 2) |
||
q |
\(q\) |
Algeb |
active power (1 to 2) |
||
a1 |
\(a_{1}\) |
ExtAlgeb |
phase angle of the from bus |
||
a2 |
\(a_{2}\) |
ExtAlgeb |
phase angle of the to bus |
||
v1 |
\(v_{1}\) |
ExtAlgeb |
voltage magnitude of the from bus |
||
v2 |
\(v_{2}\) |
ExtAlgeb |
voltage magnitude of the to bus |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
p |
\(p\) |
Algeb |
|
q |
\(q\) |
Algeb |
|
a1 |
\(a_{1}\) |
ExtAlgeb |
|
a2 |
\(a_{2}\) |
ExtAlgeb |
|
v1 |
\(v_{1}\) |
ExtAlgeb |
|
v2 |
\(v_{2}\) |
ExtAlgeb |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
p |
\(p\) |
Algeb |
\(p \left(1 - u\right) + u \left(a_{1} - a_{2}\right)\) |
q |
\(q\) |
Algeb |
\(p \left(1 - u\right) + u \left(v_{1} - v_{2}\right)\) |
a1 |
\(a_{1}\) |
ExtAlgeb |
\(p\) |
a2 |
\(a_{2}\) |
ExtAlgeb |
\(- p\) |
v1 |
\(v_{1}\) |
ExtAlgeb |
\(q\) |
v2 |
\(v_{2}\) |
ExtAlgeb |
\(- q\) |
Config Fields in [Jumper]
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) |