com.interpss.core.dclf.impl

Class DclfAlgorithmImpl

java.lang.Object

org.eclipse.emf.common.notify.impl.BasicNotifierImpl

org.eclipse.emf.ecore.impl.BasicEObjectImpl

org.eclipse.emf.ecore.impl.EObjectImpl

com.interpss.core.net.impl.NameTagImpl

com.interpss.core.net.ref.impl.NetworkRefImpl<AclfNetwork>

com.interpss.core.dclf.impl.DcLoadflowImpl

com.interpss.core.dclf.impl.DclfAlgorithmImpl

All Implemented Interfaces:

com.hazelcast.nio.serialization.DataSerializable, DclfAlgorithm, DcLoadflow, IAreaTDFactor, IBranchAngleShiftFactor, IDclfResult, ILineOutageDFactor, ILossFactor, IPowerTDFactor, ISensitivity, NameTag, NetworkRef<AclfNetwork>, org.eclipse.emf.common.notify.Notifier, org.eclipse.emf.ecore.EObject, org.eclipse.emf.ecore.InternalEObject

public class DclfAlgorithmImpl
extends DcLoadflowImpl
implements DclfAlgorithm

DclfAlgo --> AclfNet --> DclfSolver --> AclfNet - DclfAlgo has two ref objects (AclfNet and DclfSolver). DclfAlgo should always go to DclfSolver for data and info, since the data/info might be cached in DclfSolver - DclfAlgo is state-less, meaning the only place to cache analysis result is in DclfSolver

The following features are implemented:

• Inject Bus Type
• Withdraw Bus Type
• Lodf Analysis Type
• Withdraw Bus List
• Inject Bus List
• Outage Branch List

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.emf.common.notify.impl.BasicNotifierImpl

org.eclipse.emf.common.notify.impl.BasicNotifierImpl.EAdapterList<E extends java.lang.Object & org.eclipse.emf.common.notify.Adapter>, org.eclipse.emf.common.notify.impl.BasicNotifierImpl.EObservableAdapterList

Nested classes/interfaces inherited from interface org.eclipse.emf.ecore.InternalEObject

org.eclipse.emf.ecore.InternalEObject.EStore

Field Summary

Fields inherited from class org.eclipse.emf.ecore.impl.EObjectImpl

ELAST_EOBJECT_FLAG

Fields inherited from interface org.eclipse.emf.ecore.InternalEObject

EOPPOSITE_FEATURE_BASE

Method Summary

Modifier and Type	Method and Description
void	addInjectBus(java.lang.String busId, double percent)
void	addWithdrawBus(java.lang.String busId, double percent)
double	branchAngleShiftFactor(java.lang.String injectBusId, java.lang.String withdrawBusId, AclfBranch monitorBranch)
double	branchAngleShiftFactor(java.lang.String injectBusId, java.lang.String withdrawBusId, AclfBranch monitorBranch, Unit.UnitType angUnit)
double	calBusSensitivity(SenAnalysisType type, java.lang.String injectBusId, int busSortNumber) get the sensitivity results (cached) after the calculation.
double	calBusSensitivity(SenAnalysisType type, java.lang.String injectBusId, java.lang.String busId) get the sensitivity results (cached) after the calculation.
boolean	calculateDclf()
double	calGenShiftFactor(java.lang.String injectBusId, AclfBranch branch) with regarding to the slack bus, for one pu power injection at the injection bus, calculate the portion of the power flow on the branch *
java.lang.Object	calLineOutageDFactors(java.lang.String contId) calculate inv[E - PTDF] per the IEEE paper.
java.lang.Object	eGet(int featureID, boolean resolve, boolean coreType)
boolean	eIsSet(int featureID)
void	eSet(int featureID, java.lang.Object newValue)
void	eUnset(int featureID)
double	getAreaTransferFactor(AclfBranch branch)
double	getBranchClosureEquivPreFlow(AclfBranch branch)
double	getBranchClosurePTDFactor(AclfBranch branch)
org.eclipse.emf.common.util.EList<SenAnalysisBus>	getInjectBusList()
BusSenAnalysisType	getInjectBusType()
double[]	getLineOutageDFactors(AclfBranch monitorBranch, java.lang.Object invE_PTDFObj) It applies to multi-outage branches
LODFSenAnalysisType	getLodfAnalysisType()
org.eclipse.emf.common.util.EList<OutageBranch>	getOutageBranchList()
org.eclipse.emf.common.util.EList<SenAnalysisBus>	getWithdrawBusList()
BusSenAnalysisType	getWithdrawBusType()
double	lineOutageDFactor(AclfBranch outageBranch, AclfBranch transferBranch)
double	lossFactor(Area area, java.lang.String injectBusId)
double	lossFactor(Area area, java.lang.String injectBusId, java.lang.String withdrawBusId)
double	lossFactor(java.lang.String injectBusId)
double	lossFactor(java.lang.String injectBusId, java.lang.String withdrawBusId)
double	psXfrShiftFactor(AclfBranch psXfr, AclfBranch monitorBranch)
double	psXfrShiftFactor(AclfBranch psXfr, AclfBranch monitorBranch, Unit.UnitType angUnit)
double	pTransferDistFactor(java.lang.String injectBusId, AclfBranch branch)
double	pTransferDistFactor(java.lang.String injectBusId, java.lang.String withdrawBusId, AclfBranch branch)
void	setCacheSensitivity(boolean b)
void	setInjectBusType(BusSenAnalysisType newInjectBusType)
void	setLodfAnalysisType(LODFSenAnalysisType newLodfAnalysisType)
void	setWithdrawBusList(org.eclipse.emf.common.util.EList<SenAnalysisBus> list) set the withdrawBusList
void	setWithdrawBusType(BusSenAnalysisType newWithdrawBusType)
java.lang.String	toString()

Methods inherited from class com.interpss.core.dclf.impl.DcLoadflowImpl

checkCondition, destroy, getAccFactor, getAdjMaxIterations, getAdjTolerance, getB11Matrix, getB1Matrix, getBranchFlow, getBranchFlow, getBranchFlow, getBusAngle, getBusAngle, getBusPower, getBusPowerInfoNet, getDclfSolver, getMismatch, isApplyAdjustment, isDclfCalculated, loading, loading, loss, ratingViolation, ratingViolation, setAccFactor, setAdjMaxIterations, setAdjTolerance, setApplyAdjustment, setBusAngle, setDclfCalculated, setDclfSolver, setNetwork, setRefBus, setRefBus

Methods inherited from class com.interpss.core.net.ref.impl.NetworkRefImpl

getNetwork, readData, writeData

Methods inherited from class com.interpss.core.net.impl.NameTagImpl

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

Methods inherited from class org.eclipse.emf.ecore.impl.EObjectImpl

eAdapters, eClass, eContainerFeatureID, eDeliver, eInternalContainer, eInvoke, eIsProxy, eSetClass, eSetDeliver, eSetProxyURI

Methods inherited from class org.eclipse.emf.ecore.impl.BasicEObjectImpl

eAllContents, eBaseStructuralFeatureID, eBasicRemoveFromContainer, eBasicRemoveFromContainerFeature, eBasicSetContainer, eContainer, eContainingFeature, eContainmentFeature, eContains, eContents, eCrossReferences, eDerivedOperationID, eDerivedOperationID, eDerivedStructuralFeatureID, eDerivedStructuralFeatureID, eDirectResource, eDynamicBasicRemoveFromContainer, eDynamicGet, eDynamicGet, eDynamicInverseAdd, eDynamicInverseRemove, eDynamicInvoke, eDynamicIsSet, eDynamicIsSet, eDynamicSet, eDynamicSet, eDynamicUnset, eDynamicUnset, eGet, eGet, eGet, eInternalResource, eInverseAdd, eInverseAdd, eInverseRemove, eInverseRemove, eInvoke, eIsSet, eObjectForURIFragmentSegment, eOpenGet, eOpenIsSet, eOpenSet, eOpenUnset, eProxyURI, eResolveProxy, eResource, eSet, eSetResource, eSetStore, eSetting, eStore, eUnset, eURIFragmentSegment, eVirtualGet, eVirtualGet, eVirtualIsSet, eVirtualSet, eVirtualUnset

Methods inherited from class org.eclipse.emf.common.notify.impl.BasicNotifierImpl

eNotificationRequired, eNotify

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.interpss.core.dclf.DcLoadflow

checkCondition, getAccFactor, getAdjMaxIterations, getAdjTolerance, getB11Matrix, getB1Matrix, getDclfSolver, isApplyAdjustment, isDclfCalculated, setAccFactor, setAdjMaxIterations, setAdjTolerance, setApplyAdjustment, setDclfCalculated, setDclfSolver, setRefBus, setRefBus

Methods inherited from interface com.interpss.core.net.ref.NetworkRef

getNetwork, setNetwork

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.dclf.IDclfResult

getBranchFlow, getBranchFlow, getBranchFlow, getBusAngle, getBusAngle, getBusPower, getBusPowerInfoNet, getMismatch, loading, loading, loss, ratingViolation, ratingViolation

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

eNotificationRequired

Method Detail

calculateDclf

public boolean calculateDclf()
                      throws InterpssException,
                             ReferenceBusException,
                             IpssNumericException

Description copied from class: DcLoadflowImpl

Specified by:

calculateDclf in interface DcLoadflow

Overrides:

calculateDclf in class DcLoadflowImpl

Throws:

InterpssException

ReferenceBusException

IpssNumericException

getInjectBusType

public BusSenAnalysisType getInjectBusType()

Specified by:

getInjectBusType in interface DclfAlgorithm

Returns:

the value of the 'Inject Bus Type' attribute.

See Also:

BusSenAnalysisType, DclfAlgorithm.setInjectBusType(BusSenAnalysisType), DclfPackage.getDclfAlgorithm_InjectBusType()

setInjectBusType

public void setInjectBusType(BusSenAnalysisType newInjectBusType)

Specified by:

setInjectBusType in interface DclfAlgorithm

Parameters:

newInjectBusType - the new value of the 'Inject Bus Type' attribute.

See Also:

BusSenAnalysisType, DclfAlgorithm.getInjectBusType()

getWithdrawBusType

public BusSenAnalysisType getWithdrawBusType()

Specified by:

getWithdrawBusType in interface DclfAlgorithm

Returns:

the value of the 'Withdraw Bus Type' attribute.

See Also:

BusSenAnalysisType, DclfAlgorithm.setWithdrawBusType(BusSenAnalysisType), DclfPackage.getDclfAlgorithm_WithdrawBusType()

setWithdrawBusType

public void setWithdrawBusType(BusSenAnalysisType newWithdrawBusType)

Specified by:

setWithdrawBusType in interface DclfAlgorithm

Parameters:

newWithdrawBusType - the new value of the 'Withdraw Bus Type' attribute.

See Also:

BusSenAnalysisType, DclfAlgorithm.getWithdrawBusType()

getLodfAnalysisType

public LODFSenAnalysisType getLodfAnalysisType()

Specified by:

getLodfAnalysisType in interface DclfAlgorithm

Returns:

the value of the 'Lodf Analysis Type' attribute.

See Also:

LODFSenAnalysisType, DclfAlgorithm.setLodfAnalysisType(LODFSenAnalysisType), DclfPackage.getDclfAlgorithm_LodfAnalysisType()

setLodfAnalysisType

public void setLodfAnalysisType(LODFSenAnalysisType newLodfAnalysisType)

Specified by:

setLodfAnalysisType in interface DclfAlgorithm

Parameters:

newLodfAnalysisType - the new value of the 'Lodf Analysis Type' attribute.

See Also:

LODFSenAnalysisType, DclfAlgorithm.getLodfAnalysisType()

getWithdrawBusList

public org.eclipse.emf.common.util.EList<SenAnalysisBus> getWithdrawBusList()

Specified by:

getWithdrawBusList in interface DclfAlgorithm

Returns:

the value of the 'Withdraw Bus List' reference list.

See Also:

DclfPackage.getDclfAlgorithm_WithdrawBusList()

setWithdrawBusList

public void setWithdrawBusList(org.eclipse.emf.common.util.EList<SenAnalysisBus> list)

Description copied from interface: DclfAlgorithm

set the withdrawBusList

Specified by:

setWithdrawBusList in interface DclfAlgorithm

getInjectBusList

public org.eclipse.emf.common.util.EList<SenAnalysisBus> getInjectBusList()

Specified by:

getInjectBusList in interface DclfAlgorithm

Returns:

the value of the 'Inject Bus List' reference list.

See Also:

DclfPackage.getDclfAlgorithm_InjectBusList()

getOutageBranchList

public org.eclipse.emf.common.util.EList<OutageBranch> getOutageBranchList()

Specified by:

getOutageBranchList in interface DclfAlgorithm

Returns:

the value of the 'Outage Branch List' reference list.

See Also:

DclfPackage.getDclfAlgorithm_OutageBranchList()

eGet

public java.lang.Object eGet(int featureID,
                             boolean resolve,
                             boolean coreType)

Specified by:

eGet in interface org.eclipse.emf.ecore.InternalEObject

Overrides:

eGet in class DcLoadflowImpl

eSet

public void eSet(int featureID,
                 java.lang.Object newValue)

Specified by:

eSet in interface org.eclipse.emf.ecore.InternalEObject

Overrides:

eSet in class DcLoadflowImpl

eUnset

public void eUnset(int featureID)

Specified by:

eUnset in interface org.eclipse.emf.ecore.InternalEObject

Overrides:

eUnset in class DcLoadflowImpl

eIsSet

public boolean eIsSet(int featureID)

Specified by:

eIsSet in interface org.eclipse.emf.ecore.InternalEObject

Overrides:

eIsSet in class DcLoadflowImpl

toString

public java.lang.String toString()

Overrides:

toString in class DcLoadflowImpl

addWithdrawBus

public void addWithdrawBus(java.lang.String busId,
                           double percent)

Specified by:

addWithdrawBus in interface DclfAlgorithm

Parameters:

busId - bus id

percent - contribuing percentage

addInjectBus

public void addInjectBus(java.lang.String busId,
                         double percent)

Specified by:

addInjectBus in interface DclfAlgorithm

Parameters:

busId - bus id

percent - contributing percentage

psXfrShiftFactor

public double psXfrShiftFactor(AclfBranch psXfr,
                               AclfBranch monitorBranch)
                        throws ReferenceBusException,
                               BranchAngleSenException

Specified by:

psXfrShiftFactor in interface IBranchAngleShiftFactor

Throws:

ReferenceBusException

BranchAngleSenException

psXfrShiftFactor

public double psXfrShiftFactor(AclfBranch psXfr,
                               AclfBranch monitorBranch,
                               Unit.UnitType angUnit)
                        throws ReferenceBusException,
                               BranchAngleSenException

Specified by:

psXfrShiftFactor in interface IBranchAngleShiftFactor

Parameters:

psXfr - PsXfr branch

monitorBranch - monitoring branch

angUnit - angle unit

Throws:

ReferenceBusException

BranchAngleSenException

branchAngleShiftFactor

public double branchAngleShiftFactor(java.lang.String injectBusId,
                                     java.lang.String withdrawBusId,
                                     AclfBranch monitorBranch)
                              throws ReferenceBusException,
                                     BranchAngleSenException

Specified by:

branchAngleShiftFactor in interface IBranchAngleShiftFactor

Parameters:

injectBusId - injection bus id

withdrawBusId - withdraw bus id

monitorBranch - monitoring branch

Throws:

ReferenceBusException

BranchAngleSenException

branchAngleShiftFactor

public double branchAngleShiftFactor(java.lang.String injectBusId,
                                     java.lang.String withdrawBusId,
                                     AclfBranch monitorBranch,
                                     Unit.UnitType angUnit)
                              throws ReferenceBusException,
                                     BranchAngleSenException

Specified by:

branchAngleShiftFactor in interface IBranchAngleShiftFactor

Parameters:

injectBusId - injection bus id

withdrawBusId - withdraw bus id

monitorBranch - monitoring branch

angUnit - angle unit

Throws:

ReferenceBusException

BranchAngleSenException

setCacheSensitivity

public void setCacheSensitivity(boolean b)

Specified by:

setCacheSensitivity in interface ISensitivity

Parameters:

b - boolean for cache sensitivity

calBusSensitivity

public double calBusSensitivity(SenAnalysisType type,
                                java.lang.String injectBusId,
                                int busSortNumber)
                         throws InterpssException,
                                IpssNumericException,
                                ReferenceBusException

get the sensitivity results (cached) after the calculation. Has to be called after calculateSensitivity() called

Specified by:

calBusSensitivity in interface ISensitivity

Parameters:

type - sensitivity type

injectBusId - injection bus id

busSortNumber - bus sort number

Throws:

InterpssException

IpssNumericException

ReferenceBusException

calBusSensitivity

public double calBusSensitivity(SenAnalysisType type,
                                java.lang.String injectBusId,
                                java.lang.String busId)
                         throws ReferenceBusException

get the sensitivity results (cached) after the calculation. Has to be called after calculateSensitivity() called

Specified by:

calBusSensitivity in interface ISensitivity

Parameters:

type - sensitivity type

injectBusId - injection bus id

busId - bus id

Throws:

ReferenceBusException

calGenShiftFactor

public double calGenShiftFactor(java.lang.String injectBusId,
                                AclfBranch branch)
                         throws ReferenceBusException

with regarding to the slack bus, for one pu power injection at the injection bus, calculate the portion of the power flow on the branch *

Specified by:

calGenShiftFactor in interface ISensitivity

Parameters:

injectBusId - injection bus id

branch - the monitoring branch object

Throws:

ReferenceBusException

getBranchClosurePTDFactor

public double getBranchClosurePTDFactor(AclfBranch branch)
                                 throws InterpssException,
                                        ReferenceBusException,
                                        IpssNumericException

Specified by:

getBranchClosurePTDFactor in interface ISensitivity

Parameters:

branch - the branch object

Throws:

InterpssException

ReferenceBusException

IpssNumericException

getBranchClosureEquivPreFlow

public double getBranchClosureEquivPreFlow(AclfBranch branch)
                                    throws InterpssException

Specified by:

getBranchClosureEquivPreFlow in interface ISensitivity

Parameters:

branch - the branch object

Throws:

InterpssException

pTransferDistFactor

public double pTransferDistFactor(java.lang.String injectBusId,
                                  java.lang.String withdrawBusId,
                                  AclfBranch branch)
                           throws ReferenceBusException

Specified by:

pTransferDistFactor in interface IPowerTDFactor

Parameters:

injectBusId - injection bus id

withdrawBusId - withdraw bus id

branch - the monitoring branch

Throws:

ReferenceBusException

pTransferDistFactor

public double pTransferDistFactor(java.lang.String injectBusId,
                                  AclfBranch branch)
                           throws ReferenceBusException

Specified by:

pTransferDistFactor in interface IPowerTDFactor

Parameters:

injectBusId - injection bus id

branch - monitoring branch

Throws:

ReferenceBusException

getAreaTransferFactor

public double getAreaTransferFactor(AclfBranch branch)
                             throws ReferenceBusException

Specified by:

getAreaTransferFactor in interface IAreaTDFactor

Parameters:

branch - monitoring branch

Throws:

ReferenceBusException

lineOutageDFactor

public double lineOutageDFactor(AclfBranch outageBranch,
                                AclfBranch transferBranch)
                         throws ReferenceBusException

Specified by:

lineOutageDFactor in interface ILineOutageDFactor

Parameters:

outageBranch - outage branch

transferBranch - monitoring branch

Throws:

ReferenceBusException

calLineOutageDFactors

public java.lang.Object calLineOutageDFactors(java.lang.String contId)
                                       throws InterpssException,
                                              ReferenceBusException,
                                              OutageConnectivityException,
                                              IpssNumericException

calculate inv[E - PTDF] per the IEEE paper. It applies to multi-outage branches

Specified by:

calLineOutageDFactors in interface ILineOutageDFactor

Parameters:

contId - Contingency id for output message identification purpose

Throws:

InterpssException

ReferenceBusException

OutageConnectivityException

IpssNumericException

getLineOutageDFactors

public double[] getLineOutageDFactors(AclfBranch monitorBranch,
                                      java.lang.Object invE_PTDFObj)
                               throws ReferenceBusException,
                                      IpssNumericException

It applies to multi-outage branches

Specified by:

getLineOutageDFactors in interface ILineOutageDFactor

Parameters:

monitorBranch - monitoring branch

invE_PTDFObj - the inversion of the PTDF matrix

Throws:

ReferenceBusException

IpssNumericException

lossFactor

public double lossFactor(java.lang.String injectBusId)
                  throws ReferenceBusException,
                         InterpssException

Specified by:

lossFactor in interface ILossFactor

Parameters:

injectBusId - injection bus id

Throws:

ReferenceBusException

InterpssException

lossFactor

public double lossFactor(java.lang.String injectBusId,
                         java.lang.String withdrawBusId)
                  throws ReferenceBusException,
                         InterpssException

Specified by:

lossFactor in interface ILossFactor

Parameters:

injectBusId - injection bus id

withdrawBusId - withdraw bus id

Throws:

ReferenceBusException

InterpssException

lossFactor

public double lossFactor(Area area,
                         java.lang.String injectBusId)
                  throws ReferenceBusException,
                         InterpssException

Specified by:

lossFactor in interface ILossFactor

Parameters:

area - area object

injectBusId - injection bus id

Throws:

ReferenceBusException

InterpssException

lossFactor

public double lossFactor(Area area,
                         java.lang.String injectBusId,
                         java.lang.String withdrawBusId)
                  throws ReferenceBusException,
                         InterpssException

Specified by:

lossFactor in interface ILossFactor

Parameters:

area - area object

injectBusId - injection bus id

withdrawBusId - withdraw bus id

Throws:

ReferenceBusException

InterpssException