com.interpss.core.algo.dclf.solver

Class BaseDclfSolver

java.lang.Object

com.interpss.core.algo.impl.solver.BMatrixSolver

com.interpss.core.algo.dclf.solver.BaseDclfSolver

All Implemented Interfaces:

IDclfSolver

Direct Known Subclasses:

DblAryCacheDclfSolver, DclfSolver, HashMapCacheDclfSolver

public abstract class BaseDclfSolver
extends BMatrixSolver
implements IDclfSolver

Base Solver for dclf and sensitivity analysis injBus |--- monitoring branch ---| withdrawBus - Sensitivity is regarding to an injection bus or an injection bus + a withdraw bus - Branch shifting factor for a monitoring branch is the ratio of the monitoring branch current with regarding the the injection current + withdraw current

Nested Class Summary

Nested classes/interfaces inherited from interface com.interpss.core.algo.dclf.solver.IDclfSolver

IDclfSolver.CacheType

Field Summary

Fields

Modifier and Type	Field and Description
protected DclfAlgorithm	dclfAlgo
protected double[]	dclfResult
static JacobianMatrixType	JMatrixType
protected static java.lang.String	Token_PAngle
protected static java.lang.String	Token_QVoltage

Fields inherited from class com.interpss.core.algo.impl.solver.BMatrixSolver

aclfNet

Fields inherited from interface com.interpss.core.algo.dclf.solver.IDclfSolver

MaxItrDclfLoss

Constructor Summary

Constructors

Constructor and Description
BaseDclfSolver(DclfAlgorithm algo)

Method Summary

Modifier and Type	Method and Description
double	calBranchFlow(AclfBranch branch) calculate branch power flow
double	calBranchFlow(AclfBranch branch, Unit.UnitType unit) calculate branch power flow in the unit specified
boolean	calculateDclf(DclfMethod method) calculate DC Loadflow and store the bus results in the dcResult[] and branch results in branch.weight
double[]	calSensitivity(SenAnalysisType type, java.lang.String injectBusId) calculate the bus sensitivity.
double[]	calSensitivityImpl(SenAnalysisType type, java.lang.String injectBusId) calculate the bus sensitivity
double	getBusAngle(int busSortNumber) get bus voltage angle
double	getBusAngle(java.lang.String busId) get bus voltage angle
double[]	getDclfResult() get the Dclf result
void	initDclfResultForDebug(double[] dclfResult)
void	prepareBMatrix(SenAnalysisType type) if the B1/11 matrix is dirty, form the B-matrix and LU the matrix.
void	setBMatrixDirty() set B1 and B11 matrix dirty
void	setBusAngle(java.lang.String busId, double ang) for debug and investigation purpose

Methods inherited from class com.interpss.core.algo.impl.solver.BMatrixSolver

distructor, getB11Matrix, getB1Matrix, isB11MatrixDirty, isB1MatrixDirty, setB11MatrixDirty, setB1MatrixDirty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.interpss.core.algo.dclf.solver.IDclfSolver

distructor, getB11Matrix, getB1Matrix, getSenPAngle, getSenQVoltage

Field Detail

JMatrixType

public static JacobianMatrixType JMatrixType

Token_PAngle

protected static java.lang.String Token_PAngle

Token_QVoltage

protected static java.lang.String Token_QVoltage

dclfAlgo

protected DclfAlgorithm dclfAlgo

dclfResult

protected double[] dclfResult

Constructor Detail

BaseDclfSolver

public BaseDclfSolver(DclfAlgorithm algo)

Method Detail

getDclfResult

public double[] getDclfResult()

Description copied from interface: IDclfSolver

get the Dclf result

Specified by:

getDclfResult in interface IDclfSolver

Returns:

setBMatrixDirty

public void setBMatrixDirty()

Description copied from class: BMatrixSolver

set B1 and B11 matrix dirty

Specified by:

setBMatrixDirty in interface IDclfSolver

Overrides:

setBMatrixDirty in class BMatrixSolver

calculateDclf

public boolean calculateDclf(DclfMethod method)
                      throws InterpssException,
                             IpssNumericException,
                             ReferenceBusException

calculate DC Loadflow and store the bus results in the dcResult[] and branch results in branch.weight

Specified by:

calculateDclf in interface IDclfSolver

Returns:

Throws:

InterpssException

IpssNumericException

ReferenceBusException

prepareBMatrix

public void prepareBMatrix(SenAnalysisType type)
                    throws InterpssException,
                           IpssNumericException

if the B1/11 matrix is dirty, form the B-matrix and LU the matrix.

Specified by:

prepareBMatrix in interface IDclfSolver

Parameters:

type -

Throws:

InterpssException

IpssNumericException

calBranchFlow

public double calBranchFlow(AclfBranch branch)

calculate branch power flow

Specified by:

calBranchFlow in interface IDclfSolver

Parameters:

branch -

Returns:

calBranchFlow

public double calBranchFlow(AclfBranch branch,
                            Unit.UnitType unit)

calculate branch power flow in the unit specified

Specified by:

calBranchFlow in interface IDclfSolver

Parameters:

branch -

unit -

Returns:

getBusAngle

public double getBusAngle(int busSortNumber)

get bus voltage angle

Specified by:

getBusAngle in interface IDclfSolver

Parameters:

busSortNumber -

Returns:

getBusAngle

public double getBusAngle(java.lang.String busId)

get bus voltage angle

Specified by:

getBusAngle in interface IDclfSolver

Parameters:

busId -

Returns:

setBusAngle

public void setBusAngle(java.lang.String busId,
                        double ang)

for debug and investigation purpose

Specified by:

setBusAngle in interface IDclfSolver

Parameters:

busId -

ang -

calSensitivity

public double[] calSensitivity(SenAnalysisType type,
                               java.lang.String injectBusId)
                        throws InterpssException,
                               IpssNumericException,
                               ReferenceBusException

Description copied from interface: IDclfSolver

calculate the bus sensitivity. It is a wrapper of the calSensitivityImpl() with some higher level functions, including error checking, B-matrix preparation.

Specified by:

calSensitivity in interface IDclfSolver

Parameters:

type - Sen Analysis Type

injectBusId - injection bus id

Returns:

the sensitivity array

Throws:

InterpssException

IpssNumericException

ReferenceBusException

calSensitivityImpl

public double[] calSensitivityImpl(SenAnalysisType type,
                                   java.lang.String injectBusId)
                            throws InterpssException,
                                   IpssNumericException,
                                   ReferenceBusException

Description copied from interface: IDclfSolver

calculate the bus sensitivity

Specified by:

calSensitivityImpl in interface IDclfSolver

Parameters:

type - Sen Analysis Type

injectBusId - injection bus id

Returns:

the sensitivity array

Throws:

InterpssException

IpssNumericException

ReferenceBusException

initDclfResultForDebug

public void initDclfResultForDebug(double[] dclfResult)