CreateTrfrBranch Method
Declaration Description Parameters Method Result See Also Example

<< Click to Display Table of Contents >>

Navigation:  Additional Resources > OLE/COM Automation > Methods > Create >

CreateTrfrBranch Method
Declaration Description Parameters Method Result See Also Example

Previous pageReturn to chapter overviewNext page

 

Section

Declaration

 

function CreateTrfrBranch(

const FromBusName, ToBusName :WideString;

Status : Integer;

Name, Number, Descr : WideString;

X1, Y1, X2, Y2, Quantity : Integer;

PrimV, SecV, Rating: WideString;

Derate: Double;

const UserCode: WideString;

OL, Zp, XRp, Zz, XRz, ILoss, PhaseShift, IBoost,

Taps, Tnom, Tpos : Integer;

Tstep, Vmin, Vmax: Double;

TapLock, PrimTap, Earth: Integer;

Rp, Xp, Rs, Xs: Double

): WideString;

Section

Description

Creates a Transformer branch connecting two Bus Bars with the parameters passed to the function.

Should there be a name conflict, it returns the actual name of the Transformer branch.

Section

Parameters

Parameter

Usage

FromBusName

From Bus Name the Branch should connect to.

ToBusName

To Bus Name the Branch should connect to.

Status

Trfr Status (1-in service, 0 -out of service)

Name

Unique Name. If not unique, it will be changed and the new name returned by the method.

Number

Unique Number

Description

A Description for the Branch if it is required.

X1

Startpoint X Co-ordinates

Y1

Startpoint Y Co-ordinates

X2

Endpoint X Co-ordinates

Y2

Endpoint Y Co-ordinates

Quantity

Number of trfr's in Parallel

PrimV

Primary Voltage can be specified for example as 88000 or 88kV

SecV

Secondary Voltage can be specified for example as 33000 or 33kV

Rating

Rating can be specified for example as 10000000, 10000kVA or 10MVA

Derate

Derating Factor of the Transformer branch

UserCode

Tranformer User defined Code if Required

OL

Permissible transformer overload in pu.

Zp

Positive sequence impedance in percentage from the transformer's name plate information

XRp

Positive sequence Reactance to Resistance ratio.

Zz

Zero sequence impedance in percentage from the transformer's name plate information

XRz

Zero sequence Reactance to Resistance ratio.

ILoss

Iron Losses in Watt for the Transformer

PhaseShift

Angle Phase shift of the Transformer from Primary to Secondary

IBoost

Specify the percentage internal voltage boost of the transformer

Taps

Number of Taps

Tnom

Nominal Tap Position

Tpos

Tap Position

Tstep

Tap Step

Vmin

Minimum per unit voltage for the tap change control

Vmax

Maximum per unit voltage for the tap change control

TapLock

1 if the tap is locked, 0 if not.

PrimTap

1 if the tap changer is on the Primary Side of the Transformer, 0 if not.

Earth

Select the Transformer Type and Earthing arrangement,

eg : Star - Star with only the secondary earthed would be : Y / YN.

Rp

Resistance value for the primary earthing equipment

Xp

Reactance value for the primary earthing equipment

Rs

Resistance value for the secondary earthing equipment

Xs

Reactance value for the secondary earthing equipment

Section

Method Result

Unique Transformer branch Name.

Section

Example

NewName := PowaMasterObj.CreateTrfrBranch( FromBusName, ToBusName, Status, OldName, Number, Description, X1, Y1, X2, Y2, Quantity, PrimV, SecV, Rating, DerateFactor, UserCode, OL, Zp, XRp, Zz, XRz, ILoss, PhaseShift, IBoost, Taps, Tnom, Tpos, Tstep, Vmin, Vmax, TapLock, PrimTap, Earth, Rp, Xp, Rs, Xs);

if CompareText(NewName, OldName) <> 0 then ShowMessage('The Name has been changed');

Section

See Also

CreateBus

CreateGenerator

CreateLoad

CreateMotor

CreateInductionMotor

CreateShuntCap

CreateCoGen

CreateHarmonicSource

CreateBranch

CreateBranchSection

CreateProtectionDevice

CreateSeriesCap

CreateSeriesReactor

Section