Undefined#
The undefined group. Holds models with no group.
Common Parameters: u, name
Available models: TimeSeries, PLL1
TimeSeries#
Model for metadata of timeseries.
TimeSeries will not overwrite values in power flow.
Relative path is assumed in the same folder as the case file.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
mode |
Mode for applying timeseries. 1: exact time, 2: interpolated |
1 |
|||
path |
Path to timeseries xlsx file. |
mandatory |
|||
sheet |
Sheet name to use |
mandatory |
|||
fields |
comma-separated field names in timeseries data |
mandatory |
|||
tkey |
Key for timestamps |
t |
|||
model |
Model to link to |
mandatory |
|||
dev |
Idx of device to link to |
mandatory |
|||
dests |
comma-separated device fields as destinations |
mandatory |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
SW |
\(SW\) |
Switcher |
mode switcher |
Config Fields in [TimeSeries]
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) |
|
silent |
1 |
suppress output messages if is not zero |
(0, 1) |
PLL1#
Simple Phasor Lock Loop (PLL) using one PI controller.
Input bus angle signal -> Lag filter 1 with Tf -> PI Controller (Kp, Ki) -> Estimated angle (2 * pi * fn * PI_y) -> Lag filter 2 with Tp
The output signal is am.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
bus |
bus idx |
mandatory |
|||
Kp |
\(K_p\) |
proportional gain |
1 |
||
Ki |
\(K_i\) |
integral gain |
0.200 |
||
Tf |
\(T_f\) |
input digital filter time const |
0.050 |
sec |
|
Tp |
\(T_p\) |
output filter time const. |
0.050 |
sec |
|
fn |
\(f_n\) |
nominal frequency |
60 |
Hz |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
af_y |
\(y_{af}\) |
State |
State in lag transfer function |
v_str |
|
PI_xi |
\(xi_{PI}\) |
State |
Integrator output |
v_str |
|
ae |
\(\theta_{est}\) |
State |
PLL angle output before filter |
v_str |
|
am |
\(\theta_{PLL}\) |
State |
PLL output angle after filtering |
v_str |
|
PI_y |
\(y_{PI}\) |
Algeb |
PI output |
v_str |
|
a |
\(\theta\) |
ExtAlgeb |
Bus voltage angle |
Initialization Equations#
Name |
Symbol |
Type |
Initial Value |
|---|---|---|---|
af_y |
\(y_{af}\) |
State |
\(\theta\) |
PI_xi |
\(xi_{PI}\) |
State |
\(0.0\) |
ae |
\(\theta_{est}\) |
State |
\(\theta\) |
am |
\(\theta_{PLL}\) |
State |
\(\theta\) |
PI_y |
\(y_{PI}\) |
Algeb |
\(K_{p} u \left(- \theta_{PLL} + y_{af}\right)\) |
a |
\(\theta\) |
ExtAlgeb |
Differential Equations#
Name |
Symbol |
Type |
RHS of Equation "T x' = f(x, y)" |
T (LHS) |
|---|---|---|---|---|
af_y |
\(y_{af}\) |
State |
\(\theta - y_{af}\) |
\(T_f\) |
PI_xi |
\(xi_{PI}\) |
State |
\(K_{i} u \left(- \theta_{PLL} + y_{af}\right)\) |
|
ae |
\(\theta_{est}\) |
State |
\(2 \pi f_{n} y_{PI}\) |
|
am |
\(\theta_{PLL}\) |
State |
\(- \theta_{PLL} + \theta_{est}\) |
\(T_p\) |
Algebraic Equations#
Name |
Symbol |
Type |
RHS of Equation "0 = g(x, y)" |
|---|---|---|---|
PI_y |
\(y_{PI}\) |
Algeb |
\(K_{p} u \left(- \theta_{PLL} + y_{af}\right) + xi_{PI} - y_{PI}\) |
a |
\(\theta\) |
ExtAlgeb |
\(0\) |
Blocks#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
af |
\(af\) |
Lag |
input angle signal filter |
PI |
\(PI\) |
PIController |
PI controller |
Config Fields in [PLL1]
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) |