Model Data

load_data(data::Dict)

Reads a collection of model input files specified by a dictionary and returns a fully populated Parameters struct for use in the market simulation.

Arguments

• data::Dict{Symbol, String}: A dictionary mapping required and optional parameter names to file paths.

Required keys

The following keys must be included in data:

• :plants - Plant specification file.
• :nodes - Node topology file.
• :zones - Zone definition file.
• :demand - Nodal or zonal demand input.
• :types - Technology or plant type definitions.

Optional keys

These keys can optionally be included to enable extended model functionality:

• Network:
  • :lines - AC transmission line definitions.
  • :dclines - DC line definitions (requires :lines to be included).
• Availability and plant characteristics:
  • :avail - Plant availability.
  • :avail_planttype_nodal - Availability by plant type and node.
  • :avail_planttype_zonal - Availability by plant type and zone.
  • :min_generation - Minimum generation constraints.
• Market and operation:
  • :ntc - Net Transfer Capacities between zones.
  • :fixed_exchange - Fixed exchange schedules.
  • :prs_demand - Prosumer demand profiles.
  • :fuel_prices - Time-dependent fuel prices.
  • :inflow - Storage inflow data (e.g. hydro).
  • :historical_generation - Historical generation for calibration.

Example

data = Dict(
    :plants => joinpath(datapath, "plants.csv"),
    :nodes => joinpath(datapath, "nodes.csv"),
    :zones => joinpath(datapath, "zones.csv"),
    :lines => joinpath(datapath, "lines.csv"),
    :dclines => joinpath(datapath, "dclines.csv"),
    :demand => joinpath(datapath, "nodal_load.csv"),
    :types => joinpath(datapath, "planttypes.csv"),
)

params = load_data(data)

Parameters

Container structure for all static and time-varying input data used in a power system model.

This struct encapsulates metadata, technical parameters, profiles, and mappings for generation units, nodes, transmission infrastructure, demand, and other components relevant to electricity system modeling. It is typically used as a central configuration object passed to optimization or simulation routines.

Fields

Sets

• sets::Sets: Collection of index sets (e.g., nodes, plants, zones) used across the model.

Power plant parameters

• gmax::Dict{String,Float64}: Maximum generation capacity per plant.
• eta::Dict{String,Float64}: Efficiency of each plant.
• gmax_storage::Dict{String,Float64}: Maximum generation capacity from storage units.
• storage::Dict{String,Float64}: Energy storage capacity.
• mc::Dict{String,Profile}: Marginal costs as time series profiles per plant.
• avail::Dict{String,Profile}: Availability factor per plant over time.
• avail_planttype_nodal::Dict{Tuple{String,String},Profile}: Time-dependent availability by (node, plant type).
• avail_planttype_zonal::Dict{Tuple{String,String},Profile}: Time-dependent availability by (zone, plant type).
• plant_type::Dict{String,String}: Mapping from plant name to plant type.

Plant type metadata

• plant_type2color::Dict{String,String}: Color coding for each plant type (for plotting).
• dispatchable::Vector{String}: List of dispatchable plant types.
• nondispatchable::Vector{String}: List of non-dispatchable plant types.
• storage_types::Vector{String}: List of storage technologies.
• fuel_price::Dict{String,Profile}: Time-varying fuel price per plant type.
• co2content::Dict{String,Float64}: CO₂ emissions per MWh of each plant type.
• historical_generation::Dict{String,Profile}: Historical generation profiles.
• min_generation::Dict{String,Profile}: Minimum generation profiles.

Node parameters

• slack::Vector{String}: Names of slack buses (reference nodes).
• node2zone::Dict{String,String}: Mapping from node to zone.
• node_coords::Dict{String,Vector{Float64}}: Coordinates of nodes (e.g., for plotting or distance-based calculations).

AC line parameters

• acline_capacity::Dict{String,Float64}: Thermal capacity of each AC line.

• resistance::Dict{String,Float64}: Resistance per AC line.

• reactance::Dict{String,Float64}: Reactance per AC line.

• bvector::Dict{String,Float64}: Susceptance of each AC line.

• circuits::Dict{String,Int64}: Number of circuits per line.

• voltage::Dict{String,Float64}: Voltage level of each line.

• line_start::Dict{String,String}: Start node of each AC line.

• line_end::Dict{String,String}: End node of each AC line.

• b::Dict{Tuple{String,String},Float64}: Line susceptance between node pairs.

• h::Dict{Tuple{String,String},Float64}: Network matrix entries used in power flow approximations.

• ptdf::Dict{Tuple{String,String},Float64}: Power Transfer Distribution Factors between (line, node) pairs.

DC line parameters

• dcline_capacity::Dict{String,Float64}: Transfer capacity of each DC line.
• dc_start::Dict{String,String}: Start node of each DC line.
• dc_end::Dict{String,String}: End node of each DC line.

Demand parameters

• nodal_load::Dict{String,Profile}: Time series of nodal demand.
• zonal_load::Dict{String,Profile}: Time series of zonal demand.
• inflow::Dict{String,Profile}: Time-dependent inflows to storage (e.g., hydro).
• fixed_exchange::Dict{String,Profile}: Fixed cross-border or interzonal exchanges (e.g., from contracts or historical data).

Zone parameters

• ntc::Dict{Tuple{String,String},Float64}: Net transfer capacity between zones.

Prosumer parameters

• prosumer_types::Vector{String}: List of prosumer types modeled.
• prs_demand::Dict{String,Profile}: Time series of demand from prosumers.
• nodal_load_no_prs::Dict{String,Profile}: Nodal demand excluding prosumer influence.

Mapping data

• nodes_in_zone::Dict{String,Vector{String}}: List of nodes per zone.
• plants_in_zone::Dict{String,Vector{String}}: Plants located in each zone.
• storages_in_zone::Dict{String,Vector{String}}: Storage units in each zone.
• plants_in_node::Dict{String,Vector{String}}: Plants located at each node.
• storages_in_node::Dict{String,Vector{String}}: Storage units at each node.
• plant2node::Dict{String,String}: Node location of each plant.
• plant2zone::Dict{String,String}: Zone location of each plant.
• importing_ntcs::Dict{String,Vector{String}}: NTCs importing into a given zone.
• exporting_ntcs::Dict{String,Vector{String}}: NTCs exporting from a given zone.

Plotting parameters

• colors::Dict{String,String}: Color mapping for zones, nodes, or technologies (used in visualization).