com.powsybl.iidm.network.VoltageLevel is used to model a voltage level. A voltage level is is a collection of equipments located in the same substation and at the same base voltage. It can contain batteries, generators,
loads, shunt compensators, static var compensators, DC converter stations, dangling lines and switches.
A voltage level contains a topology model, i.e. an object that describes how equipments are connected together. A voltage level may have two kinds of topology model depending on what level of detail we want to have:
A topology model can be accessed through the 3 following views ordered from the most detailed to the less detailed:
Depending on the topology model kind of the voltage level a view can have the status:
The view status is summarized in the following table:
|id||String||-||yes||-||The ID of the voltage level|
|name||String||-||no||-||The name of the voltage level|
|NominalV||double||kV||yes||-||The nominal voltage|
|LowVoltageLimit||double||kV||no||-||The low voltage limit|
|HighVoltageLimit||double||kV||no||-||The high voltage limit|
||-||yes||-||The kind of topology|
TopologyKind describes the topology model of the voltage level i.e. how equipments are connected together. The
com.powsybl.iidm.network.TopologyKind enum contains these two values:
NODE_BREAKER corresponds to a node/breaker model, which is the most detailed way to describe a topology. All
elements are physical ones: busbar sections, breakers and disconnectors. A node in a node/breaker context means
“connectivity node” and not topological node or bus.
BUS_BREAKER corresponds to a bus/breaker model, which is an aggregated form of the topology made of buses and breakers. A bus is the aggregation of busbar sections and closed switches.
This example shows how to create a new
VoltageLevel voltageLevel = substation.newVoltageLevel() .setId("VL") .setName("VL") // optional .setNominalV(20) .setTopologyKind(TopologyKind.NODE_BREAKER) .setLowVoltageLimit(15) .setHighVoltageLimit(25) .add();