Currently the following RAW file data sections are supported by ePHASORSIM:

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.

Notes

The power 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

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)	Any value

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

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)

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

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)	Any value

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

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

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

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

Entry	Description	Acceptable values
I	Branch from bus number	1-999999
J	Branch to bus number	1-999999
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.)	Any value
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

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

ePHASORSIM User Documentation

PSS/E RAW file