Add Grid Renewable Energy Fraction

[adfarth]

Note: The calculation of the renewable energy %s does not yet properly account for the additional load from heating and cooling techs that use electricity. This was an issue prior to this PR and is being addressed in #456.

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

Changed

• Changed name of the following inputs:
  • ElectricUtility input cambium_metric_col changed to cambium_co2_metric
• 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 name of function (also available as endpoint through REopt API) from cambium_emissions_profile to cambium_profile
• 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. Emissions profiles are saved in data/emissions/AVERT_Data.
• Updated Cambium API call for CO2e emissions within CONUS to Cambium 2023 dataset. This includes updates to the default values and valid options for the following ElectricUtility inputs: cambium_scenario, cambium_location_type, and cambium_start_year
• Updated EMISSIONS_DECREASE_DEFAULTS from 0.02163 to 0.0459 based on Cambium

Fixed

• Make ElectricTariff export_rate_beyond_net_metering_limit and wholesale_rate with sub-hour time step work