I/O Pins for PSS/E Data

Excel Template

The I/O pins for PSS/E models are defined in the Excel Template mentionned in https://opal-rt.atlassian.net/wiki/spaces/EUD/pages/edit-v2/23199830#Prepare-the-I%2FO-Pins-File.

The Excel file must have the following pages:

General: basic information of the power system, see https://opal-rt.atlassian.net/wiki/spaces/EUD/pages/23216542/Introduction+to+Excel+Template#General
Pins: used to define the required incoming and outgoing ports, see Introduction to Excel Template | IntroductiontoExcelTemplate Pins

The following pages can be used and are optional:

Vsource, see https://opal-rt.atlassian.net/wiki/spaces/EUD/pages/23215815/Voltage+Source?atl_f=content-tree
Current Injector, see https://opal-rt.atlassian.net/wiki/spaces/EUD/pages/23215819/Current+Injector?atl_f=content-tree

Pins identifiers in PSS/E and Excel File

During a PSS/E import, the names of the components will change compared to their PSS/E names. These modified names are those required to define the pins.

The convention for creating the PSS/E names used for pins IDs is based on a combination of prefixes, bus names, and identifiers found in the PSS/E RAW and DYR files. The identifiers in PSS/E RAW files are one or two-character uppercase non-blank alphanumeric. The table below lists this convention.

Alternatively, you can access the modified names by running the simulation once without any pins to get the list of components from the *_solver.opal file.

You can then use those names to access the component and its pins.

The I/O pins for PSS/E input files only support positive sequence components listed in Native Library.

PSS/E Format and Example	OPAL Format Convention	Notes

PSS/E Format and Example	OPAL Format Convention	Notes
BUS 30	bus_ e.g.: bus_30
LOAD Load with ID 1 connected to bus 10	load_Z_ , load_I_ , or load_P_ e.g.: load_Z_10_1	Z, I , P reflect constant impedance, current, and power
Fixed Shunt and Switch Shunt Shunt with ID 1 connected to bus 10	fSH_ or swSH_ e.g.: fSH_10_1
GENERATOR Generator with ID G1 connected to bus 39	gen_ e.g.: gen_39_G1	Type and dynamic data are read from *.dyr file
BRANCH (line) Line with ID 1 between bus 9 and 39	line_b1_to_b2 e.g.: line_9_to_39_1
2-Winding TRANSFORMER Transformer with ID T1 between bus 2 and 30	xf_b1_to_b2 e.g.: xf_2_to_30_T1
3-Winding TRANSFORMER Transformer with ID T1 between buses 100, 101, and 102	xf_b1_b2_b3 e.g.: xf_100_101_102_T1
Excitation system Exciter at bus 37 connected to machine with ID G1	ex_ e.g.: ex_37_G1	Type and dynamic data are read from *.dyr file
Power system stabilizer PSS at bus 38 connected to machine with ID 2	pss_ e.g.: pss_38_2
Turbine-governor TG at bus 37 connected to machine with ID 1	tg_ e.g.: tg_37_1