com.powsybl.iidm.network.ShuntCompensator interface is used to model a shunt compensator.
|bPerSection||double||S||yes||-||The Positive sequence shunt (charging) susceptance per section|
|MaximumSectionCount||integer||int||yes||-||The maximum number of sections that may be switched on|
|CurrentSectionCount||integer||int||yes||-||The current number of section that may be switched on|
||-||no||The shunt compensator’s terminal||The terminal used for regulation|
||-||The voltage target|
||-||The deadband used to avoid excessive update of controls|
|VoltageRegulatorOn||boolean||-||no||false||The voltage regulating status|
A section of a shunt compensator is an individual capacitor or reactor. A value of bPerSection positive means it is modeling a capacitor, an equipment that injects reactive power into the bus. A value of bPerSection negative means a reactor, an equipment that can absorb excess reactive power from the network.
The current section count is expected to be greater than one and lesser or equal to the maximum section count.
Regulation for shunt compensators does not necessarily model automation, it can represent human actions on the network e.g. an operator activating or deactivating a shunt compensator). However, it can of course be integrated on a power flow calculation or not, depending of what is wanted to be shown.
The Target Deadband defines the margin withing which the target voltage is considered as respected for discrete regulation i.e. the target voltage is considered as respected
if the read voltage equals
Shunt compensators follow a load sign convention:
In case of a capacitor, the value for its Q will be negative. In case of a reactor, the value for its Q will be positive.
This example shows how to create a new
ShuntCompensator in the network:
ShuntCompensator shunt = network.getVoltageLevel("VL").newShunt() .setId("SHUNT") .setBus("BUS1") .setConnectableBus("BUS1") .setbPerSection(5.0) .setCurrentSectionCount(6) .setMaximumSectionCount(10) .setTargetV(200) .setTargetDeadband(10) .setRegulatingTerminal(terminal) .setVoltageRegulatorOn(true) .add();