In this update, we have enhanced the granularity of the timeseries response object; users will be able to view cumulative operational emissions with more resolution, alongside their annual emission counterparts. Additionally, we have made significant improvements to our testing suite, expanding coverage for the /carbon-intensities endpoint. Lastly, we have adjusted the validation process for the C.Scale parameters, specifically for primary percentages related to
use_category
and
structure
. This change aims to provide more flexibility when a second
use_category
and/or
structure
is not explicitly specified.
New Timeseries Responses
We've added
em
,
op
,
av
annual emissions to the timeseries object.
  • em
    represents the annual embodied emissions in each year.
  • op
    represents the annual operational emissions in each year.
  • av
    represents the annual avoided/stored emissions in each year.
We've also added
op_foss_cumul
,
op_ref_cumul
, and
op_elec_cumul
cumulative emissions, these break down the categories that make up operational emissions (fossil fuels, refrigerants, and electricity).
  • op_foss_cumul
    represents the cumulative operational emissions from fossil fuels from year of completion to the end of the reference period.
  • op_ref_cumul
    represents the cumulative operational emissions from refrigerants from year of completion to the end of the reference period.
  • op_elec_cumul
    represents the cumulative operational emissions from electricity from year of completion to the end of the reference period.
Primary Use/Structure Validation and Messages
If there is no
secondary_(use/structural_system)
explicitly defined, the validation for
primary_(use/structural)_percentage
has been loosened to accept values other than
100
. If the user inputs a value other than
100
and there is no secondary
use_category
and/or
structure
, the model will default this value back to
100
and the user will see
message_0022
and/or
message_0023
.
message_0022
: "Primary use percentage does not equal 100% when a secondary use category has also not been defined. Primary use percentage has been defaulted back to 100%."
message_0023
: "Primary structural system percentage does not equal 100% when a secondary structural system has not been defined. Primary structural system percentage has been defaulted back to 100%."
Additional Test Coverage for the
api/carbon-intensities
Endpoint
We've expanded our regression testing suite to include the
/carbon-intensities
endpoint. This allows us to monitor and report changes to this endpoint that happen in the course of development.