reo/nested_inputs.py

# REopt®, Copyright (c) Alliance for Sustainable Energy, LLC. See also https://github.com/NREL/REopt_API/blob/master/LICENSE.
import copy

max_big_number = 1.0e8
max_incentive = 1.0e10
max_years = 75
macrs_schedules = [0, 5, 7]
analysis_years = 25
providers = ['federal', 'state', 'utility']
default_buildings = ['FastFoodRest',
                     'FullServiceRest',
                     'Hospital',
                     'LargeHotel',
                     'LargeOffice',
                     'MediumOffice',
                     'MidriseApartment',
                     'Outpatient',
                     'PrimarySchool',
                     'RetailStore',
                     'SecondarySchool',
                     'SmallHotel',
                     'SmallOffice',
                     'StripMall',
                     'Supermarket',
                     'Warehouse',
                     'FlatLoad',
                     'FlatLoad_24_5',
                     'FlatLoad_16_7',
                     'FlatLoad_16_5',
                     'FlatLoad_8_7',
                     'FlatLoad_8_5'
                     ]

macrs_five_year = [0.2, 0.32, 0.192, 0.1152, 0.1152, 0.0576]  # IRS pub 946
macrs_seven_year = [0.1429, 0.2449, 0.1749, 0.1249, 0.0893, 0.0892, 0.0893, 0.0446]

#the user needs to supply valid data for all the attributes in at least one of these sets for load_profile_possible_sets and electric_tariff_possible_sets
load_profile_possible_sets = [["loads_kw"],
            ["doe_reference_name", "monthly_totals_kwh"],
            ["annual_kwh", "doe_reference_name"],
            ["doe_reference_name"]
            ]

electric_tariff_possible_sets = [
  ["urdb_response"],
  ["blended_monthly_demand_charges_us_dollars_per_kw", "blended_monthly_rates_us_dollars_per_kwh"],
  ["blended_annual_demand_charges_us_dollars_per_kw", "blended_annual_rates_us_dollars_per_kwh"],
  ["urdb_label"],
  ["urdb_utility_name", "urdb_rate_name"],
  ["tou_energy_rates_us_dollars_per_kwh"]
]


def list_of_float(input):
    return [float(i) for i in input]


def list_of_str(input):
  return [str(i) for i in input]

def list_of_list(input, inner_list_conversion_function=list):
  return [inner_list_conversion_function(i) for i in input]

def list_of_int(input):
  result = []
  for i in input:
    if i%1>0:
      raise Exception('Not all values in the list_of_int input are whole numbers')
    result.append(int(i))
  return result

def list_of_dict(input):
  result = []
  for i in input:
    result.append(dict(i))
  return result

off_grid_defaults = {
  "Scenario": {
    "optimality_tolerance_techs": {
      "type": "float",
      "min": 1.0e-5,
      "max": 10.0,
      "default": 0.05,
      "description": "The threshold for the difference between the solution's objective value and the best possible value at which the solver terminates"
    },
    "Site": {
      "Financial": {
        "microgrid_upgrade_cost_pct": {
          "type": "float",
          "min": 0.0,
          "max": 0.0,
          "default": 0.0,
          "description": "Additional cost, in percent of non-islandable capital costs, to make a distributed energy system islandable from the grid and able to serve critical loads. For off-grid analyses, this should instead be provided as other_capital_costs_us_dollars or other_annual_costs_us_dollars_per_year"
        },
      },
      "LoadProfile": {
        "critical_load_pct": {
          "type": "float",
          "min": 1.0,
          "max": 1.0,
          "default": 1.0,
          "description": "In off-grid scenarios, 100 percent of the typical load is assumed to be critical from a modeling standpoint (a 8760 hour outage is modeled). To adjust the 'critical load', change the typical load or the min_load_met_pct inputs."
        },
        "outage_is_major_event": {
          "type": "bool",
          "default": False,
          "description": "Boolean value for if outage is a major event, which affects the avoided_outage_costs_us_dollars. If True, the avoided outage costs are calculated for a single outage occurring in the first year of the analysis_years. If False, the outage event is assumed to be an average outage event that occurs every year of the analysis period. In the latter case, the avoided outage costs for one year are escalated and discounted using the escalation_pct and offtaker_discount_pct to account for an annually recurring outage. (Average outage durations for certain utility service areas can be estimated using statistics reported on EIA form 861.)"
        },
        "sr_required_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.1,
          "description": "Applies to off-grid scenarios only. Spinning reserve requirement for changes in load in off-grid analyses. Value must be between zero and one, inclusive."
        },
        "min_load_met_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.999,
          "description": "Applies to off-grid scenarios only. Fraction of the load that must be met on an annual energy basis. Value must be between zero and one, inclusive."
        }
      },
      "PV": {
        "sr_required_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.25,
          "description": "Applies to off-grid scenarios only. Spinning reserve requirement for PV serving load in off-grid analyses. Value must be between zero and one, inclusive."
        }
      },
      "Storage": {
        "soc_init_pct": {
          "type": "float", "min": 0.0, "max": 1.0, "default": 1.0,
          "description": "Battery state of charge at first hour of optimization"
        }
      },
      "Generator": {
        "om_cost_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e3,
          "default": 20.0,
          "description": "Annual diesel generator fixed operations and maintenance costs in $/kW"
        },
        "fuel_avail_gal": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1.0e9,
          "description": "Annual on-site generator fuel available in gallons."
        },
        "min_turn_down_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.15,
          "description": "Minimum generator loading in percent of capacity (size_kw)."
        },
        "generator_only_runs_during_grid_outage": {
          "default": False,
          "type": "bool",
          "description": "If there is existing diesel generator, must specify whether it should run only during grid outage or all the time in the bau case."
        },
        "useful_life_years": {
          "type": "float", "min": 0.0, "max": max_years, "default": 10,
          "description": "Applies to off-grid scenarios only. Number of years asset can be used for before replacement. A single replacement is considered for off-grid generators."
        }
      }
    }
  }
}

nested_input_definitions = {

  "Scenario": {
    "timeout_seconds": {
      "type": "int",
      "min": 1,
      "max": 420,
      "default": 420,
      "description": "The number of seconds allowed before the optimization times out"
    },
    "user_uuid": {
      "type": "str",
      "description": "The assigned unique ID of a signed in REopt user"
    },
    "description": {
      "type": "str",
      "description": "An optional user defined description to describe the scenario and run"
    },
    "time_steps_per_hour": {
      "type": "int",
      "restrict_to": [1, 2, 4],
      "default": 1,
      "description": "The number of time steps per hour in the REopt simulation"
    },
    "webtool_uuid": {
      "type": "str",
      "description": "The unique ID of a scenario created by the REopt Webtool. Note that this ID can be shared by several REopt API Scenarios (for example when users select a 'Resilience' analysis more than one REopt API Scenario is created)."
    },
    "optimality_tolerance_bau": {
      "type": "float",
      "min": 0.0001,
      "max": 0.05,
      "default": 0.001,
      "description": "The threshold for the difference between the solution's objective value and the best possible value at which the solver terminates"
    },
    "optimality_tolerance_techs": {
      "type": "float",
      "min": 0.0001,
      "max": 0.05,
      "default": 0.001,
      "description": "The threshold for the difference between the solution's objective value and the best possible value at which the solver terminates"
    },
    "add_soc_incentive": {
      "type": "bool",
      "default": True,
      "description": "If True, then a small incentive to keep the battery's state of charge high is added to the objective of the optimization."
    },
    "off_grid_flag": {
      "type": "bool",
      "default": False,
      "description": "Set to True to enable off-grid analyses."
    },
    "include_climate_in_objective": {
      "type": "bool",
      "default": False,
      "description": "If True, then the lifecycle cost of CO2 emissions will be included in the objective function. Lifecycle CO2 impacts will be calculated regardless."
    },
    "include_health_in_objective": {
      "type": "bool",
      "default": False,
      "description": "If True, then the lifecycle cost of SO2, NOx, and PM2.5 emissions will be included in the objective function. Lifecycle health impacts will be calculated regardless, but you must provide marginal health costs for each pollutant."
    },
    "Site": {
      "latitude": {
        "type": "float",
        "min": -90.0,
        "max": 90.0,
        "required": True,
        "description": "The approximate latitude of the site in decimal degrees"
      },
      "longitude": {
        "type": "float",
        "min": -180.0,
        "max": 180.0,
        "required": True,
        "description": "The approximate longitude of the site in decimal degrees"
      },
      "address": {
        "type": "str",
        "description": "A user defined address as optional metadata (street address, city, state or zip code)"
      },
      "land_acres": {
        "type": "float",
        "min": 0.0,
        "max": 1.0e6,
        "description": "Land area in acres available for PV panel and wind turbine siting"
      },
      "roof_squarefeet": {
        "type": "float",
        "min": 0.0,
        "max": 1.0e9,
        "description": "Area of roof in square feet available for PV siting"
      },
      "outdoor_air_temp_degF": {
        "type": "list_of_float",
        "default": [],
        "description": "Hourly outdoor air temperature (dry-bulb)."
      },
      "elevation_ft": {
        "type": "float",
        "min": 0.0,
        "max": 15000.0,
        "default": 0.0,
        "description": "Site elevation (above sea sevel), units of feet"
      },
      "renewable_electricity_min_pct": {
        "type": "float",
        "min": 0,
        "description": "Minumum acceptable percent of total energy consumption provided by renewable energy annually."
      },
      "renewable_electricity_max_pct": {
        "type": "float",
        "min": 0,
        "description": "Maximum acceptable percent of total energy consumption provided by renewable energy annually."
      },
      "co2_emissions_reduction_min_pct": {
        "type": "float",
        "description": "Minumum acceptable percent of carbon emissions reduction relative to the business-as-usual case, over the financial lifecycle of the project."
      },
      "co2_emissions_reduction_max_pct": {
        "type": "float",
        "description": "Maximum acceptable percent of carbon emissions reduction relative to the business-as-usual case, over the financial lifecycle of the project."
      },
      "include_exported_elec_emissions_in_total": {
        "type": "bool",
        "default": True,
        "description": "Include the emissions reductions (or increases) in grid emissions associated with exported onsite electrical generation in the calculation of Year 1 emissions."
      },
      "include_exported_renewable_electricity_in_total": {
        "type": "bool",
        "default": True,
        "description": "True indicates site retains credits for exported electricity derived from renewable resources."
      },
      "Financial": {
        "om_cost_escalation_pct": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.025,
          "description": "Annual nominal O&M cost escalation rate"
        },
        "escalation_pct": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.023,
          "description": "Annual nominal utility electricity cost escalation rate"
        },
        "generator_fuel_escalation_pct": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.027,
          "description": "Annual nominal diesel generator fuel cost escalation rate"
        },
        "boiler_fuel_escalation_pct": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.034,
          "description": "Annual nominal boiler fuel cost escalation rate"
        },
        "chp_fuel_escalation_pct": {
          "type": "float",
          "min": -1,
          "max": 1,
          "default": 0.034,
          "description": "Annual nominal chp fuel cost escalation rate"
        },
        "newboiler_fuel_escalation_pct": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.034,
          "description": "Annual nominal boiler fuel cost escalation rate"
        },
        "offtaker_tax_pct": {
          "type": "float",
          "min": 0.0,
          "max": 0.999,
          "default": 0.26,
          "description": "Host tax rate"
        },
        "offtaker_discount_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.083,
          "description": "Nominal energy offtaker discount rate. In single ownership model the offtaker is also the generation owner."
        },
        "third_party_ownership": {
          "default": False,
          "type": "bool",
          "description": "Specify if ownership model is direct ownership or two party. In two party model the offtaker does not purcharse the generation technologies, but pays the generation owner for energy from the generator(s)."
        },
        "owner_tax_pct": {
          "type": "float",
          "min": 0,
          "max": 0.999,
          "default": 0.26,
          "description": "Generation owner tax rate. Used for two party financing model. In two party ownership model the offtaker does not own the generator(s)."
        },
        "owner_discount_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.083,
          "description": "Nominal generation owner discount rate. Used for two party financing model. In two party ownership model the offtaker does not own the generator(s)."
        },
        "analysis_years": {
          "type": "int",
          "min": 1,
          "max": max_years,
          "default": analysis_years,
          "description": "Analysis period"
        },
        "value_of_lost_load_us_dollars_per_kwh": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e6,
          "default": 100.0,
          "description": "Value placed on unmet site load during grid outages. Units are US dollars per unmet kilowatt-hour. The value of lost load (VoLL) is used to determine the avoided outage costs by multiplying VoLL [$/kWh] with the average number of hours that the critical load can be met by the energy system (determined by simulating outages occuring at every hour of the year), and multiplying by the mean critical load."
        },
        "microgrid_upgrade_cost_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.3,
          "description": "Additional cost, in percent of non-islandable capital costs, to make a distributed energy system islandable from the grid and able to serve critical loads. Includes all upgrade costs such as additional labor and critical load panels."
        },
        "other_capital_costs_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": 0,
          "description": "Other capital costs associated with the distributed energy system project. These can include land purchase costs, distribution network costs, powerhouse or battery container structure costs, and pre-operating expenses. These costs will be incorporated in the life cycle cost and levelized cost of electricity calculations."
        },
        "other_annual_costs_us_dollars_per_year": {
          "type": "float",
          "min": 0.0,
          "max": max_big_number,
          "default": 0,
          "description": "Other annual costs associated with the distributed energy system project. These can include labor costs, land lease costs, software costs, and any other ongoing expenses not included in other cost inputs. These costs will be incorporated in the life cycle cost and levelized cost of electricity calculations."
        },
        "co2_cost_us_dollars_per_tonne": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e5,
          "default": 51.0,
          "description": "Social Cost of CO2 in the first year of the analysis. Units are US dollars per metric ton of CO2. The default of $51/t is the 2020 value (using a 3 pct discount rate) estimated by the U.S. Interagency Working Group on Social Cost of Greenhouse Gases."
        },
        "nox_cost_us_dollars_per_tonne_grid": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e8,
          "description": "Public health cost of NOx emissions from grid electricity in the first year of the analysis. Units are US dollars per metric ton. Default values for the U.S. obtained from the EASIUR model."
        },
        "so2_cost_us_dollars_per_tonne_grid": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e8,
          "description": "Public health cost of SO2 emissions from grid electricity in the first year of the analysis. Units are US dollars per metric ton. Default values for the U.S. obtained from the EASIUR model."
        },
        "pm25_cost_us_dollars_per_tonne_grid": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e8,
          "description": "Public health cost of PM2.5 emissions from grid electricity in the first year of the analysis. Units are US dollars per metric ton. Default values for the U.S. obtained from the EASIUR model."
        },
        "nox_cost_us_dollars_per_tonne_onsite_fuelburn": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e8,
          "description": "Public health cost of NOx from onsite fuelburn in the first year of the analysis. Units are US dollars per metric ton. Default values for the U.S. obtained from the EASIUR model."
        },
        "so2_cost_us_dollars_per_tonne_onsite_fuelburn": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e8,
          "description": "Public health cost of SO2 from onsite fuelburn in the first year of the analysis. Units are US dollars per metric ton. Default values for the U.S. obtained from the EASIUR model."
        },
        "pm25_cost_us_dollars_per_tonne_onsite_fuelburn": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e8,
          "description": "Public health cost of PM2.5 from onsite fuelburn in the first year of the analysis. Units are US dollars per metric ton. Default values for the U.S. obtained from the EASIUR model."
        },
        "co2_cost_escalation_pct": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.042173,
          "description": "Annual nominal Social Cost of CO2 escalation rate (as a decimal)."
        },
        "nox_cost_escalation_pct": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "description": "Annual nominal escalation rate of the public health cost of 1 tonne of NOx emissions (as a decimal). The default value is calculated from the EASIUR model for a height of 150m."
        },
        "so2_cost_escalation_pct": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "description": "Annual nominal escalation rate of the public health cost of 1 tonne of SO2 emissions (as a decimal). The default value is calculated from the EASIUR model for a height of 150m."
        },
        "pm25_cost_escalation_pct": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "description": "Annual nominal escalation rate of the public health cost of 1 tonne of PM2.5 emissions (as a decimal). The default value is calculated from the EASIUR model for a height of 150m."
        },
      },

      "LoadProfile": {
        "doe_reference_name": {
          "type": ["str", "list_of_str"],
          "restrict_to": default_buildings,
          "replacement_sets": load_profile_possible_sets,
          "description": "Simulated load profile from DOE <a href='https: //energy.gov/eere/buildings/commercial-reference-buildings' target='blank'>Commercial Reference Buildings</a>"
        },
        "annual_kwh": {
          "type": "float",
          "min": 1.0,
          "max": 1.0E10,
          "replacement_sets": load_profile_possible_sets,
          "depends_on": ["doe_reference_name"],
          "description": "Annual site energy consumption from electricity, in kWh, used to scale simulated default building load profile for the site's climate zone"
        },
        "percent_share": {
          "type": ["float", "list_of_float"],
          "min": 1.0,
          "max": 100.0,
          "default": 100.0,
          "description": "Percentage share of the types of building for creating hybrid simulated building and campus profiles."
        },
        "year": {
          "type": "int",
          "min": 1,
          "max": 9999,
          "default": 2020,
          "description": "Year of Custom Load Profile. If a custom load profile is uploaded via the loads_kw parameter, it is important that this year correlates with the load profile so that weekdays/weekends are determined correctly for the utility rate tariff. If a DOE Reference Building profile (aka 'simulated' profile) is used, the year is set to 2017 since the DOE profiles start on a Sunday."
        },
        "monthly_totals_kwh": {
          "type": "list_of_float",
          "min": 0.0,
          "max": max_big_number,
          "replacement_sets": load_profile_possible_sets,
          "depends_on": ["doe_reference_name"],
          "description": "Monthly site energy consumption from electricity series (an array 12 entries long), in kWh, used to scale simulated default building load profile for the site's climate zone"
        },
        "loads_kw": {
          "type": "list_of_float",
          "replacement_sets": load_profile_possible_sets,
          "description": "Typical load over all hours in one year. Must be hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples). All non-net load values must be greater than or equal to zero."
        },
        "critical_loads_kw": {
          "type": "list_of_float",
          "description": "Critical load during an outage period. Must be hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples). All non-net load values must be greater than or equal to zero."
        },
        "loads_kw_is_net": {
          "default": True,
          "type": "bool",
          "description": "If there is existing PV, must specify whether provided load is the net load after existing PV or not."
        },
        "critical_loads_kw_is_net": {
          "default": False,
          "type": "bool",
          "description": "If there is existing PV, must specify whether provided load is the net load after existing PV or not."
        },
        "outage_start_hour": {
          "type": "int",
          "min": 0,
          "max": 8759,
          "depends_on": ["outage_end_hour"],
          "description": "Hour of year that grid outage starts. Must be less than or equal to outage_end_hour."
        },
        "outage_end_hour": {
          "type": "int",
          "min": 0,
          "max": 8759,
          "depends_on": ["outage_start_hour"],
          "description": "Hour of year that grid outage ends. Must be greater than or equal to outage_start_hour."
        },
        "outage_start_time_step": {
          "type": "int",
          "min": 1,
          "max": 35040,
          "depends_on": ["outage_end_time_step"],
          "description": "Time step that grid outage starts. Must be less than or equal to outage_end_time_step."
        },
        "outage_end_time_step": {
          "type": "int",
          "min": 1,
          "max": 35040,
          "depends_on": ["outage_start_time_step"],
          "description": "Time step that grid outage ends. Must be greater than or equal to outage_start_time_step."
        },
        "critical_load_pct": {
          "type": "float",
          "min": 0.0,
          "max": 2.0,
          "default": 0.5,
          "description": "Critical load factor is multiplied by the typical load to determine the critical load that must be met during an outage. Value must be between zero and one, inclusive."
        },
        "outage_is_major_event": {
          "type": "bool",
          "default": True,
          "description": "Boolean value for if outage is a major event, which affects the avoided_outage_costs_us_dollars. If True, the avoided outage costs are calculated for a single outage occurring in the first year of the analysis_years. If False, the outage event is assumed to be an average outage event that occurs every year of the analysis period. In the latter case, the avoided outage costs for one year are escalated and discounted using the escalation_pct and offtaker_discount_pct to account for an annually recurring outage. (Average outage durations for certain utility service areas can be estimated using statistics reported on EIA form 861.)"
        },
        "min_load_met_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 1.0,
          "description": "Applies to off-grid scenarios only. Fraction of the load that must be met on an annual energy basis. Value must be between zero and one, inclusive."
        },
        "sr_required_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Applies to off-grid scenarios only. Spinning reserve requirement for changes in load in off-grid analyses. Value must be between zero and one, inclusive."
        }
      },

      "LoadProfileBoilerFuel": {
        "doe_reference_name": {
          "type": ["str", "list_of_str"],
          "restrict_to": default_buildings,
          "description": "Building type to use in selecting a simulated load profile from DOE <a href='https: //energy.gov/eere/buildings/commercial-reference-buildings' target='blank'>Commercial Reference Buildings</a>. By default, the doe_reference_name of the LoadProfile is used."
        },
        "annual_mmbtu": {
          "type": "float",
          "min": 0.0,
          "max": max_big_number,
          "description": "Annual electric chiller electric consumption, in mmbtu, used to scale simulated default boiler load profile for the site's climate zone",
        },
        "monthly_mmbtu": {
         "type": "list_of_float",
         "min": 0.0,
         "max": max_big_number,
         "description": "Monthly boiler energy consumption series (an array 12 entries long), in mmbtu, used to scale simulated default electric boiler load profile for the site's climate zone"
        },
        "loads_mmbtu_per_hour": {
          "type": "list_of_float",
          "description": "Typical boiler fuel load for all hours in one year."
        },
        "percent_share": {
         "type": ["float", "list_of_float"],
          "min": 1.0,
          "max": 100.0,
         "description": "Percentage share of the types of building for creating hybrid simulated building and campus profiles."
        },
        "addressable_load_fraction": {
         "type": ["float", "list_of_float"],
          "min": 0.0,
          "max": 1.0,
          "default": 1.0,
         "description": "Fraction of the boiler fuel load be served by heating technologies."
        },
        "space_heating_fraction_of_heating_load": {
         "type": ["float", "list_of_float"],
          "min": 0.0,
          "max": 1.0,
         "description": "Fraction of the total heating load (domestic hot water (DHW) plus space heating) for space heating."
        },
      },

      "LoadProfileChillerThermal": {
        "doe_reference_name": {
          "type": ["str", "list_of_str"],
          "restrict_to": default_buildings,
          "description": "Building type to use in selecting a simulated load profile from DOE <a href='https: //energy.gov/eere/buildings/commercial-reference-buildings' target='blank'>Commercial Reference Buildings</a>. By default, the doe_reference_name of the LoadProfile is used."
        },
        "loads_ton": {
          "type": "list_of_float",
          "description": "Typical electric chiller load for all hours in one year."
        },
        "annual_tonhour": {
          "type": "float",
          "min": 0.0,
          "max": max_big_number,
          "description": "Annual electric chiller energy consumption, in ton-hours, used to scale simulated default electric chiller load profile for the site's climate zone",
        },
        "monthly_tonhour": {
         "type": "list_of_float",
         "min": 0.0,
          "max": max_big_number,
         "description": "Monthly electric chiller energy consumption series (an array 12 entries long), in ton-hours, used to scale simulated default electric chiller load profile for the site's climate zone"
        },
        "annual_fraction": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "description": "Annual electric chiller energy consumption scalar (i.e. fraction of total electric load, used to scale simulated default electric chiller load profile for the site's climate zone",
        },
        "monthly_fraction": {
         "type": "list_of_float",
         "min": 0.0,
          "max": max_big_number,
         "description": "Monthly electric chiller energy consumption scalar series (i.e. 12 fractions of total electric load by month), used to scale simulated default electric chiller load profile for the site's climate zone."
        },
        "loads_fraction": {
          "type": "list_of_float",
          "min": 0.0,
          "max": max_big_number,
          "description": "Typical electric chiller load proporion of electric load series (unit is a percent) for all time steps in one year."
        },
        "percent_share": {
           "type": ["float", "list_of_float"],
            "min": 1.0,
            "max": 100.0,
           "description": "Percentage share of the types of building for creating hybrid simulated building and campus profiles."
          },
        "chiller_cop": {
          "type": "float",
          "min:": 0.01,
          "max:": 20.0,
          "description": "Existing electric chiller system coefficient of performance - conversion of electricity to "
                         "usable cooling thermal energy"
        },
      },

      "ElectricTariff": {
        "urdb_utility_name": {
          "type": "str",
          "replacement_sets": electric_tariff_possible_sets,
          "depends_on": ["urdb_rate_name"],
          "description": "Name of Utility from  <a href='https: //openei.org/wiki/Utility_Rate_Database' target='blank'>Utility Rate Database</a>"
        },
        "urdb_rate_name": {
          "type": "str",
          "replacement_sets": electric_tariff_possible_sets,
          "depends_on": ["urdb_utility_name"],
          "description": "Name of utility rate from  <a href='https: //openei.org/wiki/Utility_Rate_Database' target='blank'>Utility Rate Database</a>"
        },
        "add_blended_rates_to_urdb_rate": {
          "type": "bool",
          "default": False,
          "description": "Set to 'true' to add the monthly blended energy rates and demand charges to the URDB rate schedule. Otherwise, blended rates will only be considered if a URDB rate is not provided. "
        },
        "blended_monthly_rates_us_dollars_per_kwh": {
          "type": "list_of_float",
          "replacement_sets": electric_tariff_possible_sets,
          "depends_on": ["blended_monthly_demand_charges_us_dollars_per_kw"],
          "description": "Array (length of 12) of blended energy rates (total monthly energy in kWh divided by monthly cost in $)"
        },
        "blended_monthly_demand_charges_us_dollars_per_kw": {
          "type": "list_of_float",
          "replacement_sets": electric_tariff_possible_sets,
          "depends_on": ["blended_monthly_rates_us_dollars_per_kwh"],
          "description": "Array (length of 12) of blended demand charges (demand charge cost in $ divided by monthly peak demand in kW)"
        },
        "blended_annual_rates_us_dollars_per_kwh": {
          "type": "float",
          "replacement_sets": electric_tariff_possible_sets,
          "depends_on": ["blended_annual_demand_charges_us_dollars_per_kw"],
          "description": "Annual blended energy rate (total annual energy in kWh divided by annual cost in $)"
          },
        "blended_annual_demand_charges_us_dollars_per_kw": {
          "type": "float",
          "replacement_sets": electric_tariff_possible_sets,
          "depends_on": ["blended_annual_rates_us_dollars_per_kwh"],
          "description": "Annual blended demand rates (annual demand charge cost in $ divided by annual peak demand in kW)"
          },
        "add_tou_energy_rates_to_urdb_rate": {
          "type": "bool",
          "default": False,
          "description": "Set to 'true' to add the tou  energy rates to the URDB rate schedule. Otherwise, tou energy rates will only be considered if a URDB rate is not provided. "
        },
        "tou_energy_rates_us_dollars_per_kwh": {
          "type": "list_of_float",
          "replacement_sets": electric_tariff_possible_sets,
          "description": "Time-of-use energy rates, provided by user. Must be an array with length equal to number of timesteps per year. Hourly or 15 minute rates allowed."
        },
        "net_metering_limit_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Upper limit on the total capacity of technologies that can participate in net metering agreement."
        },
        "interconnection_limit_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": max_big_number,
          "description": "Limit on system capacity size that can be interconnected to the grid"
        },
        "wholesale_rate_us_dollars_per_kwh": {
          "type": ["float", "list_of_float"],
          "min": 0.0,
          "default": 0.0,
          "description": "Price of electricity sold back to the grid in absence of net metering or above net metering limit. The total annual kWh that can be compensated under this rate is restricted to the total annual site-load in kWh. Can be a scalar value, which applies for all-time, or an array with time-sensitive values. If an array is input then it must have a length of 8760, 17520, or 35040. The inputed array values are up/down-sampled using mean values to match the Scenario time_steps_per_hour."
        },
        "wholesale_rate_above_site_load_us_dollars_per_kwh": {
          "type": ["float", "list_of_float"],
          "min": 0.0,
          "default": 0.0,
          "description": "Price of electricity sold back to the grid above the site load, regardless of net metering.  Can be a scalar value, which applies for all-time, or an array with time-sensitive values. If an array is input then it must have a length of 8760, 17520, or 35040. The inputed array values are up/down-sampled using mean values to match the Scenario time_steps_per_hour."
        },
        "urdb_response": {
          "type": "dict",
          "replacement_sets": electric_tariff_possible_sets,
          "description": "Utility rate structure from <a href='https: //openei.org/services/doc/rest/util_rates/?version=3' target='blank'>Utility Rate Database API</a>"
        },
        "urdb_label": {
          "type": "str",
          "replacement_sets": electric_tariff_possible_sets,
          "description": "Label attribute of utility rate structure from <a href='https: //openei.org/services/doc/rest/util_rates/?version=3' target='blank'>Utility Rate Database API</a>"
        },
        "emissions_factor_series_lb_CO2_per_kwh": {
          "type": ["float", "list_of_float"],
          "description": "Carbon Dioxide emissions factor over all hours in one year. Can be provided as either a single constant fraction that will be applied across all timesteps, or an annual timeseries array at an hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples) resolution.",
        },
        "emissions_factor_CO2_pct_decrease": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.01174,
          "description": "Annual percent decrease in the total annual CO2 marginal emissions rate of the grid. A negative value indicates an annual increase.",
        },
        "emissions_factor_series_lb_NOx_per_kwh": {
          "type": ["list_of_float", "float"],
          "description": "NOx emissions factor over all hours in one year. Can be provided as either a single constant fraction that will be applied across all timesteps, or an annual timeseries array at an hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples) resolution.",
        },
        "emissions_factor_NOx_pct_decrease": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.01174,
          "description": "Annual percent decrease in the total annual NOx marginal emissions rate of the grid. A negative value indicates an annual increase.",
        },
        "emissions_factor_series_lb_SO2_per_kwh": {
          "type": ["list_of_float", "float"],
          "description": "SO2 emissions factor over all hours in one year. Can be provided as either a single constant fraction that will be applied across all timesteps, or an annual timeseries array at an hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples) resolution.",
        },
        "emissions_factor_SO2_pct_decrease": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.01174,
          "description": "Annual percent decrease in the total annual SO2 marginal emissions rate of the grid. A negative value indicates an annual increase.",
        },
        "emissions_factor_series_lb_PM25_per_kwh": {
          "type": ["list_of_float", "float"],
          "description": "PM2.5 emissions factor over all hours in one year. Can be provided as either a single constant fraction that will be applied across all timesteps, or an annual timeseries array at an hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples) resolution.",
        },
        "emissions_factor_PM25_pct_decrease": {
          "type": "float",
          "min": -1.0,
          "max": 1.0,
          "default": 0.01174,
          "description": "Annual percent decrease in the total annual PM2.5 marginal emissions rate of the grid. A negative value indicates an annual increase.",
        },
        "chp_standby_rate_us_dollars_per_kw_per_month": {
          "type": "float",
          "min": 0.0,
          "max": 1000.0,
          "default": 0.0,
          "description": "Standby rate charged to CHP based on CHP electric power size"
        },
        "chp_does_not_reduce_demand_charges": {
          "type": "bool",
          "default": False,
          "description": "Boolean indicator if CHP does not reduce demand charges"
        },
        "coincident_peak_load_active_timesteps": {
          "type": ["int", "list_of_int", "list_of_list"],
          "depends_on": ["coincident_peak_load_charge_us_dollars_per_kw"],
          "description": "The optional coincident_peak_load_charge_us_dollars_per_kw will apply at the max grid-purchased power during these timesteps. Note timesteps are indexed to a base of 1 not 0."
        },
        "coincident_peak_load_charge_us_dollars_per_kw": {
          "type": ["float", "list_of_float"],
          "min": 0,
          "max": max_big_number,
          "depends_on":["coincident_peak_load_active_timesteps"],
          "description": "Optional coincident peak demand charge that is applied to the max load during the timesteps specified in coincident_peak_load_active_timesteps"
        },
      },

      "FuelTariff": {
        "existing_boiler_fuel_type": {
          "type": "str",
          "default": 'natural_gas',
          "restrict_to": ["natural_gas", "landfill_bio_gas", "propane", "diesel_oil"],
          "description": "Boiler fuel type one of (natural_gas, landfill_bio_gas, propane, diesel_oil)"
        },
        "boiler_fuel_blended_annual_rates_us_dollars_per_mmbtu": {
          "type": "float",
          "default": 0.0,
          "description": "Single/scalar blended fuel rate for the entire year"
        },
        "boiler_fuel_blended_monthly_rates_us_dollars_per_mmbtu": {
          "type": "list_of_float",
          "default": [0.0]*12,
          "description": "Array (length of 12) of blended fuel rates (total monthly energy in mmbtu divided by monthly cost in $)"
        },
        "boiler_fuel_percent_RE": {
          "type": "float",
          "default": 0.0,
          "min": 0.0,
          "max": 1.0,
          "description": "Fraction of boiler fuel, on an energy basis, that is classified as renewable; used for RE accounting purposes."
        },
        "chp_fuel_type": {
          "type": "str",
          "default": 'natural_gas',
          "restrict_to": ["natural_gas", "landfill_bio_gas", "propane", "diesel_oil"],
          "description": "Boiler fuel type (natural_gas, landfill_bio_gas, propane, diesel_oil)"
        },
        "chp_fuel_blended_annual_rates_us_dollars_per_mmbtu": {
          "type": "float",
          "default": 0.0,
          "description": "Single/scalar blended fuel rate for the entire year"
        },
        "chp_fuel_blended_monthly_rates_us_dollars_per_mmbtu": {
          "type": "list_of_float",
          "default": [0.0] * 12,
          "description": "Array (length of 12) of blended fuel rates (total monthly energy in mmbtu divided by monthly cost in $)"
        },
        "newboiler_fuel_type": {
          "type": "str",
          "default": 'natural_gas',
          "restrict_to": ["natural_gas", "landfill_bio_gas", "propane", "diesel_oil", "uranium"],
          "description": "Boiler fuel type one of (natural_gas, landfill_bio_gas, propane, diesel_oil)"
        },
        "newboiler_fuel_percent_RE": {
          "type": "float",
          "default": 0.0,
          "min": 0.0,
          "max": 1.0,
          "description": "Fraction of boiler fuel, on an energy basis, that is classified as renewable; used for RE accounting purposes."
        },
        "newboiler_fuel_blended_annual_rates_us_dollars_per_mmbtu": {
          "type": "float",
          "default": 0.0,
          "description": "Single/scalar blended fuel rate for the entire year"
        },
        "newboiler_fuel_blended_monthly_rates_us_dollars_per_mmbtu": {
          "type": "list_of_float",
          "default": [0.0]*12,
          "description": "Array (length of 12) of blended fuel rates (total monthly energy in mmbtu divided by monthly cost in $)"
        },
        "chp_fuel_percent_RE": {
          "type": "float",
          "default": 0.0,
          "min": 0.0,
          "max": 1.0,
          "description": "Fraction of CHP fuel, on an energy basis, that is classified as renewable; used for RE accounting purposes."
        },
      },

      "Wind": {
        "size_class": {
          "type": "str",
          "restrict_to": ['residential', 'commercial', 'medium', 'large', None],
          "description": "Turbine size-class. One of [residential, commercial, medium, large]"
        },
        "wind_meters_per_sec": {
          "type": "list_of_float",
          "description": "Data downloaded from Wind ToolKit for modeling wind turbine."
        },
        "wind_direction_degrees": {
          "type": "list_of_float",
          "description": "Data downloaded from Wind ToolKit for modeling wind turbine."
        },
        "temperature_celsius": {
          "type": "list_of_float",
          "description": "Data downloaded from Wind ToolKit for modeling wind turbine."
        },
        "pressure_atmospheres": {
          "type": "list_of_float",
          "description": "Data downloaded from Wind ToolKit for modeling wind turbine."
        },
        "min_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Minimum wind power capacity constraint for optimization"
        },
        "max_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Maximum wind power capacity constraint for optimization. Set to zero to disable Wind. Enabled by default"
        },
        "installed_cost_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e5,
          "default": 3013.0,  # if the default value of 3013 goes in techs.py, there is a logic to assign actual default cost based on 'size_class' and api_version
          "description": "Total upfront installed costs in US dollars/kW. Determined by size_class. For the 'large' (>2MW) size_class the cost is $2,239/kW. For the 'medium commercial' size_class the cost is $2,766/kW. For the 'small commercial' size_class the cost is $4,300/kW and for the 'residential' size_class the cost is $5,675/kW "
        },
        "om_cost_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e3,
          "default": 40.0,
          "description": "Total annual operations and maintenance costs for wind"
        },
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 5,
          "description": "MACRS schedule for financial analysis. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to depreciate under MACRS"
        },
        "macrs_itc_reduction": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.5,
          "description": "Percent of the full ITC that depreciable basis is reduced by"
        },
        "federal_itc_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.123, # if the default value of 0.123 goes in techs.py, there is logic to assign actual default itc 'size_class' and api_version
          "description": "Percent federal capital cost incentive"
        },
        "state_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to discount under state investment based incentives"
        },
        "state_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under state investment based incentives"
        },
        "utility_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to discount under utility investment based incentives"
        },
        "utility_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under utility investment based incentives"
        },
        "federal_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Federal rebate based on installed capacity"
        },
        "state_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "State rebates based on installed capacity"
        },
        "state_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under state rebates"
        },
        "utility_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Utility rebates based on installed capacity"
        },
        "utility_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under utility rebates"
        },
        "pbi_us_dollars_per_kwh": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Production-based incentive value"
        },
        "pbi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1.0e9,
          "description": "Maximum rebate allowed under utility production-based incentives"
        },
        "pbi_years": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1,
          "description": "Duration of production-based incentives from installation date"
        },
        "pbi_system_max_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1.0e9,
          "description": "Maximum system size for which production-based incentives apply"
        },
        "prod_factor_series_kw": {
          "type": "list_of_float",
          "description": "Optional user-defined production factors. Entries have units of kWh/kW, representing the energy (kWh) output of a 1 kW system in each time step. Must be hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples)."
        },
        "can_net_meter": {
          "type": "bool",
          "default": True,
          "description": "True/False for if technology has option to participate in net metering agreement with utility. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_wholesale": {
          "type": "bool",
          "default": True,
          "description": "True/False for if technology has option to export energy that is compensated at the wholesale_rate_us_dollars_per_kwh. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_export_beyond_site_load": {
          "type": "bool",
          "default": True,
          "description": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the wholesale_rate_above_site_load_us_dollars_per_kwh)."
        },
        "can_curtail": {
          "type": "bool",
          "default": True,
          "description": "True/False for if technology can curtail energy produced."
        }
      },

      "PV": {
        "pv_name": {
          "type": "str",
          "description": "Site name/description"
        },
        "existing_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e5,
          "default": 0.0,
          "description": "Existing PV size"
        },
        "min_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Minimum PV size constraint for optimization"
        },
        "max_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1.0e9,
          "description": "Maximum PV size constraint for optimization. Set to zero to disable PV"
        },
        "installed_cost_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e5,
          "default": 1600.0,
          "description": "Installed PV cost in $/kW"
        },
        "om_cost_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e3,
          "default": 16.0,
          "description": "Annual PV operations and maintenance costs in $/kW"
        },
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 5,
          "description": "Duration over which accelerated depreciation will occur. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 1.0,
          "description": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation"
        },
        "macrs_itc_reduction": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.5,
          "description": "Percent of the ITC value by which depreciable basis is reduced"
        },
        "federal_itc_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.26,
          "description": "Percentage of capital costs that are credited towards federal taxes"
        },
        "state_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percentage of capital costs offset by state incentives"
        },
        "state_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum dollar value of state percentage-based capital cost incentive"
        },
        "utility_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percentage of capital costs offset by utility incentives"
        },
        "utility_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum dollar value of utility percentage-based capital cost incentive"
        },
        "federal_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Federal rebates based on installed capacity"
        },
        "state_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "State rebate based on installed capacity"
        },
        "state_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum state rebate"
        },
        "utility_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Utility rebate based on installed capacity"
        },
        "utility_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum utility rebate"
        },
        "pbi_us_dollars_per_kwh": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Production-based incentive value"
        },
        "pbi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1.0e9,
          "description": "Maximum annual value in present terms of production-based incentives"
        },
        "pbi_years": {
          "type": "float",
          "min": 0.0,
          "max": 100.0,
          "default": 1.0,
          "description": "Duration of production-based incentives from installation date"
        },
        "pbi_system_max_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1.0e9,
          "description": "Maximum system size eligible for production-based incentive"
        },
        "degradation_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.005,
          "description": "Annual rate of degradation in PV energy production"
        },
        "azimuth": {
          "type": "float",
          "min": 0.0,
          "max": 360.0,
          "default": 180.0,
          "description": "PV azimuth angle"
        },
        "losses": {
          "type": "float",
          "min": 0.0,
          "max": 0.99,
          "default": 0.14,
          "description": "PV system performance losses"
        },
        "array_type": {
          "type": "int",
          "restrict_to": [0, 1, 2, 3, 4],
          "default": 1,
          "description": "PV Watts array type (0: Ground Mount Fixed (Open Rack); 1: Rooftop, Fixed; 2: Ground Mount 1-Axis Tracking; 3 : 1-Axis Backtracking; 4: Ground Mount, 2-Axis Tracking)"
        },
        "module_type": {
          "type": "int",
          "restrict_to": [0, 1, 2],
          "default": 0,
          "description": "PV module type (0: Standard; 1: Premium; 2: Thin Film)"
        },
        "gcr": {
          "type": "float",
          "min": 0.01,
          "max": 0.99,
          "default": 0.4,
          "description": "PV ground cover ratio (photovoltaic array area : total ground area)."
        },
        "dc_ac_ratio": {
          "type": "float",
          "min": 0.0,
          "max": 2,
          "default": 1.2,
          "description": "PV DC-AC ratio"
        },
        "inv_eff": {
          "type": "float",
          "min": 0.9,
          "max": 0.995,
          "default": 0.96,
          "description": "PV inverter efficiency"
        },
        "radius": {
          "type": "float",
          "min": 0.0,
          "default": 0.0,
          "description": "Radius, in miles, to use when searching for the closest climate data station. Use zero to use the closest station regardless of the distance"
        },
        "tilt": {
          "type": "float",
          "min": 0.0,
          "max": 90.0,
          "default": 0.537,
          "description": "PV system tilt"
        },
        "location": {
          "type": "str",
          "restrict_to": ['roof', 'ground', 'both'],
          "default": 'both',
          "description": "Where PV can be deployed. One of [roof, ground, both] with default as both"
        },
        "prod_factor_series_kw": {
          "type": "list_of_float",
          "description": "Optional user-defined production factors. Entries have units of kWh/kW, representing the AC energy (kWh) output of a 1 kW-DC system in each time step. Must be hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples)."
        },
        "can_net_meter": {
          "type": "bool",
          "default": True,
          "description": "True/False for if technology has option to participate in net metering agreement with utility. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_wholesale": {
          "type": "bool",
          "default": True,
          "description": "True/False for if technology has option to export energy that is compensated at the wholesale_rate_us_dollars_per_kwh. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_export_beyond_site_load": {
          "type": "bool",
          "default": True,
          "description": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the wholesale_rate_above_site_load_us_dollars_per_kwh)."
        },
        "can_curtail": {
          "type": "bool",
          "default": True,
          "description": "True/False for if technology can curtail energy produced."
        },
        "sr_required_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Applies to off-grid scenarios only. Spinning reserve requirement for PV serving load in off-grid analyses. Value must be between zero and one, inclusive."
        }
      },

      "Storage": {
          "min_kw": {
            "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
            "description": "Minimum battery power capacity size constraint for optimization"
          },
          "max_kw": {
            "type": "float", "min": 0.0, "max": 1.0e9, "default": 1000000.0,
            "description": "Maximum battery power capacity size constraint for optimization. Set to zero to disable storage"
          },
          "min_kwh": {
            "type": "float", "min": 0.0, "default": 0.0,
            "description": "Minimum battery energy storage capacity constraint for optimization"
          },
          "max_kwh": {
            "type": "float", "min": 0.0, "default": 1000000.0,
            "description": "Maximum battery energy storage capacity constraint for optimization. Set to zero to disable Storage"
          },
          "internal_efficiency_pct": {
            "type": "float", "min": 0.0, "max": 1.0, "default": 0.975,
            "description": "Battery inherent efficiency independent of inverter and rectifier"
          },
          "inverter_efficiency_pct": {
            "type": "float", "min": 0.0, "max": 1.0, "default": 0.96,
            "description": "Battery inverter efficiency"
          },
          "rectifier_efficiency_pct": {
            "type": "float", "min": 0.0, "max": 1.0, "default": 0.96,
            "description": "Battery rectifier efficiency"
          },
          "soc_min_pct": {
            "type": "float", "min": 0.0, "max": 1.0, "default": 0.2,
            "description": "Minimum allowable battery state of charge"
          },
          "soc_init_pct": {
            "type": "float", "min": 0.0, "max": 1.0, "default": 0.5,
            "description": "Battery state of charge at first hour of optimization"
          },
          "canGridCharge": {
            "type": "bool", "default": True,
            "description": "Flag to set whether the battery can be charged from the grid, or just onsite generation"
          },
          "installed_cost_us_dollars_per_kw": {
            "type": "float", "min": 0.0, "max": 1.0e4, "default": 840.0,
            "description": "Total upfront battery power capacity costs (e.g. inverter and balance of power systems)"
          },
          "installed_cost_us_dollars_per_kwh": {
            "type": "float", "min": 0.0, "max": 1.0e4, "default": 420.0,
            "description": "Total upfront battery costs"
          },
          "replace_cost_us_dollars_per_kw": {
            "type": "float", "min": 0.0, "max": 1.0e4, "default": 410.0,
            "description": "Battery power capacity replacement cost at time of replacement year"
          },
          "replace_cost_us_dollars_per_kwh": {
            "type": "float", "min": 0.0, "max": 1.0e4, "default": 200.0,
            "description": "Battery energy capacity replacement cost at time of replacement year"
          },
          "inverter_replacement_year": {
            "type": "float", "min": 0.0, "max": max_years, "default": 10.0,
            "description": "Number of years from start of analysis period to replace inverter"
          },
          "battery_replacement_year": {
            "type": "float", "min": 0.0, "max": max_years, "default": 10.0,
            "description": "Number of years from start of analysis period to replace battery"
          },
          "macrs_option_years": {
            "type": "int", "restrict_to": macrs_schedules, "default": 7.0,
            "description": "Duration over which accelerated depreciation will occur. Set to zero to disable"
          },
          "macrs_bonus_pct": {
            "type": "float", "min": 0.0, "max": 1.0, "default": 1.0,
            "description": "Percent of upfront project costs to depreciate under MACRS in year one in addtion to scheduled depreciation"
          },
          "macrs_itc_reduction": {
            "type": "float", "min": 0.0, "max": 1.0, "default": 0.5,
            "description": "Percent of the ITC value by which depreciable basis is reduced"
          },
          "total_itc_pct": {
            "type": "float", "min": 0.0, "max": 1.0, "default": 0.0,
            "description": "Total investment tax credit in percent applied toward capital costs"
          },
          "total_rebate_us_dollars_per_kw": {
            "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
            "description": "Rebate based on installed power capacity"
          },
          "total_rebate_us_dollars_per_kwh": {
            "type": "float", "min": 0, "max": 1e9, "default": 0,
            "description": "Rebate based on installed energy capacity"
          }
        },

      "Generator": {
        "existing_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e5,
          "default": 0.0,
          "description": "Existing diesel generator size"
        },
        "min_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Minimum diesel generator size constraint for optimization"
        },
        "max_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1.0e9,
          "description": "Maximum diesel generator size constraint for optimization. Set to zero to disable gen"
        },
        "installed_cost_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e5,
          "default": 500.0,
          "description": "Installed diesel generator cost in $/kW"
        },
        "om_cost_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e3,
          "default": 10.0,
          "description": "Annual diesel generator fixed operations and maintenance costs in $/kW"
        },
        "om_cost_us_dollars_per_kwh": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e3,
          "default": 0.00,
          "description": "diesel generator per unit production (variable) operations and maintenance costs in $/kWh"
        },
        "diesel_fuel_cost_us_dollars_per_gallon": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e2,
          "default": 3.0,
          "description": "diesel cost in $/gallon"
        },
        "fuel_slope_gal_per_kwh": {
          "type": "float",
          "min": 0.0,
          "max": 10,
          "default": 0.076,
          "description": "Generator fuel burn rate in gallons/kWh."
        },
        "fuel_intercept_gal_per_hr": {
          "type": "float",
          "min": 0.0,
          "max": 10,
          "default": 0.0,
          "description": "Generator fuel consumption curve y-intercept in gallons per hour."
        },
        "fuel_avail_gal": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 660.0,
          "description": "Annual on-site generator fuel available in gallons."
        },
        "min_turn_down_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Minimum generator loading in percent of capacity (size_kw)."
        },
        "generator_fuel_percent_RE": {
          "type": "float",
          "default": 0.0,
          "min": 0.0,
          "max": 1.0,
          "description": "Fraction of generator fuel, on an energy basis, that is classified as renewable; used for RE accounting purposes."
        },
        "generator_only_runs_during_grid_outage": {
          "default": True,
          "type": "bool",
          "description": "If there is existing diesel generator, must specify whether it should run only during grid outage or all the time in the bau case."
        },
        "generator_sells_energy_back_to_grid": {
          "default": False,
          "type": "bool",
          "description": "If there is existing diesel generator, must specify whether it should run only during grid outage or all the time in the bau case."
        },
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 0,
          "description": "MACRS schedule for financial analysis. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 1.0,
          "description": "Percent of upfront project costs to depreciate under MACRS"
        },
        "macrs_itc_reduction": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of the full ITC that depreciable basis is reduced by"
        },
        "federal_itc_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent federal capital cost incentive"
        },
        "state_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to discount under state investment based incentives"
        },
        "state_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": 0.0,
          "description": "Maximum rebate allowed under state investment based incentives"
        },
        "utility_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to discount under utility investment based incentives"
        },
        "utility_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": 0.0,
          "description": "Maximum rebate allowed under utility investment based incentives"
        },
        "federal_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Federal rebate based on installed capacity"
        },
        "state_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "State rebates based on installed capacity"
        },
        "state_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": 0.0,
          "description": "Maximum rebate allowed under state rebates"
        },
        "utility_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Utility rebates based on installed capacity"
        },
        "utility_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": 0.0,
          "description": "Maximum rebate allowed under utility rebates"
        },
        "pbi_us_dollars_per_kwh": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Production-based incentive value"
        },
        "pbi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Maximum rebate allowed under utility production-based incentives"
        },
        "pbi_years": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Duration of production-based incentives from installation date"
        },
        "pbi_system_max_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Maximum system size for which production-based incentives apply"
        },
        "emissions_factor_lb_CO2_per_gal": {
          "type": "float",
          "description": "Pounds of carbon dioxide emitted per gallon of fuel burned"
        },
        "emissions_factor_lb_NOx_per_gal": {
          "type": "float",
          "description": "Pounds of NOx emitted per gallon of fuel burned"
        },
        "emissions_factor_lb_SO2_per_gal": {
          "type": "float",
          "description": "Pounds of SO2 emitted per gallon of fuel burned"
        },
        "emissions_factor_lb_PM25_per_gal": {
          "type": "float",
          "description": "Pounds of PM2.5 emitted per gallon of fuel burned"
        },
        "can_net_meter": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology has option to participate in net metering agreement with utility. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_wholesale": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology has option to export energy that is compensated at the wholesale_rate_us_dollars_per_kwh. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_export_beyond_site_load": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the wholesale_rate_above_site_load_us_dollars_per_kwh)."
        },
        "can_curtail": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology can curtail energy produced."
        },
        "useful_life_years": {
          "type": "float", "min": analysis_years, "max": analysis_years, "default": analysis_years,
          "description": "Number of years asset can be used for before replacement. Generator replacements are only considered in off-grid analyses."
        }
      },
      "CHP": {
        "prime_mover": {
          "type": "str",
          "description": "CHP prime mover type (recip_engine, micro_turbine, combustion_turbine, fuel_cell)"
        },
        "size_class": {
          "type": "int",
          "restrict_to": [0, 1, 2, 3, 4, 5, 6],
          "description": "CHP size class for using appropriate default inputs"
        },
        "min_kw": {
          "type": "float",
          "min": 0.0,
          "max": max_big_number,
          "default": 0.0,          
          "description": "Minimum CHP size (based on electric) constraint for optimization"
        },
        "max_kw": {
          "type": "float",
          "min": 0.0,
          "max": max_big_number,
          "description": "Maximum CHP size (based on electric) constraint for optimization. Set to zero to disable CHP"
        },
        "min_allowable_kw": {
          "type": "float",
          "min": 0.0,
          "max": max_big_number,
          "description": "Minimum CHP size (based on electric) that still allows the model to choose zero (e.g. no CHP system)"
        },
        "installed_cost_us_dollars_per_kw": {
          "type": ["float", "list_of_float"],
          "min": 0.0,
          "max": 1.0e5,
          "description": "Installed CHP system cost in $/kW (based on rated electric power)"
        },
        "tech_size_for_cost_curve": {
          "type": ["float", "list_of_float"],
          "min": 0.0,
          "max": 1.0e10,
          "description": "Size of CHP systems corresponding to installed cost input points"
        },
        "om_cost_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e4,
          "default": 0.0,           
          "description": "Annual CHP fixed operations and maintenance costs in $/kw-yr"
        },
        "om_cost_us_dollars_per_kwh": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e3,
          "description": "CHP non-fuel variable operations and maintenance costs in $/kwh"
        },
        "om_cost_us_dollars_per_hr_per_kw_rated": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,          
          "description": "CHP non-fuel variable operations and maintenance costs in $/hr/kw_rated"
        },
        "elec_effic_full_load": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "description": "Electric efficiency of CHP prime-mover at full-load, HHV-basis"
        },
        "elec_effic_half_load": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "description": "Electric efficiency of CHP prime-mover at half-load, HHV-basis"
        },
        "min_turn_down_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "description": "Minimum CHP electric loading in percent of capacity (size_kw)."
        },
        "thermal_effic_full_load": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "description": "CHP fraction of fuel energy converted to hot-thermal energy at full electric load"
        },
        "thermal_effic_half_load": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "description": "CHP fraction of fuel energy converted to hot-thermal energy at half electric load"
        },
        "supplementary_firing_capital_cost_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e5,
          "default": 150.0,
          "description": "Installed CHP supplementary firing system cost in $/kW (based on rated electric power)"
          },
        "supplementary_firing_max_steam_ratio": {
          "type": "float",
          "min": 1.0,
          "max": 10.0,
          "default": 1.0,
          "description": "Ratio of max fired steam to un-fired steam production. Relevant only for combustion_turbine prime_mover"
        },
        "supplementary_firing_efficiency": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.92,
          "description": "Thermal efficiency of the incremental steam production from supplementary firing. Relevant only for combustion_turbine prime_mover"
        },
        "use_default_derate": {
          "type": "bool",
          "default": True,
          "description": "Boolean indicator if CHP derates per the default parameters, otherwise no derate is modeled"
        },
        "max_derate_factor": {
          "type": "float",
          "min": 0.1,
          "max": 1.5,
          "default": 1.0,          
          "description": "Maximum derate factor; the y-axis value of the 'flat' part of the derate curve, on the left"
        },
        "derate_start_temp_degF": {
          "type": "float",
          "min": 0.0,
          "max": 150.0,
          "default": 95.0,          
          "description": "The outdoor air temperature at which the power starts to derate, units of degrees F"
        },
        "derate_slope_pct_per_degF": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,            
          "description": "Derate slope as a percent/fraction of rated power per degree F"
        },
        "chp_unavailability_periods": {
          "type": "list_of_dict",
          "description": "CHP unavailability periods for scheduled and unscheduled maintenance, list of dictionaries with keys of "
                            "['month', 'start_week_of_month', 'start_day_of_week', 'start_hour', 'duration_hours'] "
                            "all values are one-indexed and start_day_of_week uses 1 for Monday, 7 for Sunday"
        },
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 5,
          "description": "MACRS schedule for financial analysis. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 1.0,
          "description": "Percent of upfront project costs to depreciate under MACRS"
        },
        "macrs_itc_reduction": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.5,
          "description": "Percent of the full ITC that depreciable basis is reduced by"
        },
        "federal_itc_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.1,
          "description": "Percent federal capital cost incentive"
        },
        "state_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to discount under state investment based incentives"
        },
        "state_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under state investment based incentives"
        },
        "utility_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to discount under utility investment based incentives"
        },
        "utility_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under utility investment based incentives"
        },
        "federal_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Federal rebate based on installed capacity"
        },
        "state_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "State rebates based on installed capacity"
        },
        "state_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under state rebates"
        },
        "utility_rebate_us_dollars_per_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Utility rebates based on installed capacity"
        },
        "utility_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under utility rebates"
        },
        "pbi_us_dollars_per_kwh": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Production-based incentive value"
        },
        "pbi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under utility production-based incentives"
        },
        "pbi_years": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1.0,
          "description": "Duration of production-based incentives from installation date"
        },
        "pbi_system_max_kw": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 1.0e9,
          "description": "Maximum system size for which production-based incentives apply"
        },
        "emissions_factor_lb_CO2_per_mmbtu": {
          "type": "float",
          "description": "Pounds of carbon dioxide emitted per mmbtu of fuel burned"
        },
        "emissions_factor_lb_NOx_per_mmbtu": {
          "type": "float",
          "description": "Pounds of NOx emitted per mmbtu of fuel burned"
        },
        "emissions_factor_lb_SO2_per_mmbtu": {
          "type": "float",
          "description": "Pounds of SO2 emitted per mmbtu of fuel burned"
        },
        "emissions_factor_lb_PM25_per_mmbtu": {
          "type": "float",
          "description": "Pounds of PM2.5 emitted per mmbtu of fuel burned"
        },
        "can_net_meter": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology has option to participate in net metering agreement with utility. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_wholesale": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology has option to export energy that is compensated at the wholesale_rate_us_dollars_per_kwh. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_export_beyond_site_load": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the wholesale_rate_above_site_load_us_dollars_per_kwh)."
        },
        "can_curtail": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology can curtail energy produced."
        },
        "cooling_thermal_factor": {
          "type": "float",
          "min": 0.01,
          "max": 1.0,
          "description": "Knockdown factor on absorption chiller COP based on the CHP prime_mover not being able to produce as high of temp/pressure hot water/steam"
        },
        "can_supply_steam_turbine": {
          "type": "bool", "default": False,
          "description": "If CHP can supply steam to the steam turbine for electric production"
        },
      },

      "ColdTES": {
        "min_gal": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Minimum TES volume (energy) size constraint for optimization"
        },
        "max_gal": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Maximum TES volume (energy) size constraint for optimization. Set to zero to disable storage"
        },
        "chilled_supply_water_temp_degF": {
          "type": "float", "min": 0.0, "max": 100.0, "default": 44.0,
          "description": "Chilled-side supply water temperature from ColdTES (bottom of tank) to the cooling load"
        },
        "warmed_return_water_temp_degF": {
          "type": "float", "min": 6.0, "max": 120.0, "default": 56.0,
          "description": "Warmed-side return water temperature from the cooling load to the ColdTES (top of tank)"
        },
        "internal_efficiency_pct": {
          "type": "float", "min": 0.0, "max": 1.0, "default": 0.999999,
          "description": "Thermal losses due to mixing from thermal power entering or leaving tank"
        },
        "soc_min_pct": {
          "type": "float", "min": 0.0, "max": 1.0, "default": 0.1,
          "description": "Minimum allowable TES thermal state of charge"
        },
        "soc_init_pct": {
          "type": "float", "min": 0.0, "max": 1.0, "default": 0.5,
          "description": "TES thermal state of charge at first hour of optimization"
        },
        "installed_cost_us_dollars_per_gal": {
          "type": "float", "min": 0.0, "max": 1000.0, "default": 1.50,
          "description": "Thermal energy-based cost of TES (e.g. volume of the tank)"
        },
        "thermal_decay_rate_fraction": {
          "type": "float", "min": 0.0, "max": 0.1, "default": 0.0004,
          "description": "Thermal loss (gain) rate as a fraction of energy storage capacity, per hour (frac*energy_capacity/hr = kw_thermal)"
        },
        "om_cost_us_dollars_per_gal": {
         "type": "float", "min": 0.0, "max": 1000.0, "default": 0.0,
         "description": "Yearly fixed O&M cost dependent on storage energy size"
        },
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 0,
          "description": "MACRS schedule for financial analysis. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to depreciate under MACRS"
        },
      },

      "HotTES": {
        "min_gal": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Minimum TES volume (energy) size constraint for optimization"
        },
        "max_gal": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Maximum TES volume (energy) size constraint for optimization. Set to zero to disable storage"
        },
        "hot_supply_water_temp_degF": {
          "type": "float", "min": 40.0, "max": 210.0, "default": 180.0,
          "description": "Hot-side supply water temperature from HotTES (top of tank) to the heating load"
        },
        "cooled_return_water_temp_degF": {
          "type": "float", "min": 33.0, "max": 200.0, "default": 160.0,
          "description": "Cold-side return water temperature from the heating load to the HotTES (bottom of tank)"
        },
        "internal_efficiency_pct": {
          "type": "float", "min": 0.0, "max": 1.0, "default": 0.999999,
          "description": "Thermal losses due to mixing from thermal power entering or leaving tank"
        },
        "soc_min_pct": {
          "type": "float", "min": 0.0, "max": 1.0, "default": 0.1,
          "description": "Minimum allowable TES thermal state of charge"
        },
        "soc_init_pct": {
          "type": "float", "min": 0.0, "max": 1.0, "default": 0.5,
          "description": "TES thermal state of charge at first hour of optimization"
        },
        "installed_cost_us_dollars_per_gal": {
          "type": "float", "min": 0.0, "max": 1000.0, "default": 1.50,
          "description": "Thermal energy-based cost of TES (e.g. volume of the tank)"
        },
        "thermal_decay_rate_fraction": {
          "type": "float", "min": 0.0, "max": 0.1, "default": 0.0004,
          "description": "Thermal loss rate as a fraction of energy storage capacity, per hour (frac*energy_capacity/hr = kw_thermal)"
        },
        "om_cost_us_dollars_per_gal": {
          "type": "float", "min": 0.0, "max": 1000.0, "default": 0.0,
          "description": "Yearly fixed O&M cost dependent on storage energy size"
        },
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 0,
          "description": "MACRS schedule for financial analysis. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to depreciate under MACRS"
        },
      },

      "Boiler": {
        "max_thermal_factor_on_peak_load": {
          "type": "float", "min": 1.0, "max": 5.0, "default": 1.25,
          "description": "Factor on peak thermal LOAD which the boiler can supply"
        },
        "existing_boiler_production_type_steam_or_hw": {
          "type": "str",
          "restrict_to": ["hot_water", "steam"],
          "description": "Boiler thermal production type, hot water or steam"
        },
        "boiler_efficiency": {
          "type": "float",
          "min:": 0.0,
          "max:": 1.0,
          "description": "Existing boiler system efficiency - conversion of fuel to usable heating thermal energy. "
                         "Default value depends on existing_boiler_production_steam_or_hw input"
        },
        "can_supply_steam_turbine": {
          "type": "bool", "default": False,
          "description": "If the boiler can supply steam to the steam turbine for electric production"
        },
        "emissions_factor_lb_CO2_per_mmbtu": {
          "type": "float",
          "description": "Pounds of carbon dioxide emitted per mmbtu of fuel burned"
        },
        "emissions_factor_lb_NOx_per_mmbtu": {
          "type": "float",
          "description": "Pounds of NOx emitted per mmbtu of fuel burned"
        },
        "emissions_factor_lb_SO2_per_mmbtu": {
          "type": "float",
          "description": "Pounds of SO2 emitted per mmbtu of fuel burned"
        },
        "emissions_factor_lb_PM25_per_mmbtu": {
          "type": "float",
          "description": "Pounds of PM2.5 emitted per mmbtu of fuel burned"
        }
      },

      "ElectricChiller": {
        "max_thermal_factor_on_peak_load": {
          "type": "float", "min": 1.0, "max": 5.0, "default": 1.25,
          "description": "Factor on peak thermal LOAD which the electric chiller can supply"
        }
      },

      "AbsorptionChiller": {
        "min_ton": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Minimum thermal power size constraint for optimization"
        },
        "max_ton": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Maximum thermal power size constraint for optimization. Set to zero to disable absorption chl"
        },
        "chiller_cop": {
          "type": "float",
          "min:": 0.01,
          "max:": 20.0,
          "description": "Absorption chiller system coefficient of performance - conversion of hot thermal power input "
                         "to usable cooling thermal energy output"
        },
        "chiller_elec_cop": {
          "type": "float",
          "min:": 0.01,
          "max:": 100.0,
          "default": 14.1,
          "description": "Absorption chiller electric consumption CoP from cooling tower heat rejection - conversion of electric power input "
                         "to usable cooling thermal energy output"
        },
        "installed_cost_us_dollars_per_ton": {
          "type": "float", "min": 0.0, "max": 2.0e4,
          "description": "Thermal power-based cost of absorption chiller (3.5 to 1 ton to kwt)"
        },
        "om_cost_us_dollars_per_ton": {
          "type": "float", "min": 0.0, "max": 1000.0,
          "description": "Yearly fixed O&M cost on a thermal power (ton) basis"
        },
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 0,
          "description": "MACRS schedule for financial analysis. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to depreciate under MACRS"
        }
      },
      "NewBoiler": {
        "min_mmbtu_per_hr": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Minimum thermal power size"
          },
        "max_mmbtu_per_hr": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Maximum thermal power size"
        },
        "boiler_efficiency": {
          "type": "float", "min:": 0.0, "max:": 1.0, "default": 0.8,
          "description": "New boiler system efficiency - conversion of fuel to usable heating thermal energy"
        },
        "can_supply_steam_turbine": {
          "type": "bool", "default": True,
          "description": "If the boiler can supply steam to the steam turbine for electric production"
        },
        "installed_cost_us_dollars_per_mmbtu_per_hr": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 293000.0,
          "description": "Thermal power-based cost"
        },
        "om_cost_us_dollars_per_mmbtu_per_hr": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 2930.0,
          "description": "Thermal power-based fixed O&M cost"
        },
        "om_cost_us_dollars_per_mmbtu": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Thermal energy-based variable O&M cost"
        },
        "emissions_factor_lb_CO2_per_mmbtu": {
          "type": "float",
          "description": "Pounds of carbon dioxide emitted per mmbtu of fuel burned"
        },
        "emissions_factor_lb_NOx_per_mmbtu": {
          "type": "float",
          "description": "Pounds of NOx emitted per mmbtu of fuel burned"
        },
        "emissions_factor_lb_SO2_per_mmbtu": {
          "type": "float",
          "description": "Pounds of SO2 emitted per mmbtu of fuel burned"
        },
        "emissions_factor_lb_PM25_per_mmbtu": {
          "type": "float",
          "description": "Pounds of PM2.5 emitted per mmbtu of fuel burned"
        },
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 0,
          "description": "MACRS schedule for financial analysis. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to depreciate under MACRS"
        }
      },
      "SteamTurbine": {
        "size_class": {
          "type": "int",
          "restrict_to": [0, 1, 2, 3],
          "description": "Steam turbine size class for using appropriate default inputs"
        },
        "min_kw": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Minimum electric power size"
          },
        "max_kw": {
          "type": "float", "min": 0.0, "max": 1.0e9, "default": 0.0,
          "description": "Maximum electric power size"
        },
        "electric_produced_to_thermal_consumed_ratio": {
          "type": "float", "min": 0.0, "max": 1.0,
          "description": "Simplified input as alternative to detailed calculations from inlet and outlet steam conditions"
        },
        "thermal_produced_to_thermal_consumed_ratio": {
          "type": "float", "min": 0.0, "max": 1.0,
          "description": "Simplified input as alternative to detailed calculations from condensing outlet steam"
        },
        "is_condensing": {
          "type": "bool", "default": False,
          "description": "Steam turbine type, if it is a condensing turbine which produces no useful thermal (max electric output)"
        },
        "inlet_steam_pressure_psig": {
          "type": "float", "min": 0.0, "max": 5000.0,
          "description": "Inlet steam pressure to the steam turbine"
        },
        "inlet_steam_temperature_degF": {
          "type": "float", "min": 0.0, "max": 1300.0,
          "description": "Inlet steam temperature to the steam turbine"
        },
        "inlet_steam_superheat_degF": {
          "type": "float", "min": 0.0, "max": 700.0,
          "description": "Alternative input to inlet steam temperature, this is the superheat amount (delta from T_saturation) to the steam turbine"
        },
        "outlet_steam_pressure_psig": {
          "type": "float", "min": -14.7, "max": 1000.0,
          "description": "Outlet steam pressure from the steam turbine (to the condenser or heat recovery unit"
        },
        "outlet_steam_min_vapor_fraction": {
          "type": "float", "min": 0.0, "max": 1.0, "default": 0.8,
          "description": "Minimum vapor fraction at the outlet of the steam turbine: this serves as a check on the other inlet and outlet steam conditions to ensure that acceptable amounts of liquid are in the outlet"
        },
        "isentropic_efficiency": {
          "type": "float", "min": 0.0, "max": 1.0,
          "description": "Steam turbine isentropic efficiency - uses inlet T/P and outlet T/P/X to get power out"
        },
        "gearbox_generator_efficiency": {
          "type": "float", "min": 0.0, "max": 1.0,
          "description": "Conversion of steam turbine shaft power to electric power based on combined gearbox and electric generator efficiency"
        },
        "net_to_gross_electric_ratio": {
          "type": "float", "min": 0.0, "max": 1.0,
          "description": "Conversion of gross electric power to net power which can account for e.g. pump power"
        },
        "installed_cost_us_dollars_per_kw": {
          "type": "float", "min": 0.0, "max": 100000.0,
          "description": "Electric power-based cost"
        },
        "om_cost_us_dollars_per_kw": {
          "type": "float", "min": 0.0, "max": 5000.0,
          "description": "Electric power-based fixed O&M cost"
        },
        "om_cost_us_dollars_per_kwh": {
          "type": "float", "min": 0.0, "max": 100.0,
          "description": "Electric energy-based variable O&M cost"
        },
        "can_net_meter": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology has option to participate in net metering agreement with utility. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_wholesale": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology has option to export energy that is compensated at the wholesale_rate_us_dollars_per_kwh. Note that a technology can only participate in either net metering or wholesale rates (not both)."
        },
        "can_export_beyond_site_load": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the wholesale_rate_above_site_load_us_dollars_per_kwh)."
        },
        "can_curtail": {
          "type": "bool",
          "default": False,
          "description": "True/False for if technology can curtail energy produced."
        },
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 0,
          "description": "MACRS schedule for financial analysis. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to depreciate under MACRS"
        }
      },
      "GHP": {
        "require_ghp_purchase": {
          "type": "bool",
          "default": False,
          "description": "Force one of the considered GHP design options"
        },
        "installed_cost_heatpump_us_dollars_per_ton": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e5,
          "default": 1075.0,
          "description": "Installed heating heat pump cost in $/ton (based on peak coincident cooling+heating thermal load)"
        },
        "heatpump_capacity_sizing_factor_on_peak_load": {
          "type": "float",
          "min": 1.0,
          "max": 5.0,
          "default": 1.1,
          "description": "Factor on peak heating and cooling load served by GHP used for determining GHP installed capacity"
        },
        "installed_cost_ghx_us_dollars_per_ft": {
          "type": "float",
          "min": 0.0,
          "max": 100.0,
          "default": 14.0,
          "description": "Installed cost of the ground heat exchanger (GHX) in $/ft of vertical piping"
        },
        "installed_cost_building_hydronic_loop_us_dollars_per_sqft": {
          "type": "float",
          "min": 0,
          "max": 100.0,
          "default": 1.70,
          "description": "Installed cost of the building hydronic loop per floor space of the site"
        },
        "om_cost_us_dollars_per_sqft_year": {
          "type": "float",
          "min": -100,
          "max": 100,
          "default": -0.51,
          "description": "Annual GHP incremental operations and maintenance costs in $/ft^2-building/year"
        },
        "building_sqft": {
          "type": "float",
          "min": 0.0,
          "max": max_big_number,
          "description": "Building square footage for GHP/HVAC cost calculations"
        },
        "space_heating_efficiency_thermal_factor": {
          "type": "float",
          "min": 0.001,
          "max": 1.0,
          "description": "Heating efficiency factor (annual average) to account for reduced space heating thermal load from GHP retrofit (e.g. reduced reheat)"
        },
        "cooling_efficiency_thermal_factor": {
          "type": "float",
          "min": 0.001,
          "max": 1.0,
          "description": "Cooling efficiency factor (annual average) to account for reduced cooling thermal load from GHP retrofit (e.g. reduced reheat)"
        },       
        "ghpghx_inputs": {
          "type": "list_of_dict",
          "description": "GHP-GHX inputs/POST to /ghpghx endpoint"
        },
        "ghpghx_response_uuids": {
          "type": "list_of_str",
          "description": "GHPGHX response UUID(s) from /ghpghx endpoint, used to get ghpghx run data"
        },
        "ghpghx_responses": {
          "type": "list_of_dict",
          "description": "GHPGHX response(s) to re-use a previous /ghpghx run without relying on a database entry"
        },        
        "can_serve_dhw": {
          "type": "bool", "default": False,
          "description": "If GHP can serve the domestic hot water (DHW) portion of the heating load"
        },              
        "aux_heater_type": {
          "type": "str", "default": "electric",
          "description": "The type of auxiliary heater, 'electric' or 'natural_gas'"
        },
        "aux_heater_installed_cost_us_dollars_per_mmbtu_per_hr": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e6,
          "default": 26000.0,
          "description": "Installed cost of auxiliary heater for hybrid ghx in $/MMBtu/hr based on peak thermal production"
        },
        "aux_cooler_installed_cost_us_dollars_per_ton": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e6,
          "default": 400.0,
          "description": "Installed cost of auxiliary cooler (e.g. cooling tower) for hybrid ghx in $/ton based on peak thermal production"
        },
        "aux_unit_capacity_sizing_factor_on_peak_load": {
          "type": "float",
          "min": 1.0,
          "max": 5.0,
          "default": 1.2,
          "description": "Factor on peak heating and cooling load served by the auxiliary heater/cooler used for determining heater/cooler installed capacity"
        },        
        "macrs_option_years": {
          "type": "int",
          "restrict_to": macrs_schedules,
          "default": 5,
          "description": "MACRS schedule for financial analysis. Set to zero to disable"
        },
        "macrs_bonus_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 1.0,
          "description": "Percent of upfront project costs to depreciate under MACRS"
        },
        "macrs_itc_reduction": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.5,
          "description": "Percent of the full ITC that depreciable basis is reduced by"
        },
        "federal_itc_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.1,
          "description": "Percent federal capital cost incentive"
        },
        "state_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to discount under state investment based incentives"
        },
        "state_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under state investment based incentives"
        },
        "utility_ibi_pct": {
          "type": "float",
          "min": 0.0,
          "max": 1.0,
          "default": 0.0,
          "description": "Percent of upfront project costs to discount under utility investment based incentives"
        },
        "utility_ibi_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under utility investment based incentives"
        },
        "federal_rebate_us_dollars_per_ton": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Federal rebate based on installed capacity"
        },
        "state_rebate_us_dollars_per_ton": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "State rebates based on installed capacity"
        },
        "state_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under state rebates"
        },
        "utility_rebate_us_dollars_per_ton": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e9,
          "default": 0.0,
          "description": "Utility rebates based on installed capacity"
        },
        "utility_rebate_max_us_dollars": {
          "type": "float",
          "min": 0.0,
          "max": 1.0e10,
          "default": max_incentive,
          "description": "Maximum rebate allowed under utility rebates"
        }
      }
    }
  }
}

defaults_dict = {
  2: {
    "Scenario": {
      "Site": {
        "Financial": {
          "owner_discount_pct": {
            "default": 0.0564
          },
          "offtaker_discount_pct": {
            "default": 0.0564
          },
          "escalation_pct": {
            "default": 0.019
          }
        },
        "PV": {
          "installed_cost_us_dollars_per_kw": {
            "default":  1592.0
          },
          "om_cost_us_dollars_per_kw": {
            "default": 17.0
          },
          "federal_itc_pct": {
            "default": 0.3
          },
          "macrs_bonus_pct": {
            "default": 0.8
          }
        },
        "Storage": {
          "installed_cost_us_dollars_per_kwh": {
            "default": 388.0
          },
          "installed_cost_us_dollars_per_kw": {
            "default": 775.0
          },
          "replace_cost_us_dollars_per_kwh": {
            "default": 220.0
          },
          "replace_cost_us_dollars_per_kw": {
            "default": 440.0
          },
          "total_itc_pct": {
            "default": 0.3
          },
          "macrs_bonus_pct": {
            "default": 0.8
          }
        },
        "Wind": {
          "om_cost_us_dollars_per_kw": {
            "default": 35.0
          },
          "macrs_bonus_pct": {
            "default": 0.8
          }
        },
        "CHP": {
          "federal_itc_pct": {
            "default": 0.3
          },
          "macrs_bonus_pct": {
            "default": 0.8
          }
        },
        "GHP": {
          "federal_itc_pct": {
            "default": 0.3
          },
          "macrs_bonus_pct": {
            "default": 0.8
          }
        },
        "ColdTES": {
          "macrs_option_years": {
            "default": 7
          },
          "macrs_bonus_pct": {
            "default": 0.8
          }
        },
        "HotTES": {
          "macrs_option_years": {
            "default": 7 
          },
          "macrs_bonus_pct": {
            "default": 0.8
          }
        }
      }
    }
  }
}


def get_input_defs_by_version(version_number):
  """
  Fill in new default values based on version_number
  """
  nids = copy.deepcopy(nested_input_definitions)
  if version_number == 1:
    return nids

  def fill_nested_values(dict_to_fill: dict, vals: dict) -> None:
    for k,v in vals.items():
      if isinstance(v, dict):
        fill_nested_values(dict_to_fill[k], vals[k])
      else:
        dict_to_fill[k] = v

  defaults = defaults_dict[version_number]
  fill_nested_values(nids, defaults)
  return nids