PowerSystem

AbstractPowerSystem

First layer of the package. Store the topology of a given transmission network, including:

• the power injection at each bus ;
• the admittance matrix ;
• the default voltage at each bus.

Data are imported either from a matpower file, or a PSSE file.

PowerNetwork <: AbstractPowerSystem

This structure contains constant parameters that define the topology and physics of the power network.

The object PowerNetwork uses its own contiguous indexing for the buses. The indexing is independent from those specified in the Matpower or the PSSE input file. However, a correspondence between the two indexing (Input indexing to PowerNetwork indexing) is stored inside the attribute bus_to_indexes.

Note

The object PowerNetwork is created in the host memory. Use a AbstractFormulation object to move data to the target device.

load_case(case_name, lib::PowerNetworkLibrary=EXADATA)

Convenient function to load a PowerNetwork instance from one of the benchmark library (dir=EXADATA for MATPOWER, dir=PGLIB for PGLIB-OPF). Default library is lib=EXADATA.

Examples

julia> net = PS.load_case("case118") # default is MATPOWER
PowerNetwork object with:
    Buses: 118 (Slack: 1. PV: 53. PQ: 64)
    Generators: 54.

julia> net = PS.load_case("case1354_pegase", PS.PGLIB)
PowerNetwork object with:
    Buses: 1354 (Slack: 1. PV: 259. PQ: 1094)
    Generators: 260.

AbstractNetworkElement

Abstraction for all physical elements being parts of a AbstractPowerSystem. Elements are divided in

• transmission lines (Lines)
• buses (Buses)
• generators (Generators)

Buses <: AbstractNetworkElement

Buses of a transmission network.

Lines <: AbstractNetworkElement

Lines of a transmission network.

Generators <: AbstractElement

Generators in a transmission network

AbstractNetworkAttribute

Attribute of a AbstractPowerSystem.

NumberOfBuses <: AbstractNetworkAttribute

Number of buses in a AbstractPowerSystem.

NumberOfLines <: AbstractNetworkAttribute

Number of lines in a AbstractPowerSystem.

NumberOfGenerators <: AbstractNetworkAttribute

Number of generators in a AbstractPowerSystem.

NumberOfPVBuses <: AbstractNetworkAttribute

Number of PV buses in a AbstractPowerSystem.

NumberOfPQBuses <: AbstractNetworkAttribute

Number of PQ buses in a AbstractPowerSystem.

NumberOfSlackBuses <: AbstractNetworkAttribute

Number of slack buses in a AbstractPowerSystem.

BaseMVA <: AbstractNetworkAttribute

Base MVA of the network.

BusAdmittanceMatrix <: AbstractNetworkAttribute

Bus admittance matrix associated with the topology of the network.

PVIndexes <: AbstractIndexing

Indexes of the PV buses in a AbstractPowerSystem.

PQIndexes <: AbstractIndexing

Indexes of the PQ buses in a AbstractPowerSystem.

SlackIndexes <: AbstractIndexing

Indexes of the slack buses in a AbstractPowerSystem.

GeneratorIndexes <: AbstractIndexing

Indexes of the generators in a AbstractPowerSystem.

AbstractNetworkValues

Numerical values attached to the different attributes of the network.

VoltageMagnitude <: AbstractNetworkValues

Magnitude |v| of the voltage v = |v| exp(i θ).

VoltageAngle <: AbstractNetworkValues

Angle θ of the voltage v = |v| exp(i θ).

ActivePower <: AbstractNetworkValues

Active power P of the complex power S = P + iQ.

ReactivePower <: AbstractNetworkValues

Reactive power Q of the complex power S = P + iQ.

ActiveLoad <: AbstractNetworkValues

Active load Pd at buses.

ReactiveLoad <: AbstractNetworkValues

Reactive load Qd at buses.

bounds(pf::AbstractPowerSystem, attr::AbstractNetworkAttribute, val::AbstractNetworkValues)

Return lower and upper bounds corresponding to the admissible values of the AbstractNetworkAttribute attr.

Examples

p_min, p_max = bounds(pf, Generator(), ActivePower())
v_min, v_max = bounds(pf, Buses(), VoltageMagnitude())