calc_emissions_inputs: Calculate indirect emissions from purchased inputs

View source: R/calc_emissions_inputs.R

calc_emissions_inputsR Documentation

Calculate indirect emissions from purchased inputs

Description

Estimates CO2e emissions from purchased inputs such as feeds, fertilizers, and plastics using regional factors, with optional uncertainty analysis.

Usage

calc_emissions_inputs(
  conc_kg = 0,
  fert_n_kg = 0,
  plastic_kg = 0,
  feed_grain_dry_kg = 0,
  feed_grain_wet_kg = 0,
  feed_ration_kg = 0,
  feed_byproducts_kg = 0,
  feed_proteins_kg = 0,
  feed_corn_kg = 0,
  feed_soy_kg = 0,
  feed_wheat_kg = 0,
  region = "global",
  fert_type = "mixed",
  plastic_type = "mixed",
  include_uncertainty = FALSE,
  transport_km = NULL,
  ef_conc = NULL,
  ef_fert = NULL,
  ef_plastic = NULL,
  boundaries = NULL
)

Arguments

conc_kg

Numeric. Purchased concentrate feed (kg/year). Default = 0.

fert_n_kg

Numeric. Purchased nitrogen fertilizer (kg N/year). Default = 0.

plastic_kg

Numeric. Agricultural plastics used (kg/year). Default = 0.

feed_grain_dry_kg

Numeric. Grain dry (kg/year, DM). Default = 0.

feed_grain_wet_kg

Numeric. Grain wet (kg/year, DM). Default = 0.

feed_ration_kg

Numeric. Ration (total mixed ration) (kg/year, DM). Default = 0.

feed_byproducts_kg

Numeric. Byproducts (kg/year, DM). Default = 0.

feed_proteins_kg

Numeric. Protein feeds (kg/year, DM). Default = 0.

feed_corn_kg

Numeric. Corn (kg/year, DM). Default = 0.

feed_soy_kg

Numeric. Soybean meal (kg/year, DM). Default = 0.

feed_wheat_kg

Numeric. Wheat (kg/year, DM). Default = 0.

region

Character. "EU","US","Brazil","Argentina","Australia","global". Default "global".

fert_type

Character. "urea","ammonium_nitrate","mixed","organic". Default "mixed".

plastic_type

Character. "LDPE","HDPE","PP","mixed". Default "mixed".

include_uncertainty

Logical. Include uncertainty ranges? Default FALSE.

transport_km

Numeric. Average feed transport distance (km). Optional.

ef_conc, ef_fert, ef_plastic

Numeric overrides for emission factors (kg CO2e per unit).

boundaries

Optional. Object from set_system_boundaries().

Details

Notes:

  • When system boundaries exclude "inputs", this function MUST return a list with source = "inputs" and a numeric co2eq_kg = 0 to satisfy partial-boundaries integration.

  • The primary total field is co2eq_kg (for compatibility with calc_total_emissions()); total_co2eq_kg is included as a duplicate for convenience.

Value

A list with fields:

  • source = "inputs"

  • emissions_breakdown (named values per input)

  • co2eq_kg (numeric total)

  • total_co2eq_kg (duplicate of co2eq_kg)

  • emission_factors_used, inputs_summary, contribution_analysis, uncertainty (if requested)

  • metadata (methodology, standards, date)

Examples

# Quick example (runs fast)
calc_emissions_inputs(conc_kg = 1000, fert_n_kg = 200, region = "EU")

# With uncertainty analysis
calc_emissions_inputs(feed_corn_kg = 2000, region = "US", include_uncertainty = TRUE)

cowfootR documentation built on Jan. 13, 2026, 5:07 p.m.