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, IAcscBus, IAdaptable, IBusSwitchBreakModel, NameTag, NetworkedElement, org.eclipse.emf.common.notify.Notifier

All Known Subinterfaces:

AcscBus, BaseDStabBus<TGen,TLoad>, DStabBus, Dynamic3PBus, Steady3PBus

All Known Implementing Classes:

AcscBusImpl, BaseAcscBusImpl, BaseDStabBusImpl, DStabBusImpl, Dynamic3PBusImpl, Steady3PBusImpl

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

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
• Seq Data Initialized
• Pos Seq Data Initialized
• Neg Seq Data Initialized
• Zero Seq Data Initialized
• Sc Gen Z1
• Sc Gen Z2
• Sc Gen Z0
• Sc Load Shunt Y1
• Sc Load Shunt Y2
• Sc Load Shunt Y0
• Three Seq Voltage
• Sc Fixed Shunt Y0
• Sc Switched Shunt Y0
• Equiv Z1
• Equiv Z2
• Equiv Z0
• Grounding

See Also:

AcscPackage.getBaseAcscBus()

Field Summary

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

copyright

Fields inherited from interface com.interpss.core.acsc.IAcscBus

copyright

Method Summary

Modifier and Type	Method and Description
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.
boolean	isNegSeqDataInitialized() Returns the value of the 'Neg Seq Data Initialized' attribute.
boolean	isPosSeqDataInitialized() Returns the value of the 'Pos Seq Data Initialized' attribute.
boolean	isSeqDataInitialized() Returns the value of the 'Seq Data Initialized' attribute.
boolean	isZeroSeqDataInitialized() Returns the value of the 'Zero Seq Data Initialized' attribute.
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	setNegSeqDataInitialized(boolean value) Sets the value of the 'Neg Seq Data Initialized' attribute.
void	setPosSeqDataInitialized(boolean value) Sets the value of the 'Pos Seq Data Initialized' attribute.
void	setScCode(BusScCode value) Sets the value of the 'Sc Code' attribute.
void	setScFixedShuntY0(org.apache.commons.math3.complex.Complex fixedShuntY0) 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	setSeqDataInitialized(boolean value) Sets the value of the 'Seq Data Initialized' attribute.
void	setThreeSeqVoltage(Complex3x1 value) Sets the value of the 'Three Seq Voltage' attribute.
void	setZeroSeqDataInitialized(boolean value) Sets the value of the 'Zero Seq Data Initialized' attribute.
org.apache.commons.math3.complex.Complex	yScii(SequenceCode seq) calculate bus yii for forming Y-matrix

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

b11ii, b1ii, currentIntoNet, getBusControl, getCapacitorB, getContributeGen, getContributeGenList, getContributeLoad, getContributeLoadList, getDclfInjectP, getDesiredVoltAng, getDesiredVoltMag, getExpLoadP, getExpLoadQ, getFunctionLoad, getGenCode, getGenP, getGenPartFactor, getGenPQ, getGenQ, getJii, getLoadCode, getLoadDistFactor, getLoadP, getLoadPQ, getLoadQ, getLossCumTDPath, getLossPFactor, getNetGenResults, getNetLoadResults, getNetPQResults, getPGenLimit, getQGenLimit, getShuntY, getSwitchedShuntDevice, getVLimit, getVoltage, getVoltage, getVoltageAng, getVoltageAng, getVoltageMag, getVoltageMag, isConstILoad, isConstPLoad, isConstZLoad, isGen, powerIntoNet, setBusControl, setCapacitorB, setDclfInjectP, setDesiredVoltAng, setDesiredVoltMag, setExpLoadP, setExpLoadQ, setFunctionLoad, setGenCode, setGenP, setGenPartFactor, setGenQ, setLoadCode, setLoadDistFactor, setLoadP, setLoadPQ, setLoadQ, setLossCumTDPath, setNetLoadResults, setPGenLimit, setQGenLimit, setShuntY, setSwitchedShuntDevice, setVLimit, setVoltage, setVoltage, setVoltage, setVoltageAng, setVoltageMag, updateVoltage, updateVoltageAng, updateVoltageMag, yii

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

getBaseVoltage, getBranchList, getBusSecList, getFromBranchList, getNetwork, getParent, getSecNo, getSubAreaFlag, getToBranchList, nActiveBranchConnected, nBranchConnected, nBranchConnected, nNonGroundBranchConnected, setAttributes, setAttributes, setBaseVoltage, setBaseVoltage, setNetwork, setParent, setSecNo, setSubAreaFlag, toString

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

getExtensionObject, setExtensionObject

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

getArea, getIntFlag, getOwner, getSortNumber, getWeight, getZone, isBooleanFlag, setArea, setBooleanFlag, setIntFlag, setOwner, setSortNumber, setWeight, setZone

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

checkData, checkData, copy, copyRef, getDesc, getId, getName, getNumber, isActive, isStatus, setDesc, setId, setName, setNumber, setStatus

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.net.IAdaptable

getAdapter, getAdapter

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

addSection, addSection, getConnectedPhysicalBranch, getConnectedPhysicalBranchList, getSection, isChildSection, isIslandBus, isParent, removeSection

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

getExtAclfBus, isCapacitor, isGenPQ, isGenPV, isLoad, isNonContribute, isRefBus, isSwing, mismatch

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

allocateContributeGenQ, code2String, connect2ZeroZBranch, findZeroZPathBuses, getDclfBusP, initContributeGen, initContributeLoad, noConnectedBranch, voltageViolation

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, isStaticVarCompensator, isSwitchedShunt

Methods inherited from interface com.interpss.core.acsc.IAcscBus

getGroundCode, getGroundZ

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()

isSeqDataInitialized

boolean isSeqDataInitialized()

Returns the value of the 'Seq Data Initialized' attribute.

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

Returns:

the value of the 'Seq Data Initialized' attribute.

See Also:

setSeqDataInitialized(boolean), AcscPackage.getBaseAcscBus_SeqDataInitialized()

setSeqDataInitialized

void setSeqDataInitialized(boolean value)

Sets the value of the 'Seq Data Initialized' attribute.

Parameters:

value - the new value of the 'Seq Data Initialized' attribute.

See Also:

isSeqDataInitialized()

isPosSeqDataInitialized

boolean isPosSeqDataInitialized()

Returns the value of the 'Pos Seq Data Initialized' attribute.

If the meaning of the 'Pos Seq Data Initialized' attribute isn't clear, there really should be more of a description here...

Returns:

the value of the 'Pos Seq Data Initialized' attribute.

See Also:

setPosSeqDataInitialized(boolean), AcscPackage.getBaseAcscBus_PosSeqDataInitialized()

setPosSeqDataInitialized

void setPosSeqDataInitialized(boolean value)

Sets the value of the 'Pos Seq Data Initialized' attribute.

Parameters:

value - the new value of the 'Pos Seq Data Initialized' attribute.

See Also:

isPosSeqDataInitialized()

isNegSeqDataInitialized

boolean isNegSeqDataInitialized()

Returns the value of the 'Neg Seq Data Initialized' attribute.

If the meaning of the 'Neg Seq Data Initialized' attribute isn't clear, there really should be more of a description here...

Returns:

the value of the 'Neg Seq Data Initialized' attribute.

See Also:

setNegSeqDataInitialized(boolean), AcscPackage.getBaseAcscBus_NegSeqDataInitialized()

setNegSeqDataInitialized

void setNegSeqDataInitialized(boolean value)

Sets the value of the 'Neg Seq Data Initialized' attribute.

Parameters:

value - the new value of the 'Neg Seq Data Initialized' attribute.

See Also:

isNegSeqDataInitialized()

isZeroSeqDataInitialized

boolean isZeroSeqDataInitialized()

Returns the value of the 'Zero Seq Data Initialized' attribute.

If the meaning of the 'Zero Seq Data Initialized' attribute isn't clear, there really should be more of a description here...

Returns:

the value of the 'Zero Seq Data Initialized' attribute.

See Also:

setZeroSeqDataInitialized(boolean), AcscPackage.getBaseAcscBus_ZeroSeqDataInitialized()

setZeroSeqDataInitialized

void setZeroSeqDataInitialized(boolean value)

Sets the value of the 'Zero Seq Data Initialized' attribute.

Parameters:

value - the new value of the 'Zero Seq Data Initialized' attribute.

See Also:

isZeroSeqDataInitialized()

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.

Specified by:

getScGenZ1 in interface IAcscBus

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.

Specified by:

getScGenZ2 in interface IAcscBus

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.

Specified by:

getScGenZ0 in interface IAcscBus

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. Acsc switched shunt y0

Returns:

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

See Also:

setScSwitchedShuntY0(Complex), com.interpss.core.acsc.AcscPackage#getAcscBus_ScSwitchedShuntY0()

setScFixedShuntY0

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

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()

yScii

org.apache.commons.math3.complex.Complex yScii(SequenceCode seq)

calculate bus yii for forming Y-matrix

Parameters:

seq - 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()