Package com.powsybl.iidm.network.impl

Class BatteryImpl

java.lang.Object

com.powsybl.commons.extensions.AbstractExtendable<I>

com.powsybl.iidm.network.impl.BatteryImpl

All Implemented Interfaces:

Extendable<Battery>, Battery, Connectable<Battery>, Identifiable<Battery>, MultiVariantObject, Injection<Battery>, ReactiveLimitsHolder, Validable

public class BatteryImpl
extends AbstractExtendable<I>
implements Battery

Author:

Ghiles Abdellah <ghiles.abdellah at rte-france.com>

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	fictitious
protected String	id
protected String	name
protected final Properties	properties
protected boolean	removed
protected final List<com.powsybl.iidm.network.impl.TerminalExt>	terminals

Method Summary

Modifier and Type	Method	Description
void	addAlias(String alias)	Add an alias to the object.
void	addAlias(String alias, boolean ensureAliasUnicity)
void	addAlias(String alias, String aliasType)	Add an alias to the object.
void	addAlias(String alias, String aliasType, boolean ensureAliasUnicity)
void	allocateVariantArrayElement(int[] indexes, int sourceIndex)	Called to allocate a variant array element.
boolean	connect()
boolean	connect(Predicate<Switch> isTypeSwitchToOperate)
void	deleteVariantArrayElement(int index)	Called to delete a variant array element.
boolean	disconnect()
boolean	disconnect(Predicate<Switch> isSwitchOpenable)
void	extendVariantArraySize(int initVariantArraySize, int number, int sourceIndex)	Called to extend the variant array.
Set<String>	getAliases()	Get the aliases of the object.
Optional<String>	getAliasFromType(String aliasType)	Get the alias of the object with a given alias type if it exists.
Optional<String>	getAliasType(String alias)	Get the alias type of an alias if it exists, an empty optional otherwise.
String	getId()	Get the unique identifier of the object.
double	getMaxP()	Get the maximal active power in MW.
String	getMessageHeader()
double	getMinP()	Get the minimal active power in MW.
String	getNameOrId()	Get the name of the object if it exists.
NetworkImpl	getNetwork()	Get the network associated to the object.
NetworkImpl	getNetwork()
Optional<String>	getOptionalName()	Return an optional containing the name of the object if it exists.
NetworkExt	getParentNetwork()	Get the parent network, i.e. the smallest network containing the object.
Properties	getProperties()
String	getProperty(String key)	Get property associated to specified key.
String	getProperty(String key, String defaultValue)	Get property associated to specified key, with default value.
Set<String>	getPropertyNames()	Get properties key values.
ReactiveLimits	getReactiveLimits()	Get reactive limits of the generator.
<R extends ReactiveLimits> R	getReactiveLimits(Class<R> type)
double	getTargetP()	Get the target active power in MW.
double	getTargetQ()	Get the target reactive power in MVar.
com.powsybl.iidm.network.impl.TerminalExt	getTerminal()	Get the terminal.
List<com.powsybl.iidm.network.impl.TerminalExt>	getTerminals()
protected String	getTypeDescription()
boolean	hasAliases()	Return true if identifiable has aliases.
boolean	hasProperty()	Check that this object has some properties.
boolean	hasProperty(String key)	Check that this object has property with specified name.
boolean	isFictitious()	Get the fictitious status
protected void	move(com.powsybl.iidm.network.impl.TerminalExt oldTerminal, TopologyPoint oldTopologyPoint, int node, String voltageLevelId)
protected void	move(com.powsybl.iidm.network.impl.TerminalExt oldTerminal, TopologyPoint oldTopologyPoint, String busId, boolean connected)
MinMaxReactiveLimitsAdder	newMinMaxReactiveLimits()	Get a builder to create and associate minimum and maximum reactive limits to this generator.
ReactiveCapabilityCurveAdder	newReactiveCapabilityCurve()	Get a builder to create and associate a new reactive capability curve to this generator.
protected void	notifyUpdate(String attribute, Object oldValue, Object newValue)
protected void	notifyUpdate(String attribute, String variantId, Object oldValue, Object newValue)
protected void	notifyUpdate(Supplier<String> attribute, Object oldValue, Object newValue)
protected void	notifyUpdate(Supplier<String> attribute, String variantId, Object oldValue, Object newValue)
void	reduceVariantArraySize(int number)	Called to reduce the variant array.
void	remove()	Remove the connectable from the voltage level (dangling switches are kept).
void	removeAlias(String alias)	Remove an alias of the object.
<E extends Extension<I>> boolean	removeExtension(Class<E> type)	Remove an extension based on its class type.
boolean	removeProperty(String key)	Remove property with specified key.
void	setFictitious(boolean fictitious)	Set the fictitious status
Battery	setMaxP(double maxP)	Set the maximal active power in MW.
Battery	setMinP(double minP)	Set the minimal active power in MW.
Battery	setName(String name)	Update object name.
String	setProperty(String key, String value)	Set property value associated to specified key.
void	setReactiveLimits(ReactiveLimits reactiveLimits)
Battery	setTargetP(double targetP)	Set the target active power in MW.
Battery	setTargetQ(double targetQ)	Set the target reactive power in MVar.
String	toString()

Methods inherited from class com.powsybl.commons.extensions.AbstractExtendable

addExtension, getExtension, getExtensionByName, getExtensions, getImplementationName, removeExtension

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.powsybl.iidm.network.Battery

getP0, getQ0, getType, setP0, setQ0

Methods inherited from interface com.powsybl.iidm.network.Connectable

connect, connect, disconnect, disconnect, getTerminals, remove

Methods inherited from interface com.powsybl.commons.extensions.Extendable

addExtension, getExtension, getExtensionByName, getExtensions, getImplementationName, newExtension, removeExtension

Methods inherited from interface com.powsybl.iidm.network.Identifiable

addAlias, addAlias, addAlias, addAlias, getAliases, getAliasFromType, getAliasType, getId, getNameOrId, getNetwork, getOptionalName, getParentNetwork, getProperty, getProperty, getPropertyNames, hasAliases, hasProperty, hasProperty, isFictitious, removeAlias, removeProperty, setFictitious, setName, setProperty

Field Details

terminals

protected final List<com.powsybl.iidm.network.impl.TerminalExt> terminals

removed

protected boolean removed

id

protected String id

name

protected String name

fictitious

protected boolean fictitious

properties

protected final Properties properties

Method Details

getTypeDescription

protected String getTypeDescription()

getTargetP

public double getTargetP()

Get the target active power in MW.

Depends on the working variant.

Specified by:

getTargetP in interface Battery

See Also:

• VariantManager

setTargetP

public Battery setTargetP(double targetP)

Set the target active power in MW.

Depends on the working variant.

Specified by:

setTargetP in interface Battery

See Also:

• VariantManager

getTargetQ

public double getTargetQ()

Get the target reactive power in MVar.

Depends on the working variant.

Specified by:

getTargetQ in interface Battery

See Also:

• VariantManager

setTargetQ

public Battery setTargetQ(double targetQ)

Set the target reactive power in MVar.

Depends on the working variant.

Specified by:

setTargetQ in interface Battery

See Also:

• VariantManager

getMinP

public double getMinP()

Get the minimal active power in MW.

Specified by:

getMinP in interface Battery

setMinP

public Battery setMinP(double minP)

Set the minimal active power in MW.

Specified by:

setMinP in interface Battery

getMaxP

public double getMaxP()

Get the maximal active power in MW.

Specified by:

getMaxP in interface Battery

setMaxP

public Battery setMaxP(double maxP)

Set the maximal active power in MW.

Specified by:

setMaxP in interface Battery

getTerminal

public com.powsybl.iidm.network.impl.TerminalExt getTerminal()

Get the terminal.

Specified by:

getTerminal in interface Injection<Battery>

getReactiveLimits

public ReactiveLimits getReactiveLimits()

Get reactive limits of the generator.

Specified by:

getReactiveLimits in interface ReactiveLimitsHolder

setReactiveLimits

public void setReactiveLimits(ReactiveLimits reactiveLimits)

getReactiveLimits

public <R extends ReactiveLimits> R getReactiveLimits(Class<R> type)

Specified by:

getReactiveLimits in interface ReactiveLimitsHolder

newReactiveCapabilityCurve

public ReactiveCapabilityCurveAdder newReactiveCapabilityCurve()

Get a builder to create and associate a new reactive capability curve to this generator.

Specified by:

newReactiveCapabilityCurve in interface ReactiveLimitsHolder

newMinMaxReactiveLimits

public MinMaxReactiveLimitsAdder newMinMaxReactiveLimits()

Get a builder to create and associate minimum and maximum reactive limits to this generator.

Specified by:

newMinMaxReactiveLimits in interface ReactiveLimitsHolder

extendVariantArraySize

public void extendVariantArraySize(int initVariantArraySize,
 int number,
 int sourceIndex)

Called to extend the variant array.

Specified by:

extendVariantArraySize in interface MultiVariantObject

Parameters:

initVariantArraySize - initial variant array size

number - number of element to add

sourceIndex - the variant index to use to initialize new variants

reduceVariantArraySize

public void reduceVariantArraySize(int number)

Called to reduce the variant array.

Specified by:

reduceVariantArraySize in interface MultiVariantObject

Parameters:

number - number of element to remove

allocateVariantArrayElement

public void allocateVariantArrayElement(int[] indexes,
 int sourceIndex)

Called to allocate a variant array element. All new variants will be initialize using values of the variant sourceIndex.

Specified by:

allocateVariantArrayElement in interface MultiVariantObject

Parameters:

indexes - the indexes of the variant array to allocate

sourceIndex - the variant index to use to initialize new variants

getNetwork

NetworkImpl getNetwork()

getTerminals

public List<com.powsybl.iidm.network.impl.TerminalExt> getTerminals()

Specified by:

getTerminals in interface Connectable<I extends Connectable<I>>

getParentNetwork

public NetworkExt getParentNetwork()

Description copied from interface: Identifiable

Get the parent network, i.e. the smallest network containing the object.

Specified by:

getParentNetwork in interface Identifiable<I extends Connectable<I>>

getNetwork

public NetworkImpl getNetwork()

Description copied from interface: Identifiable

Get the network associated to the object.

Specified by:

getNetwork in interface Identifiable<I extends Connectable<I>>

remove

public void remove()

Description copied from interface: Connectable

Remove the connectable from the voltage level (dangling switches are kept).

Specified by:

remove in interface Connectable<I extends Connectable<I>>

notifyUpdate

protected void notifyUpdate(Supplier<String> attribute,
 Object oldValue,
 Object newValue)

notifyUpdate

protected void notifyUpdate(String attribute,
 Object oldValue,
 Object newValue)

notifyUpdate

protected void notifyUpdate(Supplier<String> attribute,
 String variantId,
 Object oldValue,
 Object newValue)

notifyUpdate

protected void notifyUpdate(String attribute,
 String variantId,
 Object oldValue,
 Object newValue)

deleteVariantArrayElement

public void deleteVariantArrayElement(int index)

Description copied from interface: MultiVariantObject

Called to delete a variant array element.

Specified by:

deleteVariantArrayElement in interface MultiVariantObject

Parameters:

index - the index of the variant array to delete

move

protected void move(com.powsybl.iidm.network.impl.TerminalExt oldTerminal,
 TopologyPoint oldTopologyPoint,
 int node,
 String voltageLevelId)

move

protected void move(com.powsybl.iidm.network.impl.TerminalExt oldTerminal,
 TopologyPoint oldTopologyPoint,
 String busId,
 boolean connected)

connect

public boolean connect()

Specified by:

connect in interface Connectable<I extends Connectable<I>>

connect

public boolean connect(Predicate<Switch> isTypeSwitchToOperate)

Specified by:

connect in interface Connectable<I extends Connectable<I>>

disconnect

public boolean disconnect()

Specified by:

disconnect in interface Connectable<I extends Connectable<I>>

disconnect

public boolean disconnect(Predicate<Switch> isSwitchOpenable)

Specified by:

disconnect in interface Connectable<I extends Connectable<I>>

getId

public String getId()

Description copied from interface: Identifiable

Get the unique identifier of the object.

Specified by:

getId in interface Identifiable<I extends Identifiable<I>>

getOptionalName

public Optional<String> getOptionalName()

Description copied from interface: Identifiable

Return an optional containing the name of the object if it exists. If not, return an empty optional.

Specified by:

getOptionalName in interface Identifiable<I extends Identifiable<I>>

getNameOrId

public String getNameOrId()

Description copied from interface: Identifiable

Get the name of the object if it exists. If not, get the unique identifier of the object.

Specified by:

getNameOrId in interface Identifiable<I extends Identifiable<I>>

setName

public Battery setName(String name)

Description copied from interface: Identifiable

Update object name.

Specified by:

setName in interface Identifiable<I extends Identifiable<I>>

Parameters:

name - new name of the object (could be null to erase the name)

Returns:

the object itself

getAliases

public Set<String> getAliases()

Description copied from interface: Identifiable

Get the aliases of the object.

Specified by:

getAliases in interface Identifiable<I extends Identifiable<I>>

getAliasType

public Optional<String> getAliasType(String alias)

Description copied from interface: Identifiable

Get the alias type of an alias if it exists, an empty optional otherwise. If the alias does not exist, return an empty optional.

Specified by:

getAliasType in interface Identifiable<I extends Identifiable<I>>

getAliasFromType

public Optional<String> getAliasFromType(String aliasType)

Description copied from interface: Identifiable

Get the alias of the object with a given alias type if it exists. Else return an empty optional.

Specified by:

getAliasFromType in interface Identifiable<I extends Identifiable<I>>

addAlias

public void addAlias(String alias)

Description copied from interface: Identifiable

Add an alias to the object. Aliases must be unique in associated Network, and different from any identifiable ID. No alias type is associated to this alias. If the alias already exists (i.e. is not unique) or equals an identifiable ID, throw a PowsyblException

Specified by:

addAlias in interface Identifiable<I extends Identifiable<I>>

addAlias

public void addAlias(String alias,
 boolean ensureAliasUnicity)

Specified by:

addAlias in interface Identifiable<I extends Identifiable<I>>

addAlias

public void addAlias(String alias,
 String aliasType)

Description copied from interface: Identifiable

Add an alias to the object. Aliases must be unique in associated Network, and different from any identifiable ID. This alias is associated to a given alias type. If the given alias type is null or empty, no alias type is considered associated to the alias. Only one alias can be associated to a non null given alias type for one object. If the alias already exists (i.e. is not unique) or equals an identifiable ID, throw a PowsyblException If a given non null type already has an associated alias for this object, throw a PowsyblException

Specified by:

addAlias in interface Identifiable<I extends Identifiable<I>>

addAlias

public void addAlias(String alias,
 String aliasType,
 boolean ensureAliasUnicity)

Specified by:

addAlias in interface Identifiable<I extends Identifiable<I>>

removeAlias

public void removeAlias(String alias)

Description copied from interface: Identifiable

Remove an alias of the object. If the alias does not exist for this object, throw a PowsyblException

Specified by:

removeAlias in interface Identifiable<I extends Identifiable<I>>

hasAliases

public boolean hasAliases()

Description copied from interface: Identifiable

Return true if identifiable has aliases.

Specified by:

hasAliases in interface Identifiable<I extends Identifiable<I>>

isFictitious

public boolean isFictitious()

Description copied from interface: Identifiable

Get the fictitious status

Specified by:

isFictitious in interface Identifiable<I extends Identifiable<I>>

setFictitious

public void setFictitious(boolean fictitious)

Description copied from interface: Identifiable

Set the fictitious status

Specified by:

setFictitious in interface Identifiable<I extends Identifiable<I>>

getMessageHeader

public String getMessageHeader()

Specified by:

getMessageHeader in interface Validable

getProperties

public Properties getProperties()

hasProperty

public boolean hasProperty()

Description copied from interface: Identifiable

Check that this object has some properties.

Specified by:

hasProperty in interface Identifiable<I extends Identifiable<I>>

hasProperty

public boolean hasProperty(String key)

Description copied from interface: Identifiable

Check that this object has property with specified name.

Specified by:

hasProperty in interface Identifiable<I extends Identifiable<I>>

getProperty

public String getProperty(String key)

Description copied from interface: Identifiable

Get property associated to specified key.

Specified by:

getProperty in interface Identifiable<I extends Identifiable<I>>

getProperty

public String getProperty(String key,
 String defaultValue)

Description copied from interface: Identifiable

Get property associated to specified key, with default value.

Specified by:

getProperty in interface Identifiable<I extends Identifiable<I>>

setProperty

public String setProperty(String key,
 String value)

Description copied from interface: Identifiable

Set property value associated to specified key.

Specified by:

setProperty in interface Identifiable<I extends Identifiable<I>>

removeProperty

public boolean removeProperty(String key)

Description copied from interface: Identifiable

Remove property with specified key.

Specified by:

removeProperty in interface Identifiable<I extends Identifiable<I>>

Parameters:

key - the property key

Returns:

true if property exists and has been removed, false otherwise

getPropertyNames

public Set<String> getPropertyNames()

Description copied from interface: Identifiable

Get properties key values.

Specified by:

getPropertyNames in interface Identifiable<I extends Identifiable<I>>

toString

public String toString()

Overrides:

toString in class Object

removeExtension

public <E extends Extension<I>> boolean removeExtension(Class<E> type)

Description copied from interface: Extendable

Remove an extension based on its class type.

Specified by:

removeExtension in interface Extendable<I extends Identifiable<I>>

Overrides:

removeExtension in class AbstractExtendable<I extends Identifiable<I>>

Type Parameters:

E - the extension type

Parameters:

type - the extension class type

Returns:

true if the extension has been removed false if extension has not been found