Shunt compensator

The com.powsybl.iidm.network.ShuntCompensator interface is used to model a shunt compensator.

# Characteristics

Attribute Type Unit Required Default value Description
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
RegulatingTerminal Terminal - no The shunt compensator’s terminal The terminal used for regulation
TargetV double kV only if VoltageRegulatorOn is set to true - The voltage target
TargetDeadband double kV only if VoltageRegulatorOn is set to true - The deadband used to avoid excessive update of controls
VoltageRegulatorOn boolean - no false The voltage regulating status

## Section

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.

## Current Section Count

The current section count is expected to be greater than one and lesser or equal to the maximum section count.

## Regulation

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 targetV±(targetDeadband/2).

# Flow sign convention

Shunt compensators follow a load sign convention:

• Flow out from bus has positive sign.
• Consumptions are positive.

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.

# Examples

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