com.interpss.core.acsc

Interface BaseAcscBus<TGen extends AcscGen,TLoad extends AcscLoad>

All Superinterfaces:

BaseAclfBus<TGen,TLoad>, Bus, com.hazelcast.nio.serialization.DataSerializable, org.eclipse.emf.ecore.EObject, ExtensionElement, IAclfBus, IAclfBusAdaptation, IAclfBusAdjustment, IAclfBusFunc, IAclfBusZeroZFunc, NameTag, NetworkedElement, org.eclipse.emf.common.notify.Notifier

All Known Subinterfaces:

AcscBus, BaseDStabBus<TGen,TLoad>, DStabBus, Static3PBus

All Known Implementing Classes:

AcscBusImpl, BaseAcscBusImpl, BaseDStabBusImpl, DStabBusImpl, Static3PBusImpl

public interface BaseAcscBus<TGen extends AcscGen,TLoad extends AcscLoad>
extends BaseAclfBus<TGen,TLoad>

A representation of the model object 'Bus'. * Notes 1) for NotContribute bus, z1,z2=Zload, z0=Zload if grounded. * only SolidGround and Ungrounded allowd for groundType * * --- --- --- --- * | | | | * z1 z2 z0 z0 * | | | | * - - - * SolidG UnG * * 2) for Contributing bus, z1=x1, z2=x2, z0=x0+3*GX_R if grounded. * * --- --- --- --- * | | | | * E --z1--| z2 z0+3*GX_R z0 z0 * | | | | * - - - * ZG SolidG UnG * * E could be 1.0/0deg or use LF voltage to calculate AcscBus could be extended using IAascBus interface

The following features are supported:

• Sc Code
• Three Seq Voltage
• Sc Gen Z1
• Sc Gen Z2
• Sc Gen Z0
• Sc Load Shunt Y1
• Sc Load Shunt Y2
• Sc Load Shunt Y0
• Sc Fixed Shunt Y0
• Sc Switched Shunt Y0
• Equiv Z1
• Equiv Z2
• Equiv Z0
• Grounding

See Also:

AcscPackage.getBaseAcscBus()

Method Summary

Modifier and Type	Method and Description
org.apache.commons.math3.complex.Complex	calYScii(SequenceCode seq, ScBusModelType scBusModelType) calculate bus yii for forming Y-matrix
org.apache.commons.math3.complex.Complex	getEquivZ0() Returns the value of the 'Equiv Z0' attribute.
org.apache.commons.math3.complex.Complex	getEquivZ1() Returns the value of the 'Equiv Z1' attribute.
org.apache.commons.math3.complex.Complex	getEquivZ2() Returns the value of the 'Equiv Z2' attribute.
BusScGrounding	getGrounding() Returns the value of the 'Grounding' containment reference.
BusScCode	getScCode() Returns the value of the 'Sc Code' attribute.
org.apache.commons.math3.complex.Complex	getScFixedShuntY0() Returns the value of the 'Sc Fixed Shunt Y0' attribute.
org.apache.commons.math3.complex.Complex	getScGenZ0() Returns the value of the 'Sc Gen Z0' attribute.
org.apache.commons.math3.complex.Complex	getScGenZ1() Returns the value of the 'Sc Gen Z1' attribute.
org.apache.commons.math3.complex.Complex	getScGenZ2() Returns the value of the 'Sc Gen Z2' attribute.
org.apache.commons.math3.complex.Complex	getScLoadShuntY0() Returns the value of the 'Sc Load Shunt Y0' attribute.
org.apache.commons.math3.complex.Complex	getScLoadShuntY1() Returns the value of the 'Sc Load Shunt Y1' attribute.
org.apache.commons.math3.complex.Complex	getScLoadShuntY2() Returns the value of the 'Sc Load Shunt Y2' attribute.
org.apache.commons.math3.complex.Complex	getScSwitchedShuntY0() Returns the value of the 'Sc Switched Shunt Y0' attribute.
Complex3x1	getThreeSeqVoltage() Returns the value of the 'Three Seq Voltage' attribute.
boolean	initSeqEquivLoad(SequenceCode seq) init a specific sequence bus equivalent load based on bus Load info.
void	resetSeqEquivLoad() reset bus equivalent load, i.e., equivZ1 = equivZ2 = equivZ0 = LARGE_Z
void	setGrounding(BusScGrounding value) Sets the value of the 'Grounding' containment reference.
void	setScCode(BusScCode value) Sets the value of the 'Sc Code' attribute.
void	setScFixedShuntY0(org.apache.commons.math3.complex.Complex value) Sets the value of the 'Sc Fixed Shunt Y0' attribute.
void	setScGenZ(org.apache.commons.math3.complex.Complex z1, org.apache.commons.math3.complex.Complex z2, org.apache.commons.math3.complex.Complex z0, Unit.UnitType unit)
void	setScGenZ(org.apache.commons.math3.complex.Complex z, SequenceCode seq) Set bus Z in pu
void	setScGenZ(org.apache.commons.math3.complex.Complex z, SequenceCode seq, Unit.UnitType unit) Set bsu Z in the unit specified
void	setScGenZ0(org.apache.commons.math3.complex.Complex value) Sets the value of the 'Sc Gen Z0' attribute.
void	setScGenZ1(org.apache.commons.math3.complex.Complex value) Sets the value of the 'Sc Gen Z1' attribute.
void	setScGenZ2(org.apache.commons.math3.complex.Complex value) Sets the value of the 'Sc Gen Z2' attribute.
void	setScLoadShuntY0(org.apache.commons.math3.complex.Complex value) Sets the value of the 'Sc Load Shunt Y0' attribute.
void	setScLoadShuntY1(org.apache.commons.math3.complex.Complex value) Sets the value of the 'Sc Load Shunt Y1' attribute.
void	setScLoadShuntY2(org.apache.commons.math3.complex.Complex value) Sets the value of the 'Sc Load Shunt Y2' attribute.
void	setScSwitchedShuntY0(org.apache.commons.math3.complex.Complex value) Sets the value of the 'Sc Switched Shunt Y0' attribute.
void	setThreeSeqVoltage(Complex3x1 value) Sets the value of the 'Three Seq Voltage' attribute.

Methods inherited from interface com.interpss.core.aclf.BaseAclfBus

acCurrentIntoNet, b11ii, b1ii, calLossPFactor, calNetGenResults, calNetLoadResults, calNetPQResults, getBusControl, getCompensator, getCompensatorList, getContributeGen, getContributeGenList, getContributeLoad, getContributeLoadList, getDesiredVoltAng, getDesiredVoltMag, getExpLoadP, getExpLoadQ, getExternalPowerIntoNet, getFunctionLoad, getGenCode, getGenP, getGenQ, getJii, getLoadCode, getLoadP, getLoadP, getLoadQ, getLoadQ, getLossCumTDPath, getPGenLimit, getQGenLimit, getRemoteQControlGroup, getShuntY, getSwitchedShuntList, getVLimit, getVoltageAng, getVoltageMag, mismatch, powerIntoNet, setBusControl, setDesiredVoltAng, setDesiredVoltMag, setExpLoadP, setExpLoadQ, setExternalPowerIntoNet, setFunctionLoad, setGenCode, setGenP, setGenQ, setLoadCode, setLoadP, setLoadQ, setLossCumTDPath, setPGenLimit, setQGenLimit, setRemoteQControlGroup, setShuntY, setVLimit, setVoltageAng, setVoltageMag, yii

Methods inherited from interface com.interpss.core.net.Bus

getBaseVoltage, getBranchList, getConnectedBranch, getFromBranchList, getMerge2BusId, getNetwork, getSubAreaFlag, getSubstation, getSubstationId, getToBranchList, isIslandBus, nActiveBranchConnected, nBranchConnected, nBranchConnected, nNonGroundBranchConnected, setAttributes, setAttributes, setBaseVoltage, setBaseVoltage, setMerge2BusId, setNetwork, setSubAreaFlag, setSubstation, setSubstationId, toString

Methods inherited from interface com.interpss.core.net.ExtensionElement

getExtensionObject, setExtensionObject

Methods inherited from interface com.interpss.core.net.NetworkedElement

getArea, getAreaId, getExtSeqNumber, getIntFlag, getOwner, getOwnerId, getSortNumber, getWeight, getZone, getZoneId, isBooleanFlag, setArea, setAreaId, setBooleanFlag, setExtSeqNumber, setIntFlag, setOwner, setOwnerId, setSortNumber, setWeight, setZone, setZoneId

Methods inherited from interface com.interpss.core.net.NameTag

checkData, checkData, getDesc, getId, getName, getNumber, getStatusChangeInfo, hzCopy, isActive, isStatus, jsonCopy, setDesc, setId, setName, setNumber, setStatus, setStatusChangeInfo

Methods inherited from interface org.eclipse.emf.ecore.EObject

eAllContents, eClass, eContainer, eContainingFeature, eContainmentFeature, eContents, eCrossReferences, eGet, eGet, eInvoke, eIsProxy, eIsSet, eResource, eSet, eUnset

Methods inherited from interface org.eclipse.emf.common.notify.Notifier

eAdapters, eDeliver, eNotify, eSetDeliver

Methods inherited from interface com.hazelcast.nio.serialization.DataSerializable

readData, writeData

Methods inherited from interface com.interpss.core.aclf.IAclfBus

getVoltage, getVoltage, getVoltageAng, getVoltageMag, isCapacitor, isConstILoad, isConstPLoad, isConstZLoad, isGen, isGenPQ, isGenPV, isLoad, isLoadPV, isNonContribute, isPV, isRefBus, isSwing, setVoltage, setVoltage, setVoltage, updateVoltage, updateVoltageAng, updateVoltageMag

Methods inherited from interface com.interpss.core.aclf.IAclfBusFunc

allocateContributeGenQ, code2String, distributeLoad, initContributeGen, initContributeLoad, noConnectedBranch, voltageViolation

Methods inherited from interface com.interpss.core.aclf.IAclfBusZeroZFunc

findZeroZPathBuses, getNoConnectedZbr, hasZbrLoop, isConnect2ZeroZBranch

Methods inherited from interface com.interpss.core.aclf.IAclfBusAdaptation

toCapacitorBus, toGenBus, toLoadBus, toPQBus, toPVBus, toSwingBus

Methods inherited from interface com.interpss.core.aclf.IAclfBusAdjustment

getPQBusLimit, getPVBusLimit, getRemoteQBus, getStaticVarCompensator, getSwitchedShunt, isFunctionLoad, isPQBusLimit, isPVBusLimit, isRemoteQBus, isRemoteQControlGroup, isStaticVarCompensator, isSwitchedShunt

Method Detail

getScCode

BusScCode getScCode()

Returns the value of the 'Sc Code' attribute. The default value is "NonContri". The literals are from the enumeration BusScCode.

If the meaning of the 'Sc Code' attribute isn't clear, there really should be more of a description here...

Acsc bus code

Returns:

the value of the 'Sc Code' attribute.

See Also:

BusScCode, setScCode(BusScCode), AcscPackage.getBaseAcscBus_ScCode()

setScCode

void setScCode(BusScCode value)

Sets the value of the 'Sc Code' attribute.

Parameters:

value - the new value of the 'Sc Code' attribute.

See Also:

BusScCode, getScCode()

getScGenZ1

org.apache.commons.math3.complex.Complex getScGenZ1()

Returns the value of the 'Sc Gen Z1' attribute.

If the meaning of the 'Z1' attribute isn't clear, there really should be more of a description here...

Equiv acsc generator z1, its value will be calculated automotically if there are AcscGen objects defined for the bus.

Returns:

the value of the 'Sc Gen Z1' attribute.

See Also:

setScGenZ1(Complex), AcscPackage.getBaseAcscBus_ScGenZ1()

setScGenZ1

void setScGenZ1(org.apache.commons.math3.complex.Complex value)

Sets the value of the 'Sc Gen Z1' attribute.

Parameters:

value - the new value of the 'Sc Gen Z1' attribute.

See Also:

getScGenZ1()

getScGenZ2

org.apache.commons.math3.complex.Complex getScGenZ2()

Returns the value of the 'Sc Gen Z2' attribute.

If the meaning of the 'Z2' attribute isn't clear, there really should be more of a description here...

Equiv acsc generator z2, its value will be calculated automotically if there are AcscGen objects defined for the bus.

Returns:

the value of the 'Sc Gen Z2' attribute.

See Also:

setScGenZ2(Complex), AcscPackage.getBaseAcscBus_ScGenZ2()

setScGenZ2

void setScGenZ2(org.apache.commons.math3.complex.Complex value)

Sets the value of the 'Sc Gen Z2' attribute.

Parameters:

value - the new value of the 'Sc Gen Z2' attribute.

See Also:

getScGenZ2()

getScGenZ0

org.apache.commons.math3.complex.Complex getScGenZ0()

Returns the value of the 'Sc Gen Z0' attribute.

If the meaning of the 'Z0' attribute isn't clear, there really should be more of a description here...

Equiv acsc generator z0, its value will be calculated automotically if there are AcscGen objects defined for the bus.

Returns:

the value of the 'Sc Gen Z0' attribute.

See Also:

setScGenZ0(Complex), AcscPackage.getBaseAcscBus_ScGenZ0()

setScGenZ0

void setScGenZ0(org.apache.commons.math3.complex.Complex value)

Sets the value of the 'Sc Gen Z0' attribute.

Parameters:

value - the new value of the 'Sc Gen Z0' attribute.

See Also:

getScGenZ0()

getScLoadShuntY1

org.apache.commons.math3.complex.Complex getScLoadShuntY1()

Returns the value of the 'Sc Load Shunt Y1' attribute. Acsc equiv load shunt y1

Returns:

the value of the 'Sc Load Shunt Y1' attribute.

See Also:

setScLoadShuntY1(Complex), AcscPackage.getBaseAcscBus_ScLoadShuntY1()

setScLoadShuntY1

void setScLoadShuntY1(org.apache.commons.math3.complex.Complex value)

Sets the value of the 'Sc Load Shunt Y1' attribute.

Parameters:

value - the new value of the 'Sc Load Shunt Y1' attribute.

See Also:

getScLoadShuntY1()

getScLoadShuntY2

org.apache.commons.math3.complex.Complex getScLoadShuntY2()

Returns the value of the 'Sc Load Shunt Y2' attribute. Acsc eqiv load shunt y2

Returns:

the value of the 'Sc Load Shunt Y2' attribute.

See Also:

setScLoadShuntY2(Complex), AcscPackage.getBaseAcscBus_ScLoadShuntY2()

setScLoadShuntY2

void setScLoadShuntY2(org.apache.commons.math3.complex.Complex value)

Sets the value of the 'Sc Load Shunt Y2' attribute.

Parameters:

value - the new value of the 'Sc Load Shunt Y2' attribute.

See Also:

getScLoadShuntY2()

getScLoadShuntY0

org.apache.commons.math3.complex.Complex getScLoadShuntY0()

Returns the value of the 'Sc Load Shunt Y0' attribute. Acsc eqiv load shunt y0

Returns:

the value of the 'Sc Load Shunt Y0' attribute.

See Also:

setScLoadShuntY0(Complex), AcscPackage.getBaseAcscBus_ScLoadShuntY0()

setScLoadShuntY0

void setScLoadShuntY0(org.apache.commons.math3.complex.Complex value)

Sets the value of the 'Sc Load Shunt Y0' attribute.

Parameters:

value - the new value of the 'Sc Load Shunt Y0' attribute.

See Also:

getScLoadShuntY0()

getScSwitchedShuntY0

org.apache.commons.math3.complex.Complex getScSwitchedShuntY0()

Returns the value of the 'Sc Switched Shunt Y0' attribute. Acsc switched shunt y0

Returns:

the value of the 'Sc Switched Shunt Y0' attribute.

See Also:

setScSwitchedShuntY0(Complex), AcscPackage.getBaseAcscBus_ScSwitchedShuntY0()

setScSwitchedShuntY0

void setScSwitchedShuntY0(org.apache.commons.math3.complex.Complex value)

Sets the value of the 'Sc Switched Shunt Y0' attribute.

Parameters:

value - the new value of the 'Sc Switched Shunt Y0' attribute.

See Also:

getScSwitchedShuntY0()

getScFixedShuntY0

org.apache.commons.math3.complex.Complex getScFixedShuntY0()

Returns the value of the 'Sc Fixed Shunt Y0' attribute. Fixed SC load shunt y0

Returns:

the value of the 'Sc Fixed Shunt Y0' attribute.

See Also:

setScFixedShuntY0(Complex), AcscPackage.getBaseAcscBus_ScFixedShuntY0()

setScFixedShuntY0

void setScFixedShuntY0(org.apache.commons.math3.complex.Complex value)

Sets the value of the 'Sc Fixed Shunt Y0' attribute.

Parameters:

value - the new value of the 'Sc Fixed Shunt Y0' attribute.

See Also:

getScFixedShuntY0()

getEquivZ1

org.apache.commons.math3.complex.Complex getEquivZ1()

Returns the value of the 'Equiv Z1' attribute. acsc bus equiv z1. It is internally calculated. It is not changable.

Returns:

the value of the 'Equiv Z1' attribute.

See Also:

AcscPackage.getBaseAcscBus_EquivZ1()

getEquivZ2

org.apache.commons.math3.complex.Complex getEquivZ2()

Returns the value of the 'Equiv Z2' attribute. acsc bus equiv z2. It is internally calculated. It is not changable.

Returns:

the value of the 'Equiv Z2' attribute.

See Also:

AcscPackage.getBaseAcscBus_EquivZ2()

getEquivZ0

org.apache.commons.math3.complex.Complex getEquivZ0()

Returns the value of the 'Equiv Z0' attribute. acsc bus equiv z0. It is internally calculated. It is not changable.

Returns:

the value of the 'Equiv Z0' attribute.

See Also:

AcscPackage.getBaseAcscBus_EquivZ0()

getGrounding

BusScGrounding getGrounding()

Returns the value of the 'Grounding' containment reference.

If the meaning of the 'Grounding' containment reference list isn't clear, there really should be more of a description here...

Bus SC grounding

Returns:

the value of the 'Grounding' containment reference.

See Also:

setGrounding(BusScGrounding), AcscPackage.getBaseAcscBus_Grounding()

setGrounding

void setGrounding(BusScGrounding value)

Sets the value of the 'Grounding' containment reference.

Parameters:

value - the new value of the 'Grounding' containment reference.

See Also:

getGrounding()

calYScii

org.apache.commons.math3.complex.Complex calYScii(SequenceCode seq,
                                                  ScBusModelType scBusModelType)

calculate bus yii for forming Y-matrix

Parameters:

seq - sequence

scBusModelType - sequence

setScGenZ

void setScGenZ(org.apache.commons.math3.complex.Complex z,
               SequenceCode seq)

Set bus Z in pu

Parameters:

z - z value

seq - sequence

setScGenZ

void setScGenZ(org.apache.commons.math3.complex.Complex z,
               SequenceCode seq,
               Unit.UnitType unit)

Set bsu Z in the unit specified

Parameters:

z - z value

seq - sequence

unit - z unit

setScGenZ

void setScGenZ(org.apache.commons.math3.complex.Complex z1,
               org.apache.commons.math3.complex.Complex z2,
               org.apache.commons.math3.complex.Complex z0,
               Unit.UnitType unit)

Parameters:

z1 - positive sequence z

z2 - negative sequence z

z0 - zero sequence z

unit - z unit

initSeqEquivLoad

boolean initSeqEquivLoad(SequenceCode seq)

init a specific sequence bus equivalent load based on bus Load info.

Parameters:

seq - sequence

resetSeqEquivLoad

void resetSeqEquivLoad()

reset bus equivalent load, i.e., equivZ1 = equivZ2 = equivZ0 = LARGE_Z

getThreeSeqVoltage

Complex3x1 getThreeSeqVoltage()

Returns the value of the 'Three Seq Voltage' attribute. Bus SC 012 voltage

Returns:

the value of the 'Three Seq Voltage' attribute.

See Also:

setThreeSeqVoltage(Complex3x1), AcscPackage.getBaseAcscBus_ThreeSeqVoltage()

setThreeSeqVoltage

void setThreeSeqVoltage(Complex3x1 value)

Sets the value of the 'Three Seq Voltage' attribute.

Parameters:

value - the new value of the 'Three Seq Voltage' attribute.

See Also:

getThreeSeqVoltage()