CreateBranch Method
Declaration Description Parameters Method Result See Also Example

<< Click to Display Table of Contents >>

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

CreateBranch Method
Declaration Description Parameters Method Result See Also Example

Previous pageReturn to chapter overviewNext page

 

Section

Declaration

 

function CreateBranch(

const FromBusName, ToBusName: WideString;

Status: Integer;

const Name, Number, Descr: WideString;

X1, Y1, X2, Y2: Integer;

const Conductor, UserCode: WideString;

Quantity: Integer;

const Distance: WideString;

OperateTemp, Derate: Double;

Rp, Xp, Bp: Double;

Ro, Xo, Bo: Double;

Rn, Xn, Bn: Double;

IA, IB: Double

): WideString;

Section

Description

Creates a 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 Branch.

Section

Parameters

 

Parameter

Usage

FromBusName

From Bus Name the Branch should connect to.

ToBusName

To Bus Name the Branch should connect to.

Status

Branch 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

Start Point X Co-ordinate

Y1

Start Point Y Co-ordinate

X2

End Point X Co-ordinate

Y2

End Point Y Co-ordinate

Conductor

Conductor Description

UserCode

Conductor User defined Code if Required

Quantity

Number of Branches in Parallel.

Distance

Distance of the Branch. e.g. 1000 or 1km

OperateTemp

Operating Temperature of the Branch.

Derate

Derating Factor of the Branch

Rp

Positive Sequence Resistance of the Conductor in Ω/km

Xp

Positive Sequence Reactance of the Conductor in Ω/km

Bp

Positive Sequence Charging of the Conductor in μmho/km

Ro

Zero Sequence Resistance of the Conductor in Ω/km

Xo

Zero Sequence Reactance of the Conductor in Ω/km

Bo

Zero Sequence Charging of the Conductor in μmho/km

Rn

Neutral Resistance of the Conductor in Ω/km

Xn

Neutral Reactance of the Conductor in Ω/km

Bn

Neutral Charging of the Conductor in μmho/km

IA

The current rating of normal operating conditions

IB

The current rating of Emergency operating conditions

Section

Method Result

Unique Branch Name.

Section

Example

NewName := PowaMasterObj.CreateBranch( FromBusName, ToBusName,Status, Name, Number, Description, X1, Y1, X2, Y2, ConductorStr, UserCode,Quantity, km, OperateTemp, DerateFactor, Rp, Xp, Bp, Ro, Xo, Bo, Rn, Xn, Bn, IA, IB);

 

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

Section

See Also

CreateBus

CreateGenerator

CreateLoad

CreateMotor

CreateInductionMotor

CreateShuntCap

CreateCoGen

CreateHarmonicSource

CreateBranchSection

CreateTrfrBranch

CreateProtectionDevice

CreateSeriesCap

CreateSeriesReactor

Section