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_elec_and_thermal_load
• Changed name of function (also available as endpoint through REopt API) from cambium_emissions_profile to cambium_profile

[hdunham]

is the plan to merge #456 into this and then merge together or to merge one first?

[adfarth]

I was thinking we would merge this one first if possible, because we might not get to that one until mid January. That PR would address an issue that already exists with all of the % RE calculations, whereas this one adds new RE outputs (that do also have the whole total load issue). Do you think that's an okay approach?

[hdunham]

Yes but another thought is that if there is a known issue that we aren't fixing right away I wonder if it makes sense to temporarily remove the affected total load related outputs and/or note it somewhere for users. Mid Jan is pretty soon though especially with the holidays so maybe not worth the time to do that.

[hdunham]

is this something you wanted to do in this PR?

[adfarth]

I don't think so; we need to more holistically address the whole "total load" approach and make sure we have funding for this; @zolanaj has a separate PR for this: #456

[hdunham]

got it, didin't realize this was part of that. it could be a good idea to note in #456 all the places like this that need to be considered/updated. not necessarily going through and finding all of them, cause that's the work of that PR, but just listing the ones that you already identified through this PR.