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 <geoffroy.jamgotchian at rte-france.com>

Nested Class Summary

Nested classes/interfaces inherited from interface com.powsybl.openloadflow.network.LfBus

LfBus.QLimitType

Field Summary

Fields

Modifier and Type	Field	Description
protected double	angle
protected LfAsymBus	asym
protected final List<LfBranch>	branches
protected Evaluable	calculatedV
protected LfShunt	controllerShunt
protected boolean	distributedOnConformLoad
protected Double	generationTargetP
protected double	generationTargetQ
protected final List<LfGenerator>	generators
protected boolean	generatorVoltageControlEnabled
protected final List<LfHvdc>	hvdcs
protected final List<LfLoad>	loads
protected static final org.slf4j.Logger	LOGGER
protected Evaluable	p
protected Evaluable	q
protected LfBus.QLimitType	qLimitType
protected boolean	reactivePowerControlEnabled
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 final 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> generatorsWithControl, boolean reactiveLimits, ReactivePowerDispatchMode reactivePowerDispatchMode, double qToDispatch)
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<?>>	getHighestPriorityMainVoltageControl()	Get the highest priority voltage control connected to a bus of the zero impedance subgraph to which this bus belong.
List<LfLoad>	getLoads()
double	getLoadTargetP()
double	getLoadTargetQ()
double	getMaxP()
double	getMaxQ()
double	getMinQ()
double	getMismatchP()	Get active power mismatch.
protected LfLoadImpl	getOrCreateLfLoad(com.powsybl.iidm.network.LoadModel loadModel, LfNetworkParameters parameters)
Evaluable	getP()
Evaluable	getQ()
Optional<LfBus.QLimitType>	getQLimitType()
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()
Optional<VoltageControl<?>>	getVoltageControl(VoltageControl.Type type)
List<VoltageControl<?>>	getVoltageControls()	Get list of all voltage controls (generator + transformer + shunt) linked to this bus.
LfZeroImpedanceNetwork	getZeroImpedanceNetwork(LoadFlowModel loadFlowModel)
boolean	hasGeneratorsWithSlope()
boolean	hasReactivePowerControl()
void	invalidateGenerationTargetP()
boolean	isGeneratorVoltageControlEnabled()
boolean	isGeneratorVoltageControlled()
boolean	isReactivePowerControlEnabled()
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.
boolean	isVoltageControlled(VoltageControl.Type type)
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	setP(Evaluable p)
void	setQ(Evaluable q)
void	setQLimitType(LfBus.QLimitType qLimitType)
void	setReactivePowerControl(ReactivePowerControl reactivePowerControl)
void	setReactivePowerControlEnabled(boolean reactivePowerControlEnabled)
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 Details

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

reactivePowerControlEnabled

protected boolean reactivePowerControlEnabled

generationTargetP

protected Double generationTargetP

generationTargetQ

protected double generationTargetQ

qLimitType

protected LfBus.QLimitType qLimitType

generators

protected final List<LfGenerator> generators

shunt

protected LfShunt shunt

controllerShunt

protected LfShunt controllerShunt

svcShunt

protected LfShunt svcShunt

distributedOnConformLoad

protected boolean distributedOnConformLoad

loads

protected final List<LfLoad> loads

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 Details

AbstractLfBus

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

Method Details

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

isVoltageControlled

public boolean isVoltageControlled(VoltageControl.Type type)

Specified by:

isVoltageControlled in interface LfBus

getVoltageControl

public Optional<VoltageControl<?>> getVoltageControl(VoltageControl.Type type)

Specified by:

getVoltageControl in interface LfBus

getHighestPriorityMainVoltageControl

public Optional<VoltageControl<?>> getHighestPriorityMainVoltageControl()

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:

getHighestPriorityMainVoltageControl 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

hasReactivePowerControl

public boolean hasReactivePowerControl()

Specified by:

hasReactivePowerControl in interface LfBus

isReactivePowerControlEnabled

public boolean isReactivePowerControlEnabled()

Specified by:

isReactivePowerControlEnabled in interface LfBus

setReactivePowerControlEnabled

public void setReactivePowerControlEnabled(boolean reactivePowerControlEnabled)

Specified by:

setReactivePowerControlEnabled 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

getOrCreateLfLoad

protected LfLoadImpl getOrCreateLfLoad(com.powsybl.iidm.network.LoadModel loadModel,
 LfNetworkParameters parameters)

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

getLoadTargetQ

public double getLoadTargetQ()

Specified by:

getLoadTargetQ in interface LfBus

getMaxP

public double getMaxP()

Specified by:

getMaxP in interface LfBus

getMinQ

public double getMinQ()

Specified by:

getMinQ in interface LfBus

getMaxQ

public double getMaxQ()

Specified by:

getMaxQ in interface LfBus

getQLimitType

public Optional<LfBus.QLimitType> getQLimitType()

Specified by:

getQLimitType in interface LfBus

setQLimitType

public void setQLimitType(LfBus.QLimitType qLimitType)

Specified by:

setQLimitType 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

getLoads

public List<LfLoad> getLoads()

Specified by:

getLoads 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> generatorsWithControl,
 boolean reactiveLimits,
 ReactivePowerDispatchMode reactivePowerDispatchMode,
 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