{"Meta": {"description": {"required": false, "help_text": "Optional user defined description."}, "address": {"required": false, "help_text": "Optional user defined address (street address, city, state or zip code)"}}, "Settings": {"timeout_seconds": {"required": false, "default": 600, "help_text": "The number of seconds allowed before the optimization times out.", "min_value": 1, "max_value": 1200}, "time_steps_per_hour": {"required": false, "choices": [1, 2, 4], "default": 1, "help_text": "The number of time steps per hour in the REopt model."}, "optimality_tolerance": {"required": false, "default": 0.001, "help_text": "The threshold for the difference between the solution's objective value and the best possible value at which the solver terminates", "min_value": 5e-06, "max_value": 0.2}, "add_soc_incentive": {"required": false, "default": true, "help_text": "If True, then a small incentive to keep the battery's state of charge high is added to the objective of the optimization."}, "run_bau": {"required": false, "default": true, "help_text": "If True then the Business-As-Usual scenario is also solved to provide additional outputs such as the NPV and BAU costs."}, "include_climate_in_objective": {"required": false, "default": false, "help_text": "If True, then climate costs of CO2 emissions are included in the model's objective function."}, "include_health_in_objective": {"required": false, "default": false, "help_text": "If True, then health costs of NOx, SO2, and PM2.5 emissions are included in the model's objective function."}, "off_grid_flag": {"required": false, "default": false, "help_text": "Set to true to enable off-grid analyses, not connected to a bulk power system."}, "solver_name": {"required": false, "choices": ["HiGHS", "Cbc", "SCIP", "Xpress"], "default": "HiGHS", "help_text": "Solver used for REopt.jl. Options include HiGHS, Cbc, SCIP, and Xpress"}}, "Financial": {"analysis_years": {"required": false, "default": 25, "help_text": "Analysis period in years. Must be integer.", "min_value": 1, "max_value": 75}, "elec_cost_escalation_rate_fraction": {"required": false, "help_text": "Annual nominal utility electricity cost escalation rate.", "min_value": -1, "max_value": 1}, "offtaker_discount_rate_fraction": {"required": false, "help_text": "Nominal energy offtaker discount rate. In single ownership model the offtaker is also the generation owner.", "min_value": 0, "max_value": 1}, "offtaker_tax_rate_fraction": {"required": false, "help_text": "Host tax rate", "min_value": 0, "max_value": 0.999}, "om_cost_escalation_rate_fraction": {"required": false, "help_text": "Annual nominal O&M cost escalation rate", "min_value": -1, "max_value": 1}, "owner_discount_rate_fraction": {"required": false, "help_text": "Nominal generation owner discount rate. Used for two party financing model. In two party ownership model the offtaker does not own the generator(s).", "min_value": 0, "max_value": 1}, "owner_tax_rate_fraction": {"required": false, "help_text": "Generation owner tax rate. Used for two party financing model. In two party ownership model the offtaker does not own the generator(s).", "min_value": 0, "max_value": 0.999}, "third_party_ownership": {"required": false, "help_text": "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)."}, "value_of_lost_load_per_kwh": {"required": false, "default": 0, "help_text": "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 outage costs by multiplying VoLL by unserved load for each outage start time and duration. Only applies when modeling outages using the outage_start_time_steps, outage_durations, and outage_probabilities inputs, and do not apply when modeling a single outage using outage_start_time_step and outage_end_time_step.", "min_value": 0, "max_value": 1000000.0}, "microgrid_upgrade_cost_fraction": {"required": false, "default": 0, "help_text": "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. Costs apply only when modeling outages using the outage_start_time_steps, outage_durations, and outage_probabilities inputs, and do not apply when modeling a single outage using outage_start_time_step and outage_end_time_step.", "min_value": 0, "max_value": 1}, "offgrid_other_capital_costs": {"required": false, "default": 0.0, "help_text": "Only applicable when off_grid_flag is true, applies a straight-line depreciation to this capex cost, reducing taxable income.", "min_value": 0, "max_value": 1000000.0}, "offgrid_other_annual_costs": {"required": false, "default": 0.0, "help_text": "Only applicable when off_grid_flag is true. These per year costs are considered tax deductible for owner.", "min_value": 0, "max_value": 1000000.0}, "min_initial_capital_costs_before_incentives": {"required": false, "help_text": "Minimum up-front capital cost for all technologies, excluding replacement costs and incentives [$].", "min_value": 0, "max_value": 1000000000000.0}, "max_initial_capital_costs_before_incentives": {"required": false, "help_text": "Maximum up-front capital cost for all technologies, excluding replacement costs and incentives [$].", "min_value": 0, "max_value": 1000000000000.0}, "CO2_cost_per_tonne": {"required": false, "default": 51.0, "help_text": "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.", "min_value": 0, "max_value": 1000000.0}, "CO2_cost_escalation_rate_fraction": {"required": false, "default": 0.042173, "help_text": "Annual nominal Social Cost of CO2 escalation rate (as a decimal).", "min_value": -1, "max_value": 1}, "NOx_grid_cost_per_tonne": {"required": false, "help_text": "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.", "min_value": 0, "max_value": 1000000.0}, "SO2_grid_cost_per_tonne": {"required": false, "help_text": "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.", "min_value": 0, "max_value": 1000000.0}, "PM25_grid_cost_per_tonne": {"required": false, "help_text": "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.", "min_value": 0, "max_value": 1000000.0}, "NOx_onsite_fuelburn_cost_per_tonne": {"required": false, "help_text": "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.", "min_value": 0, "max_value": 1000000.0}, "SO2_onsite_fuelburn_cost_per_tonne": {"required": false, "help_text": "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.", "min_value": 0, "max_value": 1000000.0}, "PM25_onsite_fuelburn_cost_per_tonne": {"required": false, "help_text": "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.", "min_value": 0, "max_value": 1000000.0}, "NOx_cost_escalation_rate_fraction": {"required": false, "help_text": "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.", "min_value": -1, "max_value": 1}, "SO2_cost_escalation_rate_fraction": {"required": false, "help_text": "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.", "min_value": -1, "max_value": 1}, "PM25_cost_escalation_rate_fraction": {"required": false, "help_text": "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.", "min_value": -1, "max_value": 1}, "generator_fuel_cost_escalation_rate_fraction": {"required": false, "help_text": "Annual nominal boiler fuel cost escalation rate", "min_value": -1, "max_value": 1}, "existing_boiler_fuel_cost_escalation_rate_fraction": {"required": false, "help_text": "Annual nominal existing boiler fuel cost escalation rate", "min_value": -1, "max_value": 1}, "boiler_fuel_cost_escalation_rate_fraction": {"required": false, "help_text": "Annual nominal boiler fuel cost escalation rate", "min_value": -1, "max_value": 1}, "chp_fuel_cost_escalation_rate_fraction": {"required": false, "help_text": "Annual nominal chp fuel cost escalation rate", "min_value": -1, "max_value": 1}}, "ElectricLoad": {"possible_sets": [["loads_kw"], ["doe_reference_name", "monthly_totals_kwh"], ["annual_kwh", "doe_reference_name"], ["doe_reference_name"], ["blended_doe_reference_names", "blended_doe_reference_percents"]], "annual_kwh": {"required": false, "help_text": "Annual site energy consumption from electricity, in kWh, used to scale simulated default building load profile for the site's climate zone", "min_value": 1, "max_value": 10000000000}, "doe_reference_name": {"required": false, "choices": ["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"], "help_text": "Simulated load profile from DOE Commercial Reference Buildings https://energy.gov/eere/buildings/commercial-reference-buildings"}, "year": {"required": false, "help_text": "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.", "min_value": 1, "max_value": 9999}, "monthly_totals_kwh": {"required": false, "help_text": "Monthly site energy consumption (an array 12 entries long), in kWh, used to scale either loads_kw series (with normalize_and_scale_load_profile_input) or the simulated default building load profile for the site's climate zone"}, "monthly_peaks_kw": {"required": false, "help_text": "Monthly peak power consumption (an array 12 entries long), in kW, used to scale either loads_kw series (with normalize_and_scale_load_profile_input) or the simulated default building load profile for the site's climate zone.Monthly energy is maintained while scaling to the monthly peaks."}, "loads_kw": {"required": false, "help_text": "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. "}, "normalize_and_scale_load_profile_input": {"required": false, "default": false, "help_text": "Takes the input loads_kw and normalizes and scales it to the inputs annual_kwh, monthly_totals_kwh, and/or monthly_peaks_kw."}, "critical_loads_kw": {"required": false, "help_text": "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": {"required": false, "default": true, "help_text": "If there is existing PV, must specify whether provided load is the net load after existing PV or not."}, "critical_loads_kw_is_net": {"required": false, "default": false, "help_text": "If there is existing PV, must specify whether provided load is the net load after existing PV or not."}, "critical_load_fraction": {"required": false, "default": 0.5, "help_text": "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.", "min_value": 0, "max_value": 2}, "operating_reserve_required_fraction": {"required": false, "help_text": "Only applicable when off_grid_flag=True; defaults to 0.1 (10 pct) for off-grid scenarios and fixed at 0 otherwise.Required operating reserves applied to each timestep as a fraction of electric load in that timestep.", "min_value": 0, "max_value": 1}, "min_load_met_annual_fraction": {"required": false, "help_text": "Only applicable when off_grid_flag = True. Fraction of the load that must be met on an annual energy basis.", "min_value": 0, "max_value": 1}, "blended_doe_reference_names": {"required": false, "help_text": "Used in concert with blended_doe_reference_percents to create a blended load profile from multiple DoE Commercial Reference Buildings."}, "blended_doe_reference_percents": {"required": false, "help_text": "Used in concert with blended_doe_reference_names to create a blended load profile from multiple DoE Commercial Reference Buildings. Must sum to 1.0."}}, "ElectricTariff": {"possible_sets": [["urdb_response"], ["monthly_demand_rates", "monthly_energy_rates"], ["blended_annual_energy_rate", "blended_annual_demand_rate"], ["urdb_label"], ["urdb_utility_name", "urdb_rate_name"], ["tou_energy_rates_per_kwh"]], "monthly_demand_rates": {"required": false, "help_text": "Array (length of 12) of blended demand charges in dollars per kW", "max_length": 12}, "monthly_energy_rates": {"required": false, "help_text": "Array (length of 12) of blended energy rates in dollars per kWh.", "max_length": 12}, "urdb_label": {"required": false, "help_text": "Label attribute of utility rate structure from Utility Rate Database API https://openei.org/services/doc/rest/util_rates/?version=8"}, "urdb_response": {"required": false, "help_text": "Utility rate structure from Utility Rate Database API https://openei.org/services/doc/rest/util_rates/?version=8"}, "urdb_rate_name": {"required": false, "help_text": "Name of utility rate from Utility Rate Database https://openei.org/wiki/Utility_Rate_Database"}, "urdb_utility_name": {"required": false, "help_text": "Name of Utility from Utility Rate Database https://openei.org/wiki/Utility_Rate_Database"}, "blended_annual_demand_rate": {"required": false, "help_text": "Average monthly demand charge ($ per kW per month). Rate will be applied to monthly peak demand."}, "blended_annual_energy_rate": {"required": false, "help_text": "Annual blended energy rate (total annual energy in kWh divided by annual cost in $)"}, "wholesale_rate": {"required": false, "help_text": "Price of electricity sold back to the grid in absence 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 arrayvalues are up/down-sampled using mean values to match the Settings.time_steps_per_hour."}, "export_rate_beyond_net_metering_limit": {"required": false, "help_text": "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."}, "tou_energy_rates_per_kwh": {"required": false, "help_text": "Time-of-use energy rates, provided by user. Must be an array with length equal to number of time steps per year. Hourly or 15 minute rates allowed."}, "add_monthly_rates_to_urdb_rate": {"required": false, "default": false, "help_text": "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."}, "add_tou_energy_rates_to_urdb_rate": {"required": false, "default": false, "help_text": "Set to true to add tou_energy_rates_per_kwh to the URDB rate schedule. Otherwise, tou energy rates will only be considered if a URDB rate is not provided."}, "coincident_peak_load_active_time_steps": {"required": false, "help_text": "The optional coincident_peak_load_charge_per_kw will apply to the max grid-purchased power during these time steps. Note time steps are indexed to a base of 1 not 0."}, "coincident_peak_load_charge_per_kw": {"required": false, "help_text": "Optional coincident peak demand charge that is applied to the max load during the time_steps specified in coincident_peak_load_active_time_steps"}, "urdb_metadata": {"required": false, "help_text": "Utility rate meta data from Utility Rate Database API"}}, "ElectricUtility": {"outage_start_time_step": {"required": false, "help_text": "Time step that grid outage starts. Must be less than or equal to outage_end_time_step. Use to model a single, deterministic outage.", "min_value": 1}, "outage_end_time_step": {"required": false, "help_text": "Time step that grid outage ends. Must be greater than or equal to outage_start_time_step. Use to model a single, deterministic outage.", "min_value": 1}, "outage_start_time_steps": {"required": false, "help_text": "A list of time steps that the grid outage may start. This input is used for robust optimization across multiple outages. The maximum (over outage_start_time_steps) of the expected value (over outage_durations with probabilities outage_probabilities) of outage cost is included in the objective function minimized by REopt."}, "outage_durations": {"required": false, "help_text": "One-to-one with outage_probabilities. A list of possible time step durations of the grid outage. This input is used for robust optimization across multiple outages. The maximum (over outage_start_time_steps) of the expected value (over outage_durations with probabilities outage_probabilities) of outage cost is included in the objective function minimized by REopt."}, "outage_probabilities": {"required": false, "help_text": "One-to-one with outage_durations. The probability of each duration of the grid outage. Defaults to equal probability for each duration. This input is used for robust optimization across multiple outages. The maximum (over outage_start_time_steps) of the expected value (over outage_durations with probabilities outage_probabilities) of outage cost is included in the objective function minimized by REopt."}, "interconnection_limit_kw": {"required": false, "default": 1000000000.0, "help_text": "Limit on total system capacity that can be interconnected to the grid.", "min_value": 0, "max_value": 1000000000.0}, "net_metering_limit_kw": {"required": false, "default": 0, "help_text": "Upper limit on the total capacity of technologies that can participate in net metering agreement.", "min_value": 0, "max_value": 1000000000.0}, "allow_simultaneous_export_import": {"required": false, "default": true, "help_text": "If true the site has two meters (in effect)."}, "cambium_scenario": {"required": false, "default": "Mid-case", "help_text": "Cambium Scenario for evolution of electricity sector (see Cambium documentation for descriptions).Options: ['Mid-case', 'Low renewable energy cost',   'High renewable energy cost', 'High demand growth',  'Low natural gas prices', 'High natural gas prices', 'Mid-case with 95% decarbonization by 2050',  'Mid-case with 100% decarbonization by 2035']"}, "cambium_location_type": {"required": false, "default": "GEA Regions 2023", "help_text": "Geographic boundary at which emissions and clean energy fraction are calculated. Options: ['Nations', 'GEA Regions 2023']."}, "cambium_co2_metric": {"required": false, "default": "lrmer_co2e", "help_text": "Emissions metric used. Default is Long-run marginal emissions rate for CO2-equivalant, combined combustion and pre-combustion emissions rates. Options: See metric definitions and names in the Cambium documentation."}, "cambium_start_year": {"required": false, "default": 2025, "help_text": "First year of operation of system. Emissions will be levelized starting in this year for the duration of cambium_levelization_years.", "min_value": 2025, "max_value": 2050}, "cambium_levelization_years": {"required": false, "help_text": "Expected lifetime or analysis period of the intervention being studied. Emissions and clean energy fraction will be averaged over this period. Default: analysis_years (from Financial struct)", "min_value": 1, "max_value": 100}, "cambium_grid_level": {"required": false, "default": "enduse", "help_text": "Impacts grid climate emissions calculation. Options: ['enduse' or 'busbar']. Busbar refers to point where bulk generating stations connect to grid; enduse refers to point of consumption (includes distribution loss rate)."}, "co2_from_avert": {"required": false, "default": false, "help_text": "Default is to use Cambium data for CO2 grid emissions. Set to `true` to instead use data from the EPA's AVERT database. "}, "emissions_factor_series_lb_CO2_per_kwh": {"required": false, "help_text": "CO2 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_decrease_fraction": {"required": false, "help_text": "Not applied with use of Cambium data for climate emissions. Annual percent decrease in the total annual CO2 emissions rate of the grid. A negative value indicates an annual increase.", "min_value": -1, "max_value": 1}, "avert_emissions_region": {"required": false, "help_text": "Name of the AVERT emissions region to use. Options are: 'California', 'Central', 'Florida', 'Mid-Atlantic', 'Midwest', 'Carolinas', 'New England', 'Northwest', 'New York', 'Rocky Mountains', 'Southeast', 'Southwest', 'Tennessee', 'Texas', 'Alaska', 'Hawaii (except Oahu)', 'Hawaii (Oahu)'. If emissions_factor_series_lb_<pollutant>_per_kwh inputs are not provided, avert_emissions_region overrides latitude and longitude in determining emissions factors."}, "emissions_factor_series_lb_NOx_per_kwh": {"required": false, "help_text": "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_series_lb_SO2_per_kwh": {"required": false, "help_text": "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_series_lb_PM25_per_kwh": {"required": false, "help_text": "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_NOx_decrease_fraction": {"required": false, "help_text": "Annual percent decrease in the total annual NOx marginal emissions rate of the grid. A negative value indicates an annual increase.", "min_value": -1, "max_value": 1}, "emissions_factor_SO2_decrease_fraction": {"required": false, "help_text": "Annual percent decrease in the total annual SO2 marginal emissions rate of the grid. A negative value indicates an annual increase.", "min_value": -1, "max_value": 1}, "emissions_factor_PM25_decrease_fraction": {"required": false, "help_text": "Annual percent decrease in the total annual PM2.5 marginal emissions rate of the grid. A negative value indicates an annual increase.", "min_value": -1, "max_value": 1}, "cambium_cef_metric": {"required": false, "default": "cef_load", "help_text": "Options = ['cef_load', 'cef_gen']. cef_load is the fraction of generation that is clean, for the generation that is allocated to a region\u2019s end-use load; cef_gen is the fraction of generation that is clean within a region."}, "renewable_energy_fraction_series": {"required": false, "help_text": "Fraction of energy supplied by the grid that is renewable. Can be scalar or timeseries (aligned with time_steps_per_hour)."}}, "PV": {"name": {"required": false, "default": "PV", "help_text": "PV description for distinguishing between multiple PV models"}, "existing_kw": {"required": false, "default": 0, "help_text": "Existing PV size", "min_value": 0, "max_value": 100000.0}, "min_kw": {"required": false, "default": 0, "help_text": "Minimum PV size constraint for optimization (lower bound on additional capacity beyond existing_kw).", "min_value": 0, "max_value": 1000000000.0}, "max_kw": {"required": false, "default": 1000000000.0, "help_text": "Maximum PV size constraint for optimization (upper bound on additional capacity beyond existing_kw). Set to zero to disable PV", "min_value": 0, "max_value": 1000000000.0}, "size_class": {"required": false, "help_text": "PV size class. Must be an integer value between 1 and 5. Default is 2, representing commercial-scale", "min_value": 1, "max_value": 5}, "installed_cost_per_kw": {"required": false, "help_text": "Installed PV cost in $/kW", "min_value": 0, "max_value": 100000.0}, "om_cost_per_kw": {"required": false, "help_text": "Annual PV operations and maintenance costs in $/kW", "min_value": 0, "max_value": 1000.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "macrs_itc_reduction": {"required": false, "default": 0.5, "help_text": "Percent of the ITC value by which depreciable basis is reduced", "min_value": 0, "max_value": 1}, "federal_itc_fraction": {"required": false, "help_text": "Percentage of capital costs that are credited towards federal taxes", "min_value": 0, "max_value": 1}, "state_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by state incentives", "min_value": 0, "max_value": 1}, "state_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of state percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "utility_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by utility incentives", "min_value": 0, "max_value": 1}, "utility_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of utility percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "federal_rebate_per_kw": {"required": false, "default": 0, "help_text": "Federal rebates based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "state_rebate_per_kw": {"required": false, "default": 0, "help_text": "State rebate based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "state_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum state rebate", "min_value": 0, "max_value": 10000000000.0}, "utility_rebate_per_kw": {"required": false, "default": 0, "help_text": "Utility rebate based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "utility_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum utility rebate", "min_value": 0, "max_value": 10000000000.0}, "production_incentive_per_kwh": {"required": false, "default": 0, "help_text": "Production-based incentive value", "min_value": 0, "max_value": 1000000000.0}, "production_incentive_max_benefit": {"required": false, "default": 1000000000.0, "help_text": "Maximum annual value in present terms of production-based incentives", "min_value": 0, "max_value": 1000000000.0}, "production_incentive_years": {"required": false, "default": 1, "help_text": "Duration of production-based incentives from installation date", "min_value": 0, "max_value": 100}, "production_incentive_max_kw": {"required": false, "default": 1000000000.0, "help_text": "Maximum system size eligible for production-based incentive", "min_value": 0, "max_value": 1000000000.0}, "degradation_fraction": {"required": false, "default": 0.005, "help_text": "Annual rate of degradation in PV energy production", "min_value": 0, "max_value": 1}, "azimuth": {"required": false, "help_text": "PV azimuth angle", "min_value": 0, "max_value": 360}, "losses": {"required": false, "default": 0.14, "help_text": "PV system performance losses", "min_value": 0, "max_value": 0.99}, "array_type": {"required": false, "choices": [0, 1, 2, 3, 4], "default": 1, "help_text": "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": {"required": false, "choices": [0, 1, 2], "default": 0, "help_text": "PV module type (0: Standard; 1: Premium; 2: Thin Film)"}, "gcr": {"required": false, "default": 0.4, "help_text": "PV ground cover ratio (photovoltaic array area : total ground area).", "min_value": 0.01, "max_value": 0.99}, "dc_ac_ratio": {"required": false, "default": 1.2, "help_text": "PV DC-AC ratio", "min_value": 0, "max_value": 2}, "inv_eff": {"required": false, "default": 0.96, "help_text": "PV inverter efficiency", "min_value": 0.9, "max_value": 0.995}, "radius": {"required": false, "default": 0, "help_text": "Radius, in miles, to use when searching for the closest climate data station. Use zero to use the closest station regardless of the distance.", "min_value": 0}, "tilt": {"required": false, "help_text": "PV system tilt angle. Default tilt is 20 degrees for fixed arrays (rooftop or ground-mounted) and 0 degrees for axis-tracking systems.", "min_value": 0, "max_value": 90}, "location": {"required": false, "choices": ["roof", "ground", "both"], "default": "both", "help_text": "Where PV can be deployed. One of [roof, ground, both] with default as both."}, "kw_per_square_foot": {"required": false, "default": 0.01, "help_text": "The installed power density for rooftop PV systems in kW per square foot, accounting for setbacks, row spacing, etc. The recommended PV system size is constrained based on the sum of land area available, assuming the specified ground-mount power density, and roofspace available, assuming the rooftop power density specified here.", "min_value": 0, "max_value": 10}, "acres_per_kw": {"required": false, "default": 0.006, "help_text": "The acres per kW-DC for ground-mount PV systems in acres per kW, accounting for setbacks, row spacing, etc. The recommended PV system size is constrained based on the sum of land area available, assuming the ground-mount power density specified here, and roofspace available, assuming the specified rooftop power density.", "min_value": 0, "max_value": 10}, "production_factor_series": {"required": false, "help_text": "Optional user-defined production factors. Must be normalized to units of kW-AC/kW-DC nameplate, representing the AC power (kW) output per 1 kW-DC of system capacity in each time step. The series must be one year (January through December) of hourly, 30-minute, or 15-minute PV generation data."}, "can_net_meter": {"required": false, "default": true, "help_text": "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).Note that if off-grid is true, net metering is always set to False."}, "can_wholesale": {"required": false, "default": true, "help_text": "True/False for if technology has option to export energy that is compensated at the wholesale_rate. Note that a technology can only participate in either net metering or wholesale rates (not both).Note that if off-grid is true, can_wholesale is always set to False."}, "can_export_beyond_nem_limit": {"required": false, "default": true, "help_text": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the export_rate_beyond_net_metering_limit).Note that if off-grid is true, can_export_beyond_nem_limit is always set to False."}, "can_curtail": {"required": false, "default": true, "help_text": "True/False for if technology has the ability to curtail energy production."}, "operating_reserve_required_fraction": {"required": false, "help_text": "Only applicable when off_grid_flag=True; defaults to 0.25 (25 pct) for off-grid scenarios and fixed at 0 otherwise.Required operating reserves applied to each timestep as a fraction of PV generation serving load in that timestep.", "min_value": 0, "max_value": 1.0}}, "ElectricStorage": {"min_kw": {"required": false, "default": 0, "help_text": "Minimum storage inverter capacity constraint for optimization.", "min_value": 0, "max_value": 1000000000.0}, "max_kw": {"required": false, "default": 1000000000.0, "help_text": "Maximum storage inverter capacity constraint for optimization.", "min_value": 0, "max_value": 1000000000.0}, "min_kwh": {"required": false, "default": 0, "help_text": "Minimum energy storage capacity constraint for optimization.", "min_value": 0, "max_value": 1000000000.0}, "max_kwh": {"required": false, "default": 1000000.0, "help_text": "Maximum energy storage capacity constraint for optimization.", "min_value": 0, "max_value": 1000000000.0}, "internal_efficiency_fraction": {"required": false, "default": 0.975, "help_text": "Battery inherent efficiency independent of inverter and rectifier", "min_value": 0, "max_value": 1.0}, "inverter_efficiency_fraction": {"required": false, "default": 0.96, "help_text": "Battery inverter efficiency", "min_value": 0, "max_value": 1.0}, "rectifier_efficiency_fraction": {"required": false, "default": 0.96, "help_text": "Battery rectifier efficiency", "min_value": 0, "max_value": 1.0}, "soc_min_fraction": {"required": false, "default": 0.2, "help_text": "Minimum allowable battery state of charge as fraction of energy capacity.", "min_value": 0, "max_value": 1.0}, "soc_min_applies_during_outages": {"required": false, "default": false, "help_text": "Whether the minimum allowable battery state of charge is enforced during outages in addition to normal operations."}, "soc_init_fraction": {"required": false, "help_text": "Battery state of charge at first hour of optimization as fraction of energy capacity.", "min_value": 0, "max_value": 1.0}, "can_grid_charge": {"required": false, "help_text": "Flag to set whether the battery can be charged from the grid, or just onsite generation."}, "installed_cost_per_kw": {"required": false, "default": 968.0, "help_text": "Total upfront battery power capacity costs (e.g. inverter and balance of power systems)", "min_value": 0, "max_value": 10000.0}, "installed_cost_per_kwh": {"required": false, "default": 253.0, "help_text": "Total upfront battery costs", "min_value": 0, "max_value": 10000.0}, "installed_cost_constant": {"required": false, "default": 222115.0, "help_text": "Fixed upfront cost for battery installation, independent of size.", "min_value": 0, "max_value": 1000000000.0}, "replace_cost_per_kw": {"required": false, "default": 0.0, "help_text": "Battery power capacity replacement cost at time of replacement year", "min_value": 0, "max_value": 10000.0}, "replace_cost_per_kwh": {"required": false, "default": 0.0, "help_text": "Battery energy capacity replacement cost at time of replacement year", "min_value": 0, "max_value": 10000.0}, "replace_cost_constant": {"required": false, "default": 0.0, "help_text": "Fixed replacement cost for battery, independent of size.", "min_value": 0, "max_value": 1000000000.0}, "inverter_replacement_year": {"required": false, "default": 10, "help_text": "Number of years from start of analysis period to replace inverter", "min_value": 0, "max_value": 75}, "battery_replacement_year": {"required": false, "default": 10, "help_text": "Number of years from start of analysis period to replace battery", "min_value": 0, "max_value": 75}, "cost_constant_replacement_year": {"required": false, "default": 10, "help_text": "Number of years from start of analysis period to apply replace_cost_constant.", "min_value": 0, "max_value": 75}, "om_cost_fraction_of_installed_cost": {"required": false, "default": 0.025, "help_text": "Annual O&M cost as a fraction of installed cost.", "min_value": 0, "max_value": 1.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "macrs_itc_reduction": {"required": false, "default": 0.5, "help_text": "Percent of the ITC value by which depreciable basis is reduced", "min_value": 0, "max_value": 1}, "total_itc_fraction": {"required": false, "help_text": "Total investment tax credit in percent applied toward capital costs", "min_value": 0, "max_value": 1}, "total_rebate_per_kw": {"required": false, "default": 0.0, "help_text": "Rebate based on installed power capacity", "min_value": 0, "max_value": 1000000000.0}, "total_rebate_per_kwh": {"required": false, "default": 0.0, "help_text": "Rebate based on installed energy capacity", "min_value": 0, "max_value": 1000000000.0}, "min_duration_hours": {"required": false, "default": 0.0, "help_text": "Minimum amount of time storage can discharge at its rated power capacity", "min_value": 0, "max_value": 1000000000.0}, "max_duration_hours": {"required": false, "default": 100000.0, "help_text": "Maximum amount of time storage can discharge at its rated power capacity", "min_value": 0, "max_value": 1000000000.0}, "optimize_soc_init_fraction": {"required": false, "default": false, "help_text": "If true, soc_init_fraction will not apply. Model will optimize initial SOC and constrain initial SOC = final SOC."}}, "Wind": {"size_class": {"required": false, "choices": ["residential", "commercial", "medium", "large", ""], "default": "", "help_text": "Turbine size-class. One of [\"residential\", \"commercial\", \"medium\", \"large\"]. If not provided then the size_class is determined based on the average electric load."}, "wind_meters_per_sec": {"required": false, "help_text": "Data downloaded from Wind ToolKit for modeling wind turbine."}, "wind_direction_degrees": {"required": false, "help_text": "Data downloaded from Wind ToolKit for modeling wind turbine."}, "temperature_celsius": {"required": false, "help_text": "Data downloaded from Wind ToolKit for modeling wind turbine."}, "pressure_atmospheres": {"required": false, "help_text": "Data downloaded from Wind ToolKit for modeling wind turbine."}, "min_kw": {"required": false, "default": 0, "help_text": "Minimum PV size constraint for optimization", "min_value": 0, "max_value": 1000000000.0}, "max_kw": {"required": false, "default": 1000000000.0, "help_text": "Maximum size constraint for optimization.", "min_value": 0, "max_value": 1000000000.0}, "installed_cost_per_kw": {"required": false, "help_text": "Installed cost in $/kW. Default cost is determined based on size_class.", "min_value": 0, "max_value": 100000.0}, "om_cost_per_kw": {"required": false, "default": 42, "help_text": "Annual operations and maintenance costs in $/kW", "min_value": 0, "max_value": 1000.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "macrs_itc_reduction": {"required": false, "default": 0.5, "help_text": "Percent of the ITC value by which depreciable basis is reduced", "min_value": 0, "max_value": 1}, "federal_itc_fraction": {"required": false, "help_text": "Percentage of capital costs that are credited towards federal taxes", "min_value": 0, "max_value": 1}, "state_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by state incentives", "min_value": 0, "max_value": 1}, "state_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of state percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "utility_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by utility incentives", "min_value": 0, "max_value": 1}, "utility_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of utility percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "federal_rebate_per_kw": {"required": false, "default": 0, "help_text": "Federal rebates based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "state_rebate_per_kw": {"required": false, "default": 0, "help_text": "State rebate based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "state_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum state rebate", "min_value": 0, "max_value": 10000000000.0}, "utility_rebate_per_kw": {"required": false, "default": 0, "help_text": "Utility rebate based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "utility_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum utility rebate", "min_value": 0, "max_value": 10000000000.0}, "production_incentive_per_kwh": {"required": false, "default": 0, "help_text": "Production-based incentive value", "min_value": 0, "max_value": 1000000000.0}, "production_incentive_max_benefit": {"required": false, "default": 1000000000.0, "help_text": "Maximum annual value in present terms of production-based incentives", "min_value": 0, "max_value": 1000000000.0}, "production_incentive_years": {"required": false, "default": 1, "help_text": "Duration of production-based incentives from installation date", "min_value": 0, "max_value": 100}, "production_incentive_max_kw": {"required": false, "default": 1000000000.0, "help_text": "Maximum system size eligible for production-based incentive", "min_value": 0, "max_value": 1000000000.0}, "production_factor_series": {"required": false, "help_text": "Optional user-defined production factors. Must be normalized to units of kW-AC/kW-DC nameplate, representing the AC power (kW) output per 1 kW-DC of system capacity in each time step. The series must be one year (January through December) of hourly, 30-minute, or 15-minute  generation data."}, "can_net_meter": {"required": false, "default": true, "help_text": "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).Note that if off-grid is true, net metering is always set to False."}, "can_wholesale": {"required": false, "default": true, "help_text": "True/False for if technology has option to export energy that is compensated at the wholesale_rate. Note that a technology can only participate in either net metering or wholesale rates (not both).Note that if off-grid is true, can_wholesale is always set to False."}, "can_export_beyond_nem_limit": {"required": false, "default": true, "help_text": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the export_rate_beyond_net_metering_limit).Note that if off-grid is true, can_export_beyond_nem_limit is always set to False."}, "can_curtail": {"required": false, "default": true, "help_text": "True/False for if technology has the ability to curtail energy production."}, "operating_reserve_required_fraction": {"required": false, "help_text": "Only applicable when off_grid_flag=True; defaults to 0.5 (50 pct) for off-grid scenarios and fixed at 0 otherwise.Required operating reserves applied to each timestep as a fraction of wind generation serving load in that timestep.", "min_value": 0.0, "max_value": 1.0}, "acres_per_kw": {"required": false, "default": 0.03, "help_text": "Land area required per kW of wind capacity in acres/kW; only constrained by this for systems greater than 1500 kW", "min_value": 0, "max_value": 100.0}}, "Generator": {"existing_kw": {"required": false, "default": 0, "help_text": "Existing diesel generator size", "min_value": 0, "max_value": 100000.0}, "min_kw": {"required": false, "default": 0, "help_text": "Minimum diesel generator size constraint for optimization", "min_value": 0, "max_value": 1000000000.0}, "max_kw": {"required": false, "default": 1000000000.0, "help_text": "Maximum diesel generator size constraint for optimization. Set to zero to disable PV", "min_value": 0, "max_value": 1000000000.0}, "installed_cost_per_kw": {"required": false, "help_text": "Installed diesel generator cost in $/kW", "min_value": 0.0, "max_value": 100000.0}, "om_cost_per_kw": {"required": false, "help_text": "Annual diesel generator fixed operations and maintenance costs in $/kW", "min_value": 0.0, "max_value": 1000.0}, "om_cost_per_kwh": {"required": false, "default": 0.0, "help_text": "Diesel generator per unit production (variable) operations and maintenance costs in $/kWh", "min_value": 0.0, "max_value": 1000.0}, "fuel_cost_per_gallon": {"required": false, "default": 2.25, "help_text": "Diesel cost in $/gallon", "min_value": 0.0, "max_value": 100.0}, "electric_efficiency_half_load": {"required": false, "help_text": "Electric efficiency of the generator running at half load. Defaults to electric_efficiency_full_load.", "min_value": 0.0, "max_value": 1.0}, "electric_efficiency_full_load": {"required": false, "default": 0.322, "help_text": "Electric efficiency of the generator running at full load.", "min_value": 0.0, "max_value": 1.0}, "fuel_avail_gal": {"required": false, "default": 1000000000.0, "help_text": "On-site generator fuel available in gallons per year.", "min_value": 0.0, "max_value": 1000000000.0}, "fuel_higher_heating_value_kwh_per_gal": {"required": false, "default": 40.7, "help_text": "Higher heating value of the generator fuel in kWh/gal. Defaults to the HHV of diesel.", "min_value": 1e-06, "max_value": 100000000.0}, "min_turn_down_fraction": {"required": false, "help_text": "Minimum generator loading in percent of capacity (size_kw).", "min_value": 0.0, "max_value": 1.0}, "only_runs_during_grid_outage": {"required": false, "default": true, "help_text": "Determines if the generator can run only during grid outage or all the time."}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "default": 0, "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "default": 0.0, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "macrs_itc_reduction": {"required": false, "default": 0.0, "help_text": "Percent of the ITC value by which depreciable basis is reduced", "min_value": 0, "max_value": 1}, "federal_itc_fraction": {"required": false, "default": 0.0, "help_text": "Percentage of capital costs that are credited towards federal taxes", "min_value": 0, "max_value": 1}, "state_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by state incentives", "min_value": 0, "max_value": 1}, "state_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of state percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "utility_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by utility incentives", "min_value": 0, "max_value": 1}, "utility_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of utility percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "federal_rebate_per_kw": {"required": false, "default": 0, "help_text": "Federal rebates based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "state_rebate_per_kw": {"required": false, "default": 0, "help_text": "State rebate based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "state_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum state rebate", "min_value": 0, "max_value": 10000000000.0}, "utility_rebate_per_kw": {"required": false, "default": 0, "help_text": "Utility rebate based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "utility_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum utility rebate", "min_value": 0, "max_value": 10000000000.0}, "production_incentive_per_kwh": {"required": false, "default": 0, "help_text": "Production-based incentive value", "min_value": 0, "max_value": 1000000000.0}, "production_incentive_max_benefit": {"required": false, "default": 1000000000.0, "help_text": "Maximum annual value in present terms of production-based incentives", "min_value": 0, "max_value": 1000000000.0}, "production_incentive_years": {"required": false, "default": 0, "help_text": "Duration of production-based incentives from installation date", "min_value": 0, "max_value": 100}, "production_incentive_max_kw": {"required": false, "default": 0.0, "help_text": "Maximum system size eligible for production-based incentive", "min_value": 0, "max_value": 1000000000.0}, "can_net_meter": {"required": false, "default": false, "help_text": "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": {"required": false, "default": false, "help_text": "True/False for if technology has option to export energy that is compensated at the wholesale_rate. Note that a technology can only participate in either net metering or wholesale rates (not both)."}, "can_export_beyond_nem_limit": {"required": false, "default": false, "help_text": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the export_rate_beyond_net_metering_limit)."}, "can_curtail": {"required": false, "default": false, "help_text": "True/False for if technology has the ability to curtail energy production."}, "fuel_renewable_energy_fraction": {"required": false, "default": 0.0, "help_text": "Fraction of the generator fuel considered renewable.", "min_value": 0, "max_value": 1}, "emissions_factor_lb_CO2_per_gal": {"required": false, "default": 22.58, "help_text": "Pounds of CO2e emitted per gallon of generator fuel burned.", "min_value": 0, "max_value": 10000.0}, "emissions_factor_lb_NOx_per_gal": {"required": false, "default": 0.0775544, "help_text": "Pounds of NOx emitted per gallon of generator fuel burned.", "min_value": 0, "max_value": 10000.0}, "emissions_factor_lb_SO2_per_gal": {"required": false, "default": 0.040020476, "help_text": "Pounds of SO2 emitted per gallon of generator fuel burned.", "min_value": 0, "max_value": 10000.0}, "emissions_factor_lb_PM25_per_gal": {"required": false, "default": 0.0, "help_text": "Pounds of PM2.5 emitted per gallon of generator fuel burned.", "min_value": 0, "max_value": 10000.0}, "replacement_year": {"required": false, "help_text": "Project year in which generator capacity will be replaced at a cost of replace_cost_per_kw.", "min_value": 0, "max_value": 100}, "replace_cost_per_kw": {"required": false, "help_text": "Per kW replacement cost for generator capacity. Replacement costs are considered tax deductible.", "min_value": 0, "max_value": 1000000000.0}}, "CoolingLoad": {"possible_sets": [["thermal_loads_ton"], ["doe_reference_name"], ["blended_doe_reference_names", "blended_doe_reference_percents"], ["annual_fraction_of_electric_load"], ["monthly_fractions_of_electric_load"], ["per_time_step_fractions_of_electric_load"], []], "doe_reference_name": {"required": false, "choices": ["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"], "help_text": "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 ElectricLoad is used."}, "blended_doe_reference_names": {"required": false, "help_text": "Used in concert with blended_doe_reference_percents to create a blended load profile from multiple DoE Commercial Reference Buildings."}, "blended_doe_reference_percents": {"required": false, "help_text": "Used in concert with blended_doe_reference_names to create a blended load profile from multiple DoE Commercial Reference Buildings to simulate buildings/campuses. Must sum to 1.0."}, "annual_tonhour": {"required": false, "help_text": "Annual electric chiller thermal energy production, in [Ton-Hour],used to scale simulated default electric chiller load profile for the site's climate zone", "min_value": 0.0, "max_value": 1000000000.0}, "monthly_tonhour": {"required": false, "help_text": "Monthly site space cooling requirement in [Ton-Hour], used to scale simulated default building load profile for the site's climate zone"}, "thermal_loads_ton": {"required": false, "help_text": "Typical electric chiller thermal production to serve the load for all hours in one year. Must be hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples)."}, "year": {"required": false, "help_text": "Year of Custom Load Profile. If a custom load profile is uploaded via the thermal_loads_ton parameter, it is important that this year correlates with the electric 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.", "min_value": 1, "max_value": 9999}, "annual_fraction_of_electric_load": {"required": false, "help_text": "Annual electric chiller energy consumption scalar as a fraction of total electric load applied to every time stepused to scale simulated default electric chiller load profile for the site's climate zone", "min_value": 0, "max_value": 1}, "monthly_fractions_of_electric_load": {"required": false, "help_text": "Monthly fraction of site's total electric consumption used up by electric chiller, applied to every hour of each month,to scale simulated default building load profile for the site's climate zone"}, "per_time_step_fractions_of_electric_load": {"required": false, "help_text": "Per timestep fraction of site's total electric consumption used up by electric chiller.Must be hourly (8,760 samples), 30 minute (17,520 samples), or 15 minute (35,040 samples)."}}, "ExistingChiller": {"cop": {"required": false, "help_text": "Existing electric chiller system coefficient of performance (COP) (ratio of usable cooling thermal energy produced per unit electric energy consumed)", "min_value": 0.01, "max_value": 20}, "max_thermal_factor_on_peak_load": {"required": false, "default": 1.25, "help_text": "Factor on peak thermal LOAD which the electric chiller can supply. This accounts for the assumed size of the electric chiller which typically has a safety factor above the peak load.This factor limits the max production which could otherwise be exploited with ColdThermalStorage", "min_value": 0.0, "max_value": 5.0}, "retire_in_optimal": {"required": false, "default": false, "help_text": "Boolean indicator if the existing chiller is unavailable in the optimal case (still used in BAU)"}, "installed_cost_per_ton": {"required": false, "default": 0.0, "help_text": "Thermal power capacity-based cost incurred in BAU and only based on what's needed in Optimal scenario", "min_value": 0, "max_value": 100000000.0}, "installed_cost_dollars": {"required": false, "default": 0.0, "help_text": "Cost incurred in BAU scenario, as well as Optimal if needed still, in dollars", "min_value": 0, "max_value": 100000000.0}}, "ExistingBoiler": {"production_type": {"required": false, "choices": ["steam", "hot_water"], "default": "hot_water", "help_text": "Boiler thermal production type, hot water or steam"}, "max_thermal_factor_on_peak_load": {"required": false, "default": 1.25, "help_text": "Factor on peak thermal LOAD which the boiler can supply", "min_value": 1.0, "max_value": 5.0}, "efficiency": {"required": false, "help_text": "Existing boiler system efficiency - conversion of fuel to usable heating thermal energy.", "min_value": 0.0, "max_value": 1.0}, "retire_in_optimal": {"required": false, "default": false, "help_text": "Boolean indicator if the existing boiler is unavailable in the optimal case (still used in BAU)"}, "fuel_renewable_energy_fraction": {"required": false, "help_text": "Fraction of the fuel considered renewable. Default depends on fuel type.", "min_value": 0, "max_value": 1}, "emissions_factor_lb_CO2_per_mmbtu": {"required": false, "help_text": "Pounds of CO2e emitted per MMBTU of fuel burned.", "min_value": 0.0, "max_value": 100000000.0}, "emissions_factor_lb_NOx_per_mmbtu": {"required": false, "help_text": "Pounds of NOx emitted per MMBTU of fuel burned.", "min_value": 0.0, "max_value": 100000000.0}, "emissions_factor_lb_SO2_per_mmbtu": {"required": false, "help_text": "Pounds of SO2 emitted per MMBTU of fuel burned.", "min_value": 0.0, "max_value": 100000000.0}, "emissions_factor_lb_PM25_per_mmbtu": {"required": false, "help_text": "Pounds of PM2.5 emitted per MMBTU fuel burned.", "min_value": 0.0, "max_value": 100000000.0}, "fuel_cost_per_mmbtu": {"required": false, "help_text": "The ExistingBoiler default operating cost is zero. Please provide this field to include non-zero BAU heating costs.The `fuel_cost_per_mmbtu` can be a scalar, a list of 12 monthly values, or a time series of values for every time step.If a vector of length 8760, 17520, or 35040 is provided, it is adjusted to match timesteps per hour in the optimization."}, "fuel_type": {"required": false, "choices": ["natural_gas", "landfill_bio_gas", "propane", "diesel_oil"], "default": "natural_gas", "help_text": "Existing boiler fuel type, one of natural_gas, landfill_bio_gas, propane, diesel_oil"}, "installed_cost_per_mmbtu_per_hour": {"required": false, "default": 0.0, "help_text": "Thermal power capacity-based cost incurred in BAU and only based on what's needed in Optimal scenario", "min_value": 0, "max_value": 100000000.0}, "installed_cost_dollars": {"required": false, "default": 0.0, "help_text": "Cost incurred in BAU scenario, as well as Optimal if needed still, in dollars", "min_value": 0, "max_value": 100000000.0}, "can_supply_steam_turbine": {"required": false, "default": false, "help_text": "If the boiler can supply steam to the steam turbine for electric production"}, "can_serve_dhw": {"required": false, "default": true, "help_text": "Boolean indicator if the existing boiler can serve domestic hot water load"}, "can_serve_space_heating": {"required": false, "default": true, "help_text": "Boolean indicator if the existing boiler can serve space heating load"}, "can_serve_process_heat": {"required": false, "default": true, "help_text": "Boolean indicator if the existing boiler can serve process heat load"}}, "Boiler": {"min_mmbtu_per_hour": {"required": false, "default": 0.0, "help_text": "Minimum thermal power size", "min_value": 0.0, "max_value": 100000000.0}, "max_mmbtu_per_hour": {"required": false, "default": 10000000.0, "help_text": "Maximum thermal power size", "min_value": 0.0, "max_value": 100000000.0}, "efficiency": {"required": false, "default": 0.8, "help_text": "New boiler system efficiency - conversion of fuel to usable heating thermal energy.", "min_value": 0.0, "max_value": 1.0}, "fuel_cost_per_mmbtu": {"required": false, "help_text": "Fuel cost in [$/MMBtu]"}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "default": 0, "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "default": 0.0, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "installed_cost_per_mmbtu_per_hour": {"required": false, "default": 293000.0, "help_text": "Thermal power-based cost", "min_value": 0, "max_value": 100000000.0}, "om_cost_per_mmbtu_per_hour": {"required": false, "default": 2930.0, "help_text": "Thermal power-based fixed O&M cost", "min_value": 0, "max_value": 100000000.0}, "om_cost_per_mmbtu": {"required": false, "default": 0.0, "help_text": "Thermal energy-based variable O&M cost", "min_value": 0, "max_value": 100000000.0}, "fuel_type": {"required": false, "choices": ["natural_gas", "landfill_bio_gas", "propane", "diesel_oil", "uranium"], "default": "natural_gas", "help_text": "Existing boiler fuel type, one of natural_gas, landfill_bio_gas, propane, diesel_oil, uranium"}, "can_supply_steam_turbine": {"required": false, "default": true, "help_text": "If the boiler can supply steam to the steam turbine for electric production"}, "can_serve_dhw": {"required": false, "default": true, "help_text": "Boolean indicator if boiler can serve domestic hot water load"}, "can_serve_space_heating": {"required": false, "default": true, "help_text": "Boolean indicator if boiler can serve space heating load"}, "can_serve_process_heat": {"required": false, "default": true, "help_text": "Boolean indicator if boiler can serve process heat load"}}, "HotThermalStorage": {"min_gal": {"required": false, "default": 0.0, "help_text": "Minimum TES volume (energy) size constraint for optimization", "min_value": 0, "max_value": 1000000000.0}, "max_gal": {"required": false, "default": 0.0, "help_text": "Maximum TES volume (energy) size constraint for optimization. Set to zero to disable storage", "min_value": 0, "max_value": 1000000000.0}, "hot_water_temp_degF": {"required": false, "default": 180.0, "help_text": "Hot-side supply water temperature from HotTES (top of tank) to the heating load", "min_value": 40.0, "max_value": 210.0}, "cool_water_temp_degF": {"required": false, "default": 160.0, "help_text": "Cold-side return water temperature from the heating load to the HotTES (bottom of tank)", "min_value": 33.0, "max_value": 200.0}, "internal_efficiency_fraction": {"required": false, "default": 0.999999, "help_text": "Thermal losses due to mixing from thermal power entering or leaving tank", "min_value": 0, "max_value": 1.0}, "soc_min_fraction": {"required": false, "default": 0.1, "help_text": "Minimum allowable battery state of charge as fraction of energy capacity.", "min_value": 0, "max_value": 1.0}, "soc_init_fraction": {"required": false, "default": 0.5, "help_text": "Battery state of charge at first hour of optimization as fraction of energy capacity.", "min_value": 0, "max_value": 1.0}, "installed_cost_per_gal": {"required": false, "default": 1.5, "help_text": "Installed hot TES cost in $/gal", "min_value": 0, "max_value": 10000.0}, "om_cost_per_gal": {"required": false, "default": 0.0, "help_text": "Annual hot TES operations and maintenance costs in $/gal", "min_value": 0, "max_value": 1000.0}, "thermal_decay_rate_fraction": {"required": false, "default": 0.0004, "help_text": "Thermal energy-based cost of TES (e.g. volume of the tank)", "min_value": 0, "max_value": 1.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "macrs_itc_reduction": {"required": false, "default": 0.0, "help_text": "Percent of the ITC value by which depreciable basis is reduced", "min_value": 0, "max_value": 1}, "total_itc_fraction": {"required": false, "help_text": "Total investment tax credit in percent applied toward capital costs", "min_value": 0, "max_value": 1}, "total_rebate_per_kwh": {"required": false, "default": 0.0, "help_text": "Rebate per unit installed energy capacity", "min_value": 0, "max_value": 1000000000.0}, "can_serve_dhw": {"required": false, "default": true, "help_text": "Boolean indicator if hot thermal storage can serve space heating load"}, "can_serve_space_heating": {"required": false, "default": true, "help_text": "Boolean indicator if hot thermal storage can serve space heating load"}, "can_serve_process_heat": {"required": false, "default": false, "help_text": "Boolean indicator if hot thermal storage can serve process heat load"}}, "HighTempThermalStorage": {"min_kwh": {"required": false, "default": 0.0, "help_text": "Minimum TES volume (energy) size constraint for optimization", "min_value": 0, "max_value": 1000000000.0}, "max_kwh": {"required": false, "default": 0.0, "help_text": "Maximum TES volume (energy) size constraint for optimization. Set to zero to disable storage", "min_value": 0, "max_value": 1000000000.0}, "hot_temp_degF": {"required": false, "default": 1065.0, "help_text": "Hot-side supply water temperature from HotTES (top of tank) to the heating load", "min_value": 200.0, "max_value": 2000.0}, "cool_temp_degF": {"required": false, "default": 554.0, "help_text": "Cold-side return water temperature from the heating load to the HotTES (bottom of tank)", "min_value": 200.0, "max_value": 2000.0}, "internal_efficiency_fraction": {"required": false, "default": 0.999999, "help_text": "Thermal losses due to mixing from thermal power entering or leaving tank", "min_value": 0, "max_value": 1.0}, "soc_min_fraction": {"required": false, "default": 0.1, "help_text": "Minimum allowable battery state of charge as fraction of energy capacity.", "min_value": 0, "max_value": 1.0}, "soc_init_fraction": {"required": false, "default": 0.5, "help_text": "Battery state of charge at first hour of optimization as fraction of energy capacity.", "min_value": 0, "max_value": 1.0}, "installed_cost_per_kwh": {"required": false, "default": 86.0, "help_text": "Installed hot TES cost in $/kwh", "min_value": 0, "max_value": 10000.0}, "om_cost_per_kwh": {"required": false, "default": 0.0, "help_text": "Annual hot TES operations and maintenance costs in $/kwh", "min_value": 0, "max_value": 1000.0}, "thermal_decay_rate_fraction": {"required": false, "default": 0.0004, "help_text": "Thermal energy-based cost of TES (e.g. volume of the tank)", "min_value": 0, "max_value": 1.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "macrs_itc_reduction": {"required": false, "default": 0.0, "help_text": "Percent of the ITC value by which depreciable basis is reduced", "min_value": 0, "max_value": 1}, "total_itc_fraction": {"required": false, "help_text": "Total investment tax credit in percent applied toward capital costs", "min_value": 0, "max_value": 1}, "total_rebate_per_kwh": {"required": false, "default": 0.0, "help_text": "Rebate per unit installed energy capacity", "min_value": 0, "max_value": 1000000000.0}, "can_serve_dhw": {"required": false, "default": false, "help_text": "Boolean indicator if hot thermal storage can serve space heating load"}, "can_serve_space_heating": {"required": false, "default": false, "help_text": "Boolean indicator if hot thermal storage can serve space heating load"}, "can_serve_process_heat": {"required": false, "default": true, "help_text": "Boolean indicator if hot thermal storage can serve process heat load"}, "supply_turbine_only": {"required": false, "default": false, "help_text": "Boolean indicator if hot thermal storage can serve only steam turbine"}, "one_direction_flow": {"required": false, "default": false, "help_text": "Boolean indicator if hot thermal storage can only"}, "num_charge_hours": {"required": false, "default": 4.0, "help_text": "Number of charge hours", "min_value": 0, "max_value": 10000.0}, "num_discharge_hours": {"required": false, "default": 10.0, "help_text": "Number of charge hours", "min_value": 0, "max_value": 10000.0}}, "ColdThermalStorage": {"min_gal": {"required": false, "default": 0.0, "help_text": "Minimum TES volume (energy) size constraint for optimization", "min_value": 0, "max_value": 1000000000.0}, "max_gal": {"required": false, "default": 0.0, "help_text": "Maximum TES volume (energy) size constraint for optimization. Set to zero to disable storage", "min_value": 0, "max_value": 1000000000.0}, "cool_water_temp_degF": {"required": false, "default": 44.0, "help_text": "Cold-side supply water temperature from ColdTES (top of tank) to the heating load", "min_value": 33.0, "max_value": 200.0}, "hot_water_temp_degF": {"required": false, "default": 56.0, "help_text": "Cold-side return water temperature from the heating load to the ColdTES (bottom of tank)", "min_value": 40.0, "max_value": 210.0}, "internal_efficiency_fraction": {"required": false, "default": 0.999999, "help_text": "Thermal losses due to mixing from thermal power entering or leaving tank", "min_value": 0, "max_value": 1.0}, "soc_min_fraction": {"required": false, "default": 0.1, "help_text": "Minimum allowable battery state of charge as fraction of energy capacity.", "min_value": 0, "max_value": 1.0}, "soc_init_fraction": {"required": false, "default": 0.5, "help_text": "Battery state of charge at first hour of optimization as fraction of energy capacity.", "min_value": 0, "max_value": 1.0}, "installed_cost_per_gal": {"required": false, "default": 1.5, "help_text": "Installed cold TES cost in $/gal", "min_value": 0, "max_value": 10000.0}, "om_cost_per_gal": {"required": false, "default": 0.0, "help_text": "Annual cold TES operations and maintenance costs in $/gal", "min_value": 0, "max_value": 1000.0}, "thermal_decay_rate_fraction": {"required": false, "default": 0.0004, "help_text": "Thermal energy-based cost of TES (e.g. volume of the tank)", "min_value": 0, "max_value": 1.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "macrs_itc_reduction": {"required": false, "default": 0.0, "help_text": "Percent of the ITC value by which depreciable basis is reduced", "min_value": 0, "max_value": 1}, "total_itc_fraction": {"required": false, "help_text": "Total investment tax credit in percent applied toward capital costs", "min_value": 0, "max_value": 1}, "total_rebate_per_kwh": {"required": false, "default": 0.0, "help_text": "Rebate per unit installed energy capacity", "min_value": 0, "max_value": 1000000000.0}}, "SpaceHeatingLoad": {"possible_sets": [["fuel_loads_mmbtu_per_hour"], ["doe_reference_name", "monthly_mmbtu"], ["annual_mmbtu", "doe_reference_name"], ["doe_reference_name"], ["blended_doe_reference_names", "blended_doe_reference_percents"], []], "annual_mmbtu": {"required": false, "help_text": "Annual site space heating consumption, used to scale simulated default building load profile for the site's climate zone [MMBtu]", "min_value": 0.0, "max_value": 100000000.0}, "doe_reference_name": {"required": false, "choices": ["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"], "help_text": "Simulated load profile from DOE Commercial Reference Buildings https://energy.gov/eere/buildings/commercial-reference-buildings"}, "monthly_mmbtu": {"required": false, "help_text": "Monthly site space heating energy consumption in [MMbtu], used to scale simulated default building load profile for the site's climate zone"}, "fuel_loads_mmbtu_per_hour": {"required": false, "help_text": "Vector of space heating fuel loads [mmbtu/hr] over 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. "}, "normalize_and_scale_load_profile_input": {"required": false, "default": false, "help_text": "Takes the input fuel_loads_mmbtu_per_hour and normalizes and scales it to annual or monthly energy inputs."}, "year": {"required": false, "help_text": "Year of Custom Load Profile. If a custom load profile is uploaded via the fuel_loads_mmbtu_per_hour parameter, it is important that this year correlates with the electric 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.", "min_value": 1, "max_value": 9999}, "blended_doe_reference_names": {"required": false, "help_text": "Used in concert with blended_doe_reference_percents to create a blended load profile from multiple DoE Commercial Reference Buildings."}, "blended_doe_reference_percents": {"required": false, "help_text": "Used in concert with blended_doe_reference_names to create a blended load profile from multiple DoE Commercial Reference Buildings. Must sum to 1.0."}, "addressable_load_fraction": {"required": false, "help_text": "Fraction of input fuel load which is addressable by heating technologies (default is 1.0).Can be a scalar or vector with length aligned with use of monthly_mmbtu (12) or fuel_loads_mmbtu_per_hour."}}, "DomesticHotWaterLoad": {"possible_sets": [["fuel_loads_mmbtu_per_hour"], ["doe_reference_name", "monthly_mmbtu"], ["annual_mmbtu", "doe_reference_name"], ["doe_reference_name"], [], ["blended_doe_reference_names", "blended_doe_reference_percents"]], "annual_mmbtu": {"required": false, "help_text": "Annual site DHW consumption, used to scale simulated default building load profile for the site's climate zone [MMBtu]", "min_value": 0.0, "max_value": 100000000.0}, "doe_reference_name": {"required": false, "choices": ["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"], "help_text": "Simulated load profile from DOE Commercial Reference Buildings https://energy.gov/eere/buildings/commercial-reference-buildings"}, "monthly_mmbtu": {"required": false, "help_text": "Monthly site DHW energy consumption in [MMbtu], used to scale simulated default building load profile for the site's climate zone"}, "fuel_loads_mmbtu_per_hour": {"required": false, "help_text": "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. "}, "normalize_and_scale_load_profile_input": {"required": false, "default": false, "help_text": "Takes the input fuel_loads_mmbtu_per_hour and normalizes and scales it to annual or monthly energy inputs."}, "year": {"required": false, "help_text": "Year of Custom Load Profile. If a custom load profile is uploaded via the fuel_loads_mmbtu_per_hour parameter, it is important that this year correlates with the electric 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.", "min_value": 1, "max_value": 9999}, "blended_doe_reference_names": {"required": false, "help_text": "Used in concert with blended_doe_reference_percents to create a blended load profile from multiple DoE Commercial Reference Buildings."}, "blended_doe_reference_percents": {"required": false, "help_text": "Used in concert with blended_doe_reference_names to create a blended load profile from multiple DoE Commercial Reference Buildings to simulate buildings/campuses. Must sum to 1.0."}, "addressable_load_fraction": {"required": false, "help_text": "Fraction of input fuel load which is addressable by heating technologies (default is 1.0).Can be a scalar or vector with length aligned with use of monthly_mmbtu (12) or fuel_loads_mmbtu_per_hour."}}, "ProcessHeatLoad": {"possible_sets": [["fuel_loads_mmbtu_per_hour"], ["industrial_reference_name", "monthly_mmbtu"], ["annual_mmbtu", "industrial_reference_name"], ["industrial_reference_name"], ["blended_industrial_reference_names", "blended_industrial_reference_percents"], []], "annual_mmbtu": {"required": false, "help_text": "Annual site process heat fuel consumption, used to scale simulated default industry load profile [MMBtu]", "min_value": 0.0, "max_value": 100000000.0}, "industrial_reference_name": {"required": false, "choices": ["Chemical", "Warehouse", "FlatLoad", "FlatLoad_24_5", "FlatLoad_16_7", "FlatLoad_16_5", "FlatLoad_8_7", "FlatLoad_8_5"], "help_text": "Industrial process heat load reference facility/sector type"}, "monthly_mmbtu": {"required": false, "help_text": "Monthly site process heat fuel consumption in [MMbtu], used to scale simulated default building load profile for the site's climate zone"}, "fuel_loads_mmbtu_per_hour": {"required": false, "help_text": "Vector of process heat fuel loads [mmbtu/hr] over 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. "}, "year": {"required": false, "help_text": "Year of Custom Load Profile. If a custom load profile is uploaded via the fuel_loads_mmbtu_per_hour parameter, it is important that this year correlates with the electric load profile so that weekdays/weekends are determined correctly for the utility rate tariff. If a Industrial Reference Building profile (aka 'simulated' profile) is used, the year is set to 2017 to be consistent with the DOE reference building year which starts on a Sunday.", "min_value": 1, "max_value": 9999}, "normalize_and_scale_load_profile_input": {"required": false, "default": false, "help_text": "Takes the input fuel_loads_mmbtu_per_hour and normalizes and scales it to annual or monthly energy inputs."}, "blended_industrial_reference_names": {"required": false, "help_text": "Used in concert with blended_industrial_reference_percents to create a blended load profile from multiple Industrial reference facility/sector types."}, "blended_industrial_reference_percents": {"required": false, "help_text": "Used in concert with blended_industrial_reference_names to create a blended load profile from multiple Industrial reference facility/sector types. Must sum to 1.0."}, "addressable_load_fraction": {"required": false, "help_text": "Fraction of input fuel load which is addressable by heating technologies (default is 1.0).Can be a scalar or vector with length aligned with use of monthly_mmbtu (12) or fuel_loads_mmbtu_per_hour."}}, "Site": {"latitude": {"required": true, "help_text": "The latitude of the site in decimal degrees.", "min_value": -90, "max_value": 90}, "longitude": {"required": true, "help_text": "The longitude of the site in decimal degrees.", "min_value": -180, "max_value": 180}, "land_acres": {"required": false, "help_text": "Land area in acres available for PV panel siting", "min_value": 0, "max_value": 1000000}, "roof_squarefeet": {"required": false, "help_text": "Area of roof in square feet available for PV siting", "min_value": 0, "max_value": 1000000000}, "min_resil_time_steps": {"required": false, "help_text": "The minimum number consecutive timesteps that load must be fully met once an outage begins. Only applies to multiple outage modeling using inputs outage_start_time_steps and outage_durations.If no value is provided, will default to max([ElectricUtility].outage_durations).", "min_value": 0}, "sector": {"required": false, "choices": ["commercial/industrial", "federal"], "default": "commercial/industrial", "help_text": "The sector of the site. Options: ['federal', 'commercial/industrial']"}, "federal_sector_state": {"required": false, "default": "", "help_text": "The state where the site is located, if the site's sector is 'federal'. State can be written out or abbreviated."}, "federal_procurement_type": {"required": false, "choices": ["fedowned_dirpurch", "fedowned_thirdparty", "privateowned_thirdparty"], "default": "", "help_text": "The capital procurement type if the site's sector is 'federal'. Options: ['fedowned_dirpurch', 'fedowned_thirdparty', 'privateowned_thirdparty']"}, "CO2_emissions_reduction_min_fraction": {"required": false, "help_text": "Minimum allowed percentage reduction of CO2 emissions, relative to the business-as-usual case, over the financial lifecycle of the project.", "min_value": 0, "max_value": 1}, "CO2_emissions_reduction_max_fraction": {"required": false, "help_text": "Maximum allowed percentage reduction of CO2 emissions, relative to the business-as-usual case, over the financial lifecycle of the project.", "min_value": 0, "max_value": 1}, "renewable_electricity_min_fraction": {"required": false, "help_text": "Minimum allowed percentage of site electric consumption met by renewable energy on an annual basis.", "min_value": 0, "max_value": 10}, "renewable_electricity_max_fraction": {"required": false, "help_text": "Maximum allowed percentage of site electric consumption met by renewable energy on an annual basis.", "min_value": 0, "max_value": 10}, "include_grid_renewable_fraction_in_RE_constraints": {"required": false, "default": false, "help_text": "If True, then the renewable energy content of energy from the grid is included in any min or max renewable energy requirements."}, "include_exported_elec_emissions_in_total": {"required": false, "default": true, "help_text": "If True, then energy exported to the grid is included in emissions calculations."}, "include_exported_renewable_electricity_in_total": {"required": false, "default": true, "help_text": "If True, then renewable energy exported to the grid is counted in renewable electricity percent calculation."}, "outdoor_air_temperature_degF": {"required": false, "help_text": "The outdoor air (dry-bulb) temperature in degrees Fahrenheit as determined by the site's location TMY3 data from the PVWatts call or user input. This is used for GHP COP and ASHP COP and CF values based on the default or custom mapping of those."}}, "CHP": {"fuel_cost_per_mmbtu": {"required": false, "help_text": "The `fuel_cost_per_mmbtu` is a required input and can be a scalar, a list of 12 monthly values, or a time series of values for every time step."}, "prime_mover": {"required": false, "choices": ["recip_engine", "micro_turbine", "combustion_turbine", "fuel_cell"], "help_text": "CHP prime mover, one of recip_engine, micro_turbine, combustion_turbine, fuel_cell"}, "installed_cost_per_kw": {"required": false, "help_text": "Installed cost in $/kW"}, "tech_sizes_for_cost_curve": {"required": false, "help_text": "Capacity intervals correpsonding to cost rates in installed_cost_per_kW, in kW"}, "om_cost_per_kwh": {"required": false, "help_text": "CHP per unit production (variable) operations and maintenance costs in $/kWh", "min_value": 0.0, "max_value": 1000.0}, "electric_efficiency_half_load": {"required": false, "help_text": "Electric efficiency of CHP prime-mover at half-load, HHV-basis", "min_value": 0.0, "max_value": 1.0}, "electric_efficiency_full_load": {"required": false, "help_text": "Electric efficiency of CHP prime-mover at full-load, HHV-basis", "min_value": 0.0, "max_value": 1.0}, "min_turn_down_fraction": {"required": false, "help_text": "Minimum CHP loading in fraction of capacity (size_kw).", "min_value": 0.0, "max_value": 1.0}, "thermal_efficiency_full_load": {"required": false, "help_text": "CHP fraction of fuel energy converted to hot-thermal energy at full electric load", "min_value": 0.0, "max_value": 1.0}, "thermal_efficiency_half_load": {"required": false, "help_text": "CHP fraction of fuel energy converted to hot-thermal energy at half electric load", "min_value": 0.0, "max_value": 1.0}, "min_allowable_kw": {"required": false, "help_text": "Minimum nonzero CHP size (in kWe) (i.e. it is possible to select no CHP system)", "min_value": 0.0, "max_value": 100000000.0}, "max_kw": {"required": false, "help_text": "Maximum CHP size (in kWe) constraint for optimization. Set to zero to disable CHP", "min_value": 0.0, "max_value": 100000000.0}, "cooling_thermal_factor": {"required": false, "help_text": "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", "min_value": 0.01, "max_value": 1.0}, "unavailability_periods": {"required": false, "help_text": "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"}, "size_class": {"required": false, "help_text": "CHP size class. Must be an integer value between 0 and 7", "min_value": 0, "max_value": 7}, "min_kw": {"required": false, "default": 0, "help_text": "Minimum CHP size constraint for optimization", "min_value": 0, "max_value": 1000000000.0}, "fuel_type": {"required": false, "choices": ["natural_gas", "landfill_bio_gas", "propane", "diesel_oil"], "default": "natural_gas", "help_text": "Existing CHP fuel type, one of natural_gas, landfill_bio_gas, propane, diesel_oil"}, "om_cost_per_kw": {"required": false, "default": 0.0, "help_text": "Annual CHP fixed operations and maintenance costs in $/kW", "min_value": 0.0, "max_value": 1000.0}, "om_cost_per_hr_per_kw_rated": {"required": false, "default": 0.0, "help_text": "CHP system per-operating-hour (variable) operations and maintenance costs in $/hr-kW", "min_value": 0.0, "max_value": 1000.0}, "supplementary_firing_capital_cost_per_kw": {"required": false, "default": 150, "help_text": "Installed CHP supplementary firing system cost in $/kWe", "min_value": 0.0, "max_value": 100000.0}, "supplementary_firing_max_steam_ratio": {"required": false, "default": 1.0, "help_text": "Ratio of max fired steam to un-fired steam production. Relevant only for combustion_turbine prime_mover", "min_value": 0.0, "max_value": 10.0}, "supplementary_firing_efficiency": {"required": false, "default": 0.92, "help_text": "Thermal efficiency of the incremental steam production from supplementary firing. Relevant only for combustion_turbine prime_mover", "min_value": 0.0, "max_value": 1.0}, "standby_rate_per_kw_per_month": {"required": false, "default": 0, "help_text": "Standby rate charged to CHP based on CHP electric power size", "min_value": 0, "max_value": 1000}, "reduces_demand_charges": {"required": false, "default": true, "help_text": "Boolean indicator if CHP reduces demand charges"}, "can_supply_steam_turbine": {"required": false, "default": false, "help_text": "Boolean indicator if CHP can supply steam to the steam turbine for electric production"}, "can_serve_dhw": {"required": false, "default": true, "help_text": "Boolean indicator if CHP can serve  hot water load"}, "can_serve_space_heating": {"required": false, "default": true, "help_text": "Boolean indicator if CHP can serve space heating load"}, "can_serve_process_heat": {"required": false, "default": true, "help_text": "Boolean indicator if CHP can serve process heat load"}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "macrs_itc_reduction": {"required": false, "default": 0.5, "help_text": "Percent of the ITC value by which depreciable basis is reduced", "min_value": 0, "max_value": 1}, "federal_itc_fraction": {"required": false, "help_text": "Percentage of capital costs that are credited towards federal taxes", "min_value": 0, "max_value": 1}, "federal_rebate_per_kw": {"required": false, "default": 0, "help_text": "Federal rebates based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "state_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by state incentives", "min_value": 0, "max_value": 1}, "state_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of state percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "state_rebate_per_kw": {"required": false, "default": 0, "help_text": "State rebate based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "state_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum state rebate", "min_value": 0, "max_value": 10000000000.0}, "utility_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by utility incentives", "min_value": 0, "max_value": 1}, "utility_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of utility percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "utility_rebate_per_kw": {"required": false, "default": 0, "help_text": "Utility rebate based on installed capacity", "min_value": 0, "max_value": 1000000000.0}, "utility_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum utility rebate", "min_value": 0, "max_value": 10000000000.0}, "production_incentive_per_kwh": {"required": false, "default": 0, "help_text": "Production-based incentive value", "min_value": 0, "max_value": 1000000000.0}, "production_incentive_max_benefit": {"required": false, "default": 1000000000.0, "help_text": "Maximum annual value in present terms of production-based incentives", "min_value": 0, "max_value": 1000000000.0}, "production_incentive_years": {"required": false, "default": 0, "help_text": "Duration of production-based incentives from installation date", "min_value": 0, "max_value": 100}, "production_incentive_max_kw": {"required": false, "default": 0.0, "help_text": "Maximum system size eligible for production-based incentive", "min_value": 0, "max_value": 1000000000.0}, "can_net_meter": {"required": false, "default": false, "help_text": "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": {"required": false, "default": false, "help_text": "True/False for if technology has option to export energy that is compensated at the wholesale_rate. Note that a technology can only participate in either net metering or wholesale rates (not both)."}, "can_export_beyond_nem_limit": {"required": false, "default": false, "help_text": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the export_rate_beyond_net_metering_limit)."}, "can_curtail": {"required": false, "default": false, "help_text": "True/False for if technology has the ability to curtail energy production."}, "fuel_renewable_energy_fraction": {"required": false, "help_text": "Fraction of the CHP fuel considered renewable. Default depends on fuel type.", "min_value": 0, "max_value": 1}, "emissions_factor_lb_CO2_per_mmbtu": {"required": false, "help_text": "Pounds of CO2 emitted per MMBTU of CHP fuel burned.", "min_value": 0, "max_value": 10000.0}, "emissions_factor_lb_NOx_per_mmbtu": {"required": false, "help_text": "Pounds of CO2 emitted per MMBTU of CHP fuel burned.", "min_value": 0, "max_value": 10000.0}, "emissions_factor_lb_SO2_per_mmbtu": {"required": false, "help_text": "Pounds of CO2 emitted per MMBTU of CHP fuel burned.", "min_value": 0, "max_value": 10000.0}, "emissions_factor_lb_PM25_per_mmbtu": {"required": false, "help_text": "Pounds of CO2 emitted per MMBTU of CHP fuel burned.", "min_value": 0, "max_value": 10000.0}}, "AbsorptionChiller": {"thermal_consumption_hot_water_or_steam": {"required": false, "choices": ["steam", "hot_water"], "help_text": "Boiler thermal production type, hot water or steam"}, "installed_cost_per_ton": {"required": false, "help_text": "Thermal power-based cost of absorption chiller [$/ton] (3.5 ton to 1 kWt)", "min_value": 0, "max_value": 100000000.0}, "min_ton": {"required": false, "default": 0.0, "help_text": "Minimum thermal power size constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "max_ton": {"required": false, "default": 100000000.0, "help_text": "Maximum thermal power size constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "cop_thermal": {"required": false, "help_text": "Absorption chiller system coefficient of performance - conversion of hot thermal power input to usable cooling thermal energy output", "min_value": 0, "max_value": 100000000.0}, "cop_electric": {"required": false, "default": 14.1, "help_text": "Absorption chiller electric consumption CoP from cooling tower heat rejection - conversion of electric power input to usable cooling thermal energy output", "min_value": 0, "max_value": 100000000.0}, "om_cost_per_ton": {"required": false, "help_text": "Yearly fixed O&M cost [$/ton]", "min_value": 0, "max_value": 100000000.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "default": 0, "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "default": 0.0, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "heating_load_input": {"required": false, "choices": ["DomesticHotWater", "SpaceHeating", "ProcessHeat"], "help_text": "Absorption chiller heat input - determines what heating load is added to by absorption chiller use"}}, "SteamTurbine": {"min_kw": {"required": false, "default": 0.0, "help_text": "Minimum steam turbine size constraint for optimization", "min_value": 0, "max_value": 1000000000.0}, "max_kw": {"required": false, "default": 100000000.0, "help_text": "Maximum steam turbine size constraint for optimization", "min_value": 0, "max_value": 1000000000.0}, "size_class": {"required": false, "choices": [0, 1, 2, 3], "help_text": "Steam turbine size class for using appropriate default inputs"}, "gearbox_generator_efficiency": {"required": false, "help_text": "Combined gearbox (if applicable) and electric motor/generator efficiency", "min_value": 0.0, "max_value": 1.0}, "inlet_steam_pressure_psig": {"required": false, "help_text": "Inlet steam pressure to the steam turbine", "min_value": 0.0, "max_value": 5000.0}, "inlet_steam_temperature_degF": {"required": false, "help_text": "Inlet steam temperature to the steam turbine", "min_value": 0.0, "max_value": 1300.0}, "installed_cost_per_kw": {"required": false, "help_text": "Installed steam turbine cost in $/kW", "min_value": 0.0, "max_value": 100000.0}, "om_cost_per_kwh": {"required": false, "help_text": "Steam turbine per unit production (variable) operations and maintenance costs in $/kWh", "min_value": 0.0, "max_value": 100.0}, "outlet_steam_pressure_psig": {"required": false, "help_text": "Outlet steam pressure from the steam turbine (to the condenser or heat recovery unit)", "min_value": -14.7, "max_value": 1000.0}, "net_to_gross_electric_ratio": {"required": false, "help_text": "Efficiency factor to account for auxiliary loads such as pumps, controls, lights, etc", "min_value": 0.0, "max_value": 1.0}, "electric_produced_to_thermal_consumed_ratio": {"required": false, "help_text": "Simplified input as alternative to detailed calculations from inlet and outlet steam conditions", "min_value": 0.0, "max_value": 1.0}, "thermal_produced_to_thermal_consumed_ratio": {"required": false, "help_text": "Simplified input as alternative to detailed calculations from condensing outlet steam", "min_value": 0.0, "max_value": 1.0}, "is_condensing": {"required": false, "default": false, "help_text": "Steam turbine type, if it is a condensing turbine which produces no useful thermal (max electric output)"}, "inlet_steam_superheat_degF": {"required": false, "default": 0.0, "help_text": "Alternative input to inlet steam temperature, this is the superheat amount (delta from T_saturation) to the steam turbine", "min_value": 0.0, "max_value": 700.0}, "outlet_steam_min_vapor_fraction": {"required": false, "default": 0.8, "help_text": "Minimum practical vapor fraction of steam at the exit of the steam turbine", "min_value": 0.0, "max_value": 1.0}, "isentropic_efficiency": {"required": false, "help_text": "Steam turbine isentropic efficiency - uses inlet T/P and outlet T/P/X to get power out", "min_value": 0.0, "max_value": 1.0}, "om_cost_per_kw": {"required": false, "default": 0.0, "help_text": "Annual steam turbine fixed operations and maintenance costs in $/kW", "min_value": 0.0, "max_value": 5000.0}, "can_net_meter": {"required": false, "default": false, "help_text": "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).Note that if off-grid is true, net metering is always set to False."}, "can_wholesale": {"required": false, "default": false, "help_text": "True/False for if technology has option to export energy that is compensated at the wholesale_rate. Note that a technology can only participate in either net metering or wholesale rates (not both).Note that if off-grid is true, can_wholesale is always set to False."}, "can_export_beyond_nem_limit": {"required": false, "default": false, "help_text": "True/False for if technology can export energy beyond the annual site load (and be compensated for that energy at the export_rate_beyond_net_metering_limit).Note that if off-grid is true, can_export_beyond_nem_limit is always set to False."}, "can_curtail": {"required": false, "default": false, "help_text": "True/False for if technology has the ability to curtail energy production."}, "can_serve_dhw": {"required": false, "default": true, "help_text": "Boolean indicator if steam turbine can serve space heating load"}, "can_serve_space_heating": {"required": false, "default": true, "help_text": "Boolean indicator if steam turbine can serve space heating load"}, "can_serve_process_heat": {"required": false, "default": true, "help_text": "Boolean indicator if steam turbine can serve process heat load"}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}}, "GHP": {"require_ghp_purchase": {"required": false, "default": false, "help_text": "Force one of the considered GHP design options."}, "installed_cost_heatpump_per_ton": {"required": false, "default": 1075.0, "help_text": "Installed heating heat pump cost in $/ton (based on peak coincident cooling+heating thermal load)", "min_value": 0, "max_value": 100000.0}, "installed_cost_wwhp_heating_pump_per_ton": {"required": false, "default": 700.0, "help_text": "Installed WWHP heating heat pump cost in $/ton (based on peak heating thermal load)", "min_value": 0, "max_value": 100000.0}, "installed_cost_wwhp_cooling_pump_per_ton": {"required": false, "default": 700.0, "help_text": "Installed WWHP cooling heat pump cost in $/ton (based on peak cooling thermal load)", "min_value": 0, "max_value": 100000.0}, "heatpump_capacity_sizing_factor_on_peak_load": {"required": false, "default": 1.1, "help_text": "Factor on peak heating and cooling load served by GHP used for determining GHP installed capacity", "min_value": 1.0, "max_value": 5.0}, "installed_cost_ghx_per_ft": {"required": false, "default": 14.0, "help_text": "Installed cost of the ground heat exchanger (GHX) in $/ft of vertical piping", "min_value": 0.0, "max_value": 100.0}, "installed_cost_building_hydronic_loop_per_sqft": {"required": false, "default": 1.7, "help_text": "Installed cost of the building hydronic loop per floor space of the site", "min_value": 0.0, "max_value": 100.0}, "om_cost_per_sqft_year": {"required": false, "default": -0.51, "help_text": "Annual GHP incremental operations and maintenance costs in $/ft^2-building/year", "min_value": -100.0, "max_value": 100.0}, "building_sqft": {"required": true, "help_text": "Building square footage for GHP/HVAC cost calculations", "min_value": 0.0, "max_value": 100000000.0}, "space_heating_efficiency_thermal_factor": {"required": false, "help_text": "Heating efficiency factor (annual average) to account for reduced space heating thermal load from GHP retrofit (e.g. reduced reheat)", "min_value": 0.001, "max_value": 1.0}, "cooling_efficiency_thermal_factor": {"required": false, "help_text": "Cooling efficiency factor (annual average) to account for reduced cooling thermal load from GHP retrofit (e.g. reduced reheat)", "min_value": 0.001, "max_value": 1.0}, "ghx_useful_life_years": {"required": false, "default": 50, "help_text": "Lifetime of geothermal heat exchanger being modeled in years. This is used to calculate residual value at end of REopt analysis period. If this value is less than Financial.analysis_years, its set to Financial.analysis_years.", "min_value": 1, "max_value": 75}, "ghx_only_capital_cost": {"required": false, "help_text": "Capital cost of geothermal heat exchanger which is calculated by REopt automatically. User does not need to provide this input.", "min_value": 1, "max_value": 100000000.0}, "aux_heater_type": {"required": false, "help_text": "This field only accepts \"electric\" as the auxillary heater type. User does not need to provide this information."}, "aux_heater_installed_cost_per_mmbtu_per_hr": {"required": false, "default": 26000.0, "help_text": "Installed cost of auxiliary heater for hybrid ghx in $/MMBtu/hr based on peak thermal production.", "min_value": 1.0, "max_value": 1000000.0}, "aux_cooler_installed_cost_per_ton": {"required": false, "default": 400.0, "help_text": "Installed cost of auxiliary cooler (e.g. cooling tower) for hybrid ghx in $/ton based on peak thermal production", "min_value": 1.0, "max_value": 1000000.0}, "aux_unit_capacity_sizing_factor_on_peak_load": {"required": false, "default": 1.2, "help_text": "Factor on peak heating and cooling load served by the auxiliary heater/cooler used for determining heater/cooler installed capacity", "min_value": 1.0, "max_value": 5.0}, "avoided_capex_by_ghp_present_value": {"required": false, "default": 0.0, "help_text": "Expected cost of HVAC upgrades avoided due to GHP tech over Financial.analysis_years", "min_value": 0.0, "max_value": 100000000.0}, "ghpghx_inputs": {"required": false, "help_text": "GhpGhx.jl inputs/POST to ghpghx app"}, "ghpghx_response_uuids": {"required": false, "help_text": "List of ghp_uuid's (like run_uuid for REopt) from ghpghx app, used to get GhpGhx.jl run data"}, "ghpghx_responses": {"required": false, "help_text": "ghpghx app response(s) to re-use a previous GhpGhx.jl run without relying on a database entry"}, "can_serve_dhw": {"required": false, "default": false, "help_text": "If GHP can serve the domestic hot water (DHW) portion of the heating load"}, "can_serve_space_heating": {"required": false, "default": true, "help_text": "Boolean indicator if GHP can serve space heating load"}, "can_serve_process_heat": {"required": false, "default": false, "help_text": "Boolean indicator if GHP can serve process heat load"}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "macrs_itc_reduction": {"required": false, "default": 0.5, "help_text": "Percent of the ITC value by which depreciable basis is reduced", "min_value": 0, "max_value": 1}, "federal_itc_fraction": {"required": false, "help_text": "Percentage of capital costs that are credited towards federal taxes", "min_value": 0, "max_value": 1}, "state_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by state incentives", "min_value": 0, "max_value": 1}, "state_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of state percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "utility_ibi_fraction": {"required": false, "default": 0, "help_text": "Percentage of capital costs offset by utility incentives", "min_value": 0, "max_value": 1}, "utility_ibi_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum dollar value of utility percentage-based capital cost incentive", "min_value": 0, "max_value": 10000000000.0}, "federal_rebate_per_ton": {"required": false, "default": 0, "help_text": "Federal rebates based on installed capacity of heat pumps", "min_value": 0, "max_value": 1000000000.0}, "state_rebate_per_ton": {"required": false, "default": 0, "help_text": "State rebate based on installed capacity of heat pumps", "min_value": 0, "max_value": 1000000000.0}, "state_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum state rebate", "min_value": 0, "max_value": 10000000000.0}, "utility_rebate_per_ton": {"required": false, "default": 0, "help_text": "Utility rebate based on installed capacity of heat pumps", "min_value": 0, "max_value": 1000000000.0}, "utility_rebate_max": {"required": false, "default": 10000000000.0, "help_text": "Maximum utility rebate", "min_value": 0, "max_value": 10000000000.0}, "max_ton": {"required": false, "help_text": "Maximum thermal power size constraint for GHP [ton]", "min_value": 0, "max_value": 100000000.0}, "max_number_of_boreholes": {"required": false, "help_text": "Maximum number of boreholes for GHX", "min_value": 0, "max_value": 100000000.0}, "load_served_by_ghp": {"required": false, "default": "nonpeak", "help_text": "How to split between load served by GHP and load served by backup system"}}, "ElectricHeater": {"min_mmbtu_per_hour": {"required": false, "default": 0.0, "help_text": "Minimum thermal power size", "min_value": 0.0, "max_value": 100000000.0}, "max_mmbtu_per_hour": {"required": false, "default": 10000000.0, "help_text": "Maximum thermal power size", "min_value": 0.0, "max_value": 100000000.0}, "installed_cost_per_mmbtu_per_hour": {"required": false, "default": 154902.0, "help_text": "Thermal power-based cost", "min_value": 0, "max_value": 100000000.0}, "om_cost_per_mmbtu_per_hour": {"required": false, "default": 0.0, "help_text": "Thermal power-based fixed O&M cost", "min_value": 0, "max_value": 100000000.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "default": 0, "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "default": 0.0, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "cop": {"required": false, "default": 1.0, "help_text": "Electric heater system coefficient of performance (COP) (ratio of usable thermal energy produced per unit electric energy consumed)", "min_value": 0.01, "max_value": 20}, "can_supply_steam_turbine": {"required": false, "default": true, "help_text": "If the boiler can supply steam to the steam turbine for electric production"}, "can_serve_dhw": {"required": false, "default": true, "help_text": "Boolean indicator if the electric heater can serve domestic hot water load"}, "can_serve_space_heating": {"required": false, "default": true, "help_text": "Boolean indicator if the electric heater can serve space heating load"}, "can_serve_process_heat": {"required": false, "default": true, "help_text": "Boolean indicator if the electric heater can serve process heat load"}}, "ASHPSpaceHeater": {"min_ton": {"required": false, "default": 0.0, "help_text": "Minimum thermal power size constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "max_ton": {"required": false, "help_text": "Maximum thermal power size constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "min_allowable_ton": {"required": false, "help_text": "Minimum nonzero thermal power size constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "min_allowable_peak_capacity_fraction": {"required": false, "help_text": "Minimum nonzero thermal power as a fucniton of coincident peak load - constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "sizing_factor": {"required": false, "help_text": "Size of system relative to max dispatch output [fraction]", "min_value": 0, "max_value": 100000000.0}, "installed_cost_per_ton": {"required": false, "help_text": "Thermal power-based cost of ASHP space heater [$/ton] (3.5 ton to 1 kWt)", "min_value": 0, "max_value": 100000000.0}, "om_cost_per_ton": {"required": false, "help_text": "Thermal power-based cost of ASHP space heater [$/ton] (3.5 ton to 1 kWt)", "min_value": 0, "max_value": 100000000.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "heating_cop_reference": {"required": false, "help_text": "Reference points for ASHP space heating system heating coefficient of performance (COP) (ratio of usable heating thermal energy produced per unit electric energy consumed)"}, "heating_cf_reference": {"required": false, "help_text": "Reference points for ASHP space heating system heating capac)ity factor(ratio of heating thermal power to rated capacity)"}, "heating_reference_temps_degF": {"required": false, "help_text": "Reference temperatures for ASHP space heating system's heating COP and CF"}, "cooling_cop_reference": {"required": false, "help_text": "Reference points for ASHP space heating system cooling coefficient of performance (COP) (ratio of usable heating thermal energy produced per unit electric energy consumed)"}, "cooling_cf_reference": {"required": false, "help_text": "Reference points for ASHP space heating system cooling capac)ity factor(ratio of heating thermal power to rated capacity)"}, "cooling_reference_temps_degF": {"required": false, "help_text": "Reference temperatures for ASHP space heating system's cooling COP and CF"}, "can_serve_cooling": {"required": false, "help_text": "Boolean indicator if ASHP space heater can serve cooling load"}, "force_into_system": {"required": false, "help_text": "Boolean indicator if ASHP space heater serves compatible thermal loads exclusively in optimized scenario"}, "force_dispatch": {"required": false, "default": true, "help_text": "Boolean indicator that ASHP space heater outputs either maximum capacity or site load if true"}, "avoided_capex_by_ashp_present_value": {"required": false, "default": 0.0, "help_text": "net present value of avoided capital expenditures due to ASHP system being present [$]", "min_value": 0, "max_value": 100000000.0}, "back_up_temp_threshold_degF": {"required": false, "help_text": "Temperature threshold below which resistive back-up heater turns on [Fahrenheit]", "min_value": -275.0, "max_value": 200.0}}, "ASHPWaterHeater": {"min_ton": {"required": false, "default": 0.0, "help_text": "Minimum thermal power size constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "max_ton": {"required": false, "help_text": "Maximum thermal power size constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "min_allowable_ton": {"required": false, "help_text": "Minimum nonzero thermal power size constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "min_allowable_peak_capacity_fraction": {"required": false, "help_text": "Minimum nonzero thermal power as a function of coincident peak load / CF - constraint for optimization [ton]", "min_value": 0, "max_value": 100000000.0}, "sizing_factor": {"required": false, "help_text": "Size of system relative to max dispatch output [fraction]", "min_value": 0, "max_value": 100000000.0}, "installed_cost_per_ton": {"required": false, "help_text": "Thermal power-based cost of ASHP water heater [$/ton] (3.5 ton to 1 kWt)", "min_value": 0, "max_value": 100000000.0}, "om_cost_per_ton": {"required": false, "help_text": "Thermal power-based cost of ASHP water heater [$/ton] (3.5 ton to 1 kWt)", "min_value": 0, "max_value": 100000000.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "heating_cop_reference": {"required": false, "help_text": "Reference points for ASHP water heating system heating coefficient of performance (COP) (ratio of usable heating thermal energy produced per unit electric energy consumed)"}, "heating_cf_reference": {"required": false, "help_text": "Reference points for ASHP water heating system heating capacity factor(ratio of heating thermal power to rated capacity)"}, "heating_reference_temps_degF": {"required": false, "help_text": "Reference temperatures for ASHP water heating system's heating COP and CF [Fahrenheit]"}, "avoided_capex_by_ashp_present_value": {"required": false, "default": 0.0, "help_text": "Net present value of avoided capital expenditures due to ASHP system being present [$]", "min_value": 0, "max_value": 100000000.0}, "back_up_temp_threshold_degF": {"required": false, "help_text": "Temperature threshold below which resistive back-up heater turns on [Fahrenheit]", "min_value": -275.0, "max_value": 200.0}, "force_into_system": {"required": false, "help_text": "Boolean indicator if ASHP water heater serves compatible thermal loads exclusively in optimized scenario"}, "force_dispatch": {"required": false, "default": true, "help_text": "Boolean indicator that ASHP water heater outputs either maximum capacity or site load if true"}}, "CST": {"tech_type": {"required": false, "default": "ptc", "help_text": "Type of CST you want to implement into your system"}, "min_kw": {"required": false, "default": 0, "help_text": "Minimum CST size constraint for optimization.", "min_value": 0, "max_value": 1000000000.0}, "max_kw": {"required": false, "default": 1000000000.0, "help_text": "Maximum CST size constraint for optimization (upper bound on additional capacity beyond existing_kw). Set to zero to disable PV", "min_value": 0, "max_value": 1000000000.0}, "inlet_temp_degF": {"required": false, "default": 400, "help_text": "This is the temperature at which your process needs the heat transfer fluid specified above to be at when entering your facility. In other words, this is your 'hot' temperature.", "min_value": 0, "max_value": 750}, "outlet_temp_degF": {"required": false, "default": 70, "help_text": "This is the temperature at which your the heat transfer fluid specified above returns from your process after heat has been extracted. In other words, this is your cold' temperature. If you have an open system, the inlet temperature will be assumed to be ambient temperature (20 C / 68 F).", "min_value": 0, "max_value": 750}, "acres_per_kw": {"required": false, "default": 0.000939, "help_text": "Power density for CST", "min_value": 0, "max_value": 1000.0}, "installed_cost_per_kw": {"required": false, "default": 2200.0, "help_text": "Installed CST cost in $/kW", "min_value": 0, "max_value": 100000.0}, "om_cost_per_kw": {"required": false, "default": 33.0, "help_text": "Annual CST operations and maintenance costs in $/kW", "min_value": 0, "max_value": 1000.0}, "om_cost_per_kwh": {"required": false, "default": 0.0, "help_text": "Annual CST operations and maintenance costs in $/kWh", "min_value": 0, "max_value": 1000.0}, "macrs_option_years": {"required": false, "choices": [0, 5, 7], "default": 0, "help_text": "Duration over which accelerated depreciation will occur. Set to zero to disable"}, "macrs_bonus_fraction": {"required": false, "default": 0.0, "help_text": "Percent of upfront project costs to depreciate in year one in addition to scheduled depreciation", "min_value": 0, "max_value": 1}, "production_factor": {"required": false, "help_text": "Optional user-defined production factors for CST."}, "elec_consumption_factor_series": {"required": false, "help_text": "Optional user-defined electricity consumption factors for CST."}, "can_supply_steam_turbine": {"required": false, "default": false, "help_text": "Boolean indicator if CST can supply steam to the steam turbine for electric production"}, "can_serve_dhw": {"required": false, "default": false, "help_text": "Boolean indicator if CST can serve hot water load"}, "can_serve_space_heating": {"required": false, "default": false, "help_text": "Boolean indicator if CST can serve space heating load"}, "can_serve_process_heat": {"required": false, "default": true, "help_text": "Boolean indicator if CST can serve process heat load"}, "charge_storage_only": {"required": false, "default": false, "help_text": "Boolean indicator if CST can only supply hot TES"}, "can_waste_heat": {"required": false, "default": true, "help_text": "Boolean indicator if CST waste (not use) heat relative to its potential production"}, "emissions_factor_lb_CO2_per_mmbtu": {"required": false, "help_text": "Pounds of CO2 emitted per MMBTU of fuel burned.", "min_value": 0, "max_value": 10000.0}, "emissions_factor_lb_NOx_per_mmbtu": {"required": false, "help_text": "Pounds of CO2 emitted per MMBTU of fuel burned.", "min_value": 0, "max_value": 10000.0}, "emissions_factor_lb_SO2_per_mmbtu": {"required": false, "help_text": "Pounds of CO2 emitted per MMBTU of fuel burned.", "min_value": 0, "max_value": 10000.0}, "emissions_factor_lb_PM25_per_mmbtu": {"required": false, "help_text": "Pounds of CO2 emitted per MMBTU of fuel burned.", "min_value": 0, "max_value": 10000.0}}}