Internal Functions

_check_switch_state_feasibility(eng::Dict{String,Any})

Helper function to aid users in determining whether network model has a feasible starting switch configuration, assuming radiality constraints are applied.

_convert_event_data_types!(
    events::Vector{<:Dict{String,<:Any}}
)::Vector{Dict{String,Any}}

Helper function to convert JSON data types to native data types (Enums) in events.

_correct_branch_directions!(switches::Dict{String,<:Any}, ref::Dict{Symbol,<:Any})::Dict{String,Any}

Helper function that will attempt to make a directed graph that is strong-connected by adjusting the switch directions starting from the voltage_sources

_deepcopy_args!(args::Dict{String,<:Any})::Dict{String,Any}

Copies arguments to "raw_args" in-place in args, for use in entrypoint

_dss2eng_protection!(
    eng::Dict{String,<:Any},
    dss::Dict{String,<:Any}
)

Extension function for converting opendss protection into protection objects for protection optimization.

_find_next_nw_id_from_fault_duration(
    network::Dict{String,<:Any},
    nw_id::String,
    duration::Real
)::Union{String,Missing}

Helper function to find the next timestep following a fault given its duration in ms

_find_nw_id_from_timestep(
    network::Dict{String,<:Any},
    timestep::Union{Real,String}
)::String

Helper function to find the multinetwork id of the subnetwork of network corresponding most closely to a timestep.

_find_switch_id_from_source_id(
    network::Dict{String,<:Any},
    source_id::String
)::Union{String,Missing}

Helper function to find a switch id in the network model based on the dss source_id

helper function to find which switches need to be opened to isolate a fault on asset given by source_id

helper function to convert stringified enums

_fix_fault_data_types!(faults::Dict{String,<:Any})

Helper function to help parse data types for multiconductor fault study data structures from JSON faults.

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

helper function to convert stringified Symbols

_get_formulation(form_string::String)

helper function to convert from opt-disp-formulation, opt-switch-formulation string to PowerModelsDistribution Type

_get_formulation(form::Type)

helper function to convert from PowerModelsDistribution Type to PowerModelsDistribution Type

_make_filtered_logger(mods::Vector, level::Logging.LogLevel)

Helper function to create the filtered logger for PMD

_make_filtered_logger(mods::Vector{Tuple{<:Module,Logging.LogLevel}})

Helper function to create the filtered logger for PMD

_map_eng2math_scenarios!(data_math::Dict{String,<:Any}, data_eng::Dict{String,<:Any}; pass_props::Vector{String}=String[])

Converts engineering scenarios into mathematical scenarios.

_prepare_dispatch_data(
    network::Dict{String,<:Any},
    switching_solutions::Union{Missing,Dict{String,<:Any}}=missing
)::Dict{String,Any}

Helper function to prepare data for running a optimal dispatch problem, copying in solutions from the switching results, if present.

_prepare_fault_study_multinetwork_data(
    network::Dict{String,<:Any},
    switching_solutions::Union{Missing,Dict{String,<:Any}}=missing,
    dispatch_solution::Union{Missing,Dict{String,<:Any}}=missing
)

Helper function that helps to prepare all of the subnetworks for use in PowerModelsProtection.solve_mc_fault_study

_prepare_optimal_switching_data(network::Dict{String,<:Any})::Dict{String,Any}

Helper function to prepare optimal switching data structure.

_prepare_stability_multinetwork_data(
    network::Dict{String,<:Any},
    inverters::Dict{String,<:Any},
    switching_solutions::Union{Missing,Dict{String,<:Any}}=missing,
    dispatch_solution::Union{Missing,Dict{String,<:Any}}=missing
)::Dict{String,Any}

Helper function to prepare the multinetwork data for stability analysis (adds inverters, data_model).

_recursive_initialize_output_from_schema!(output::Dict{String,<:Any}, schema_properties::Dict{String,<:Any})

Helper function to initialize the output data structure from the output schema

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

Ref extension to add load blocks to ref at a single time step

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

Ref extension to add options to ref for all time steps

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

Ref extension to add scenario information to ref at a single time step

_sanitize_results_metadata!(metadata::Dict{String,<:Any})::Dict{String,Any}

Helper function to turn any field that is not a Real into a String.

_set_property!(data::Dict{String,<:Any}, path::Tuple{Vararg{String}}, value::Any)

Helper function to set a property to value at an arbitrary nested path in a dictionary

_solution_statuses!(sol::Dict{String,<:Any}, ref::Dict{Symbol,<:Any})

Adds block ids (as generated in the ref), and microgrid_ids to the solution

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

Converts inverter to Inverter enum, from a single time step.

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

Raises bus_type from math model up to solution for reporting, from a single time step.

_solution_statuses!(sol::Dict{String,<:Any})

Converts all status fields in a solution sol from Float64 to Status enum, for a single time step.

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

Helper function to update inverter settings from a solution, for the mld robust problem to check for feasibility.

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

Helper function to update storage capacity for the next subnetwork based on a solution, for the rolling horizon algorithm.

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

Helper function to update switch settings from a solution, for the rolling horizon algorithm.

_validate_against_schema(
    data::Union{Dict{String,<:Any}, Vector},
    schema::JSONSchema.Schema
)::Bool

Validates dict or vector structure data against json schema using JSONSchema.jl.

_validate_against_schema(
    data::Union{Dict{String,<:Any}, Vector},
    schema_name::String
)::Bool

Validates dict or vector structure data against json schema given by schema_name.

default ref_extension functions

default solution_processor functions

string to PowerModelsDistribution type conversion for opt-disp-formulation