Problems

Solve load shedding problem with storage

Solve unit commitment load shedding problem (!relaxed)

solve_mc_model(
    data::Dict{String,<:Any},
    model_type::Type,
    optimizer,
    build_mc::Function;
    ref_extensions::Vector{<:Function}=Function[],
    multinetwork::Bool=false,
    global_keys::Set{String}=Set{String}(),
    eng2math_extensions::Vector{<:Function}=Function[],
    eng2math_passthrough::Dict{String,<:Vector{<:String}}=Dict{String,Vector{String}}(),
    make_si::Bool=!get(data, "per_unit", false),
    make_si_extensions::Vector{<:Function}=Function[],
    dimensionalize_math_extensions::Dict{String,Dict{String,Vector{String}}}=Dict{String,Dict{String,Vector{String}}}(),
    kwargs...
)::Dict{String,Any}

Takes data in either the ENGINEERING or MATHEMATICAL model, a model type (e.g., ACRUPowerModel), and model builder function (e.g., build_mc_opf), and returns a solution in the original data model defined by data.

If make_si is false, data will remain in per-unit.

For an explanation of multinetwork and global_keys, see make_multinetwork

For an explanation of eng2math_extensions and eng2math_passthrough, see transform_data_model

For an explanation of make_pu_extensions, see make_per_unit!

For an explanation of ref_extensions, see instantiate_mc_model

For an explanation of map_math2eng_extensions, make_si, make_si_extensions, and dimensionalize_math_extensions, see solution_make_si

solve_mc_model(
    file::String,
    model_type::Type,
    optimizer,
    build_mc::Function;
    dss2eng_extensions::Vector{<:Function}=Function[],
    multinetwork::Bool=false,
    global_keys::Set{String}=Set{String}(),
    kwargs...
)::Dict{String,Any}

Given a file::String, data will be parsed automatically from the file.

See solve_mc_model for detailed explanation of function arguments.

function solve_mc_opf(
	data::Union{Dict{String,<:Any},String},
	model_type::Type,
	solver;
	kwargs...
)

Solve Optimal Power Flow

solve_mc_opf_capc(data::Union{Dict{String,<:Any},String}, model_type::Type, solver; kwargs...)

Solve OPF with capacitor control

Solve on-load tap-changer OPF

solve_mc_opf_capc(data::Union{Dict{String,<:Any},String}, model_type::Type, solver; kwargs...)

Solve OPF with capacitor control

Solve OPF problem with slack power at every bus

Power Flow Problem

Solve PF problem with slack power at every bus

Solve multinetwork load shedding problem with storage

function solve_mn_mc_opf(
	data::Union{Dict{String,<:Any},String},
	model_type::Type,
	solver;
	kwargs...
)

Solve multinetwork optimal power flow problem

function solve_mn_mc_opf_oltc(
	data::Union{Dict{String,<:Any},String},
	model_type::Type,
	solver;
	kwargs...
)

Solve multinetwork oltc optimal power flow problem

Load shedding problem for Branch Flow model

Load shedding problem including storage (snap-shot)

Load shedding problem for Branch Flow model

Standard unit commitment (!relaxed) load shedding problem

function build_mc_opf(
	pm::AbstractExplicitNeutralACRModel
)

constructor for OPF in power-voltage variable space with explicit neutrals

function build_mc_opf(
	pm::AbstractExplicitNeutralIVRModel
)

constructor for OPF in current-voltage variable space with explicit neutrals

function build_mc_opf(
	pm::AbstractUBFModels
)

constructor for branch flow opf

function build_mc_opf(
	pm::AbstractUnbalancedIVRModel
)

constructor for OPF in current-voltage variable space

function build_mc_opf(
	pm::AbstractUnbalancedPowerModel
)

Constructor for Optimal Power Flow

constructor for branch flow opf with capcontrol

constructor for capcontrol OPF in current-voltage variable space

build_mc_opf_capc(pm::AbstractUnbalancedPowerModel)

Constructor for capcontrol OPF

constructor for branch flow on-load tap-changer OPF

constructor for on-load tap-changer OPF

constructor for branch flow opf

build_mc_opf_capc(pm::AbstractUnbalancedPowerModel)

Constructor for capcontrol OPF

OPF problem with slack power at every bus

Constructor for Branch Flow Power Flow

Constructor for Power Flow in current-voltage variable space

Constructor for Power Flow Problem

PF problem with slack power at every bus

Multinetwork load shedding problem for Branch Flow model

Multinetwork load shedding problem including storage

function buildmcopf( pm::AbstractExplicitNeutralIVRModel )

constructor for multinetwork OPF in current-voltage variable space with explicit neutrals

function build_mn_mc_opf(
	pm::AbstractUBFModels
)

Multinetwork branch flow optimal power flow problem

function build_mn_mc_opf(
	pm::AbstractUnbalancedIVRModel
)

Multinetwork current-voltage optimal power flow problem

function build_mn_mc_opf(
	pm::AbstractUnbalancedPowerModel
)

Multinetwork optimal power flow problem

function build_mn_mc_opf_oltc(
	pm::AbstractUnbalancedPowerModel
)

Constructor for otlc Optimal Power Flow

build_pf_result(
  pfd::PowerFlowData,
  Uv::Vector,
  status::PFTerminationStatus,
  its::Int,
  time::Real,
  stationarity::Real,
  verbose::Bool
)

Builds the result dict from the solution dict.

build_pf_solution(
  pfd::PowerFlowData,
  Uv::Vector
)

Builds the solution dict.

instantiate_mc_model(
    data::Dict{String,<:Any},
    model_type::Type,
    build_method::Function;
    ref_extensions::Vector{<:Function}=Function[],
    multinetwork::Bool=false,
    global_keys::Set{String}=Set{String}(),
    eng2math_extensions::Vector{<:Function}=Function[],
    eng2math_passthrough::Dict{String,<:Vector{<:String}}=Dict{String,Vector{String}}(),
    make_pu_extensions::Vector{<:Function}=Function[],
    kwargs...
)

Takes data in either the ENGINEERING or MATHEMATICAL model, a model type (e.g., ACRUPowerModel), and model builder function (e.g., build_mc_opf), and returns an AbstractUnbalancedPowerModel structure.

For an explanation of multinetwork and global_keys, see make_multinetwork

For an explanation of eng2math_extensions and eng2math_passthrough, see transform_data_model

For an explanation of make_pu_extensions, see make_per_unit!

ref_extensions

Inside of the model structures, data can be quickly accessed via the ref function. By default, the only ref objects available are created by ref_add_core!, but users can add their own custom ref objects by passing functions via ref_extensions that have the signature:

ref_add!(ref::Dict{Symbol,Any}, data::Dict{String,Any})

See the Beginners Guide for an example.

sol_data_model!(pm::AbstractUnbalancedACRModel, solution::Dict{String,<:Any})

solutionprocessor, see [`solvemcmodel`](@ref solvemc_model), to convert ACR variables back into polar representation (default data model voltage form)

sol_data_model!(pm::AbstractUnbalancedPowerModel, solution::Dict{String,<:Any})

does nothing (no sol_data_model! exists for the formulation attempting to be converted)

sol_data_model!(pm::AbstractUnbalancedWModels, solution::Dict{String,<:Any})

solutionprocessor, see [`solvemcmodel`](@ref solvemc_model), to convert W variables back into polar representation (default data model voltage form)

sol_data_model!(pm::FBSUBFPowerModel, solution::Dict{String,<:Any})

solution_processor, to convert FBS variables back into polar representation (default data model voltage form)

sol_data_model!(pm::FOTRUPowerModel, solution::Dict{String,<:Any})

solution_processor, to convert FOT rectangular variables back into polar representation (default data model voltage form)