3.3  Network Data Access

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

Recloser-Phase slow curve time multiplier

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:
1- active; 2- out-of-service

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:
1- active; 2- out-of-service

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:
1- active; 2- out-of-service

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:
1- control voltage; 2- control MVAR

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.