| Table of Contents | ||
|---|---|---|
|
Currently the following RAW file data sections are supported by ePHASORSIM:
...
| color | #D3D3D3 |
|---|
...
Note
Not all data items for each record are read and there are restrictions on some. This section presents the data items for each record which are read from the RAW file along with the range of acceptable values.
...
| color | #D3D3D3 |
|---|
...
Notes
Thepower system’s base power and nominal frequency are read from the RAW file.
Buses with type 4 will not be imported.
From version 2020.2; in all the supported sections in the RAW file, all the components with Status 0 or 1 are imported to be presented in the Solver. Note that in the previous versions only components with Status=1 were being imported, except for Generator Data. This new functionality provides the flexibility to the user to change the Status of out-of-service components during real-time simulation. However, be advised this can have an impact on run-time performance and memory usage for large-scale systems if there exist several components with Status=0 in the RAW file whose Status is not going to change during the simulation. For these cases, it is recommended to remove them from the RAW file.
In the case of incorporating FMUs, the initial status of the corresponding component in the RAW file must be '1', otherwise, the data will not be imported.
Bus Data
The table below shows the list of required fields and their acceptable values imported from Bus data section of the RAW file.
Entry | Description | Acceptable values |
|---|---|---|
I | Bus Number | 1-999999 |
‘NAME’ | Bus Identifier | Any alpha-numerical string with up to 12 characters |
BASEKV | Bus base voltage | Any value |
IDE | Bus type code (only for power-flow study) | 1, 2, or 3 |
VM | Bus voltage magnitude (p.u.) | Any value |
VA | Bus voltage phase angle (degree) |
Load Data
The table below shows the list of required fields and their acceptable values imported from Load data section of the RAW file.
Entry | Description | Acceptable values |
|---|---|---|
I | Bus Number | 1-999999 |
ID | Load Identifier | One- or two-character uppercase non-blank alphanumeric load identifier |
STATUS | Load Status | 1: in-service, 0: out of service. |
PL | Active power component of constant MVA load (MW) | For each type either P or Q must be non-zero to import the corresponding load model |
QL | Reactive power component of constant MVA load (MVAr) | |
IP | Active power component of constant current load (MW) | |
IQ | Reactive power component of constant current load (MVAr) | |
YP | Active power component of constant admittance load (MW) | |
YQ | Reactive power component of constant admittance load (MVAr) |
...
| color | #D3D3D3 |
|---|
...
Note
Loads with all zero values for PL, QL, IP, IQ, YP and YQ are ignored and not imported into the .opal file.
Fixed Shunt Data
The table below shows the list of required fields and their acceptable values imported from Fixed shunt data section of the RAW file.
Entry | Description | Acceptable values |
|---|---|---|
I | Bus Number | 1-999999 |
ID | Shunt Identifier | One- or two-character uppercase non-blank alphanumeric shunt identifier |
STATUS | Shunt Status | 1: in-service, 0: out of service. |
GL | Active component of shunt admittance to ground (MW) | Any value |
BL | Reactive component of shunt admittance to ground (MVAr) |
Switched Shunt Data
The table below shows the list of required fields and their acceptable values imported from Switched shunt data section of the RAW file.
Entry | Description | Acceptable values |
|---|---|---|
I | Bus Number | 1-999999 |
MODSW | Control Mode | 0 (locked) |
STAT | Switched shunt Status | 1: in-service, 0: out of service. |
BINIT | Initial switched shunt admittance (MVAr at unity voltage) | Any value |
Generator Data
The table below shows the list of required fields and their acceptable values imported from Generator data section of the RAW file.
Entry | Description | Acceptable values |
|---|---|---|
I | Bus Number | 1-999999 |
ID | Generator Identifier | One- or two-character uppercase non-blank alphanumeric generator identifier |
PG | Generator active power output (MW) | Greater than or equal to 0 |
QG | Generator reactive power output (MVAr) | Any value |
QT | Maximum generator reactive power output (MVAr) | |
QB | Minimum generator reactive power output (MVAr) | |
MBASE | Machine MVA base | |
ZR | Machine resistance (p.u. on MBASE base) | |
ZX | Machine reactance(p.u. on MBASE base) | |
STAT | Generator Status | 1: in-service, 0: out of service |
...
| color | #D3D3D3 |
|---|
...
Note
For machine types GENROU, GENROE, GENSAL, GENSAE and CIMTR3-double cage, reactance value is replaced by sub-transient reactances from the *.dyr file.
Non-Transformer Branch Data
The table below shows the list of required fields and their acceptable values imported from Branch data section of the RAW file.
Entry | Description | Acceptable values |
|---|---|---|
I | Branch from bus number | 1-999999 |
J | Branch to bus number | |
CKT | Branch circuit identifier | One- or two-character uppercase non-blank alphanumeric branch circuit identifier |
R | Branch resistance (p.u.) | Greater than or equal to 0 |
X | Branch reactance (p.u.) | Any value |
B | Total branch charging susceptance (p.u.) | |
ST | Branch Status | 1: in-service, 0: out of service. |
Transformer Data
ePHASORSIM supports both 2-winding and 3-winding transformers. The table below shows the list of required fields and their acceptable values imported from Transformer data section of the RAW file.
Entry | Description | Acceptable values |
|---|---|---|
I | Winding 1 bus number | 1-999999 |
J | Winding 2 bus number | |
K | Winding 3 bus number | |
CKT | Branch circuit identifier | One- or two-character uppercase non-blank alphanumeric branch circuit identifier |
CW | The winding data I/O code defines the units in which the turns ratios are specified | 1 |
CZ | The impedance data I/O code defines the units in which the winding impedances are specified | |
CM | The magnetizing admittance I/O code defines the units in which are specified | |
MAG1, MAG2 | Magnetizing conductance and susceptance respectively (for CW=1, p.u. on system MVA and winding 1 bus voltage base) | Any value |
STAT | Transformer Status | 1: in-service, 0: out of service. |
R1-2, R3-1, R2-3 | Measured resistance between windings 1-2, 3-1 and 2-3 respectively (for CZ=1, p.u. on system MVA and winding voltage base) | Any value |
X1-2, X3-1, X2-3 | Measured reactance between windings 1-2, 3-1 and 2-3 respectively (for CZ=1, p.u. on system MVA and winding voltage base) | |
WINDV1, WINDV2, WINDV3 | For CW=1, winding 1, 2 and 3 off-nominal turn ratio in p.u. | |
ANG1, ANG2, ANG3 | Winding 1, 2 and 3 phase shift (degree) | -180 to +180 |