TimedEvent#
Timed event group
Common Parameters: u, name
Available models: Toggler, Fault, Alter
Toggler#
Time-based connectivity status toggler.
Toggler is used to toggle the connection status of a device at a predefined time. Both the model name (or group name) and the device idx need to be provided.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
model |
model or group name of the device |
mandatory |
|||
dev |
idx of the device to control |
mandatory |
|||
t |
switch time for connection status |
-1 |
mandatory |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
_u |
\(_u\) |
\(1\) |
ConstService |
Config Fields in [Toggler]
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) |
Fault#
Three-phase to ground fault.
Two times, tf and tc, can be defined for fault on for fault clearance.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
bus |
linked bus idx |
mandatory |
|||
tf |
Bus fault start time |
-1 |
second |
mandatory |
|
tc |
Bus fault end time |
-1 |
second |
||
xf |
\(x_f\) |
Fault to ground impedance (positive) |
0.000 |
p.u.(sys) |
|
rf |
\(x_f\) |
Fault to ground resistance (positive) |
0 |
p.u.(sys) |
Variables#
Name |
Symbol |
Type |
Description |
Unit |
Properties |
|---|---|---|---|---|---|
a |
\(\theta\) |
ExtAlgeb |
Bus voltage angle |
p.u.(kV) |
|
v |
\(V\) |
ExtAlgeb |
Bus voltage magnitude |
p.u.(kV) |
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 |
\(V^{2} g_{f} u u_{f}\) |
v |
\(V\) |
ExtAlgeb |
\(- V^{2} b_{f} u u_{f}\) |
Services#
Name |
Symbol |
Equation |
Type |
|---|---|---|---|
gf |
\(g_{f}\) |
\(\frac{\operatorname{re}{\left(x_{f}\right)} - \operatorname{im}{\left(x_{f}\right)}}{\left(\operatorname{re}{\left(x_{f}\right)} - \operatorname{im}{\left(x_{f}\right)}\right)^{2} + \left(\operatorname{re}{\left(x_{f}\right)} + \operatorname{im}{\left(x_{f}\right)}\right)^{2}}\) |
ConstService |
bf |
\(b_{f}\) |
\(\frac{- \operatorname{re}{\left(x_{f}\right)} - \operatorname{im}{\left(x_{f}\right)}}{\left(\operatorname{re}{\left(x_{f}\right)} - \operatorname{im}{\left(x_{f}\right)}\right)^{2} + \left(\operatorname{re}{\left(x_{f}\right)} + \operatorname{im}{\left(x_{f}\right)}\right)^{2}}\) |
ConstService |
uf |
\(u_f\) |
\(0\) |
ConstService |
Config Fields in [Fault]
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) |
|
restore |
1 |
restore algebraic variables to pre-fault values |
(0, 1) |
|
mode |
1 |
1 - restore voltages on all buses, 2 - fault bus only |
(1, 2) |
|
scale |
1 |
scaling factor of restored algebraic values |
Alter#
Model for altering device internal data (service or param) at a given time.
Parameters#
Name |
Symbol |
Description |
Default |
Unit |
Properties |
|---|---|---|---|---|---|
idx |
unique device idx |
||||
u |
\(u\) |
connection status |
1 |
bool |
|
name |
device name |
||||
t |
switch time for connection status |
-1 |
mandatory |
||
model |
model or group name of the device |
mandatory |
|||
dev |
idx of the device to alter |
mandatory |
|||
src |
model source field (param or service) |
mandatory |
|||
attr |
attribute (e.g., v) of the source field |
v |
|||
method |
alteration method in +, -, *, /, = |
mandatory |
|||
amount |
the amount to apply |
mandatory |
|||
rand |
use uniform ramdom sampling |
0 |
|||
lb |
lower bound of random sampling |
0 |
|||
ub |
upper bound of random sampling |
0 |
Discretes#
Name |
Symbol |
Type |
Info |
|---|---|---|---|
SW |
\(SW\) |
Switcher |
Switcher for alteration method |
Config Fields in [Alter]
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) |