Updated Grid RE and Emissions

[adfarth]

Inputs and outputs from:

• Add Grid Renewable Energy Fraction REopt.jl#426

Added

• Add the following inputs to account for the clean or renewable energy fraction of grid-purchased electricity:
  • ElectricUtility cambium_cef_metric to utilize clean energy data from NREL's Cambium database
  • ElectricUtility renewable_energy_fraction_series to supply a custom grid clean or renewable energy scalar or series
  • Site include_grid_renewable_fraction_in_RE_constraints - to allow user to choose whether to include grid RE in min max constraints
• Add the following outputs:
  • ElectricUtility annual_renewable_electricity_supplied_kwh
  • Site onsite_and_grid_renewable_electricity_fraction_of_elec_load
  • Site onsite_and_grid_renewable_energy_fraction_of_elec_and_thermal_load
  • ElectricLoad annual_electric_load_with_thermal_conversions_kwh which calculates end-use electrical load after including electric consumption by heaters and chillers
• Add input option optimize_soc_init_fraction (defaults to false) to ElectricStorage, which makes the optimization choose the inital SOC (equal to final SOC) instead of using soc_init_fraction. The initial SOC is also constrained to equal the final SOC, which eliminates the "free energy" issue. We currently do not fix SOC when soc_init_fraction is used because this has caused infeasibility.

Changed

• Change name of the following inputs:
  • ElectricUtility input cambium_metric_col changed to cambium_co2_metric, to distinguish between the CO2 and clean energy fraction metrics
• Change name of the following outputs:
  • ElectricUtility cambium_emissions_region changed to cambium_region
  • Site annual_renewable_electricity_kwh changed to annual_onsite_renewable_electricity_kwh
  • Site renewable_electricity_fraction changed to onsite_renewable_electricity_fraction_of_elec_load
  • Site total_renewable_energy_fraction changed to onsite_renewable_energy_fraction_of_total_load
• Change v3 endpoint "cambium_emissions_profile" to "cambium_profile"

[hdunham]

Should we really not allow users to give a past year for this? What if we want to model a system that already exists to validate or something?

[adfarth]

I might be missing something, but users can give a year for this, it just has to be between 2025-2050 because those are the years for which Cambium has data. If they want to run a past year, they would need to supply their own custom emissions rates.

[hdunham]

I guess I was thinking that if cambium has time steps every 5 years from 2025 to 2050 and the nominal year also covers the 4 years preceding, that users would be allowed to provide a start year from 2021 to 2050. Maybe that's wrong though.