Package index

Build datasets

Build full datasets from raw FAOSTAT inputs. These functions orchestrate reading, gap-filling, historical extension, and balance validation.

build_primary_production(): Build primary production dataset
build_commodity_balances(): Build commodity balance sheets
build_processing_coefs(): Build processing coefficients
build_detailed_trade(): Build detailed bilateral trade matrix
build_trade_prices(): Build global trade prices
build_primary_prices(): Build primary item prices
build_cbs_prices(): Build CBS item prices

Tidy datasets

Get cleaned dataframes with project related data.

Production

Production, supply/use, and processing datasets.

build_supply_use(): Supply and use tables
get_feed_intake(): Livestock feed intake
get_primary_production(): Primary items production
get_primary_residues(): Crop residue items
get_processing_coefs(): Processed products share factors
get_wide_cbs(): Commodity balance sheet data

Trade

Bilateral trade datasets.

get_bilateral_trade(): Bilateral trade data

Nitrogen cycles

Nitrogen inputs, outputs, production, and destinies for Spain.

create_n_prov_destiny(): GRAFS Nitrogen (N) flows
create_n_soil_inputs(): Nitrogen (N) soil inputs for Spain
create_n_production(): N production for Spain
calculate_nue_crops(): N soil inputs and Nitrogen Use Efficiency (NUE) for crop
calculate_nue_livestock(): NUE for Livestock
calculate_system_nue(): System NUE
create_n_nat_destiny(): GRAFS Nitrogen (N) flows at Spain national level

Download large input datasets

Fetch large files from external sources and cache them.

whep_read_file(): Download, cache and read files
whep_inputs: External inputs
whep_list_file_versions(): Input file versions

Code namings

Add name columns in dataframes from their codes or viceversa.

Polities

polities: Polities
polities_cats: Polity categories and regional classifications
regions_full: Full polity and region reference table
add_area_code(): Get area codes from area names
add_area_name(): Get area names from area codes

Commodity balance sheet items

items_cbs: Commodity balance sheet items
items_full: Full CBS item table
cbs_trade_codes: CBS to trade item code mapping
add_item_cbs_code(): Get commodity balance sheet item codes from item names
add_item_cbs_name(): Get commodity balance sheet item names from item codes

Primary production items

items_prod: Primary production items
items_prim: Primary production items linked to CBS
items_prod_full: Full production item table
add_item_prod_code(): Get production item codes from item names
add_item_prod_name(): Get production item names from item codes

Reference tables

Lookup and coefficient tables used internally across the pipeline.

animals_codes: Animal codes and classifications
biomass_coefs: Biomass coefficients for crops and livestock products
cb_processing: Commodity balance sheet processing fractions
crops_eurostat: Eurostat crop classification codes
liv_lu_coefs: Livestock unit coefficients
primary_double: Items with double-counting in production statistics

FAOSTAT raw data

Download FAOSTAT data as is.

get_faostat_data(): Scrapes activity_data from FAOSTAT and slightly post-processes it

Data sources

Get a tidy dataframe with the found sources for different data.

expand_trade_sources(): Trade data sources

Gap filling functions

Functions to fill gaps (NA values) in time-dependent variables using different methods.

fill_linear(): Fill gaps by linear interpolation, or carrying forward or backward.
fill_sum(): Fill gaps summing the previous value of a variable to the value of another variable.
fill_proxy_growth(): Fill gaps using growth rates from proxy variables

Decomposition analysis

Functions for index decomposition analysis.

calculate_lmdi(): Calculate LMDI decomposition.

Livestock emissions

Calculate livestock GHG emissions using IPCC 2019 Tier 1 and Tier 2 methods for enteric methane, manure methane, and manure nitrous oxide.

prepare_livestock_emissions(): Prepare production data for livestock emission calculations.
calculate_livestock_emissions(): Calculate all livestock emissions.
calculate_enteric_ch4(): Calculate enteric methane emissions.
calculate_manure_emissions(): Calculate manure emissions (CH4 + N2O).
estimate_energy_demand(): Estimate energy demand (Gross Energy) - Tier 2
calculate_cohorts_systems(): Calculate cohort and production system distribution.
calculate_uncertainty_bounds(): Calculate uncertainty bounds for livestock emissions.

Livestock coefficient tables

IPCC and GLEAM coefficient tables for livestock emission calculations.

GLEAM supplement tables

Data from MacLeod et al. (2018) GLEAM 3.0 Supplement S1.

gleam_animal_weights: GLEAM animal weights.
gleam_crop_residue_params: GLEAM crop residue parameters.
gleam_dressing_percentages: GLEAM dressing percentages.
gleam_enteric_params: GLEAM enteric fermentation parameters.
gleam_feed_categories: GLEAM feed categories.
gleam_feed_composition: GLEAM feed use efficiency.
gleam_feed_conversion_ratios: GLEAM feed conversion ratios for monogastrics.
gleam_feed_digestibility: GLEAM feed digestibility for ruminants.
gleam_geographic_hierarchy: GLEAM geographic hierarchy.
gleam_livestock_categories: GLEAM livestock categories.
gleam_milk_production: GLEAM milk production.
gleam_mms_shares: GLEAM manure management system shares.
gleam_field_operation_ef: Emission factors for field operations on feed materials.
gleam_mechanization_levels: Country-level mechanization levels for feed materials.
gleam_processing_transport_ef: Processing and transport emission factors for feeds.
gleam_crop_residue_nitrogen: Nitrogen parameters for crop residues of feed materials.
gleam_fracremove: Country-level fraction of crop residues removed.
gleam_energy_use_ef: Energy use emission factors by species and system.

Emission factors and parameters from IPCC 2019, Vol 4, Ch 10.

ipcc_2019_enteric_ef_cattle: IPCC 2019 enteric EF for cattle.
ipcc_2019_enteric_ef_other: IPCC 2019 enteric EF for non-cattle.
ipcc_2019_manure_ch4_ef_cattle: IPCC 2019 manure CH4 EF for cattle.
ipcc_2019_manure_ch4_ef_other: IPCC 2019 manure CH4 EF for non-cattle.
ipcc_2019_mcf_manure: IPCC 2019 MCF for manure management.
ipcc_2019_n_excretion: IPCC 2019 nitrogen excretion rates.
ipcc_2019_n2o_ef_direct: IPCC 2019 direct N2O emission factors.
ipcc_2019_ym: IPCC 2019 Ym values (Table 10.12).
ipcc_2019_bo: IPCC 2019 Bo values (Table 10.16).
ipcc_2019_cfi: IPCC 2019 Cfi values (Table 10.4).

IPCC 2006 tables

Emission factors from IPCC 2006 Guidelines, Vol 4, Ch 10.

ipcc_2006_enteric_ef: IPCC 2006 Tier 1 enteric emission factors.
ipcc_2006_manure_ef: IPCC 2006 Tier 1 manure emission factors.
ipcc_2006_mcf_temp: IPCC 2006 MCF by temperature.

Tier 2 parameters

Detailed parameters for IPCC Tier 2 calculations.

ipcc_tier2_energy_coefs: Tier 2 energy coefficients.
ipcc_tier2_ym_values: Tier 2 Ym values.
ipcc_tier2_bo_values: Tier 2 Bo values.
ipcc_tier2_manure_ash: Tier 2 manure ash content.
ipcc_tier2_n_retention: Tier 2 nitrogen retention fractions.
livestock_production_defaults: Default production parameters.
feed_characteristics: Feed characteristics by diet quality.
livestock_constants: Livestock physical constants.

Other livestock tables

Climate, manure management, and uncertainty tables.

climate_mcf: Climate-zone MCF values.
regional_mms_distribution: Regional MMS distribution.
temperature_adjustment: Temperature adjustment factors for NEm.
grazing_energy_coefs: Grazing energy coefficients.
indirect_n2o_ef: Indirect N2O emission factors.
uncertainty_ranges: Uncertainty ranges for emission parameters.

Harmonization

Functions to harmonize time series items according to specified mapping.

harmonize_simple(): Harmonize rows labeled "simple" by summing values
harmonize_interpolate(): Harmonize advanced cases with interpolation for 1:N groups