com.powerdata.openpa.se

Class ObservableIslandList

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<T>

com.powerdata.openpa.impl.AbstractBaseList<T>

com.powerdata.openpa.impl.AbstractPAList<T>

com.powerdata.openpa.GroupListI<ObservableIslandList.ObservableIsland>

com.powerdata.openpa.se.ObservableIslandList

All Implemented Interfaces:

BaseList<ObservableIslandList.ObservableIsland>, GroupListIfc<ObservableIslandList.ObservableIsland>, java.lang.Iterable<ObservableIslandList.ObservableIsland>, java.util.Collection<ObservableIslandList.ObservableIsland>, java.util.List<ObservableIslandList.ObservableIsland>

public class ObservableIslandList
extends GroupListI<ObservableIslandList.ObservableIsland>

List of observable islands based on a USDOE paper, "Contribution to Power State Estimation and Transient Stability Analysis" , Feb 1984.

Measurement Telemetered status is not yet available directly in OpenPA or the PSIM CSV formats. As such, we look for non-zero measurements on devices connected to known-energized buses.

This class provides a list of observable islands built using ObsIslandBldrDOE (inner static class for now). This class has been tested only against a 24-bus model with fabricated data. Test procedures are under development for larger models

There is a 2nd "build", @{link ObsIslandBldrNew} algorith based on the DOE algorithm, with some potential optimizations in place. This is a work in progress, and does not currently work.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ObservableIslandList.Debug Provide in interface to trace debug information in different implementations
class	ObservableIslandList.ObservableIsland Single Observable Island.

Constructor Summary

Constructors

Constructor and Description
ObservableIslandList(PAModel model) Create a new observable island list
ObservableIslandList(PAModel model, ObservableIslandList.Debug debug) Create a new observable island list with debugging enabled

Method Summary

Modifier and Type	Method and Description
ObservableIslandList.ObservableIsland	get(int index)
java.util.Set<ColumnMeta>	getColTypes()
<R> R	getColumnData(ColumnMeta col)
java.lang.String[]	getID() return array of string object ID's
java.lang.String	getID(int ndx) get unique object ID
ListMetaType	getListMeta()
java.lang.String[]	getName() name of object
java.lang.String	getName(int ndx) name of object
boolean	hasVoltage(int ndx) Try to find a bus with voltage telemetry TODO: Since OpenPA doesn't yet have explicity telemetry status, we assume that if a bus has nonzero voltage but we know that the topological island is energized, then we have good telemetry
static void	main(java.lang.String... args)

Methods inherited from class com.powerdata.openpa.GroupListI

getBuses, getByBus, getGenerators, getLines, getLoads, getPhaseShifters, getSeriesCapacitors, getSeriesReactors, getShuntCapacitors, getShuntReactors, getSVCs, getSwitches, getTransformers, getTwoTermDCLines, translateBusIndexes

Methods inherited from class com.powerdata.openpa.impl.AbstractPAList

getByID, getByKey, getIndex, getIndexesFromKeys, getKey, getKeys, reset, setID, setID, setName, setName

Methods inherited from class com.powerdata.openpa.impl.AbstractBaseList

objEquals, objHash, size

Methods inherited from class java.util.AbstractList

add, add, addAll, clear, equals, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, remove, set, subList

Methods inherited from class java.util.AbstractCollection

addAll, contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.powerdata.openpa.BaseList

CalcListHash, getByID, getByKey, getIndex, getIndexes, getIndexesFromIDs, getIndexesFromKeys, getKey, getKeys, objEquals, objHash, reset, setID, setID, setName, setName, toArray

Methods inherited from interface java.util.List

add, add, addAll, addAll, clear, contains, containsAll, equals, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

ObservableIslandList

public ObservableIslandList(PAModel model)
                     throws PAModelException

Create a new observable island list

Parameters:

model -

Throws:

PAModelException

ObservableIslandList

public ObservableIslandList(PAModel model,
                            ObservableIslandList.Debug debug)
                     throws PAModelException

Create a new observable island list with debugging enabled

Parameters:

model -

Throws:

PAModelException

Method Detail

getListMeta

public ListMetaType getListMeta()

getColTypes

public java.util.Set<ColumnMeta> getColTypes()

get

public ObservableIslandList.ObservableIsland get(int index)

Specified by:

get in interface java.util.List<ObservableIslandList.ObservableIsland>

Specified by:

get in class java.util.AbstractList<ObservableIslandList.ObservableIsland>

hasVoltage

public boolean hasVoltage(int ndx)
                   throws PAModelException

Try to find a bus with voltage telemetry TODO: Since OpenPA doesn't yet have explicity telemetry status, we assume that if a bus has nonzero voltage but we know that the topological island is energized, then we have good telemetry

Parameters:

ndx -

Returns:

Throws:

PAModelException

getID

public java.lang.String getID(int ndx)

Description copied from class: com.powerdata.openpa.impl.AbstractPAList

get unique object ID

Specified by:

getID in interface BaseList<ObservableIslandList.ObservableIsland>

Overrides:

getID in class com.powerdata.openpa.impl.AbstractPAList<ObservableIslandList.ObservableIsland>

getID

public java.lang.String[] getID()
                         throws PAModelException

Description copied from class: com.powerdata.openpa.impl.AbstractPAList

return array of string object ID's

Specified by:

getID in interface BaseList<ObservableIslandList.ObservableIsland>

Overrides:

getID in class com.powerdata.openpa.impl.AbstractPAList<ObservableIslandList.ObservableIsland>

Throws:

PAModelException

getName

public java.lang.String getName(int ndx)
                         throws PAModelException

Description copied from class: com.powerdata.openpa.impl.AbstractPAList

name of object

Specified by:

getName in interface BaseList<ObservableIslandList.ObservableIsland>

Overrides:

getName in class com.powerdata.openpa.impl.AbstractPAList<ObservableIslandList.ObservableIsland>

Throws:

PAModelException

getName

public java.lang.String[] getName()
                           throws PAModelException

Description copied from class: com.powerdata.openpa.impl.AbstractPAList

name of object

Specified by:

getName in interface BaseList<ObservableIslandList.ObservableIsland>

Overrides:

getName in class com.powerdata.openpa.impl.AbstractPAList<ObservableIslandList.ObservableIsland>

Throws:

PAModelException

main

public static void main(java.lang.String... args)
                 throws java.lang.Exception

Throws:

java.lang.Exception

getColumnData

public <R> R getColumnData(ColumnMeta col)