6d Get Emissions Metrics

Step 6d: Get Emissions Metrics

Retrieve emissions metrics for all facilities in the task. Join these to the assets table and map tooltips by facility relationship ID.

What this step does

It reads the per-shed emissions results from /metrics/sheds/emissions, scoped by filter[assets.task_id]. Each metric carries the carbon figures โ€” luc, nonluc, removal, soc, biogenic, area โ€” and a facility (and shed) relationship for joining back to the locations.

Why it's needed

Emissions is the second half of the metric run triggered in Step 4, and like deforestation it lives on its own resource rather than on the facility. This read supplies the LUC / non-LUC columns in the assets table and the carbon figures in the map tooltips. It only returns data when emissions was included in the Step 4 metrics list.

When you can skip it

Skip it if you only requested deforestation in Step 4 โ€” with no emissions run there are no rows to fetch, and the combined visualization simply omits the emissions columns. It's also facility-oriented, so plot-only uploads have nothing to join here.

Request

GET /metrics/sheds/emissions?filter[assets.task_id]=eq:{process-task-id}

Query parameters:

ParameterDescription
filter[assets.task_id]Process task ID from Step 4
filter[commodity]Filter by commodity type
filter[country_code]Filter by country code
page[number]Page number
page[size]Items per page

Data Joining

  • Match relationships.facility.data.id to facility IDs from Step 6a
  • Or match relationships.shed.data.id to plot IDs from Step 6b
  • Same joining strategy as deforestation metrics (Step 6c)

Assets Table Columns

ColumnSourceDescription
LUC Emissions (tCO2e/yr)lucLand-use change emissions
Non-LUC Emissions (tCO2e/yr)nonlucNon-land-use change emissions

Map Tooltip Data

  • luc: Land-use change emissions (tCO2e/yr)
  • nonluc: Non-land-use change emissions (tCO2e/yr)
  • removal: Carbon removal (tCO2e/yr, negative value)
  • soc: Soil organic carbon (tCO2e/yr)
  • biogenic: Biogenic emissions (tCO2e/yr)
  • area: Total analyzed area in hectares