Edit on GitHub

MPC Inputs

The input structure for MPC models is very similar to the structure for REopt Inputs. The primary differences are

  1. The MPCElectricTariff requires specifying individual rate components (and does not parse URDB rates like ElectricTariff).

  2. The capacities of any provided DER must be provided

  3. The load profile for each time step must be provided

Just like REopt Inputs, inputs to run_mpc can be provided in one of three formats:

  1. a file path (string) to a JSON file,
  2. a Dict, or
  3. using the MPCInputs struct

The accepted keys for the JSON file or Dict are:

  • ElectricLoad
  • ElectricTariff
  • PV
  • Storage
  • Financial
  • Generator
  • ElectricUtility
  • Settings

The simplest scenario does not have any dispatch optimization and is essentially a cost "calculator:

{
    "ElectricLoad": {
        "loads_kw": [10.0, 11.0, 12.0]
    },
    "ElectricTariff": {
        "energy_rates": [0.1, 0.2, 0.3]
    }
}
Note

The ElectricLoad.loads_kw can have an arbitrary length, but its length must be the same lengths as many other inputs such as the MPCElectricTariff.energy_rates and the PV.prod_factor_series.

Here is a more complex MPCScenario, which is used in MPC Examples:

{
    "PV": {
        "size_kw": 150,
        "prod_factor_series": [
            0.0,
            0.0,
            0.0,
            0.0,
            0.0,
            0.0,
            0.0,
            0.05,
            0.10,
            0.15,
            0.30,
            0.6,
            0.5,
            0.3,
            0.02,
            0.01,
            0.005,
            0.0,
            0.0,
            0.0,
            0.0,
            0.0,
            0.0,
            0.0
        ]
    },
    "Storage": {
        "size_kw": 30.0,
        "size_kwh": 60.0,
        "can_grid_charge": true
    },
    "ElectricLoad": {
        "loads_kw": [
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100,
            100
        ]
    },
    "ElectricTariff": {
        "energy_rates": [
            0.1,
            0.1,
            0.1,
            0.1,
            0.1,
            0.1,
            0.15,
            0.15,
            0.15,
            0.15,
            0.15,
            0.15,
            0.15,
            0.2,
            0.2,
            0.2,
            0.3,
            0.2,
            0.2,
            0.2,
            0.1,
            0.1,
            0.1,
            0.1
        ],
        "monthly_demand_rates": [10.0],
        "monthly_previous_peak_demands": [98.0],
        "tou_demand_rates": [0.0, 15.0],
        "tou_demand_timesteps": [
            [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], 
            [16, 17, 18, 19, 20, 21, 22, 23, 24]
        ],
        "tou_previous_peak_demands": [98.0, 97.0],
        "net_metering": false,
        "export_rates": [0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 
            0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05, 0.05]
    }
}

MPC Input Structures

Note that the keys of the input Dict or JSON file do not need the MPC prefix.

MPCElectricTariff

REoptLite.MPCElectricTariff — Method
MPCElectricTariff(d::Dict)

function for parsing user inputs into 

    struct MPCElectricTariff
        monthly_previous_peak_demands::Array{Float64,1}
        energy_rates::Array{Float64,1} 

        monthly_demand_rates::Array{Float64,1}
        time_steps_monthly::Array{Array{Int64,1},1}  # length = 0 or 12

        tou_demand_rates::Array{Float64,1}
        tou_demand_ratchet_timesteps::Array{Array{Int64,1},1}  # length = n_tou_demand_ratchets
        tou_previous_peak_demands::Array{Float64,1}

        fixed_monthly_charge::Float64
        annual_min_charge::Float64
        min_monthly_charge::Float64

        export_rates::DenseAxisArray{Array{Float64,1}}
        export_bins::Array{Symbol,1}
    end

Keys for d include:

  • energy_rates

    • REQUIRED
    • must have length equal to ElectricLoad.loads_kw

  • monthly_demand_rates

    • default = [0]

  • time_steps_monthly

    • array of arrays for integer time steps that the monthly_demand_rates apply to
    • default = [collect(1:length(energy_rates))]

  • monthly_previous_peak_demands

    • default = [0]

  • tou_demand_rates

    • an array of time-of-use demand rates
    • must have length equal to tou_demand_timesteps
    • default = []

  • tou_demand_timesteps

    • an array of arrays for the integer time steps that apply to the tou_demand_rates
    • default = []

  • tou_previous_peak_demands

    • an array of the previous peak demands set in each time-of-use demand period
    • must have length equal to tou_demand_timesteps
    • default = []

  • net_metering

    • boolean, if true then customer DER export is compensated at the energy_rates

  • export_rates

    • can be a <:Real or Array{<:Real, 1}, or not provided
    • if provided, customer DER export is compensated at the export_rates

NOTE: if both net_metering=true and export_rates are provided then the model can choose from either option.

source

MPCElectricLoad

REoptLite.MPCElectricLoad — Type
MPCElectricLoad

Base.@kwdef struct MPCElectricLoad
    loads_kw::Array{Real,1}
    critical_loads_kw::Union{Missing, Array{Real,1}} = missing
end
source

MPCElecStorage

REoptLite.MPCElecStorage — Type
MPCElecStorage
Base.@kwdef struct MPCElecStorage
    size_kw::Float64
    size_kwh::Float64
    charge_efficiency::Float64
    discharge_efficiency::Float64
    soc_min_pct::Float64
    soc_init_pct::Float64
    can_grid_charge::Bool = true
    grid_charge_efficiency::Float64
end
source

MPCFinancial

REoptLite.MPCFinancial — Type
MPCFinancial

Base.@kwdef struct MPCFinancial
    value_of_lost_load_per_kwh::Union{Array{R,1}, R} where R<:Real = 1.00
end
source

MPCPV

REoptLite.MPCPV — Type
MPCPV
Base.@kwdef struct MPCPV
    name::String="PV"
    size_kw::Real = 0
    prod_factor_series::Union{Missing, Array{Real,1}} = missing
end
source

MPCGenerator

REoptLite.MPCGenerator — Type
MPCGenerator

struct with inner constructor:

function MPCGenerator(;
    size_kw::Real,
    fuel_cost_per_gallon::Float64 = 3.0,
    fuel_slope_gal_per_kwh::Float64 = 0.076,
    fuel_intercept_gal_per_hr::Float64 = 0.0,
    fuel_avail_gal::Float64 = 660.0,
    min_turn_down_pct::Float64 = 0.0,  # TODO change this to non-zero value
    only_runs_during_grid_outage::Bool = true,
    sells_energy_back_to_grid::Bool = false,
    om_cost_per_kwh::Float64=0.0,
    )
source

MPCSettings

The MPCSetting is the same as the Settings.