Package com.powsybl.openloadflow.network.impl

Class AbstractLfBus

java.lang.Object

com.powsybl.openloadflow.network.AbstractPropertyBag

com.powsybl.openloadflow.network.AbstractElement

com.powsybl.openloadflow.network.impl.AbstractLfBus

All Implemented Interfaces:

LfBus, LfElement, PropertyBag

Direct Known Subclasses:

LfBusImpl, LfDanglingLineBus, LfStarBus

public abstract class AbstractLfBus
extends AbstractElement
implements LfBus

Author:

Geoffroy Jamgotchian

Field Summary

Fields

Modifier and Type	Field	Description
protected double	angle
protected LfAsymBus	asym
protected List<LfBranch>	branches
protected Evaluable	calculatedV
protected LfShunt	controllerShunt
protected boolean	ensurePowerFactorConstantByLoad
protected Double	generationTargetP
protected double	generationTargetQ
protected List<LfGenerator>	generators
protected boolean	generatorVoltageControlEnabled
protected List<LfHvdc>	hvdcs
protected double	initialLoadTargetP
protected List<Ref<com.powsybl.iidm.network.LccConverterStation>>	lccCsRefs
protected com.powsybl.openloadflow.network.impl.LfLoadImpl	load
protected double	loadTargetP
protected double	loadTargetQ
protected static org.slf4j.Logger	LOGGER
protected Evaluable	p
protected Evaluable	q
protected boolean	reference
protected double	remoteVoltageControlReactivePercent
protected LfShunt	shunt
protected ShuntVoltageControl	shuntVoltageControl
protected boolean	slack
protected LfShunt	svcShunt
protected TransformerVoltageControl	transformerVoltageControl
protected double	v
protected Map<LoadFlowModel,LfZeroImpedanceNetwork>	zeroImpedanceNetwork

Fields inherited from class com.powsybl.openloadflow.network.AbstractElement

disabled, network, num

Fields inherited from class com.powsybl.openloadflow.network.AbstractPropertyBag

properties

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractLfBus(LfNetwork network, double v, double angle, boolean distributedOnConformLoad)

Method Summary

Modifier and Type	Method	Description
protected void	add(LfGenerator generator)
void	addBranch(LfBranch branch)
void	addHvdc(LfHvdc hvdc)
protected static double	dispatchQ(List<LfGenerator> generatorsThatControlVoltage, boolean reactiveLimits, double qToDispatch)
boolean	ensurePowerFactorConstantByLoad()
Map<LfBus,List<LfBranch>>	findNeighbors()	Find bus + parallel branches neighbors.
double	getAngle()
LfAsymBus	getAsym()
List<LfBranch>	getBranches()
Evaluable	getCalculatedV()
Optional<LfShunt>	getControllerShunt()
double	getGenerationTargetP()
double	getGenerationTargetQ()
List<LfGenerator>	getGenerators()
List<LfGenerator>	getGeneratorsControllingVoltageWithSlope()
Optional<GeneratorVoltageControl>	getGeneratorVoltageControl()
Optional<VoltageControl<?>>	getHighestPriorityVoltageControl()	Get the highest priority voltage control connected to a bus of the zero impedance subgraph to which this bus belong.
double	getInitialLoadTargetP()
LfLoad	getLoad()
double	getLoadTargetP()
double	getLoadTargetQ()
double	getMaxQ()
double	getMinQ()
double	getMismatchP()	Get active power mismatch.
Evaluable	getP()
Evaluable	getQ()
Optional<ReactivePowerControl>	getReactivePowerControl()
double	getRemoteVoltageControlReactivePercent()
Optional<LfShunt>	getShunt()
Optional<ShuntVoltageControl>	getShuntVoltageControl()
Optional<LfShunt>	getSvcShunt()
double	getTargetP()
double	getTargetQ()
Optional<TransformerVoltageControl>	getTransformerVoltageControl()
ElementType	getType()
double	getV()
List<VoltageControl<?>>	getVoltageControls()	Get list of all voltage controls (generator + transformer + shunt) linked to this bus.
LfZeroImpedanceNetwork	getZeroImpedanceNetwork(LoadFlowModel loadFlowModel)
boolean	hasGeneratorsWithSlope()
boolean	hasGeneratorVoltageControllerCapability()
void	invalidateGenerationTargetP()
boolean	isGeneratorVoltageControlEnabled()
boolean	isGeneratorVoltageControlled()
boolean	isReference()
boolean	isShuntVoltageControlled()
boolean	isSlack()
boolean	isTransformerVoltageControlled()
boolean	isVoltageControlled()	Check if this bus is voltage controlled so either by a generator, a transformer or a shunt.
void	removeGeneratorSlopes()
void	setAngle(double angle)
void	setAsym(LfAsymBus asym)
void	setCalculatedV(Evaluable calculatedV)
void	setDisabled(boolean disabled)
void	setGenerationTargetQ(double generationTargetQ)
void	setGeneratorVoltageControl(GeneratorVoltageControl generatorVoltageControl)
void	setGeneratorVoltageControlEnabled(boolean generatorVoltageControlEnabled)
void	setLoadTargetP(double loadTargetP)
void	setLoadTargetQ(double loadTargetQ)
void	setP(Evaluable p)
void	setQ(Evaluable q)
void	setReactivePowerControl(ReactivePowerControl reactivePowerControl)
void	setReference(boolean reference)
void	setRemoteVoltageControlReactivePercent(double remoteVoltageControlReactivePercent)
void	setShuntVoltageControl(ShuntVoltageControl shuntVoltageControl)
void	setSlack(boolean slack)
void	setTransformerVoltageControl(TransformerVoltageControl transformerVoltageControl)
void	setV(double v)
void	setZeroImpedanceNetwork(LoadFlowModel loadFlowModel, LfZeroImpedanceNetwork zeroImpedanceNetwork)
void	updateState(LfNetworkStateUpdateParameters parameters)

Methods inherited from class com.powsybl.openloadflow.network.AbstractElement

getNetwork, getNum, getOriginalIds, isDisabled, notifyDisable, setNum, toString

Methods inherited from class com.powsybl.openloadflow.network.AbstractPropertyBag

getProperty, removeProperty, setProperty

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.powsybl.openloadflow.network.LfBus

createBusResults, getCountry, getHighVoltageLimit, getLowVoltageLimit, getNominalV, getVoltageLevelId, isFictitious, isParticipating

Methods inherited from interface com.powsybl.openloadflow.network.LfElement

getId, getNetwork, getNum, getOriginalIds, isDisabled, setNum

Methods inherited from interface com.powsybl.openloadflow.network.PropertyBag

getProperty, removeProperty, setProperty

Field Detail

LOGGER

protected static final org.slf4j.Logger LOGGER

slack

protected boolean slack

reference

protected boolean reference

v

protected double v

calculatedV

protected Evaluable calculatedV

angle

protected double angle

generatorVoltageControlEnabled

protected boolean generatorVoltageControlEnabled

loadTargetP

protected double loadTargetP

initialLoadTargetP

protected double initialLoadTargetP

loadTargetQ

protected double loadTargetQ

generationTargetP

protected Double generationTargetP

generationTargetQ

protected double generationTargetQ

generators

protected final List<LfGenerator> generators

shunt

protected LfShunt shunt

controllerShunt

protected LfShunt controllerShunt

svcShunt

protected LfShunt svcShunt

load

protected final com.powsybl.openloadflow.network.impl.LfLoadImpl load

ensurePowerFactorConstantByLoad

protected boolean ensurePowerFactorConstantByLoad

lccCsRefs

protected final List<Ref<com.powsybl.iidm.network.LccConverterStation>> lccCsRefs

branches

protected final List<LfBranch> branches

hvdcs

protected final List<LfHvdc> hvdcs

transformerVoltageControl

protected TransformerVoltageControl transformerVoltageControl

shuntVoltageControl

protected ShuntVoltageControl shuntVoltageControl

p

protected Evaluable p

q

protected Evaluable q

remoteVoltageControlReactivePercent

protected double remoteVoltageControlReactivePercent

zeroImpedanceNetwork

protected final Map<LoadFlowModel,LfZeroImpedanceNetwork> zeroImpedanceNetwork

asym

protected LfAsymBus asym

Constructor Detail

AbstractLfBus

protected AbstractLfBus(LfNetwork network,
                        double v,
                        double angle,
                        boolean distributedOnConformLoad)

Method Detail

getType

public ElementType getType()

Specified by:

getType in interface LfElement

isSlack

public boolean isSlack()

Specified by:

isSlack in interface LfBus

setSlack

public void setSlack(boolean slack)

Specified by:

setSlack in interface LfBus

isReference

public boolean isReference()

Specified by:

isReference in interface LfBus

setReference

public void setReference(boolean reference)

Specified by:

setReference in interface LfBus

getTargetP

public double getTargetP()

Specified by:

getTargetP in interface LfBus

getTargetQ

public double getTargetQ()

Specified by:

getTargetQ in interface LfBus

getVoltageControls

public List<VoltageControl<?>> getVoltageControls()

Description copied from interface: LfBus

Get list of all voltage controls (generator + transformer + shunt) linked to this bus.

Specified by:

getVoltageControls in interface LfBus

isVoltageControlled

public boolean isVoltageControlled()

Description copied from interface: LfBus

Check if this bus is voltage controlled so either by a generator, a transformer or a shunt.

Specified by:

isVoltageControlled in interface LfBus

getHighestPriorityVoltageControl

public Optional<VoltageControl<?>> getHighestPriorityVoltageControl()

Description copied from interface: LfBus

Get the highest priority voltage control connected to a bus of the zero impedance subgraph to which this bus belong.

Specified by:

getHighestPriorityVoltageControl in interface LfBus

hasGeneratorVoltageControllerCapability

public boolean hasGeneratorVoltageControllerCapability()

Specified by:

hasGeneratorVoltageControllerCapability in interface LfBus

getGeneratorVoltageControl

public Optional<GeneratorVoltageControl> getGeneratorVoltageControl()

Specified by:

getGeneratorVoltageControl in interface LfBus

setGeneratorVoltageControl

public void setGeneratorVoltageControl(GeneratorVoltageControl generatorVoltageControl)

Specified by:

setGeneratorVoltageControl in interface LfBus

getReactivePowerControl

public Optional<ReactivePowerControl> getReactivePowerControl()

Specified by:

getReactivePowerControl in interface LfBus

setReactivePowerControl

public void setReactivePowerControl(ReactivePowerControl reactivePowerControl)

Specified by:

setReactivePowerControl in interface LfBus

isGeneratorVoltageControlled

public boolean isGeneratorVoltageControlled()

Specified by:

isGeneratorVoltageControlled in interface LfBus

getGeneratorsControllingVoltageWithSlope

public List<LfGenerator> getGeneratorsControllingVoltageWithSlope()

Specified by:

getGeneratorsControllingVoltageWithSlope in interface LfBus

hasGeneratorsWithSlope

public boolean hasGeneratorsWithSlope()

Specified by:

hasGeneratorsWithSlope in interface LfBus

removeGeneratorSlopes

public void removeGeneratorSlopes()

Specified by:

removeGeneratorSlopes in interface LfBus

isGeneratorVoltageControlEnabled

public boolean isGeneratorVoltageControlEnabled()

Specified by:

isGeneratorVoltageControlEnabled in interface LfBus

setGeneratorVoltageControlEnabled

public void setGeneratorVoltageControlEnabled(boolean generatorVoltageControlEnabled)

Specified by:

setGeneratorVoltageControlEnabled in interface LfBus

add

protected void add(LfGenerator generator)

invalidateGenerationTargetP

public void invalidateGenerationTargetP()

Specified by:

invalidateGenerationTargetP in interface LfBus

getGenerationTargetP

public double getGenerationTargetP()

Specified by:

getGenerationTargetP in interface LfBus

getGenerationTargetQ

public double getGenerationTargetQ()

Specified by:

getGenerationTargetQ in interface LfBus

setGenerationTargetQ

public void setGenerationTargetQ(double generationTargetQ)

Specified by:

setGenerationTargetQ in interface LfBus

getLoadTargetP

public double getLoadTargetP()

Specified by:

getLoadTargetP in interface LfBus

getInitialLoadTargetP

public double getInitialLoadTargetP()

Specified by:

getInitialLoadTargetP in interface LfBus

setLoadTargetP

public void setLoadTargetP(double loadTargetP)

Specified by:

setLoadTargetP in interface LfBus

getLoadTargetQ

public double getLoadTargetQ()

Specified by:

getLoadTargetQ in interface LfBus

setLoadTargetQ

public void setLoadTargetQ(double loadTargetQ)

Specified by:

setLoadTargetQ in interface LfBus

ensurePowerFactorConstantByLoad

public boolean ensurePowerFactorConstantByLoad()

Specified by:

ensurePowerFactorConstantByLoad in interface LfBus

getMinQ

public double getMinQ()

Specified by:

getMinQ in interface LfBus

getMaxQ

public double getMaxQ()

Specified by:

getMaxQ in interface LfBus

getV

public double getV()

Specified by:

getV in interface LfBus

setV

public void setV(double v)

Specified by:

setV in interface LfBus

getCalculatedV

public Evaluable getCalculatedV()

Specified by:

getCalculatedV in interface LfBus

setCalculatedV

public void setCalculatedV(Evaluable calculatedV)

Specified by:

setCalculatedV in interface LfBus

getAngle

public double getAngle()

Specified by:

getAngle in interface LfBus

setAngle

public void setAngle(double angle)

Specified by:

setAngle in interface LfBus

getShunt

public Optional<LfShunt> getShunt()

Specified by:

getShunt in interface LfBus

getControllerShunt

public Optional<LfShunt> getControllerShunt()

Specified by:

getControllerShunt in interface LfBus

getSvcShunt

public Optional<LfShunt> getSvcShunt()

Specified by:

getSvcShunt in interface LfBus

getGenerators

public List<LfGenerator> getGenerators()

Specified by:

getGenerators in interface LfBus

getLoad

public LfLoad getLoad()

Specified by:

getLoad in interface LfBus

getBranches

public List<LfBranch> getBranches()

Specified by:

getBranches in interface LfBus

addBranch

public void addBranch(LfBranch branch)

Specified by:

addBranch in interface LfBus

addHvdc

public void addHvdc(LfHvdc hvdc)

Specified by:

addHvdc in interface LfBus

dispatchQ

protected static double dispatchQ(List<LfGenerator> generatorsThatControlVoltage,
                                  boolean reactiveLimits,
                                  double qToDispatch)

updateState

public void updateState(LfNetworkStateUpdateParameters parameters)

Specified by:

updateState in interface LfBus

getTransformerVoltageControl

public Optional<TransformerVoltageControl> getTransformerVoltageControl()

Specified by:

getTransformerVoltageControl in interface LfBus

isTransformerVoltageControlled

public boolean isTransformerVoltageControlled()

Specified by:

isTransformerVoltageControlled in interface LfBus

setTransformerVoltageControl

public void setTransformerVoltageControl(TransformerVoltageControl transformerVoltageControl)

Specified by:

setTransformerVoltageControl in interface LfBus

getShuntVoltageControl

public Optional<ShuntVoltageControl> getShuntVoltageControl()

Specified by:

getShuntVoltageControl in interface LfBus

isShuntVoltageControlled

public boolean isShuntVoltageControlled()

Specified by:

isShuntVoltageControlled in interface LfBus

setShuntVoltageControl

public void setShuntVoltageControl(ShuntVoltageControl shuntVoltageControl)

Specified by:

setShuntVoltageControl in interface LfBus

setDisabled

public void setDisabled(boolean disabled)

Specified by:

setDisabled in interface LfElement

Overrides:

setDisabled in class AbstractElement

setP

public void setP(Evaluable p)

Specified by:

setP in interface LfBus

getP

public Evaluable getP()

Specified by:

getP in interface LfBus

setQ

public void setQ(Evaluable q)

Specified by:

setQ in interface LfBus

getQ

public Evaluable getQ()

Specified by:

getQ in interface LfBus

findNeighbors

public Map<LfBus,List<LfBranch>> findNeighbors()

Description copied from interface: LfBus

Find bus + parallel branches neighbors.

Specified by:

findNeighbors in interface LfBus

getRemoteVoltageControlReactivePercent

public double getRemoteVoltageControlReactivePercent()

Specified by:

getRemoteVoltageControlReactivePercent in interface LfBus

setRemoteVoltageControlReactivePercent

public void setRemoteVoltageControlReactivePercent(double remoteVoltageControlReactivePercent)

Specified by:

setRemoteVoltageControlReactivePercent in interface LfBus

getMismatchP

public double getMismatchP()

Description copied from interface: LfBus

Get active power mismatch. Only make sens for slack bus.

Specified by:

getMismatchP in interface LfBus

setZeroImpedanceNetwork

public void setZeroImpedanceNetwork(LoadFlowModel loadFlowModel,
                                    LfZeroImpedanceNetwork zeroImpedanceNetwork)

Specified by:

setZeroImpedanceNetwork in interface LfBus

getZeroImpedanceNetwork

public LfZeroImpedanceNetwork getZeroImpedanceNetwork(LoadFlowModel loadFlowModel)

Specified by:

getZeroImpedanceNetwork in interface LfBus

getAsym

public LfAsymBus getAsym()

Specified by:

getAsym in interface LfBus

setAsym

public void setAsym(LfAsymBus asym)

Specified by:

setAsym in interface LfBus