Internal Functions

items that are mapped one-to-one from engineering to math models

A mapping of supported component types to their functional interfaces.

different acceptable delimiters for arrays

field names that should become multi-conductor matrix not arrays

field names that should not be multi-conductor values

conversion factors for units to meters

two number operators for reverse polish notation

dss to pmd capcontrol type

dss to pmd load model

regex for dss arrays

regex for dss 'buscoords' command

regex for dss 'more' command

regex for dss 'new' command

regex for dss 'set' command

all objects that define controls

all data holding objects

all edge types that can help define buses

regex for dss matrices

all objects that provide montoring

all node types that can help define buses

collection of dss properties that have been renamed (i.e., deprecated)

regex for dss rpn arrays

const built at import of short property names

supported dss commands

components currently supported for automatic data type parsing

unsupported dss commands

list of edge type elements in the engineering model

data check functions for the engineering data model

Data types of accepted fields in the engineering data model

required fields in the engineering data model

list of nodal type elements in the engineering model

properties that should be excluded from being overwritten during the application of like

collect of components and their properties that define loss models when transforming to the MATHEMATICAL model

list of math asset types that are dispatchable

list of edge type elements in the engineering model

list of nodal type elements in the engineering model

list of multinetwork keys that belong at the root level

single number operators in reverse polish notation

Base.delete! for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.delete! for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.eltype for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.get for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.getindex for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.getproperty for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.haskey for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.isempty for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.iterate for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.keys for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.keytype for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.length for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.merge! for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Parses dss capacitor control type into CapControlType enum

Parses dss conn properties into ConnConfig enum

Parses dss load model into LoadModel enum

Parses dss enabled property into Status enum

parser to pass through String

parses a dss type matrix into Matrix{T}

parses a dss type vector into Vector{T}

Base.setindex! for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.setproperty! for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.show variant for InfrastructureModel,InfrastructureObject to make them Dict-like

Base.show variant for InfrastructureModel,InfrastructureObject to make them Dict-like

Base.summary for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.valtype for InfrastructureModel,InfrastructureObject to give them Dict-like behavior

Base.zero for Char

Base.zero for ConnConfig enum

Base.zero for Dispatchable enum

Base.zero for LoadModel enum

Base.zero for ShuntModel enum

Base.zero for Status enum

Base.zero for String

Base.zero for SwitchState enum

custom build_solution_values for multiconductor (vector) JuMP expressions

custom build_solution_values for generic dense axis arrays

custom build_solution_values for multiconductor (vector) constants

custom build_solution_values for multiconductor (vector) constants

Definition of the default solution preprocessor for PowerModelsDistribution

add engineering data object to engineering data model

convert cost model names

When a terminal is grounded, any pairwise bounds it occurs in imply an absolute bound for the other terminal in the pair. This method converts such pairwise bounds to absolute ones.

adds kwargs that were specified but unused by the required defaults to the component

_adjust_line_limits!(data_eng::Dict{String,<:Any}, mult::Real)

Multiplies limits (sm_ub and/or cm_ub) on line objects (line, linecode, switch) by a multiplier mult

_adjust_small_line_admittances!(data_eng::Dict{String,<:Any}; min_admittance_val::Real=1e-2, replace_admittance_val::Real=0.0)

Replaces admittances (gfr, gto, bfr, bto) on lines, linecodes, and switches lower than min_admittance_val with replace_admittance_val.

_adjust_small_line_impedances!(data_eng::Dict{String,<:Any}; min_impedance_val::Real=1e-2, replace_impedance_val::Real=0.0)

Replaces impedances (rs, xs) on lines, linecodes, and switches lower than min_impedance_val with replace_impedance_val.

_adjust_small_line_lengths!(data_eng::Dict{String,<:Any}; min_length_val::Real=25.0, replace_length_val::Real=0.0)

Replaces length on lines, switches lower than min_length_val with replace_length_val.

_adjust_transformer_limits!(data_eng::Dict{String,<:Any}, mult::Real)

Multiplies limits (sm_ub and/or cm_ub) on transformer objects by a multiplier mult

converts admittance by multiplying by 2πωl

Filters out values of a vector or matrix for certain properties (transformer winding variant)

Filters out values of a vector or matrix for certain properties

helper to apply function values

_apply_kron_reduction!(data_eng::Dict{String,<:Any}; kr_phases::Union{Vector{Int},Vector{String}}=[1,2,3], kr_neutral::Union{Int,String}=4)

Applies a Kron Reduction to the network, reducing out the kr_neutral, leaving only the kr_phases

applies a linecode to a line in preparation for converting to mathematical model

_apply_phase_projection!(data_eng::Dict{String,<:Any})

pad matrices and vectors to max number of conductors

_apply_phase_projection_delta!(data_eng::Dict{String,<:Any})

phase projection for components where unprojected states are not yet supported (delta configurations).

See apply_phase_projection!

_apply_voltage_angle_difference_bounds!(eng::Dict{String,<:Any}, vad::Real=5.0)

Applies voltage angle difference bound given by vad::Real in degrees (i.e., the allowed drift of angle from one end of a line to another) to all lines. By default, vad=5.0.

_apply_voltage_bounds!(data_eng::Dict{String,<:Any}; vm_lb::Union{Real,Missing}=0.9, vm_ub::Union{Real,Missing}=1.1)

add voltage bounds to all buses based on per-unit upper (vm_ub) and lower (vm_lb), scaled by the bus's voltage based

applies a xfmrcode to a transformer in preparation for converting to mathematical model

Combines transformers with 'bank' keyword into a single transformer

shifts a vector by shift spots to the left

finds the largest active generation asset (gen, storage) in an island

find the largest active generator in a collection of generators

_bts_to_start_voltage(
    dm::Dict
)

Assigns the initialisation voltages to appropriate bus terminals.

helper function to build bus shunt matrices for power balance constraints

loss model builder for transformer decomposition

_build_mc_mn_opb(pm::AbstractUnbalancedPowerModel)

Constructor for Optimal Power Balance

constructor for branch flow osw

constructor for OSW in current-voltage variable space

Constructor for Optimal Switching

_build_mc_osw_mi(pm::AbstractUBFModels)

constructor for mixed-integer branch flow osw

Constructor for Optimal Switching

helper function to properly reference time series variables from opendss

Returns a total (shunt+series) current magnitude bound for the from and to side of a branch. The total power rating also implies a current bound through the lower bound on the voltage magnitude of the connected buses.

Returns a total (shunt+series) current magnitude bound for the from and to side of a branch. The total power rating also implies a current bound through the lower bound on the voltage magnitude of the connected buses.

Returns a total (shunt+series) power magnitude bound for the from and to side of a branch. The total current rating also implies a current bound through the upper bound on the voltage magnitude of the connected buses.

Returns a total (shunt+series) power magnitude bound for the from and to side of a branch. The total current rating also implies a current bound through the upper bound on the voltage magnitude of the connected buses.

Returns a valid series current magnitude bound for a branch.

Returns bounds in line-to-line bounds on the voltage magnitude. If these are not part of the problem specification, then a valid upper bound is implied by the line-to-neutral bounds, but a lower bound (greater than zero) is not. Therefore, a default lower bound is then used, specified by the keyword argument vdmin_eps. The returned bounds are for the pairs 1->2, 2->3, 3->1

_calc_comp_lines(component::Dict{String,<:Any})

compute lines in m and b from from pwl cost models

computes the connected components of the network graph returns a set of sets of bus ids, each set is a connected component

computes the connected components of the network graph returns a set of sets of bus ids, each set is a connected component

Returns a current magnitude bound for the generators.

Given a set of terminals 'cnds' with associated shunt admittance 'Y', this method will calculate the reduced admittance matrix if terminal 'ground' is grounded.

Returns magnitude bounds for the current going through the load.

Returns a magnitude bound for the current going through the load.

Calculates lower and upper bounds for the loads themselves (not the power withdrawn at the bus).

Returns the voltage magnitude bounds for the individual load elements in a multiphase load. These are inferred from vmin/vmax for wye loads and from calcbusvmll_bounds for delta loads.

_calc_max_cost_index(data::Dict{String,<:Any})

Computes maximum cost index of subnetworks

Given a set of addmittances 'y' connected from the conductors 'fcnds' to the conductors 'tcnds', this method will return a list of conductors 'cnd' and a matrix 'Y', which will satisfy I[cnds] = Y*V[cnds].

Returns a current magnitude bound for the from and to side of a transformer. The total power rating also implies a current bound through the lower bound on the voltage magnitude of the connected buses.

Returns a power magnitude bound for the from and to side of a transformer. The total current rating also implies a current bound through the upper bound on the voltage magnitude of the connected buses.

_calc_voltage_bases(data_model::Dict{String,<:Any}, vbase_sources::Dict{String,<:Real}, edge_elements::Vector{String})::Tuple{Dict,Dict}

Calculates voltage bases for each voltage zone for buses and branches given a list of edge_elements

DFS on a graph

checks that all branches connect two distinct buses

bus data checks

checks bus_name exists and has terminals

checks the connection configuration and infers the dimensions of the connection (number of connected terminals)

checks connectivity of object

checks that all buses are unique and other components link to valid buses

checks that an engineering model component has the correct data types

checks if data structures are equivalent, and if not, will enumerate the differences

generator data checks

checks that a component has fields

check that fields has size data_size

line data checks

linecode data checks

load data checks

Returns a Bool, indicating whether the convex hull of the voltage-dependent relationship needs a cone inclusion constraint.

check that all data in fields have the same size

shunt data checks

shunt capacitor data checks

Transformer, n-windings three-phase lossy data checks

checks if a sufficient number of variables exist for the given keys collection

voltage source data checks

composeyprimbankedidealtransformersDyg( ts::Vector, npairsfr::Tuple, npairsto::Tuple, ppm::Float )

Modifies ideal delta-wye_grounded transformers to avoid singularity error, through the ppm value, inspired by OpenDSS.

composeyprimbankedidealtransformersYgyg( ts::Vector, npairsfr::Tuple, npairsto::Tuple, ppm::Float )

Modifies ideal wyegrounded-wyegrounded transformers to avoid singularity error, through the ppm value, inspired by OpenDSS.

_compose_yprim_banked_ideal_transformers_Yy(
  ts::Vector,
  npairs_fr::Tuple,
  npairs_to::Tuple,
  ppm::Float
)

Modifies ideal wye-wye transformers to avoid singularity error, through the ppm value, inspired by OpenDSS.

_compute_Uv(
  pfd::PowerFlowData,
  max_iter::Int,
  stat_tol::Float,
  verbose::Bool
)

Computes a nonlinear AC power flow in rectangular coordinates based on the admittance matrix of the network data using the fixed-point current injection method (See https://arxiv.org/abs/2305.04405). Returns a solution data structure in PowerModelsDistribution Dict format.

computes the bus type based on existing bustype, the status of the generation object, and the controlmode

_compute_mc_pf(
    data_math::Dict{String,<:Any};
    v_start::Union{Dict{<:Any,<:Any},Missing}=missing,
    explicit_neutral::Bool=false,
    max_iter::Int=100,
    stat_tol::Real=1E-8,
    verbose::Bool=false
)::Dict{String,Any}

Computes native power flow and outputs the result dict (See https://arxiv.org/abs/2305.04405).

Abbreviations:

• ntype: node type (variable, fixed, grounded, virtual)
• bts: bus-terminals for the component
• ns: nodes
• vns: virtual nodes
• nr_vns: number of virtual nodes
• y_prim: primitive admittance matrix for the component
• cnlfunc: nonlinear compensation current function handle for the component
• ctotsfunc: total current function handle for the component

lossy grounding to perfect grounding and shunts

Helper function to convert InfrastructureModel,InfrastructureObject into Dict{String,Any}

checks that all parallel branches have the same orientation

checks bus types are suitable for a power flow study, if not, fixes them. the primary checks are that all type 2 buses (i.e., PV) have a connected and active generator and there is a single type 3 bus (i.e., slack bus) with an active connected generator. Assumes that the network is a single connected component

throws warnings if cost functions are malformed

throws warnings if cost functions are malformed

_correct_mc_thermal_limits!(data::Dict{String,<:Any})

checks that each branch has non-negative thermal ratings and removes zero thermal ratings

_correct_mc_voltage_angle_differences!(data::Dict{String,<:Any}, default_pad::Real=deg2rad(10.0))

checks that voltage angle differences are within 90 deg., if not tightens to a default of 10deg (adjustable)

_cpf_branch_interface(
  branch::Dict,
  v_start::Dict,
  explicit_neutral::Bool,
  line_vbase::Dict,
  sbase::Float
)

Branch component interface outputs branch primitive Y matrix (See https://arxiv.org/abs/2305.04405 Section 4.1).

_cpf_generator_interface(
  gen::Dict,
  v_start::Dict,
  explicit_neutral::Bool,
  line_vbase::Dict,
  sbase::Float
)

Generator component interface outputs generator primitive Y matrix (See https://arxiv.org/abs/2305.04405 Section 4.4 and 4.5).

_cpf_load_interface(
  load::Dict,
  v_start::Dict,
  explicit_neutral::Bool,
  line_vbase::Dict,
  sbase::Float
)

Load component interface outputs load primitive Y matrix (See https://arxiv.org/abs/2305.04405 Sections 4.4 and 4.5).

_cpf_shunt_interface(
  shunt::Dict,
  v_start::Dict,
  explicit_neutral::Bool,
  line_vbase::Dict,
  sbase::Float
)

Shunt component interface outputs shunt primitive Y matrix (See https://arxiv.org/abs/2305.04405 Section 4.2).

_cpf_storage_interface(
  storage::Dict,
  v_start::Dict,
  explicit_neutral::Bool,
  line_vbase::Dict,
  sbase::Float
)

Storage component interface outputs storage primitive Y matrix (See https://arxiv.org/abs/2305.04405 Section 4.4 and 4.5).

_cpf_switch_interface(
  switch::Dict,
  v_start::Dict,
  explicit_neutral::Bool,
  line_vbase::Dict,
  sbase::Float
)

Branch component interface outputs branch primitive Y matrix (See https://arxiv.org/abs/2305.04405 Section 4.2).

_cpf_transformer_interface(
  tr::Dict,
  v_start::Dict,
  explicit_neutral::Bool,
  line_vbase::Dict,
  sbase::Float
)

Transformer component interface outputs transformer primitive Y matrix (See https://arxiv.org/abs/2305.04405 Section 4.3).

Discovers all of the buses (not separately defined in OpenDSS), from 'lines'

discovers all terminals in the network

discover_voltage_zones(data_model::Dict{String,<:Any}, edge_elements::Vector{String})::Dict{Int,Set{Any}}

finds voltage zones by walking through the network and analyzing the transformers

Adds nodes as buses to data_eng from data_dss

Parses buscoords lon,lat (if present) into their respective buses

Adds capacitors to data_eng from data_dss

Adds capcontrol to data_eng from data_dss

Adds generators to data_eng from data_dss

Adds lines to data_eng from data_dss

Adds lines to data_eng from data_dss

Adds loads to data_eng from data_dss

Constant can still be scaled by other settings, fixed cannot Note that in the current feature set, fixed therefore equals constant

1: Constant P and Q, default 2: Constant Z 3: Constant P and quadratic Q 4: Exponential 5: Constant I 6: Constant P and fixed Q

7: Constant P and quadratic Q (i.e., fixed reactance)

8: ZIP

Adds loadshapes to data_eng from data_dss

Adds pvsystems to data_eng from data_dss

Adds shunt reactors to data_eng from data_dss

Adds regcontrol to data_eng from data_dss

Adds storage to data_eng from data_dss

Adds transformers to data_eng from data_dss

Adds vsources to data_eng from data_dss

Adds transformers to data_eng from data_dss

_equivalance_center_tap!(transformer::Dict{String,<:Any}, data_eng::Dict{String,<:Any})

Removes center tap transformers based on Eq. (1) from Kersting's paper 'Center-Tapped Transformers and 120/240-V Secondary Models' Z0 = 0.5r_t + j0.8x_t

Helper function for Base.parse for dss matrices

Helper function for Base.parse for dss vectors

helper function to fix matrices (from vector of vectors) and vector dtypes

recursive function to fix data types from data imported from json

helper function to convert stringified enums

helper function to fix null values from json (usually Inf or NaN)

Helper function to generate 'short' property names

Generates pairwise bounds for oneport components.

gets concentric neutral cable data for line geometry

finds maximal set of ungrounded phases

returns the conductor indicator for a ENGINEERING component

Returns an ordered list of defined conductors. If ground=false, will omit any 0

creates a delta transformation matrix

gets line geometry data for line, including applying line spacing if specified

Given a vector and a list of elements to find, this method will return a list of the positions of the elements in that vector.

get locations of terminal in connections list

returns number of phases implied by a two-bus (edge) object

returns number of phases implied by a single-bus (node) object

returns number of phases implied by a transformer object

Obtain impedance parameters, directly or from linecode.

returns component from the mathematical data model

Helper function to pull the specified properties from dss property pairs

get line spacing data for line or line geometry

Returns the tightest set of absolute voltage magnitude bounds, removing looser bounds which are implied by the tighter ones.

Returns the tightest set of pairwise voltage magnitude bounds, removing looser bounds which are implied by the tighter ones.

gets tape shielded cable data for line geometry

_get_v(
  pfd::struct,
  Vp::Vector,
  n::Union{Tuple, Int}
)

Calculates the voltage from PowerFlowData struct.

gets overhead wire data for line geometry

converts impendance in Ohm/m by multiplying by length

creates a dss dict inside object that imports all items in prop_order from dss_obj

infer the internal dimension of a winding, load or generator based on the connections and the configuration

infer the internal dimension for a transformer (only in the MATHEMATICAL data model format)

infer the internal dimension for a unit, i.e. any one-port component with connections and configuration properties

Return a list of all implicit neutrals as a list of bus-terminal pairs. This is done by starting from a list of all terminals which are either a.connected to the neutral of wye-connected components; b. or are grounded. This initial list is then expanded to all terminals which are galvanically connected to terminals in the initial list.

Helper function to infer a full property name from a partial one

initializes the base components that are expected by powermodelsdistribution in the mathematical model

initializes the base math object of any type, and copies any one-to-one mappings

initialization actions for unmapping

helper function to determine if property1 appears after property2 in the property pair list for objects that have windings

helper function to determine if property1 appears after property2 in the property pair list

checks if loadshape has both pmult and qmult

checks if loadshape has both pmult and qmult

Indicates whether the passed component has a multiport structure (e.g. transformers).

Indicates whether the passed component has a oneport structure (e.g. loads and generators).

Indicates whether the passed component has a twoport structure (e.g. lines and switches).

detects if expr is Reverse Polish Notation expression

_kron(Z::Matrix{T}, nconds::Int)::Matrix{T} where T <: Complex

Kron reduces impedance matrix down to size (nconds, nconds)

_kron(Z::Matrix{T}, Y::Matrix{T}, nconds::Int)::Tuple{Matrix{T}, Matrix{T}} where T <: Complex

Kron reduces impedance and shunt admittance matrices down to size (nconds, nconds)

performs kron reduction on branch

performs kron reduction on branch - helper function

_kron_reduce_implicit_neutrals!(data_eng::Dict{String,Any})::Dict{String,Any}

Kron-reduce all (implied) neutral conductors of lines, switches and shunts, and remove any terminals which become unconnected. A line or switch conductor is considered as a neutral conductor if it is connected between two neutral terminals. A terminal is a neutral terminals if it is galvanically connected (i.e. through a line or switch) to a grounded terminal, or the neutral conductor of a wye-connected component.

Kron-reduce specified neutral conductors of a linecode.

Return the Kron-reduction of the specified neutral conductors of a series impedance matrix.

Return the Kron-reduction of the specified neutral conductors of a shunt addmittance matrix.

Reverse the direction of a line.

_load_expmodel_params(load::Dict{String,<:Any}, bus::Dict{String,<:Any})

Returns the exponential load model parameters for a load. For an exponential load it simply returns certain data model properties, whilst for constantpower, constantcurrent and constant_impedance it returns the equivalent exponential model parameters.

Create an equivalent shunt for a line which connects to a single bus.

_make_filtered_logger(level::Logging.LogLevel)

Helper function to create the filtered logger for PMD

makes a full matrix variable from a diagonal, and lower and upper triangular vectors

makes a hermitian matrix variable from diagonal, and lower and upper triangular vectors

_make_lossless!(data_eng::Dict{String,<:Any})

Remove parameters from objects with loss models to make them lossless. This includes linecodes, lines, switches, xfmrcodes, transformers, voltage sources, generators, solar, and storage, which all have (or will have in the future), loss model parameters that can be omitted.

converts the MATHEMATICAL model to per unit from SI

_make_matrix_variable_element(
    model::JuMP.Model,
    indices::Array{T,1},
    n::Int,
    m::Int;
    upper_bound::Union{Missing, Dict{T,<:Matrix{<:Real}}}=missing,
    lower_bound::Union{Missing, Dict{T,<:Matrix{<:Real}}}=missing,
    varname::String=""
) where T

Sometimes we want to bound only a subset of the elements of a matrix variable. For example, an unbounded Hermitian variable usually still has a lower bound of zero on the real diagonal elements. When there is a mix of bounded and unbounded elements, the unboundedness is encoded as 'Inf' and '-Inf' in the bound parameters. This cannot be passed directlty to JuMP, because it would lead to an error in Mosek for example. Instead, this method checks whether all bounds for an element (n,m) are Inf, and if so, does not pass a bound to JuMP.

Hacky helper function to transform single-conductor network data, from, e.g., matpower/psse, into multi-conductor data

Expands an ENGINEERING data structure into a multinetwork, see make_multinetwork

Expands an MATHEMATICAL data structure into a multinetwork, see make_multinetwork

helper function to map non integer conductor ids into integers

base function for converting engineering model to mathematical model

converts engineering bus components into mathematical bus components

converts engineering generators into mathematical generators

converts engineering lines into mathematical branches

converts engineering load components into mathematical load components

converts engineering generic shunt components into mathematical shunt components

converts engineering solar components into mathematical generators

converts engineering storage into mathematical storage

converts engineering switches into mathematical switches and (if neeed) impedance branches to represent loss model

converts engineering n-winding transformers into mathematical ideal 2-winding lossless transformer branches and impedance branches to represent the loss model

converts engineering voltage sources into mathematical generators and (if needed) impedance branches to represent the loss model

matrix to lower triangular vector

matrix to upper triangular vector

matrix multiplication removing NaN values

Merges flow variables that enter the same terminals, i.e. multiple neutrals of an underground cable connected to same neutral terminal

Merge a terminal into another for a specified bus, i.e. as if they are short-ciruited.

Helper to convert

Replaces NaN values with zeros

gen connections adaptation of min fuel cost polynomial linquad objective

Multiconductor adaptation of min fuel cost polynomial linquad objective

gen connections adaptation of min fuel cost polynomial linquad objective

adds conductors to connections during padding process, transformer winding variant

adds conductors to connections during padding process

pads properties to have the total number of conductors for the whole system (transformer winding variant)

pads properties to have the total number of conductors for the whole system

pads properties to have the total number of conductors for the whole system - delta connection variant

pads properties to have the total number of conductors for the whole system - delta connection variant

helper function to parse reverse polish notation arrays

Parses busnames as defined in OpenDSS, e.g. 'primary.1.2.3.0'

_parse_command_from_line(line::String)::Tuple{String,String}

Parses the dss command from the line (if present), optionnally making the command set if implicitly used.

Helper function for Base.parse for dss matrices

Helper function for Base.parse for dss vectors

helper function to parse reverse polish notation

parses Reverse Polish Notation expr

helper function to parse reverse polish notation vectors

_pmd_metafmt(level::Logging.LogLevel, _module, group, id, file, line)

MetaFormatter for ConsoleLogger for PMD to adjust log message format

_propagate_network_topology!(data::Dict{String,Any})

helper function to propagate bus status to any connected components

per-unit conversion for branches

per-unit conversion for buses

per-unit conversion for generators

per-unit conversion for loads

per-unit conversion for shunts

per-unit conversion for storage

per-unit conversion for switches

per-unit conversion for ideal 2-winding transformers

adds connected components for opb problem type

_remove_all_bounds!(data_eng; exclude::Vector{<:String}=String["energy_ub"], exclude_asset_type::Vector{String}=String[])

Removes all fields ending in 'ub' or 'lb' that aren't required by the math model. Properties can be excluded from this removal with exclude::Vector{String}

Whole asset types (e.g., "line") can be excluded using the keyword argument exclude_asset_type::Vector{String}

By default, "energy_ub" is excluded from this removal, since it is a required properly on storage.

_remove_line_limits!(data_eng::Dict{String,<:Any})

Removes fields cm_ub and sm_ub from lines, switches, and linecodes

checks that each point in the a pwl function is unqiue, simplifies the function if duplicates appear

_remove_transformer_limits!(data_eng::Dict{String,<:Any})

Removes field sm_ub from transformers, xfmrcodes

_remove_unconnected_terminals!(data_eng::Dict{String,Any})::Dict{String,Any}

Remove all terminals which are unconnected (not considering a grounding as a connection).

rescales the cost model terms

_sanatize_line(line::String)::String

Sanitizes lines by stripping them clean of extra space and the beginnging and end, making everything lowercase, changing ~ or m to more, and stripping comments

Converts a set of short-circuit tests to an equivalent reactance network. Reference: R. C. Dugan, “A perspective on transformer modeling for distribution system analysis,” in 2003 IEEE Power Engineering Society General Meeting (IEEE Cat. No.03CH37491), 2003, vol. 1, pp. 114-119 Vol. 1.

function for applying a scale to a paramter

helper function to apply a scale factor to given properties

Helper functions for Base.show for InfrastructureModel,InfrastructureObject

checks the slope of each segment in a pwl function, simplifies the function if the slope changes is below a tolerance

slices branches based on connected terminals

_sol_data_model_acr!(solution::Dict{String,<:Any})

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

converts w models voltages to standard voltage magnitude (sqrt)

_solve_mc_model(
    data::Dict{String,<:Any},
    model_type::Type,
    optimizer,
    build_method::Function;
    multinetwork::Bool=false,
    ref_extensions::Vector{<:Function}=Function[],
    solution_processors::Vector{<:Function}=Function[],
    relax_integrality::Bool=false,
    kwargs...
)::Dict{String,Any}

Internal solver interface that uses instantiate_mc_model directly and runs optimize_model!, returning a result

See solve_mc_model

Solve optimal switching problem

Solve mixed-integer optimal switching problem

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

solve test mn mc problem

ensures all polynomial costs functions have at exactly comp_order terms

strips lines that are either commented (block or single) or empty

BOUND manipulation methods (0*Inf->0 is often desired)

_transform_loops!(
    data_eng::Dict{String,Any};
    zero_series_impedance_threshold::Real=1E-8,
    shunt_id_prefix::AbstractString="line_loop"
)::Dict{String,Any}

Transform line loops (connected to a single bus), which are not allowed in the mathematical model. Lossy line loops are converted to equivalent shunts, and lossless ones (i.e. short-circuits) are represented by merging the short-circuited terminals. The argument 'zeroseriesimpedance_threshold' controls the threshold below which the series impedance is considered to be a short-ciruit. This is useful because OpenDSS modelers have to insert tiny impedances to represent short-circuit reactors. The addmittance to ground should be zero to trigger the short-circuit handling.

helper function to update the terminals on projected buses

vector to lower triangular

https://stackoverflow.com/questions/39039553/lower-triangular-matrix-in-julia

wraps angles in degrees to 180

wraps angles in radians to pi