public interface Network<TBus extends Bus,TBranch extends Branch> extends NameTag, IChildNet
The following features are supported:
NetPackage.getNetwork()
Modifier and Type | Method and Description |
---|---|
boolean |
accept(INetBVisitor<?,?> visitor)
accept a visitor to visit the Network object.
|
void |
addArea(Area area)
Add the area object into the Network, if it not exists in the network.
|
boolean |
addBranch(TBranch branch)
Add the branch object into the network container.
|
boolean |
addBranch(TBranch branch,
java.lang.String fromBusId,
java.lang.String toBusId)
Add the branch object into the network container and connect to the from bus and to bus identified by the Id(s) with default circuit number.
|
boolean |
addBranch(TBranch branch,
java.lang.String fromBusId,
java.lang.String toBusId,
java.lang.String cirId)
Add the branch object into the network container and connect to the from bus and to bus identified by the Id(s).
|
boolean |
addBranch2Cache(TBranch branch)
Add the branch object into the cache HashMap.
|
boolean |
addBranch2Cache(TBranch branch,
java.lang.String fromBusId,
java.lang.String toBusId)
Add the branch object into the cache HashMap and connect to the from bus and to bus identified by the Id(s) with default circuit number.
|
boolean |
addBranch2Cache(TBranch branch,
java.lang.String fromBusId,
java.lang.String toBusId,
java.lang.String cirId)
Add the branch object into the the cache HashMap and connect to the from
bus and to bus identified by the Id(s).
|
boolean |
addBus(TBus bus)
Add the bus object into the network container.
|
boolean |
addBus2Cache(TBus bus)
Add the bus object into the cache HashMap.
|
boolean |
addGroundBranch(TBranch branch,
java.lang.String busId)
Add a grpund branch object into the network container and connect to the
bus with default circuit number.
|
void |
addOwner(Owner owner)
Add the owner object into the Network, if it not exists in the network.
|
void |
addSubstation(Substation substation)
Add the substation object into the Network, if it not exists in the network.
|
java.util.Optional<TieLine> |
addTieLine(java.lang.String meteredBusId,
int meteredAreaNo,
java.lang.String nonMeteredBusId,
int nonMeteredAreaNo,
java.lang.String cirNo)
Add a TieLine into the Network
|
void |
addZone(Zone zone)
Add the zone object into the Network, if it not exists in the network.
|
void |
arrangeBusNumber()
arrange bus sort number
|
boolean |
cachedBranches2Net()
transfer the cached branch objects into the network container.
|
boolean |
cachedBuses2Net()
transfer the cached bus objects into the network container.
|
ISparseEqnInteger |
formAdjacencyMatrix()
form the adjacency matrix, based on the bus.sortNumber
|
Area |
getArea(long areaNumber)
Get the area object by the area number
|
Area |
getArea(java.lang.String areaId)
Get the area object by the area name
|
java.util.Map<java.lang.String,Area> |
getAreaMap()
Returns the value of the 'Area Map' attribute.
|
double |
getBaseKva()
Returns the value of the 'Base Kva' attribute.
|
double |
getBaseMva()
get network base MVA
|
TBranch |
getBranch(java.lang.String branchId)
Get the branch object identified by the branch id.
|
TBranch |
getBranch(java.lang.String fromBusId,
java.lang.String toBusId,
java.lang.String circuitNumber)
Get the branch object identified by the from bus id,
to bus id and branch circuit number.
|
TBranch |
getBranch(java.lang.String fromBusId,
java.lang.String toBusId,
java.lang.String circuitNumber,
boolean dirSensitive)
Get the branch object identified by the from bus id,
to bus id and branch circuit number.
|
java.util.List<Branch> |
getBranches(java.lang.String fromBusId,
java.lang.String toBusId)
Get the branch object identified by the from bus id and to bus id.
|
java.util.List<Branch> |
getBranches(java.lang.String fromBusId,
java.lang.String toBusId,
boolean dirSensitive)
Get the branch object(s) identified by the from bus id and to bus id.
|
org.eclipse.emf.common.util.EList<TBranch> |
getBranchList()
Returns the value of the 'Branch List' reference list.
|
TBus |
getBus(int sortNumber)
Get the bus object identified by the id.
|
TBus |
getBus(java.lang.String id)
Get the bus object identified by the id.
|
org.eclipse.emf.common.util.EList<TBus> |
getBusList()
Returns the value of the 'Bus List' reference list.
|
org.eclipse.emf.common.util.EList<ChildNetworkWrapper<?,?>> |
getChildNetWrapperList()
Returns the value of the 'Child Net Wrapper List' containment reference list.
|
java.util.Map<java.lang.String,java.lang.Object> |
getExtraInfo()
Returns the value of the 'Extra Info' attribute.
|
double |
getFrequency()
Returns the value of the 'Frequency' attribute.
|
int |
getNoActiveBranch()
return number of active branches in the network.
|
int |
getNoActiveBranch(boolean inclChildNet)
return number of active branches in the network.
|
int |
getNoActiveBus()
Return total number of active buses in the net
|
int |
getNoActiveBus(boolean inclChildNet)
Return total number of active buses in the net
|
int |
getNoBranch()
return number of branches in the network.
|
int |
getNoBranch(boolean inclChildNet)
return number of branches in the network.
|
int |
getNoBus()
Return total number of buses in the net
|
int |
getNoBus(boolean inclChildNet)
Return total number of buses in the net
|
OriginalDataFormat |
getOriginalDataFormat()
Returns the value of the 'Original Data Format' attribute.
|
Owner |
getOwner(int number)
Get the owner object with the specified the owner number.
|
Owner |
getOwner(java.lang.String ownerId)
Get the owner object with the specified the id.
|
java.util.Map<java.lang.String,Owner> |
getOwnerMap()
Returns the value of the 'Owner Map' attribute.
|
java.lang.String |
getRefBusId()
Get the ref bus id.
|
java.util.Set<java.lang.String> |
getRefBusIdSet()
Returns the value of the 'Ref Bus Id Set' attribute.
|
RefBusType |
getRefBusType()
Returns the value of the 'Ref Bus Type' attribute.
|
Substation |
getSubstation(java.lang.String substationName)
Get the substation object by substation name
|
java.util.Map<java.lang.String,Substation> |
getSubstationMap()
Returns the value of the 'Substation Map' attribute.
|
java.util.Map<java.lang.String,Substation> |
getSubstationMap(boolean inclChildNet)
Get the substation object by substation name
|
org.eclipse.emf.common.util.EList<TieLine> |
getTieLineList()
Returns the value of the 'Tie Line List' containment reference list.
|
java.time.LocalDateTime |
getTimeStamp()
Returns the value of the 'Time Stamp' attribute.
|
Zone |
getZone(long zoneNo)
Get the zone object by zone number.
|
Zone |
getZone(java.lang.String zoneId)
Get the zone object by zone name
|
java.util.Map<java.lang.String,Zone> |
getZoneMap()
Returns the value of the 'Zone Map' attribute.
|
boolean |
hasBranch(java.lang.String fromBusId,
java.lang.String toBusId)
Check if branch fromId->toBus with default circuit number exists in the network
|
boolean |
hasBranch(java.lang.String fromBusId,
java.lang.String toBusId,
java.lang.String cirId)
Check if branch fromId->toBus(cirId) exists in the network
|
boolean |
hasBus(java.lang.String busId)
Check if the network already contains a bus object with the busId
|
<T> T |
hzCopy()
Deprecated.
|
boolean |
isAllowGroundBranch()
Returns the value of the 'Allow Ground Branch' attribute.
|
boolean |
isBusNumberArranged()
Returns the value of the 'Bus Number Arranged' attribute.
|
boolean |
isBypassDataCheck()
Returns the value of the 'Bypass Data Check' attribute.
|
boolean |
isDataChecked()
Returns the value of the 'Data Checked' attribute.
|
boolean |
isOnlineModel()
Based on the original format, determine if the model is a online model.
|
boolean |
isRefBus(Bus bus)
check if the bus is a reference bus
|
java.lang.String |
net2String()
Transform all elements in the network to a string for print out purpose.
|
void |
rebuildLookupTable()
Rebuilt the network object lookup table, for example, after the network is recreated by de-serialization.
|
boolean |
removeBranch(java.lang.String branchId)
Remove the branch object with the branchId from the network container.
|
boolean |
removeBranch(java.lang.String fromBusId,
java.lang.String toBusId,
java.lang.String cirNumber)
Remove the branch object connected to the buses from the network container.
|
boolean |
removeBranch(TBus fromBus,
TBus toBus,
java.lang.String cirNumber)
Remove the branch object connected to the buses from the network container.
|
boolean |
removeBus(java.lang.String busId)
Remove the bus object identified by the busId from the network container.
|
boolean |
removeBus(TBus bus)
Remove the bus object from the network container.
|
boolean |
removeTieLine(java.lang.String tieLineId)
Remove the TieLine object from the Network container.
|
boolean |
replaceBus(java.lang.String busId,
TBus bus)
replace the bus object (same busid) in the network container.
|
void |
setAllowGroundBranch(boolean value)
Sets the value of the '
Allow Ground Branch ' attribute. |
void |
setBaseKva(double value)
Sets the value of the '
Base Kva ' attribute. |
void |
setBusNumberArranged(boolean value)
Sets the value of the '
Bus Number Arranged ' attribute. |
void |
setBypassDataCheck(boolean value)
Sets the value of the '
Bypass Data Check ' attribute. |
void |
setDataChecked(boolean value)
Sets the value of the '
Data Checked ' attribute. |
void |
setExtraInfo(java.util.Map<java.lang.String,java.lang.Object> value)
Sets the value of the '
Extra Info ' attribute. |
void |
setFrequency(double value)
Sets the value of the '
Frequency ' attribute. |
void |
setOriginalDataFormat(OriginalDataFormat value)
Sets the value of the '
Original Data Format ' attribute. |
void |
setRefBusId(java.lang.String busId)
Set the ref bus id.
|
void |
setRefBusIdSet(java.util.Set<java.lang.String> value)
Sets the value of the '
Ref Bus Id Set ' attribute. |
void |
setRefBusType(RefBusType value)
Sets the value of the '
Ref Bus Type ' attribute. |
void |
setTimeStamp(java.time.LocalDateTime value)
Sets the value of the '
Time Stamp ' attribute. |
void |
setToEmpty()
Set the network to empty, including remove all elements from the areaList, busList and branchList ...
|
void |
setVisitedStatus(boolean status)
Set bus and branch objects visited status
|
void |
updateBranchId(java.lang.String branchId)
After changing branch-bus connection relationship, it is used to update branchId.
|
checkData, checkData, getDesc, getId, getName, getNumber, getStatusChangeInfo, hzCopy, isActive, isStatus, jsonCopy, setDesc, setId, setName, setNumber, setStatus, setStatusChangeInfo
readData, writeData
getChildNetWrapper, hasChildNet
java.time.LocalDateTime getTimeStamp()
setTimeStamp(LocalDateTime)
,
NetPackage.getNetwork_TimeStamp()
void setTimeStamp(java.time.LocalDateTime value)
Time Stamp
' attribute.
value
- the new value of the 'Time Stamp' attribute.getTimeStamp()
double getBaseKva()
"100000"
.
If the meaning of the 'Base Kva' attribute isn't clear, there really should be more of a description here...
Base Kva in unit KVA.setBaseKva(double)
,
NetPackage.getNetwork_BaseKva()
void setBaseKva(double value)
Base Kva
' attribute.
value
- the new value of the 'Base Kva' attribute.getBaseKva()
double getFrequency()
"50"
.
System base frequency in Hz
setFrequency(double)
,
NetPackage.getNetwork_Frequency()
void setFrequency(double value)
Frequency
' attribute.
value
- the new value of the 'Frequency' attribute.getFrequency()
boolean isBusNumberArranged()
"false"
.
If the meaning of the 'Bus Number Arranged' attribute isn't clear, there really should be more of a description here...
An indicator of bus number arrangement statussetBusNumberArranged(boolean)
,
NetPackage.getNetwork_BusNumberArranged()
void setBusNumberArranged(boolean value)
Bus Number Arranged
' attribute.
value
- the new value of the 'Bus Number Arranged' attribute.isBusNumberArranged()
boolean isDataChecked()
"false"
.
If the meaning of the 'Data Checked' attribute isn't clear, there really should be more of a description here...
set to true after the data has been checked.setDataChecked(boolean)
,
NetPackage.getNetwork_DataChecked()
void setDataChecked(boolean value)
Data Checked
' attribute.
value
- the new value of the 'Data Checked' attribute.isDataChecked()
boolean isBypassDataCheck()
"false"
.
If the meaning of the 'Bypass Data Check' attribute isn't clear, there really should be more of a description here...
set to true if bypass the data check is needed.setBypassDataCheck(boolean)
,
NetPackage.getNetwork_BypassDataCheck()
void setBypassDataCheck(boolean value)
Bypass Data Check
' attribute.
value
- the new value of the 'Bypass Data Check' attribute.isBypassDataCheck()
boolean isAllowGroundBranch()
"false"
.
If the meaning of the 'Allow Ground Branch' attribute isn't clear, there really should be more of a description here...
An indicator for allowing branch branch, which connect to a bus and the ground.setAllowGroundBranch(boolean)
,
NetPackage.getNetwork_AllowGroundBranch()
void setAllowGroundBranch(boolean value)
Allow Ground Branch
' attribute.
value
- the new value of the 'Allow Ground Branch' attribute.isAllowGroundBranch()
org.eclipse.emf.common.util.EList<TBus> getBusList()
If the meaning of the 'Bus List' containment reference list isn't clear, there really should be more of a description here...
bus list containing bus objectsNetPackage.getNetwork_BusList()
org.eclipse.emf.common.util.EList<TBranch> getBranchList()
If the meaning of the 'Branch List' containment reference list isn't clear, there really should be more of a description here...
branch list containing branch objects for 2W branches, which will be represented in the Y-matrix.NetPackage.getNetwork_BranchList()
void addArea(Area area)
void addZone(Zone zone)
void addSubstation(Substation substation)
void addOwner(Owner owner)
Area getArea(long areaNumber)
areaNumber
- area number
Area getArea(java.lang.String areaId)
areaId
- area Id
Zone getZone(long zoneNo)
zoneNo
- zone number
Zone getZone(java.lang.String zoneId)
zoneId
- zone id
Substation getSubstation(java.lang.String substationName)
substationName
- substation name
Owner getOwner(java.lang.String ownerId)
ownerId
- owner id
Owner getOwner(int number)
number
- owner number
java.util.Optional<TieLine> addTieLine(java.lang.String meteredBusId, int meteredAreaNo, java.lang.String nonMeteredBusId, int nonMeteredAreaNo, java.lang.String cirNo)
meteredBusId
- metered bus idmeteredAreaNo
- metered area numbernonMeteredBusId
- non metered bus idnonMeteredAreaNo
- non metered area numbercirNo
- tie line reference branch circuit id
boolean removeTieLine(java.lang.String tieLineId)
tieLineId
- tie line id
void setVisitedStatus(boolean status)
status
- area number
org.eclipse.emf.common.util.EList<TieLine> getTieLineList()
TieLine
.
It is bidirectional and its opposite is 'Network
'.
If the meaning of the 'Tie Line List' containment reference list isn't clear, there really should be more of a description here...
Tieline list containing tieline objectsNetPackage.getNetwork_TieLineList()
,
TieLine.getNetwork()
java.util.Map<java.lang.String,java.lang.Object> getExtraInfo()
""
.
extra info map for the model extension purpose.
setExtraInfo(Map)
,
NetPackage.getNetwork_ExtraInfo()
void setExtraInfo(java.util.Map<java.lang.String,java.lang.Object> value)
Extra Info
' attribute.
value
- the new value of the 'Extra Info' attribute.getExtraInfo()
org.eclipse.emf.common.util.EList<ChildNetworkWrapper<?,?>> getChildNetWrapperList()
ChildNetworkWrapper
<?, ?>
.
It is bidirectional and its opposite is 'Parent Network
'.
child network list containing child network objects
NetPackage.getNetwork_ChildNetWrapperList()
,
ChildNetworkWrapper.getParentNetwork()
boolean isOnlineModel()
boolean accept(INetBVisitor<?,?> visitor)
OriginalDataFormat getOriginalDataFormat()
OriginalDataFormat
.
If the meaning of the 'Original Data Format' attribute isn't clear, there really should be more of a description here...
Original data formatOriginalDataFormat
,
setOriginalDataFormat(OriginalDataFormat)
,
NetPackage.getNetwork_OriginalDataFormat()
void setOriginalDataFormat(OriginalDataFormat value)
Original Data Format
' attribute.
value
- the new value of the 'Original Data Format' attribute.OriginalDataFormat
,
getOriginalDataFormat()
RefBusType getRefBusType()
"Swing"
.
The literals are from the enumeration RefBusType
.
If the meaning of the 'Ref Bus Type' attribute isn't clear, there really should be more of a description here...
Reference bus type (Swing or user defined). User defined often is needed for the sensitivity analysis. When the type is userDefined, the refBusId is used for defined the RefBus.RefBusType
,
setRefBusType(RefBusType)
,
NetPackage.getNetwork_RefBusType()
void setRefBusType(RefBusType value)
Ref Bus Type
' attribute.
value
- the new value of the 'Ref Bus Type' attribute.RefBusType
,
getRefBusType()
java.util.Set<java.lang.String> getRefBusIdSet()
""
.
When reference bus is of the type UserDefined, this attribute defines reference bus id set.
setRefBusIdSet(Set)
,
NetPackage.getNetwork_RefBusIdSet()
void setRefBusIdSet(java.util.Set<java.lang.String> value)
Ref Bus Id Set
' attribute.
value
- the new value of the 'Ref Bus Id Set' attribute.getRefBusIdSet()
java.util.Map<java.lang.String,Area> getAreaMap()
""
.
Area lookup table
NetPackage.getNetwork_AreaMap()
java.util.Map<java.lang.String,Zone> getZoneMap()
""
.
Zone lookup table
NetPackage.getNetwork_ZoneMap()
java.util.Map<java.lang.String,Owner> getOwnerMap()
""
.
Owner lookup table
NetPackage.getNetwork_OwnerMap()
java.util.Map<java.lang.String,Substation> getSubstationMap()
"false"
.
Substation lookup table
NetPackage.getNetwork_SubstationMap()
java.util.Map<java.lang.String,Substation> getSubstationMap(boolean inclChildNet)
inclChildNet
- flag to include the child network info
boolean isRefBus(Bus bus)
double getBaseMva()
void setToEmpty()
java.lang.String net2String()
int getNoBus()
int getNoBus(boolean inclChildNet)
inclChildNet
- flag to include the child network info
int getNoActiveBus()
int getNoActiveBus(boolean inclChildNet)
inclChildNet
- flag to include the child network info
boolean addBus(TBus bus)
bus
- bus object
boolean addBus2Cache(TBus bus)
bus
- bus object
boolean cachedBuses2Net()
boolean hasBus(java.lang.String busId)
busId
- bus id
java.lang.String getRefBusId()
void setRefBusId(java.lang.String busId)
busId
- from bus id
TBus getBus(java.lang.String id)
id
- bus id
TBus getBus(int sortNumber)
sortNumber
- bus sort number
boolean replaceBus(java.lang.String busId, TBus bus)
busId
- bus idbus
- the bus object with same id to be removed
void updateBranchId(java.lang.String branchId)
branchId
- branch id of the branch to be updated
boolean removeBus(java.lang.String busId)
busId
- bus id
boolean removeBus(TBus bus)
bus
- the bus object to be removed
int getNoBranch()
int getNoBranch(boolean inclChildNet)
inclChildNet
- flag to include the child network info
int getNoActiveBranch()
int getNoActiveBranch(boolean inclChildNet)
inclChildNet
- flag to include the child network info
boolean hasBranch(java.lang.String fromBusId, java.lang.String toBusId)
fromBusId
- from bus idtoBusId
- to bus id
boolean hasBranch(java.lang.String fromBusId, java.lang.String toBusId, java.lang.String cirId)
fromBusId
- from bus idtoBusId
- to bus idcirId
- branch circuit id
TBranch getBranch(java.lang.String branchId)
branchId
- branch id
java.util.List<Branch> getBranches(java.lang.String fromBusId, java.lang.String toBusId)
fromBusId
- from bus idtoBusId
- to bus id
TBranch getBranch(java.lang.String fromBusId, java.lang.String toBusId, java.lang.String circuitNumber)
fromBusId
- from bus idtoBusId
- to bus idcircuitNumber
- branch circuit number
java.util.List<Branch> getBranches(java.lang.String fromBusId, java.lang.String toBusId, boolean dirSensitive)
fromBusId
- from bus idtoBusId
- to bus iddirSensitive
- if set to true, branch search is direction sensitive
TBranch getBranch(java.lang.String fromBusId, java.lang.String toBusId, java.lang.String circuitNumber, boolean dirSensitive)
fromBusId
- from bus idtoBusId
- to bus idcircuitNumber
- branch circuit numberdirSensitive
- if set to true, branch search is direction sensitive
boolean addBranch(TBranch branch)
branch
- the branch object to be added
boolean addBranch2Cache(TBranch branch)
branch
- bus object
boolean cachedBranches2Net()
boolean addBranch(TBranch branch, java.lang.String fromBusId, java.lang.String toBusId)
branch
- the branch object to be addedfromBusId
- from bus idtoBusId
- to bus id
boolean addGroundBranch(TBranch branch, java.lang.String busId)
branch
- the branch object to be addedbusId
- from bus id
boolean addBranch2Cache(TBranch branch, java.lang.String fromBusId, java.lang.String toBusId)
branch
- the branch object to be addedfromBusId
- from bus idtoBusId
- to bus id
boolean addBranch(TBranch branch, java.lang.String fromBusId, java.lang.String toBusId, java.lang.String cirId)
branch
- the branch object to be addedfromBusId
- from bus idtoBusId
- to bus idcirId
- branch circuit id
boolean addBranch2Cache(TBranch branch, java.lang.String fromBusId, java.lang.String toBusId, java.lang.String cirId)
branch
- the branch object to be addedfromBusId
- from bus idtoBusId
- to bus idcirId
- branch circuit id
boolean removeBranch(java.lang.String fromBusId, java.lang.String toBusId, java.lang.String cirNumber)
fromBusId
- from bud idtoBusId
- to bus idcirNumber
- branch circuit number
boolean removeBranch(TBus fromBus, TBus toBus, java.lang.String cirNumber)
fromBus
- from bus objecttoBus
- to bus objectcirNumber
- branch circuit number
boolean removeBranch(java.lang.String branchId)
branchId
- branch id
void arrangeBusNumber()
void rebuildLookupTable()
ISparseEqnInteger formAdjacencyMatrix()
@Deprecated <T> T hzCopy()