Updated Grid RE and Emissions

[adfarth]

Inputs and outputs from:

• Add Grid Renewable Energy Fraction REopt.jl#426

Added

• Added 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
  • 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
• Added 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
• Added 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

• Changed 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
• Changed 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
• Changed v3 endpoint "cambium_emissions_profile" to "cambium_profile"
• In REopt.jl: Updated Cambium API call to Cambium 2023 dataset, Updated AVERT emissions data to v4.3, which uses Regional Data Files for year 2023 for CONUS. For Alaska and Hawaii (regions AKGD, HIMS, HIOA), updated eGRID data to eGRID2022 datafile, adjusted to CO2e values.

[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.