CreateProtectionDevice Method
Declaration Description Parameters Method Result See Also Example

<< Click to Display Table of Contents >>

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

CreateProtectionDevice Method
Declaration Description Parameters Method Result See Also Example

Previous pageReturn to chapter overviewNext page

 

Section

Declaration

 

function CreateProtectionDevice(

const BranchName: WideString;

SectionID: Integer;

const Name, Number, Descr: WideString;

X, Y: Integer;

const DeviceName: WideString;

CurveType, DeviceType, CTPrimary, CTSecondary : Integer;

PlugSetting, TimeMultiplier, DefMinTime: Double;

CTSaturation : Integer;

InstantPlugSetting, InstantTripTime, MinDiscrTime,

Rating, Utm, Ucm : Double;

const UserData: WideString

): WideString;

Section

Description

Creates a Protection Device onto a Branch with the parameters passed to the function.

Should there be a name conflict, it returns the actual name of the Protection Device.

Section

Parameters

Parameter

Usage

BranchName

Branch Name the Protection Device should be connected to.

SectionID

Id of the section of the Branch on which to place the Protection Device

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 Series Reactor if it is required.

X

X Co-ordinate

Y

Y Co-ordinate

DeviceName

Protection Device Name

CurveType

Normal Inverse, Very Inverse, Extremely Inverse, Long Inverse, User Defined,

Moderate Inverse (ANSI), Very Inverse (ANSI), Extremely Inverse (ANSI),

US CO8 Inverse, US CO2 Inverse, Thermal Flat, Thermal It, Thermal I2t, Thermal I4t

DeviceType

0 - Over Current, 1 - Earth Fault, 2 - Combined

CTPrimary

C.T. Primary Current

CTSecondary

C.T. Secondary Current

PlugSetting

Protection Device Plug Setting (p.u.)

TimeMultiplier

Protection Device Time Multiplier

DefMinTime

Definite Minimum Time of the Relay

CTSaturation

Multiple of primary or secondary current respectively.

InstantPlugSetting

Protection Device Instantaneous Setting (p.u.)

InstantTripTime

Protection Device Instantaneous Setting Trip Time (s)

MinDiscrTime

The Minimum Discrimination Time for this relay

Rating

Breaker Rating in kA

Utm

User Time Multiplier (Shifts the user curve time by this factor)

Ucm

User current Multiplier (Shifts the user curve current by this factor)

UserData

User Defined Time and Current curve.

UserData = Time1 Current1 Time2 Current2, etc...

Section

Method Result

Unique Protection Device Name.

Section

Example

NewName := PowaMasterObj.CreateProtectionDevice( BranchName, SectionID, OldName, NumberStr, DescriptionStr, X, Y, DeviceName, NormalI, OC, 1000, 5, 1.5, 0.1, 0.01, 10, 10, 0.04, 0. 04, 50, 1, 1, "");
 

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

CreateTrfrBranch

CreateSeriesCap

CreateSeriesReactor

Section