PowerSystem
Description
ExaPF.PowerSystem.AbstractPowerSystem
— TypeAbstractPowerSystem
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.
ExaPF.PowerSystem.PowerNetwork
— TypePowerNetwork <: 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.
ExaPF.PowerSystem.load_case
— Functionload_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.
API Reference
Network elements
ExaPF.PowerSystem.AbstractNetworkElement
— TypeAbstractNetworkElement
Abstraction for all physical elements being parts of a AbstractPowerSystem
. Elements are divided in
- transmission lines (
Lines
) - buses (
Buses
) - generators (
Generators
)
List of elements:
ExaPF.PowerSystem.Buses
— TypeBuses <: AbstractNetworkElement
Buses of a transmission network.
ExaPF.PowerSystem.Lines
— TypeLines <: AbstractNetworkElement
Lines of a transmission network.
ExaPF.PowerSystem.Generators
— TypeGenerators <: AbstractElement
Generators in a transmission network
Network attributes
ExaPF.PowerSystem.AbstractNetworkAttribute
— TypeAbstractNetworkAttribute
Attribute of a AbstractPowerSystem
.
List of attributes:
ExaPF.PowerSystem.NumberOfBuses
— TypeNumberOfBuses <: AbstractNetworkAttribute
Number of buses in a AbstractPowerSystem
.
ExaPF.PowerSystem.NumberOfLines
— TypeNumberOfLines <: AbstractNetworkAttribute
Number of lines in a AbstractPowerSystem
.
ExaPF.PowerSystem.NumberOfGenerators
— TypeNumberOfGenerators <: AbstractNetworkAttribute
Number of generators in a AbstractPowerSystem
.
ExaPF.PowerSystem.NumberOfPVBuses
— TypeNumberOfPVBuses <: AbstractNetworkAttribute
Number of PV buses in a AbstractPowerSystem
.
ExaPF.PowerSystem.NumberOfPQBuses
— TypeNumberOfPQBuses <: AbstractNetworkAttribute
Number of PQ buses in a AbstractPowerSystem
.
ExaPF.PowerSystem.NumberOfSlackBuses
— TypeNumberOfSlackBuses <: AbstractNetworkAttribute
Number of slack buses in a AbstractPowerSystem
.
ExaPF.PowerSystem.BaseMVA
— TypeBaseMVA <: AbstractNetworkAttribute
Base MVA of the network.
ExaPF.PowerSystem.BusAdmittanceMatrix
— TypeBusAdmittanceMatrix <: AbstractNetworkAttribute
Bus admittance matrix associated with the topology of the network.
Query the indexing of the different elements in a given network:
ExaPF.PowerSystem.PVIndexes
— TypePVIndexes <: AbstractIndexing
Indexes of the PV buses in a AbstractPowerSystem
.
ExaPF.PowerSystem.PQIndexes
— TypePQIndexes <: AbstractIndexing
Indexes of the PQ buses in a AbstractPowerSystem
.
ExaPF.PowerSystem.SlackIndexes
— TypeSlackIndexes <: AbstractIndexing
Indexes of the slack buses in a AbstractPowerSystem
.
ExaPF.PowerSystem.GeneratorIndexes
— TypeGeneratorIndexes <: AbstractIndexing
Indexes of the generators in a AbstractPowerSystem
.
Network values
ExaPF.PowerSystem.AbstractNetworkValues
— TypeAbstractNetworkValues
Numerical values attached to the different attributes of the network.
List of values:
ExaPF.PowerSystem.VoltageMagnitude
— TypeVoltageMagnitude <: AbstractNetworkValues
Magnitude |v|
of the voltage v = |v| exp(i θ)
.
ExaPF.PowerSystem.VoltageAngle
— TypeVoltageAngle <: AbstractNetworkValues
Angle θ
of the voltage v = |v| exp(i θ)
.
ExaPF.PowerSystem.ActivePower
— TypeActivePower <: AbstractNetworkValues
Active power P
of the complex power S = P + iQ
.
ExaPF.PowerSystem.ReactivePower
— TypeReactivePower <: AbstractNetworkValues
Reactive power Q
of the complex power S = P + iQ
.
ExaPF.PowerSystem.ActiveLoad
— TypeActiveLoad <: AbstractNetworkValues
Active load Pd
at buses.
ExaPF.PowerSystem.ReactiveLoad
— TypeReactiveLoad <: AbstractNetworkValues
Reactive load Qd
at buses.
Function to get the range of a given value:
ExaPF.PowerSystem.bounds
— Functionbounds(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())