The PowerScript function GetData copies network and system data from a OneLiner or Power Flow case to PowerScript program variables. The datum to be read is uniquely identified by an object handle and a parameter code. The list of supported parameter codes is given in table 3.3.
Parameters that are listed in table 3.3 with YES in Write Access column can be modified from PowerScript. There are two functions that help you modify the parameters of an object: SetData and PostData.
Suppose you want to change three parameters of an object. In your program you must call the function SetData separately for each of the parameters you are changing. PowerScript automatically creates a temporary object in memory with the updated parameters. Once you are done modifying the parameters, you must call the function PostData once to validate the object data and if the data is valid, copy the temporary object to the OneLiner or Power Flow case.
Table 3.3. List of
PowerScript Equipment Parameter Code
Parameter |
Data type |
Write Access |
Parameter Code |
Breaker contact parting time for group 1 (cycles) |
double |
YES |
BK_dCPT1 |
Breaker contact parting time for group 2 (cycles) |
double |
YES |
BK_dCPT2 |
Breaker interrupting time (cycles) |
double |
YES |
BK_dCycles |
Breaker kV range factor |
double |
YES |
BK_dK |
Breaker no-ac-decay ratio |
double |
YES |
BK_dNACD |
Breaker operating kV |
double |
YES |
BK_dOperatingKV |
Breaker max design kV |
double |
YES |
BK_dRatedKV |
Breaker interrupting rating |
double |
YES |
BK_dRating1 |
Breaker momentary rating |
double |
YES |
BK_dRating2 |
Breaker bus handle |
Long |
NO |
BK_nBusHnd |
Breaker do not derate in reclosing operation flag: 1-true; 0-false; |
Long |
YES |
BK_nDontDerate |
Breaker In-service flag: 1-true; 2-false; |
Long |
YES |
BK_nInService |
Breaker group 1 interrupting current: 1-max current; 0-group current |
Long |
YES |
BK_nInterrupt1 |
Breaker group 1 interrupting current: 1-max current; 0-group current |
Long |
YES |
BK_nInterrupt2 |
Breaker rating type: 0- symmetrical current basis;1- total current basis; 2- IEC |
Long |
YES |
BK_nRatingType |
Breaker total operations for group 1 |
Long |
YES |
BK_nTotalOps1 |
Breaker total operations for group 2 |
Long |
YES |
BK_nTotalOps2 |
Breaker protected equipment group 1 in string format |
String |
NO |
BK_sEquipGrp1 |
Breaker protected equipment group 2 in string format |
String |
NO |
BK_sEquipGrp2 |
Breaker ID |
String |
YES |
BK_sID |
Breaker reclosing intervals for group 1 (s) |
array(3) of double |
YES |
BK_vdRecloseInt1 |
Breaker reclosing intervals for group 2 (s) |
array(3) of double |
YES |
BK_vdRecloseInt2 |
Breaker protected equipment group 1 list of equipment handles |
array(10) of long |
NO |
BK_vnG1DevHnd |
Breaker protected equipment group 1 list of additional outage handles |
array(10) of long |
NO |
BK_vnG1OutageHnd |
Breaker protected equipment group 2 list of equipment handles |
array(10) of long |
NO |
BK_vnG2DevHnd |
Breaker protected equipment group 2 list of additional outage handles |
array(10) of long |
NO |
BK_vnG2OutageHnd |
Branch near bus handle |
Long |
NO |
BR_nBus1Hnd |
Branch far bus handle |
Long |
NO |
BR_nBus2Hnd |
Branch bus 3 handle |
Long |
NO |
BR_nBus3Hnd |
Branch equipment handle |
Long |
NO |
BR_nHandle |
Branch in-service flag: 1- active; 2- out-of-service |
Long |
NO |
BR_nInService |
Branch near bus relay group handle |
Long |
NO |
BR_nRlyGrp1Hnd |
Branch far bus relay group handle |
Long |
NO |
BR_nRlyGrp2Hnd |
Branch bus 3 relay group handle |
Long |
NO |
BR_nRlyGrp3Hnd |
Branch type |
Long |
NO |
BR_nType |
Bus voltage angle (load flow solution) |
double |
NO |
BUS_dAngleP |
Bus nominal kV |
double |
NO |
BUS_dKVnorminal |
Bus voltage magnitude (load flow solution) |
double |
NO |
BUS_dKVP |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
Bus state plane coordinate - X |
double |
YES |
BUS_dSPCx |
Bus state plane coordinate - Y |
double |
YES |
BUS_dSPCy |
Bus area |
Long |
YES |
BUS_nArea |
Bus number |
Long |
YES |
BUS_nNumber |
System slack bus flag: 1-yes; 0-no |
Long |
YES |
BUS_nSlack |
Bus substation group |
Long |
YES |
BUS_nSubGroup |
Tap bus flag: 0-no; 1- tap bus; 3- tap bus of 3-terminal line |
Long |
YES |
BUS_nTapBus |
Bus visibility flag: 1-visible; -1-hidden; 0-not yet placed |
Long |
YES |
BUS_nVisible |
Bus zone |
Long |
YES |
BUS_nZone |
Bus comment |
String |
YES |
BUS_sComment |
Bus location |
String |
YES |
BUS_sLocation |
Bus name |
String |
YES |
BUS_sName |
Voltage controlled current source MVA rating |
double |
YES |
CC_dMVArating |
Voltage controlled current source maximum voltage limit |
double |
YES |
CC_dVmax |
Voltage controlled current source minimum voltage limit |
double |
YES |
CC_dVmin |
Voltage controlled current source in-service flag: 1-true; 2-false |
Long |
YES |
CC_nInService |
Voltage controlled current source voltage measurement location |
Long |
YES |
CC_nVloc |
Voltage controlled current source bus handle |
Long |
NO |
CC_nBusHnd |
Voltage controlled current source out of service date |
String |
YES |
CC_sOffDate |
Voltage controlled current source in service date |
String |
YES |
CC_sOnDate |
Voltage controlled current source angle |
array(10) of double |
YES |
CC_vdAng |
Voltage controlled current source current |
array(10) of double |
YES |
CC_vdI |
Voltage controlled current source voltage |
array(10) of double |
YES |
CC_vdV |
Recloser-Ground high current trip |
double |
YES |
CG_dHiAmps |
Recloser-Ground high current trip delay |
double |
YES |
CG_dHiAmpsDelay |
Recloser-Ground fast curve minimum time |
double |
YES |
CG_dMinTF |
Recloser-Ground slow curve minimum time |
double |
YES |
CG_dMinTS |
Recloser-Ground fast curve pickup |
double |
YES |
CG_dPickupF |
Recloser-Ground slow curve pickup |
double |
YES |
CG_dPickupS |
Recloser-Ground reclosing interval 1 |
double |
YES |
CG_dRecIntvl1 |
Recloser-Ground reclosing interval 2 |
double |
YES |
CG_dRecIntvl2 |
Recloser-Ground reclosing interval 3 |
double |
YES |
CG_dRecIntvl3 |
Recloser-Ground fast curve time adder |
double |
YES |
CG_dTimeAddF |
Recloser-Ground slow curve time adder |
double |
YES |
CG_dTimeAddS |
Recloser-Ground fast curve time multiplier |
double |
YES |
CG_dTimeMultF |
Recloser-Ground slow curve time multiplier |
double |
YES |
CG_dTimeMultS |
Recloser-Ground curve selection flag: 0- slow; 1- fast |
Long |
YES |
CG_nCurveInUse |
Recloser-Ground number of fast operations |
Long |
YES |
CG_nFastOps |
Recloser-Ground in service flag: 1- active; 2- out-of-service |
Long |
YES |
CG_nInService |
Recloser-Ground relay group handle |
Long |
NO |
CG_nRlyGrHnd |
Recloser-Ground total operations to locked out |
Long |
YES |
CG_nTotalOps |
Recloser-Ground asset ID |
String |
YES |
CG_sAssetID |
Recloser-Ground comments |
String |
YES |
CG_sComment |
Recloser-Ground ID |
String |
YES |
CG_sID |
Recloser-Ground fast curve |
String |
NO |
CG_sTypeFast |
Recloser-Ground slow curve |
String |
NO |
CG_sTypeSlow |
Recloser-Phase high current trip |
double |
YES |
CP_dHiAmps |
Recloser-Phase high current trip delay |
double |
YES |
CP_dHiAmpsDelay |
Recloser-Phase fast curve minimum time |
double |
YES |
CP_dMinTF |
Recloser-Phase slow curve minimum time |
double |
YES |
CP_dMinTS |
Recloser-Phase fast curve pickup |
double |
YES |
CP_dPickupF |
Recloser-Phase slow curve pickup |
double |
YES |
CP_dPickupS |
Recloser-Phase reclosing interval 1 |
double |
YES |
CP_dRecIntvl1 |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
Recloser-Phase reclosing interval 2 |
double |
YES |
CP_dRecIntvl2 |
Recloser-Phase reclosing interval 3 |
double |
YES |
CP_dRecIntvl3 |
Recloser-Phase fast curve time adder |
double |
YES |
CP_dTimeAddF |
Recloser-Phase slow curve time adder |
double |
YES |
CP_dTimeAddS |
Recloser-Phase fast curve time multiplier |
double |
YES |
CP_dTimeMultF |
double |
YES |
CP_dTimeMultS | |
Recloser-Phase curve selection flag: 0- slow; 1- fast |
Long |
YES |
CP_nCurveInUse |
Recloser-Phase number of fast operations |
Long |
YES |
CP_nFastOps |
Recloser-Phase in service flag: 1- active; 2- out-of-service |
Long |
YES |
CP_nInService |
Recloser-Phase relay group handle |
Long |
NO |
CP_nRlyGrHnd |
Recloser-Phase total operations to locked out |
Long |
YES |
CP_nTotalOps |
Recloser-Phase comments |
String |
YES |
CP_sComment |
Recloser-Phase ID |
String |
YES |
CP_sID |
Recloser-Phase fast curve |
String |
NO |
CP_sTypeFast |
Recloser-Phase slow curve |
String |
NO |
CP_sTypeSlow |
DS ground relay CT ratio |
double |
YES |
DG_dCT |
Zero sequence compensation factor K - angle |
double |
NO |
DG_dKang |
Zero sequence compensation factor K - magnitude |
double |
NO |
DG_dKmag |
DS ground relay VT ratio |
double |
YES |
DG_dVT |
DS ground relay in-service flag: 1- active; 2- out-of-service |
Long |
NO |
DG_nInService |
DS ground relay parameter count |
Long |
NO |
DG_nParamCount |
DS ground signal-only zone flag |
Long |
YES |
DG_nSignalOnly |
DS ground relay group handle |
Long |
NO |
DG_nRlyGrHnd |
DS ground relay asset ID |
String |
YES |
DG_sAssetID |
DS ground relay comment |
String |
NO |
DG_sComment |
DS ground relay type name |
String |
NO |
DG_sDSType |
DS ground relay ID |
String |
YES |
DG_sID |
DS ground relay setting (1) |
String |
YES |
DG_sParam |
DS ground relay ID2 |
String |
YES |
DG_sType |
DS ground relay zone delay |
array (8) of double |
NO |
DG_vdDelay |
DS ground relay parameter |
array(DG_nParamCount) of double |
NO |
DG_vdParams |
DS ground relay zone reach |
array(8) of double |
NO |
DG_vdReach |
DS ground relay zone reach 1 |
array(8) of double |
NO |
DG_vdReach1 |
DS ground relay setting labels |
array(255) of variant |
NO |
DG_vParamLabels |
DS ground relay settings |
array(255) of variant |
NO |
DG_vParams |
DS phase relay CT ratio |
double |
YES |
DP_dCT |
DS phase relay VT ratio |
double |
YES |
DP_dVT |
DS phase relay in-service flag: 1- active; 2- out-of-service |
Long |
NO |
DP_nInService |
DS phase relay parameter count |
Long |
NO |
DP_nParamCount |
DS phase signal-only zone flag |
Long |
YES |
DP_nSignalOnly |
DS phase relay group handle |
Long |
NO |
DP_nRlyGrHnd |
DS phase relay asset ID |
String |
YES |
DP_sAssetID |
DS phase relay comment |
String |
NO |
DP_sComment |
DS phase relay type name |
String |
NO |
DP_sDSType |
DS phase relay ID |
String |
YES |
DP_sID |
DS phase relay setting (1) |
String |
YES |
DP_sParam |
DS phase relay ID2 |
String |
NO |
DP_sType |
DS phase relay zone delay |
array(8) of double |
NO |
DP_vdDelay |
DS phase relay parameter |
array(DS_nParamCount) of double |
NO |
DP_vdParams |
DS phase relay zone reach |
array(8) of double |
NO |
DP_vdReach |
DS phase relay alternat zone reach |
array(8) of double |
NO |
DP_vdReach1 |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
DS phase relay setting labels |
array(255) of variant |
NO |
DP_vParamLabels |
DS phase relay settings |
array(255) of variant |
NO |
DP_vParams |
Fuse ‘Compute time using’ flag: 1- minimum melt; 2- Total clear |
Long |
YES |
FS_nCurve |
Fuse in-service flag: 1- active; 2- out-of-service |
Long |
YES |
FS_nInService |
Fuse relay group handle |
Long |
NO |
FS_nRlyGrHnd |
Fuse asset ID |
String |
YES |
FS_sAssetID |
Fuse comment |
String |
NO |
FS_sComment |
Fuse ID |
String |
YES |
FS_sID |
Fuse type |
String |
NO |
FS_sType |
Fault MVA |
double |
NO |
FT_dMVA |
Thevenin equivalent negative sequence resistance |
double |
NO |
FT_dRNt |
Thevenin equivalent positive sequence resistance |
double |
NO |
FT_dRPt |
Thevenin equivalent zero sequence resistance |
double |
NO |
FT_dRZt |
Thevenin equivalent negative sequence reactance |
double |
NO |
FT_dXNt |
Thevenin equivalent positive sequence reactance |
double |
NO |
FT_dXPt |
X/R ratio at fault point |
double |
NO |
FT_dXR |
ANSI X/R ratio at fault point |
double |
NO |
FT_dXRANSI |
Thevenin equivalent zero sequence reactance |
double |
NO |
FT_dXZt |
Number of faults saved in solution buffer |
Long |
NO |
FT_nNOFaults |
Generator current limit 1 |
double |
YES |
GE_dCurrLimit1 |
Generator current limit 2 |
double |
YES |
GE_dCurrLimit2 |
Generator reference angle |
double |
YES |
GE_dRefAngle |
Generator scheduled P |
double |
NO |
GE_dScheduledP |
Generator scheduled Q |
double |
NO |
GE_dScheduledQ |
Generator scheduled V |
double |
YES |
GE_dScheduledV |
Generator internal voltage source per unit magnitude |
double |
YES |
GE_dVSourcePU |
Generator in-service
flag: |
Long |
NO |
GE_nActive |
Handle of generator’s controlled bus |
Long |
NO |
GE_nCtrlBusHnd |
Generator regulation flag: 1- PQ; 0- PV |
Long |
NO |
GE_nFixedPQ |
Generator unit rating |
double |
YES |
GU_dMVArating |
Generator unit max MW |
double |
YES |
GU_dPmax |
Generator unit min MW |
double |
YES |
GU_dPmin |
Generator unit max MVAR |
double |
YES |
GU_dQmax |
Generator unit min MVAR |
double |
YES |
GU_dQmin |
Generator unit grounding resistance |
double |
YES |
GU_dRz |
Generator unit grounding reactance |
double |
YES |
GU_dXz |
Generator unit online flag |
Long |
YES |
GU_nOnline |
Generator unit generator handle |
Long |
NO |
GU_nGenHnd |
Generator unit ID |
String |
NO |
GU_sID |
Generator unit out of service date |
String |
YES |
GU_sOffDate |
Generator unit in service date |
String |
YES |
GU_sOnDate |
Generator unit resistances: subtransient, synchronous, transient, negative sequence, zero sequence |
array(5) of double |
YES |
GU_vdR |
Generator unit reactances: subtransient, synchronous, transient, negative sequence, zero sequence |
array(5) of double |
YES |
GU_vdX |
Total load MW |
double |
NO |
LD_dPload |
Total load MVAR |
double |
NO |
LD_dQload |
Load in-service flag: 1- active; 2- out-of-service |
Long |
NO |
LD_nActive |
Line B1 |
double |
YES |
LN_dB1 |
Line B10 |
double |
YES |
LN_dB10 |
Line B2 |
double |
YES |
LN_dB2 |
Line B20 |
double |
YES |
LN_dB20 |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
Line G1 |
double |
YES |
LN_dG1 |
Line G10 |
double |
YES |
LN_dG10 |
Line G2 |
double |
YES |
LN_dG2 |
Line G20 |
double |
YES |
LN_dG20 |
Line length |
double |
YES |
LN_dLength |
Line R |
double |
YES |
LN_dR |
Line Ro |
double |
YES |
LN_dR0 |
Line X |
double |
YES |
LN_dX |
Line Xo |
double |
YES |
LN_dX0 |
Line bus 1 handle |
long |
NO |
LN_nBus1Hnd |
Line bus 2 handle |
long |
NO |
LN_nBus2Hnd |
Line in-service flag: 1- active; 2- out-of-service |
long |
YES |
LN_nInService |
Line mutual pair handle |
long |
NO |
LN_nMuPairHnd |
Line bus 1 relay group handle |
long |
NO |
LN_nRlyGr1Hnd |
Line bus 2 relay group handle |
long |
NO |
LN_nRlyGr2Hnd |
Line circuit ID |
string |
YES |
LN_sID |
Line length unit |
string |
YES |
LN_sLengthUnit |
Line name |
string |
YES |
LN_sName |
Line out of service date |
string |
YES |
LN_sOffDate |
Line in service date |
string |
YES |
LN_sOnDate |
Line table type |
string |
YES |
LN_sType |
Line ratings |
array(4) of double |
YES |
LN_vdRating |
Logic scheme in service |
long |
YES |
LS_nInservice |
Logic scheme relay group handle |
Long |
NO |
LS_nRlyGrpHnd |
Logic scheme signal only |
long |
YES |
LS_nSignalOnly |
Logic scheme asset ID |
string |
YES |
LS_sAssetID |
Logic scheme equation |
String |
NO |
LS_sEquation |
Logic scheme ID |
string |
YES |
LS_sID |
Logic scheme name |
string |
NO |
LS_sScheme |
Logic scheme variables details (one variable per line in the format: name=description) |
String |
NO |
LS_sVariables |
Load unit MW |
double |
NO |
LU_dPload |
Load unit MVAR |
double |
NO |
LU_dQload |
Load unit in-service flag: 1-active; 2- out-of-service |
long |
YES |
LU_nOnline |
Load unit load handle |
long |
NO |
LU_nLoadHnd |
Load unit ID |
string |
NO |
LU_sID |
Load unit out of service date |
string |
YES |
LU_sOffDate |
Load unit in service date |
string |
YES |
LU_sOnDate |
Load unit MVARs: const. P, const. I, const Z |
array(3) of double |
YES |
LU_vdMAR |
Load unit MWs: const. P, const. I, const Z |
array(3) of double |
YES |
LU_vdMW |
Mutual pair line 1 handle |
long |
YES |
MU_nHndLine1 |
Mutual pair line 2 handle |
long |
YES |
MU_nHndLine2 |
Mutual pair line 1 From percent |
array(5) double |
YES |
MU_vdFrom1 |
Mutual pair line 2 From percent |
array(5) double |
YES |
MU_vdFrom2 |
Mutual pair: R |
array(5) of double |
YES |
MU_vdR |
Mutual pair line1 To percent |
array(5) of double |
YES |
MU_vdTo1 |
Mutual pair line 2 To percent |
array(5) of double |
YES |
MU_vdTo2 |
Mutual pair: X |
array(5) of double |
YES |
MU_vdX |
OC ground relay CT ratio |
Double |
YES |
OG_dCT |
OC ground relay instantaneous setting |
double |
NO |
OG_dInst |
OC ground relay instantaneous delay |
double |
NO |
OG_dInstDelay |
OC ground relay reset time |
double |
YES |
OG_dResetTime |
OC ground relay tap Ampere |
double |
YES |
OG_dTap |
OC ground relay time dial |
double |
YES |
OG_dTDial |
OC ground relay time adder |
double |
YES |
OG_dTimeAdd |
OC ground relay time adder 2 |
double |
YES |
OG_dTimeAdd2 |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
OC ground relay time multiplier |
double |
YES |
OG_dTimeMult |
OC ground relay time multiplier 2 |
double |
YES |
OG_dTimeMult2 |
OC ground relay sentitive to DC offset |
long |
YES |
OG_nDCOffset |
OC ground relay directional flag: 0=false; |
long |
NO |
OG_nDirectional |
OC ground relay flat definite time delay flag: 1-true; 0-false |
long |
YES |
OG_nFlatDelay |
OC ground relay Inst. Directional flag: 0=false; |
long |
NO |
OG_nIDirectional |
OC ground relay in-service flag: 1- active; 2- out-of-service |
long |
NO |
OG_nInService |
OC ground relay polar option |
long |
YES |
OG_nPolar |
OC ground relay group handle |
long |
NO |
OG_nRlyGrHnd |
OC ground relay signal only |
long |
YES |
OG_nSignalOnly |
OC ground relay asset ID |
string |
YES |
OG_sAssetID |
OC ground relay comment |
string |
NO |
OG_sComment |
OC ground relay ID |
string |
YES |
OG_sID |
OC ground relay type |
string |
NO |
OG_sType |
OC ground relay direction setting |
array(8) of double |
YES |
OG_vdDirSetting |
OC phase relay CT ratio |
double |
YES |
OP_dCT |
OC phase relay instantaneous setting |
double |
NO |
OP_dInst |
OC phase relay instantaneous delay |
double |
NO |
OP_dInstDelay |
OC phase relay tap Ampere |
double |
YES |
OP_dTap |
OC phase relay time dial |
double |
YES |
OP_dTDial |
OC phase relay time adder |
double |
YES |
OP_dTimeAdd |
OC phase relay time adder 2 |
double |
YES |
OP_dTimeAdd2 |
OC phase relay time multiplier |
double |
YES |
OP_dTimeMult |
OC phase relay time multiplier 2 |
double |
YES |
OP_dTimeMult2 |
OC phase relay reset time |
double |
YES |
OP_dResetTime |
OC_phase relay voltage controlled or restrained percentage |
double |
YES |
OP_dVCtrlRestPcnt |
OC phase reley CT connection |
long |
YES |
OP_nByCTConnect |
OC phase relay sentitive to DC offset |
long |
YES |
OP_nDCOffset |
OC phase relay directional flag: 0=false; |
long |
NO |
OP_nDirectional |
OC phase relay flat delay |
long |
YES |
OP_nFlatDelay |
OC phase relay Inst. Directional flag: 0=false; |
long |
NO |
OP_nIDirectional |
OC phase relay in-service flag: 1- active; 2- out-of-service |
long |
NO |
OP_nInService |
OC_phase relay polar option |
long |
YES |
OP_nPolar |
OC phase relay group handle |
long |
NO |
OP_nRlyGrHnd |
OC phase relay signal only |
long |
YES |
OP_nSignalOnly |
OC phase relay voltage controlled or restrained |
long |
YES |
OP_nVoltControl |
OC phase relay asset ID |
string |
YES |
OP_sAssetID |
OC phase relay comment |
string |
NO |
OP_sComment |
OC phase relay ID |
string |
YES |
OP_sID |
OC phase relay type |
string |
NO |
OP_sType |
OC phase relay direction setting |
array(8) of double |
YES |
OP_vdDirSetting |
Phase shifter shift angle |
double |
YES |
PS_dAngle |
Phase shifter shift angle max |
double |
YES |
PS_dAngleMax |
Phase shifter shift angle min |
double |
YES |
PS_dAngleMin |
Phase shifter B |
double |
YES |
PS_dB |
Phase shifter Bo |
double |
YES |
PS_dB0 |
Phase shifter B2 |
double |
YES |
PS_dB2 |
Phase shifter MVA1 |
double |
YES |
PS_dMVA1 |
Phase shifter MVA2 |
double |
YES |
PS_dMVA2 |
Phase shifter MVA3 |
double |
YES |
PS_dMVA3 |
Phase shifter MW max |
double |
YES |
PS_dMWmax |
Phase shifter MW min |
double |
YES |
PS_dMWmin |
Phase shifter R |
double |
YES |
PS_dR |
Phase shifter Ro |
double |
YES |
PS_dR0 |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
Phase shifter R2 |
double |
YES |
PS_dR2 |
Phase shifter X |
double |
YES |
PS_dX |
Phase shifter Xo |
double |
YES |
PS_dX0 |
Phase shifter X2 |
double |
YES |
PS_dX2 |
Phase shifter bus 1 handle |
long |
NO |
PS_nBus1Hnd |
Phase shifter bus 2 handle |
long |
NO |
PS_nBus2Hnd |
Phase shifter control mode |
long |
NO |
PS_nControlMode |
Phase shifter in-service flag: 1- active; 2- out-of-service |
long |
YES |
PS_nInService |
Phase shifter relay group 1 handle |
long |
NO |
PS_nRlyGr1Hnd |
Phase shifter relay group 2 handle |
long |
NO |
PS_nRlyGr2Hnd |
Phase shifter circuit ID |
string |
NO |
PS_sID |
Phase shifter name |
string |
NO |
PS_sName |
Phase shifter out of service date |
string |
YES |
PS_sOffDate |
Phase shifter in service date |
string |
YES |
PS_sOnDate |
Differential relay minimum enable differential current (3I0) |
double |
YES |
RD_dPickup3I0 |
Differential relay minimum enable differential current (3I2) |
double |
YES |
RD_dPickup3I2 |
Differential relay minimum enable differential current (phase) |
double |
YES |
RD_dPickupPh |
Differential relay tapped load coordination delay (I0) |
double |
YES |
RD_dTLCTDDelayI0 |
Differential relay tapped load coordination delay (I2) |
double |
YES |
RD_dTLCTDDelayI2 |
Differential relay tapped load coordination delay (phase) |
double |
YES |
RD_dTLCTDDelayPh |
Differential relay local current input CTR 1 |
long |
YES |
RD_nCTR1 |
Differential relay in service |
long |
YES |
RD_nInService |
Differential relay local current input handle 1 |
long |
NO |
RD_nLocalCTHnd1 |
Differential relay group handle |
long |
NO |
RD_nRlyGrpHnd |
Differential relay remote device handle 1 |
long |
NO |
RD_nRmeDevHnd1 |
Differential relay remote device handle 2 |
long |
NO |
RD_nRmeDevHnd2 |
Differential relay signal only |
long |
YES |
RD_nSignalOnly |
Differential relay asset ID |
string |
YES |
RD_sAssetID |
Differential relay ID |
string |
YES |
RD_sID |
Differential relay tapped load coordination curve (I0) |
string |
NO |
RD_sTLCCurveI0 |
Differential relay tapped load coordination curve (I2) |
string |
NO |
RD_sTLCCurveI2 |
Differential relay tapped load coordination curve (phase) |
string |
NO |
RD_sTLCCurvePh |
Relay group interrupting time (cycles) |
double |
YES |
RG_dBreakerTime |
Relay group back up group handle |
long |
NO |
RG_nBackupHnd |
Relay group branch handle |
long |
NO |
RG_nBranchHnd |
Relay group in-service flag: 1- active; 2- out-of-service |
long |
NO |
RG_nInService |
Relay group primary group handle |
long |
NO |
RG_nPrimaryHnd |
Relay group trip logic scheme handle |
long |
YES |
RG_nTripLogicHnd |
Relay group reclose logic scheme handle |
long |
NO |
RG_nReclLogicHnd |
Relay group total operations |
long |
NO |
RG_nOps |
Relay group annotation |
string |
NO |
RG_sNote |
Relay group reclosing intervals |
array(4) of double |
YES |
RG_vdRecloseInt |
Voltage relay over-voltage instant pickup (V) |
double |
YES |
RV_dOVIPickup |
Voltage relay over-voltage delay |
double |
YES |
RV_dOVTDelay |
Voltage relay over-voltage pickup (V) |
double |
YES |
RV_dOVTPickup |
Voltage relay under-voltage instant pickup (V) |
double |
YES |
RV_dUVIPickup |
Voltage relay under-voltage delay |
double |
YES |
RV_dUVTDelay |
Voltage relay under-voltage pickup (V) |
double |
YES |
RV_dUVTPickup |
Voltage relay PT ratio |
double |
YES |
RV_dCTR |
Voltage relay in service |
long |
YES |
RV_nInService |
Voltage relay signal only |
long |
YES |
RV_nSignalOnly |
Voltage relay operate on voltage option |
long |
YES |
RV_nVoltOperate |
Voltage relay group handle |
long |
NO |
RV_RlyGrpHnd |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
Voltage relay asset ID |
string |
YES |
RV_sAssetID |
Voltage relay ID |
string |
YES |
RV_sID |
Voltage relay over-voltage element curve |
string |
NO |
RV_sOVCurve |
Voltage relay under-voltage element curve |
string |
NO |
RV_sUVCurve |
Series capacitor protective level current |
double |
YES |
SC_dIpr |
Series capacitor/reactor R |
double |
YES |
SC_dR |
Series capacitor/reactor X |
double |
YES |
SC_dX |
Series capacitor/reactor bus 1 handle |
long |
NO |
SC_nBus1Hnd |
Series capacitor/reactor bus 2 handle |
long |
NO |
SC_nBus2Hnd |
Series capacitor/reactor in-service flag: 1- active; 2- out-of-service; 3- bypassed |
long |
YES |
SC_nInService |
Series capacitor/reactor relay group handle 1 |
long |
NO |
SC_nRlyGr1Hnd |
Series capacitor/reactor relay group handle 2 |
long |
NO |
SC_nRlyGr2Hnd |
Series capacitor/reactor circuit ID |
string |
YES |
SC_sID |
Series capacitor/reactor name |
string |
YES |
SC_sName |
Series capacitor out of service date |
string |
YES |
SC_sOffDate |
Series capacitor in service date |
string |
YES |
SC_sOnDate |
Shunt unit succeptance (positive sequence) |
double |
YES |
SU_dB |
Shunt unit succeptance (zero sequence) |
double |
YES |
SU_dB0 |
Shunt unit conductance (positive sequence) |
double |
YES |
SU_dG |
Shunt unit conductance (zero sequence) |
double |
YES |
SU_dG0 |
Shunt unit 3-winding transformer flag |
long |
NO |
SU_n3WX |
Shunt unit online flag |
long |
YES |
SU_nOnline |
Shunt unit shunt handle |
long |
NO |
SU_nShuntHnd |
Shunt unit ID |
string |
NO |
SU_sID |
Shunt unit our of service date |
string |
YES |
SU_sOffDate |
Shunt unit in service date |
string |
YES |
SU_sOnDate |
SVD admitance in use |
double |
NO |
SV_dB |
SVD max V |
double |
NO |
SV_dVmax |
SVD min V |
double |
NO |
SV_dVmin |
SVD in-service flag: 1- active; 2- out-of-service |
long |
NO |
SV_nActive |
Handle of SVD controled bus |
long |
NO |
SV_nCtrlBusHnd |
SVD control mode |
long |
NO |
SV_nCtrlMode |
SVD increment B0 |
array(8) of double |
NO |
SV_vdB0inc |
SVD increment B |
array(8) of double |
NO |
SV_vdBinc |
SVD number of step |
array(8) of double |
NO |
SV_vnNoStep |
Switch current rating |
double |
YES |
SW_dRating |
Switch bus 1 handle |
long |
NO |
SW_nBus1Hnd |
Switch bus 2 handle |
long |
NO |
SW_nBus2Hnd |
Switch default position flag: 1- normaly open; 2- normaly close; 0-Not defined |
long |
YES |
SW_nDefault |
Switch in-service flag: 1- active; 2- out-of-service |
long |
YES |
SW_nInService |
Switch relay group handle 1 |
long |
NO |
SW_nRlyGrHnd1 |
Switch relay group handle 2 |
long |
NO |
SW_nRlyGrHnd2 |
Switch position flag: 7- close; 0- open |
long |
YES |
SW_nStatus |
Switch ID |
string |
YES |
SW_sID |
Switch name |
string |
YES |
SW_sName |
Switch out of service date |
string |
YES |
SW_sOffDate |
Switch in service date |
string |
YES |
SW_sOnDate |
System MVA base |
double |
NO |
SY_dBaseMVA |
System number of buses |
long |
NO |
SY_nNObus |
System number of generators |
long |
NO |
SY_nNOgen |
System number of transmision lines |
long |
NO |
SY_nNOline |
System number of loads |
long |
NO |
SY_nNOload |
System number of phase shifter |
long |
NO |
SY_nNOps |
System number of series capacitors |
long |
NO |
SY_nNOseriescap |
System number of shunts |
long |
NO |
SY_nNOshunt |
System number of 2-winding transformers |
long |
NO |
SY_nNOxfmr |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
System number of 3-winding transformers |
long |
NO |
SY_nNOxfmr3 |
System number of switches |
long |
NO |
SY_nNOswitch |
System number of load units |
long |
NO |
SY_nNOloadUnit |
System number of switched shunts |
long |
NO |
SY_nNOsvd |
System number of OC phase relays |
long |
NO |
SY_nNOrlyOCP |
System number of OC ground relays |
long |
NO |
SY_nNOrlyOCG |
System number of DS phase relays |
long |
NO |
SY_nNOrlyDSP |
System number of DS ground relays |
long |
NO |
SY_nNOrlyDSG |
System number of line differential relays |
long |
NO |
SY_nNOrlyD |
System number of voltage relays |
long |
NO |
SY_nNOrlyV |
System number of fuses |
long |
NO |
SY_nNOfuse |
System number of phase reclosers |
long |
NO |
SY_nNOrecloserP |
System number of ground reclosers |
long |
NO |
SY_nNOrecloserG |
System number of shunt units |
long |
NO |
SY_nNOshuntUnita |
System number of voltage controlled current sources |
long |
NO |
SY_nNOccgen |
System number of breakers |
long |
NO |
SY_nNObreaker |
System number of logic schemes |
long |
NO |
SY_nNOscheme |
System data: comment |
string |
NO |
SY_sFComment |
3-winding transformer base MVA for per-unit quantities |
long |
YES |
X3_dBaseMVA |
3-winding transformer LTC center tap |
double |
YES |
X3_dLTCCenterTap |
3-winding transformer B |
double |
YES |
X3_dB |
3-winding transformer B0 |
double |
YES |
X3_dB0 |
3-winding transformer base MVA for per-unit quantities |
double |
YES |
X3_dBaseMVA |
3-winding transformer LTC step size |
double |
YES |
X3_dLTCstep |
3-winding transformer LTC max tap |
double |
YES |
X3_dMaxTap |
3-winding transformer LTC min controlled quantity limit |
double |
YES |
X3_dMaxVW |
3-winding transformer LTC min tap |
double |
YES |
X3_dMinTap |
3-winding transformer LTC controlled quantity limit |
double |
YES |
X3_dMinVW |
3-winding transformer LTC controlled quantity limit |
double |
YES |
X3_dMinVW |
3-winding transformer MVA rating n, n=1,2,3 |
double |
YES |
X3_dMVAn |
3-winding transformer R0ps |
double |
YES |
X3_dR0ps |
3-winding transformer R0pt |
double |
YES |
X3_dR0pt |
3-winding transformer R0st |
double |
YES |
X3_dR0st |
3-winding transformer RG1 |
double |
YES |
X3_dRG1 |
3-winding transformer RG2 |
double |
YES |
X3_dRG2 |
3-winding transformer RG3 |
double |
YES |
X3_dRG3 |
3-winding transformer RGn |
double |
YES |
X3_dRGN |
3-winding transformer Rps |
double |
YES |
X3_dRps |
3-winding transformer Rpt |
double |
YES |
X3_dRpt |
3-winding transformer Rst |
double |
YES |
X3_dRst |
3-winding transformer winding 1 tap kV |
double |
YES |
X3_dTap1 |
3-winding transformer winding 2 tap kV |
double |
YES |
X3_dTap2 |
3-winding transformer winding 3 tap kV |
double |
YES |
X3_dTap3 |
3-winding transformer X0ps |
double |
YES |
X3_dX0ps |
3-winding transformer X0pt |
double |
YES |
X3_dX0pt |
3-winding transformer X0st |
double |
YES |
X3_dX0st |
3-winding transformer XG1 |
double |
YES |
X3_dXG1 |
3-winding transformer XG2 |
double |
YES |
X3_dXG2 |
3-winding transformer XG3 |
double |
YES |
X3_dXG3 |
3-winding transformer XGn |
double |
YES |
X3_dXGN |
3-winding transformer Xps |
double |
YES |
X3_dXps |
3-winding transformer Xpt |
double |
YES |
X3_dXpt |
3-winding transformer Xst |
double |
YES |
X3_dXst |
3-winding transformer auto transformer flag:1-true;0-false |
long |
YES |
X3_nAuto |
3-winding transformer bus 1 handle |
long |
NO |
X3_nBus1Hnd |
3-winding transformer bus 2 handle |
long |
NO |
X3_nBus2Hnd |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
3-winding transformer bus 3 handle |
long |
NO |
X3_nBus3Hnd |
3-winding transformer fictitious bus number |
long |
NO |
X3_nFictBusNo |
3-winding transformer
in-service flag: |
long |
YES |
X3_nInService |
3-winding transformer LTC tag ganged flag: 0-False; 1-True |
long |
YES |
X3_nLTCGanged |
3-winding transformer relay group 1 handle |
long |
NO |
X3_nRlyGr1Hnd |
3-winding transformer relay group 2 handle |
long |
NO |
X3_nRlyGr2Hnd |
3-winding transformer relay group 3 handle |
long |
NO |
X3_nRlyGr3Hnd |
3-winding transformer winding 1 config |
string |
YES |
X3_sCfg1 |
3-winding transformer winding 2 config |
string |
YES |
X3_sCfg2 |
3-winding transformer winding 2 config in test |
string |
YES |
X3_sCfg2T |
3-winding transformer winding 3 config |
string |
YES |
X3_sCfg3 |
3-winding transformer winding 3 config in test |
string |
YES |
X3_sCfg3T |
3-winding transformer circuit ID |
string |
NO |
X3_sID |
3-winding transformer name |
string |
YES |
X3_sName |
3-winding transformer out of service date |
string |
YES |
X3_sOffDate |
3-winding transformer in service date |
string |
YES |
X3_sOnDate |
2-winding transformer B |
double |
YES |
XR_dB |
2-winding transformer Bo |
double |
YES |
XR_dB0 |
2-winding transformer B1 |
double |
YES |
XR_dB1 |
2-winding transformer B10 |
double |
YES |
XR_dB10 |
2-winding transformer B2 |
double |
YES |
XR_dB2 |
2-winding transformer B20 |
double |
YES |
XR_dB20 |
2-winding transformer base MVA for per-unit quantities |
double |
YES |
XR_dBaseMVA |
2-winding transformer G1 |
double |
YES |
XR_dG1 |
2-winding transformer G10 |
double |
YES |
XR_dG10 |
2-winding transformer G2 |
double |
YES |
XR_dG2 |
2-winding transformer G20 |
double |
YES |
XR_dG20 |
2-winding transformer LTC center tap |
double |
YES |
XR_dLTCCenterTap |
2-winding transformer LTC step size |
double |
YES |
XR_dLTCstep |
2-winding transformer LTC max tap |
double |
YES |
XR_dMaxTap |
2-winding transformer LTC min controlled quantity limit |
double |
YES |
XR_dMaxVW |
2-winding transformer LTC min tap |
double |
YES |
XR_dMinTap |
2-winding transformer LTC max controlled quantity limit |
double |
YES |
XR_dMinVW |
2-winding transformer MVA rating n, n=1,2,3 |
double |
YES |
XR_dMVAn |
2-winding transformer R |
double |
YES |
XR_dR |
2-winding transformer Ro |
double |
YES |
XR_dR0 |
2-winding transformer Rg1 |
double |
YES |
XR_dRG1 |
2-winding transformer Rg2 |
double |
YES |
XR_dRG2 |
2-winding transformer Rgn |
double |
YES |
XR_dRGN |
2-winding transformer winding 1 tap kV |
double |
YES |
XR_dTap1 |
2-winding transformer winding 2 tap kV |
double |
YES |
XR_dTap2 |
2-winding transformer X |
double |
YES |
XR_dX |
2-winding transformer Xo |
double |
YES |
XR_dX0 |
2-winding transformer Xg1 |
double |
YES |
XR_dXG1 |
2-winding transformer Xg2 |
double |
YES |
XR_dXG2 |
2-winding transformer Xgn |
double |
YES |
XR_dXGN |
2-winding transformer auto transformer flag:1-true;0-false |
long |
YES |
XR_nAuto |
2-winding transformer bus1 handle |
long |
NO |
XR_nBus1Hnd |
2-winding transformer bus 2 handle |
long |
NO |
XR_nBus2Hnd |
2-winding transformer
in-service flag: |
long |
YES |
XR_nInService |
2-winding transformer LTC control bus handle |
long |
NO |
XR_nLTCCtrlBusHnd |
2-winding transformer LTC tag ganged flag: 0-False; 1-True |
long |
YES |
XR_nLTCGanged |
|
|
|
Table 3.3 (Cont.) |
Parameter |
Data type |
Write Access |
Parameter Code |
2-winding transformer LTC adjustment priority |
long |
YES |
XR_nLTCPriority |
2-winding transformer LTC side: 1; 2; 0 |
long |
NO |
XR_nLTCside |
2-winding transformer LTC
type: |
long |
NO |
XR_nLTCtype |
2-winding transformer metered bus handle |
long |
NO |
XR_nMetered |
2-winding transformer side 1 relay group handle |
long |
NO |
XR_nRlyGr1Hnd |
2-winding transformer side 2 relay group handle |
long |
NO |
XR_nRlyGr2Hnd |
2-winding transformer winding 1 config |
string |
YES |
XR_sCfg1 |
2-winding transformer winding 2 config |
string |
YES |
XR_sCfg2 |
2-winding transformer winding 2 config in test |
string |
YES |
XR_sCfg2T |
2-winding transformer circuit ID |
string |
NO |
XR_sID |
2-winding transformer name |
string |
NO |
XR_sName |
2-winding transformer out of service date |
string |
YES |
XR_sOffDate |
2-winding transformer in service date |
string |
YES |
XR_sOnDate |
NOTE:
(1) Call GetData function with this code and string parameter label to retrieve the setting value;
Call SetData function with this code and tab delimited string with parameter label and value to set the setting value.