com.interpss.core.algo.dclf

Interface ContingencyAnalysisAlgorithm

All Superinterfaces:

com.hazelcast.nio.serialization.DataSerializable, DclfAlgorithm, org.eclipse.emf.ecore.EObject, IBranchAngleShiftFactor, IDclfAlgoLookup, IDclfResult, IGenTDFactor, ILineOutageDFactor, IPowerTDFactor, ISensitivity, NameTag, NetworkRef<BaseAclfNetwork<?,?>>, org.eclipse.emf.common.notify.Notifier, SenAnalysisAlgorithm

All Known Implementing Classes:

ContingencyAnalysisAlgorithmImpl

public interface ContingencyAnalysisAlgorithm
extends SenAnalysisAlgorithm

A representation of the model object 'Contingency Analysis Algorithm'. Contingency analysis algorithm definition. It contains a list of outage branches, and supports single or multiple outage, and open or closure outage analysis.

The following features are supported:

• Ca Performed
• Outage Branch List

See Also:

DclfAlgorithmPackage.getContingencyAnalysisAlgorithm()

Method Summary

Modifier and Type	Method and Description
CaOutageBranch	addOutageBranch(java.lang.String branchId, CaBranchOutageType outageType) add an outage ranch
void	ca(BaseContingency contingency) perform contigency analysis and store the result in the monitoring branches
double[]	calBranchClosureFlow() internal method for closure branch outage analysis
double	calBranchClosureFlow(CaOutageBranch branch) for a closure branch outage analysis (internal method)
java.lang.Object	calBranchClosureInvZMtx(java.lang.String contId) calculate the branch closure inverse Z matrix (internal method)
java.lang.Object	calMultiOutageInvE_PTDF(java.lang.String contId) (internal method) calculate the lineOutage distribution factors using the outageBranchList for all branches.
double[]	calMultiOutageLODFs(AclfBranch monitorBranch, java.lang.Object invE_PTDF) (internal method) get LODFs after calling the calMultiOutageInvE_PTDF() for multi outage (open) branches case.
double[]	calMultiOutageLODFs(DclfAlgoBranch monitorBranch) (internal method) calculate LODFs for multi outage (open) branches case.
double	calPostOutageFlow(CaOutageBranch outageBranch, DclfAlgoBranch dclfBranch) calculate and return the post outage flow for the outageBranch and the monitoring branch.
CaOutageBranch	getOutageBranch(java.lang.String branchId) get an outage ranch by its sort number
org.eclipse.emf.common.util.EList<CaOutageBranch>	getOutageBranchList() Returns the value of the 'Outage Branch List' reference list.
boolean	isCaPerformed() Returns the value of the 'Ca Performed' attribute.
void	multiCloseOutgageAnalysis(CaOutageBranch[] outageBranches) perform the multiclose outages (stored in the outageBranchList) analysis and store the result in the dclfAlgoBranches
void	multiOpenOutgageAnalysis(CaOutageBranch[] outageBranches) perform the multi open outages (stored in the outageBranchList) analysis and store the result in the dclfAlgoBranches
void	outgageAnalysis(CaOutageBranch outageBranch) perform single outage (open/close) analysis and store the result in dclfAlgoBranches
void	setCaPerformed(boolean value) Sets the value of the 'Ca Performed' attribute.

Methods inherited from interface com.interpss.core.algo.dclf.SenAnalysisAlgorithm

addInjectBus, addWithdrawBus, getInjectBusList, getWithdrawBusList, setWithdrawBusList

Methods inherited from interface com.interpss.core.algo.dclf.DclfAlgorithm

calculateDclf, calculateDclf, calculateDclf, calculateDclf, checkCondition, deepCopy, distributeLoad, getAccFactor, getAclfNet, getAdjMaxIterations, getAdjTolerance, getB11Matrix, getB1Matrix, getDclfAlgoBranch, getDclfAlgoBranchList, getDclfAlgoBus, getDclfAlgoBusList, getDclfSolver, isApplyAdjustment, isDclfCalculated, removeDclfAlgoBranch, removeDclfAlgoBus, setAccFactor, setAdjMaxIterations, setAdjTolerance, setApplyAdjustment, setDclfCalculated, setDclfSolver, setRefBus, setRefBus, transfer2AclfNet

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

getNetwork, setNetwork

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.algo.dclf.IDclfAlgoLookup

getDclfAlgoBranchIdLookupTable, getDclfAlgoBusIdLookupTable, getDclfAlgoGenNameLookupTable, getDclfAlgoLoadNameLookupTable, rebuildLookupRefRelationship

Methods inherited from interface com.interpss.core.algo.dclf.IDclfResult

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

Methods inherited from interface com.interpss.core.algo.dclf.ISensitivity

calBusSensitivity, calBusSensitivity

Methods inherited from interface com.interpss.core.algo.dclf.IGenTDFactor

calGenShiftFactor, genTransferDistFactor

Methods inherited from interface com.interpss.core.algo.dclf.IPowerTDFactor

pTransferDistFactor, pTransferDistFactor, pTransferDistFactors

Methods inherited from interface com.interpss.core.algo.dclf.ILineOutageDFactor

getBranchClosurePTDFactor, lineOutageDFactor, lineOutageDFactors

Methods inherited from interface com.interpss.core.algo.dclf.IBranchAngleShiftFactor

branchAngleShiftFactor, branchAngleShiftFactor, psXfrShiftFactor, psXfrShiftFactor

Method Detail

isCaPerformed

boolean isCaPerformed()

Returns the value of the 'Ca Performed' attribute. a flag to indicate if contingency analysis has been performed, and therefore it has CA results.

Returns:

the value of the 'Ca Performed' attribute.

See Also:

setCaPerformed(boolean), DclfAlgorithmPackage.getContingencyAnalysisAlgorithm_CaPerformed()

setCaPerformed

void setCaPerformed(boolean value)

Sets the value of the 'Ca Performed' attribute.

Parameters:

value - the new value of the 'Ca Performed' attribute.

See Also:

isCaPerformed()

calPostOutageFlow

double calPostOutageFlow(CaOutageBranch outageBranch,
                         DclfAlgoBranch dclfBranch)
                  throws InterpssException

calculate and return the post outage flow for the outageBranch and the monitoring branch. It only applies to single open/close outage analysis

Parameters:

outageBranch - outage branch

dclfBranch - monitoring branch

Throws:

InterpssException

calBranchClosureFlow

double calBranchClosureFlow(CaOutageBranch branch)
                     throws InterpssException

for a closure branch outage analysis (internal method)

Parameters:

branch - the closure branch object

Throws:

InterpssException

calBranchClosureFlow

double[] calBranchClosureFlow()
                       throws InterpssException

internal method for closure branch outage analysis

Throws:

InterpssException

calBranchClosureInvZMtx

java.lang.Object calBranchClosureInvZMtx(java.lang.String contId)
                                  throws InterpssException

calculate the branch closure inverse Z matrix (internal method)

Parameters:

contId - Contingency id for output message identification purpose

Throws:

InterpssException

ca

void ca(BaseContingency contingency)
 throws InterpssException

perform contigency analysis and store the result in the monitoring branches

Parameters:

contingency - outage branch

Throws:

InterpssException

outgageAnalysis

void outgageAnalysis(CaOutageBranch outageBranch)
              throws InterpssException

perform single outage (open/close) analysis and store the result in dclfAlgoBranches

Parameters:

outageBranch - outage branch

Throws:

InterpssException

multiOpenOutgageAnalysis

void multiOpenOutgageAnalysis(CaOutageBranch[] outageBranches)
                       throws InterpssException

perform the multi open outages (stored in the outageBranchList) analysis and store the result in the dclfAlgoBranches

Parameters:

outageBranches - outage branch

Throws:

InterpssException

multiCloseOutgageAnalysis

void multiCloseOutgageAnalysis(CaOutageBranch[] outageBranches)
                        throws InterpssException

perform the multiclose outages (stored in the outageBranchList) analysis and store the result in the dclfAlgoBranches

Parameters:

outageBranches - outage branch

Throws:

InterpssException

calMultiOutageInvE_PTDF

java.lang.Object calMultiOutageInvE_PTDF(java.lang.String contId)
                                  throws InterpssException

(internal method) calculate the lineOutage distribution factors using the outageBranchList for all branches. return the invE_PTDF matrix. Use getLineOutageDFactors() to get the results

Parameters:

contId - Contingency id for output message identification purpose

Throws:

InterpssException

calMultiOutageLODFs

double[] calMultiOutageLODFs(AclfBranch monitorBranch,
                             java.lang.Object invE_PTDF)
                      throws InterpssException

(internal method) get LODFs after calling the calMultiOutageInvE_PTDF() for multi outage (open) branches case.

Parameters:

monitorBranch - monitoring branch

invE_PTDF - the inversion of the PTDF matrix

Throws:

InterpssException

calMultiOutageLODFs

double[] calMultiOutageLODFs(DclfAlgoBranch monitorBranch)
                      throws InterpssException

(internal method) calculate LODFs for multi outage (open) branches case.

Parameters:

monitorBranch - monitoring branch

Throws:

InterpssException

getOutageBranch

CaOutageBranch getOutageBranch(java.lang.String branchId)

get an outage ranch by its sort number

Parameters:

branchId - branch sort number

addOutageBranch

CaOutageBranch addOutageBranch(java.lang.String branchId,
                               CaBranchOutageType outageType)

add an outage ranch

Parameters:

branchId - branch id

outageType - outage type

getOutageBranchList

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

Returns the value of the 'Outage Branch List' reference list. The list contents are of type CaOutageBranch. outage branch list

Returns:

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

See Also:

DclfAlgorithmPackage.getContingencyAnalysisAlgorithm_OutageBranchList()