com.interpss.core.dclf.impl

Class DclfSolver

java.lang.Object

com.interpss.core.algo.impl.BMatrixSolver

com.interpss.core.dclf.impl.DclfSolver

All Implemented Interfaces:

IDclfSolver

public class DclfSolver
extends BMatrixSolver
implements IDclfSolver

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

Field Summary

Fields

Modifier and Type	Field and Description
static JacobianMatrixType	JMatrixType

Constructor Summary

Constructors

Constructor and Description
DclfSolver(AclfNetwork net)

Method Summary

Modifier and Type	Method and Description
boolean	calculateDclf() 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
void	distructor() distructor to release resource if necessary
double	getBranchFlow(AclfBranch branch) calculate branch power flow
double	getBranchFlow(AclfBranch branch, Unit.UnitType unit) calculate branch power flow in the unit specified
double	getBusAngle(int busSortNumber) get bus voltage angle
double	getBusAngle(java.lang.String busId) get bus voltage angle
double[]	getDclfResult() get the Dclf result
double[]	getSenPAngle(java.lang.String busId) Retrieve P-Ang sen from the cache table or calculate sen if it is not found
double[]	getSenQVoltage(java.lang.String busId) Retrieve Q-Voltage sen from the cache table or calculate sen if it is not found
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
void	setCacheSensitivity(boolean b) set the cache sensitivity flag

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

getB11Matrix, getB1Matrix, setB11MatrixDirty, setB1MatrixDirty

Methods inherited from class java.lang.Object

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

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

getB11Matrix, getB1Matrix

Field Detail

JMatrixType

public static JacobianMatrixType JMatrixType

Constructor Detail

DclfSolver

public DclfSolver(AclfNetwork net)

Method Detail

getDclfResult

public double[] getDclfResult()

Description copied from interface: IDclfSolver

get the Dclf result

Specified by:

getDclfResult in interface IDclfSolver

Returns:

setCacheSensitivity

public void setCacheSensitivity(boolean b)

Description copied from interface: IDclfSolver

set the cache sensitivity flag

Specified by:

setCacheSensitivity in interface IDclfSolver

Parameters:

b - flag

distructor

public void distructor()

Description copied from class: BMatrixSolver

distructor to release resource if necessary

Specified by:

distructor in interface IDclfSolver

Overrides:

distructor in class BMatrixSolver

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()
                      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

getBranchFlow

public double getBranchFlow(AclfBranch branch)

calculate branch power flow

Specified by:

getBranchFlow in interface IDclfSolver

Parameters:

branch -

Returns:

getBranchFlow

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

calculate branch power flow in the unit specified

Specified by:

getBranchFlow 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 -

getSenPAngle

public double[] getSenPAngle(java.lang.String busId)
                      throws InterpssException,
                             IpssNumericException,
                             ReferenceBusException

Retrieve P-Ang sen from the cache table or calculate sen if it is not found

Specified by:

getSenPAngle in interface IDclfSolver

Parameters:

busId -

Returns:

Throws:

InterpssException

IpssNumericException

ReferenceBusException

getSenQVoltage

public double[] getSenQVoltage(java.lang.String busId)
                        throws InterpssException,
                               IpssNumericException,
                               ReferenceBusException

Retrieve Q-Voltage sen from the cache table or calculate sen if it is not found

Specified by:

getSenQVoltage in interface IDclfSolver

Parameters:

busId -

Returns:

Throws:

InterpssException

IpssNumericException

ReferenceBusException

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

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)