CreateTrfr2WBranch Method
Declaration Description Parameters Method Result See Also Example

<< Click to Display Table of Contents >>

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

CreateTrfr2WBranch Method
Declaration Description Parameters Method Result See Also Example

Previous pageReturn to chapter overviewNext page

 

Section

 

Declaration

 

function CreateTrfr2WBranch(

const FromBusName, ToBusName: WideString;

Status: Integer;

Name, Number, Descr: WideString;

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

PrimV, SecV, Rating: WideString;

Derate: Double;

UserCode: WideString;

OL, Zp, XRp, Zz, XRz: Double;

AutoTrfr, AutoTrfrGrnd, PrimVec, SecVec: Integer;

PhaseShift, Rp, Xp, Rs, Xs: Double;

Taps, TNom, TPos: Integer;

TStep, Vmin, Vmax: Double;

TapLock, PrimTap: Integer;

NoLoadPpu, NoLoadIpu, ZoMag, IBoost: Double

): WideString;

 

Section

Description

Creates a 2 Winding 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

 

Parameters

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.

AutoTrfr

AutoTransformer status (1-Autotransformer, 0-not autotransformer)

AutoTrfrGrnd

AutoTransformer Grounding status (1-Grounded, 0-not Grounded)

PrimVec

Select the Transformer Primary Type and Earthing arrangement,

eg : Star earthed would be : YN.

SecVec

Select the Transformer Primary Type and Earthing arrangement,

eg : Delta not earthed would be : D.

PhaseShift

Angle Phase shift of the Transformer from Primary to Secondary

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

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.

NoLoadPpu

No Load Loss (pu)

NoLoadIpu

No Load Current (pu)

ZoMag

pu Zo Magnetizing factor

IBoost

Specify the percentage internal voltage boost of the transformer

Section

Method Result

Unique Transformer branch Name.

Section

Example

NewName := PowaMasterObj.CreateTrfr2WBranch( FromBusName, ToBusName, Status, OldName, Number, Descr, X1, Y1, X2, Y2, Quantity, PrimV, SecV, Rating, Derate, UserCode, OL, Zp, XRp, Zz, XRz, AutoTrfr, AutoTrfrGrnd, PrimVec, SecVec, PhaseShift, Rp, Xp, Rs, Xs, Taps, TNom, TPos, TStep, Vmin, Vmax, TapLock, PrimTap, NoLoadPpu, NoLoadIpu, ZoMag, IBoost);
 

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