geo_goblin.geo_lca_emissions

Description:

Calculates emissions from land cover change. It imports various modules and classes related to land use and emissions factors. The script defines functions to estimate carbon dioxide (CO2) and methane (CH4) Nitrous Oxide (N2O) emissions from land cover change. from the various land cover types.

These functions take into account current/future and historical land use data, emission factor country, and transition matrices.

Functionality for the calculation of nutrient exports from forested land to water bodies is also included.

Note

This is part of a larger suite of tools developed for environmental data analysis and modeling.

Module Contents

Functions

co2_drainage_organic_soils_forest(ef_country, ...)

Estimates carbon dioxide (CO2) emissions from the drainage of organic soils in forest areas,

ch4_drainage_organic_soils_forest(ef_country, ...)

Calculate the CH4 emissions from drainage of organic soils in forest land.

n2o_drainage_organic_soils_forest(ef_country, ...)

Calculate the N2O emissions from drainage of organic soils in forest land use.

organic_soils_co2_forest(ef_country, ...)

Calculate CO2 emissions from organic soils in a forest.

organic_soils_ch4_forest(ef_country, ...)

Calculate CH4 emissions from organic soils in forest land use.

mineral_soils_co2_from_cropland_to_forest(land_use, ...)

Calculates the CO2 emissions from mineral soils during the transition from cropland to forest.

mineral_soils_co2_from_grassland_to_forest(land_use, ...)

Calculate CO2 emissions from mineral soils during land use change from grassland to forest.

mineral_soils_co2_to_forest(land_use, ...)

Calculates the CO2 from mineral soils to forest land use.

burning_co2_forest(ef_country, transition_matrix, ...)

Calculate the CO2 emissions from burning forests.

burning_ch4_forest(ef_country, transition_matrix, ...)

Calculate the CH4 emissions from burning forests.

burning_n2o_forest(ef_country, transition_matrix, ...)

Calculate the N2O emissions from burning forests.

total_co2_emission_forest(land_use_data, ...)

Calculate the total CO2 emission from forest land use change.

total_ch4_emission_forest(land_use_data, ...)

Calculate the total CH4 emission from forest based on land use data, past land use data,

total_n2o_emission_forest(land_use_data, ...)

Calculate the total N2O emission from forest land use.

drainage_co2_organic_soils_in_grassland(land_use, ...)

Calculate the CO2 emissions from drainage of organic soils in grassland.

drainage_ch4_organic_soils_in_grassland(land_use, ...)

Calculate the CH4 emissions from organic soils in grassland due to drainage.

drainage_n2O_organic_soils_in_grassland(land_use, ...)

Calculate the N2O emissions from drainage of organic soils in grassland.

rewetting_co2_organic_soils_in_grassland(land_use, ...)

Calculate the CO2 emissions from rewetting organic soils in grassland.

rewetting_ch4_organic_soils_in_grassland(land_use, ...)

Calculate the CH4 emissions from rewetting organic soils in grassland.

mineral_soils_co2_grassland_remainging_grassland(...)

Calculate the CO2 emissions from mineral soils in grassland that remains grassland.

mineral_soils_co2_from_forest_to_grassland(land_use, ...)

Calculate CO2 emissions from mineral soils during land use change from forest to grassland.

mineral_soils_co2_from_cropland_to_grassland(land_use, ...)

Calculates the CO2 emissions from mineral soils due to land use change from cropland to grassland.

mineral_soils_n2o_from_forest_to_grassland(land_use, ...)

Calculates the N2O emissions from mineral soils due to land use change from forest to grassland.

burning_co2_grassland(ef_country, transition_matrix, ...)

Calculate the CO2 emissions from burning grassland.

burning_ch4_grassland(ef_country, transition_matrix, ...)

Calculate the CH4 emissions from burning grassland.

burning_n2o_grassland(ef_country, transition_matrix, ...)

Calculate the N2O emissions from burning grassland.

total_co2_emission_to_grassland(land_use, ...)

Calculates the total CO2 emission to grassland based on the given parameters. It sums mineral soils CO2

total_co2_emission_in_grassland(land_use, ...)

Calculates the total CO2 emission in grassland based on the land use, past land use data,

total_ch4_emission_in_grassland(land_use, ...)

Calculates the total CH4 emission in grassland by summing the drainage CH4 emission from organic soils

total_co2_emission_grassland(land_use, ...)

Calculate the total CO2 emission from grassland. Includes total CO2 emission to grassland (cropland and forest),

total_ch4_emission_grassland(land_use, ...)

Calculate the total CH4 emission in grassland. Includes total CH4 emission in grassland (drainage and rewetting)

total_n2o_emission_grassland(land_use, ...)

Calculate the total N2O emission from grassland. Includes N2O emissons from land use change to grassland and

biomass_co2_from_conversion_to_wetland(land_use_data, ...)

Calculate the CO2 removals from conversion to wetland.

unmanaged_wetland_ch4_emission(ef_country, ...)

Calculate the CH4 emissions from unmanaged wetland.

rewetting_co2_organic_soils_in_wetland(ef_country, ...)

burning_co2_wetland(ef_country, transition_matrix, ...)

Calculate the CO2 emissions from burning wetland.

burning_ch4_wetland(ef_country, transition_matrix, ...)

Calculate the CH4 emissions from burning wetlands.

burning_n2o_wetland(ef_country, transition_matrix, ...)

Calculate the N2O emissions from burning in wetland areas.

total_co2_emission_wetland(land_use_data, ...)

Calculates the total CO2 emission from wetland based on different factors. Includes CO2 emissions from drainage,

total_ch4_emission_wetland(land_use_data, ...)

Calculate the total CH4 emission from wetlands. Includes CH4 emissions from drainage and burning.

total_n2o_emission_wetland(land_use_data, ...)

Calculate the total N2O emission from wetland. Includes N2O emissions from drainage and burning.

mineral_soils_co2_from_forest_to_cropland(...)

Calculates the CO2 emissions from mineral soils due to land use change from forest to cropland.

mineral_soils_co2_from_grassland_to_cropland(...)

Calculates the CO2 emissions from mineral soils due to land use change from grassland to cropland.

burning_ch4_cropland(ef_country, transition_matrix, ...)

Calculate the CH4 emissions from burning cropland.

burning_n2o_cropland(ef_country, transition_matrix, ...)

Calculate the N2O emissions from burning cropland.

total_co2_emission_cropland(land_use_data, ...)

Calculates the total CO2 emission from cropland based on the given inputs. Includes conversion of forest to cropland

total_ch4_emission_cropland(ef_country, ...)

Calculate the total CH4 emissions from cropland. Burning is the only source of CH4 emissions from cropland.

total_n2o_emission_cropland(ef_country, ...)

Calculate the total N2O emission from cropland. Burning is the only source of N2O emissions from cropland.

drainage_co2_organic_soils_in_settlement(land_use, ...)

Calculate the CO2 emissions from drainage of organic soils in settlements.

drainage_ch4_organic_soils_in_settlement(land_use, ...)

Calculate the estimated methane emissions from drainage of organic soils in settlements.

mineral_soils_co2_from_forest_to_settlement(land_use, ...)

Calculate the CO2 emissions from mineral soils due to forest-to-settlement conversion.

total_co2_settlement(land_use, ef_country)

Calculates the total CO2 emissions from settlement. Includes CO2 emissions from mineral soils and drainage.

total_ch4_settlement(land_use, ef_country)

Calculate the total CH4 emissions from settlement areas. Includes CH4 emissions from drainage.

total_co2_emission(land_use_data, past_land_use_data, ...)

Calculates the total CO2 emission by summing the CO2 emissions from different land cover types.

total_ch4_emission(land_use_data, past_land_use_data, ...)

Calculate the total CH4 emission by summing the CH4 emissions from different land cover types.

total_n2o_emission(land_use_data, past_land_use_data, ...)

Calculate the total N2O emission by summing the N2O emissions from different land cover types.

exports_to_water_N_forest(land_use_data, ...)

Calculate the N emissions to water from forests.

exports_to_water_P_forest(land_use_data, ...)

Calculate the P emissions to water from forests.

exports_to_water_PO4e_forest(land_use_data, ...)

Calculate nutrient exports to water as PO4 equivalents.

Attributes

t_to_kg

kt_to_kg

C_to_N

kha_to_ha

geo_goblin.geo_lca_emissions.t_to_kg = 1000.0
geo_goblin.geo_lca_emissions.kt_to_kg = 1000000.0
geo_goblin.geo_lca_emissions.C_to_N
geo_goblin.geo_lca_emissions.kha_to_ha = 1000.0
geo_goblin.geo_lca_emissions.co2_drainage_organic_soils_forest(ef_country, transition_matrix, land_use_data, past_land_use_data)

Estimates carbon dioxide (CO2) emissions from the drainage of organic soils in forest areas, based on current and historical land use data. This function utilizes the Forest class to calculate the emissions, with a focus on areas that have been drained and are not older than 50 years, as it is assumed these older areas do not emit CO2 due to drainage.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

The estimated CO2 emissions resulting from the drainage of organic soils in

forest areas. This estimation is based on current and historical land use data, and it excludes emissions from forest areas older than 50 years.

Return type:

float

Note

The function initializes an instance of the Forest class, passing in relevant data, and invokes its co2_drainage_organic_soils_forest method to perform the emissions calculation.

geo_goblin.geo_lca_emissions.ch4_drainage_organic_soils_forest(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CH4 emissions from drainage of organic soils in forest land.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

The calculated CH4 emissions from drainage of organic soils in forest land.

Return type:

float

geo_goblin.geo_lca_emissions.n2o_drainage_organic_soils_forest(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the N2O emissions from drainage of organic soils in forest land use.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

N2O emissions from drainage of organic soils in forest land use.

Return type:

float

geo_goblin.geo_lca_emissions.organic_soils_co2_forest(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate CO2 emissions from organic soils in a forest.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns: float: CO2 emissions from organic soils in the forest.

geo_goblin.geo_lca_emissions.organic_soils_ch4_forest(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate CH4 emissions from organic soils in forest land use.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns: float: CH4 emissions from organic soils in forest land use.

geo_goblin.geo_lca_emissions.mineral_soils_co2_from_cropland_to_forest(land_use, past_land_use_data, transition_matrix_data, ef_country)

Calculates the CO2 emissions from mineral soils during the transition from cropland to forest.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: float: The computed CO2 emissions from mineral soils in the land use change.

geo_goblin.geo_lca_emissions.mineral_soils_co2_from_grassland_to_forest(land_use, past_land_use_data, transition_matrix_data, ef_country)

Calculate CO2 emissions from mineral soils during land use change from grassland to forest.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: float: The calculated CO2 emissions from mineral soils during land use change.

geo_goblin.geo_lca_emissions.mineral_soils_co2_to_forest(land_use, past_land_use_data, transition_matrix_data, ef_country)

Calculates the CO2 from mineral soils to forest land use.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

CO2 from mineral soils to forest land use.

Return type:

float

geo_goblin.geo_lca_emissions.burning_co2_forest(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CO2 emissions from burning forests.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

CO2 emissions from burning forests.

Return type:

float

geo_goblin.geo_lca_emissions.burning_ch4_forest(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CH4 emissions from burning forests.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns: float: The CH4 emissions from burning forests.

geo_goblin.geo_lca_emissions.burning_n2o_forest(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the N2O emissions from burning forests.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

N2O emissions from burning forests.

Return type:

float

geo_goblin.geo_lca_emissions.total_co2_emission_forest(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the total CO2 emission from forest land use change.

Mineral soils are not included here as they are accounted for in the CBM model.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

Total CO2 emission from forest land use change.

Return type:

float

geo_goblin.geo_lca_emissions.total_ch4_emission_forest(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the total CH4 emission from forest based on land use data, past land use data, transition matrix, and emission factor for the country.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: float: Total CH4 emission from forest.

geo_goblin.geo_lca_emissions.total_n2o_emission_forest(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the total N2O emission from forest land use.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

Total N2O emission from forest land use.

Return type:

float

geo_goblin.geo_lca_emissions.drainage_co2_organic_soils_in_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculate the CO2 emissions from drainage of organic soils in grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - The CO2 emissions from drainage of organic soils in grassland.

geo_goblin.geo_lca_emissions.drainage_ch4_organic_soils_in_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculate the CH4 emissions from organic soils in grassland due to drainage.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - The calculated CH4 emissions from organic soils in grassland due to drainage.

geo_goblin.geo_lca_emissions.drainage_n2O_organic_soils_in_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculate the N2O emissions from drainage of organic soils in grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - The calculated N2O emissions from drainage of organic soils in grassland.

geo_goblin.geo_lca_emissions.rewetting_co2_organic_soils_in_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculate the CO2 emissions from rewetting organic soils in grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - The calculated CO2 emissions from rewetting organic soils in grassland.

geo_goblin.geo_lca_emissions.rewetting_ch4_organic_soils_in_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculate the CH4 emissions from rewetting organic soils in grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - The CH4 emissions from rewetting organic soils in grassland.

geo_goblin.geo_lca_emissions.mineral_soils_co2_grassland_remainging_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculate the CO2 emissions from mineral soils in grassland that remains grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - The calculated CO2 emissions from mineral soils in grassland that remains grassland.

geo_goblin.geo_lca_emissions.mineral_soils_co2_from_forest_to_grassland(land_use, past_land_use_data, transition_matrix_data, ef_country)

Calculate CO2 emissions from mineral soils during land use change from forest to grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - The computed CO2 emissions from mineral soils during land use change.

geo_goblin.geo_lca_emissions.mineral_soils_co2_from_cropland_to_grassland(land_use, past_land_use_data, transition_matrix_data, ef_country)

Calculates the CO2 emissions from mineral soils due to land use change from cropland to grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

The computed CO2 emissions from mineral soils in the land use change.

Return type:

float

geo_goblin.geo_lca_emissions.mineral_soils_n2o_from_forest_to_grassland(land_use, past_land_use_data, transition_matrix_data, ef_country)

Calculates the N2O emissions from mineral soils due to land use change from forest to grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - emissions_from_mineralization (float): The calculated N2O emissions from mineral soils.

geo_goblin.geo_lca_emissions.burning_co2_grassland(ef_country, transition_matrix, land_use, past_land_use_data)

Calculate the CO2 emissions from burning grassland.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

CO2 emissions from burning grassland.

Return type:

float

geo_goblin.geo_lca_emissions.burning_ch4_grassland(ef_country, transition_matrix, land_use, past_land_use_data)

Calculate the CH4 emissions from burning grassland.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

CH4 emissions from burning grassland.

Return type:

float

geo_goblin.geo_lca_emissions.burning_n2o_grassland(ef_country, transition_matrix, land_use, past_land_use_data)

Calculate the N2O emissions from burning grassland.

Parameters:
  • ef_country (string): Emission factor country.

  • transition_matrix (landcover_lca.models.TransitionMatrixCategory): The transition matrix.

  • land_use_data (landcover_lca.models.LandUseCollection): The current/future land use data.

  • past_land_use_data (landcover_lca.models.LandUseCollection): The past land use data.

Returns:

N2O emissions from burning grassland.

Return type:

float

Raises:

None

geo_goblin.geo_lca_emissions.total_co2_emission_to_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculates the total CO2 emission to grassland based on the given parameters. It sums mineral soils CO2 from forest to grassland and mineral soils CO2 from cropland to grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: The total CO2 emission to grassland.

geo_goblin.geo_lca_emissions.total_co2_emission_in_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculates the total CO2 emission in grassland based on the land use, past land use data, transition matrix. It sums the drainage CO2 emission from organic soils and the rewetting.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - float: The total CO2 emission in grassland.

geo_goblin.geo_lca_emissions.total_ch4_emission_in_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculates the total CH4 emission in grassland by summing the drainage CH4 emission from organic soils and the rewetting CH4 emission from organic soils.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: float: The total CH4 emission in grassland.

geo_goblin.geo_lca_emissions.total_co2_emission_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculate the total CO2 emission from grassland. Includes total CO2 emission to grassland (cropland and forest), total CO2 emission in grassland (drainage and rewetting), and burning CO2 emission in grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

Total CO2 emission from grassland.

Return type:

float

geo_goblin.geo_lca_emissions.total_ch4_emission_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculate the total CH4 emission in grassland. Includes total CH4 emission in grassland (drainage and rewetting) and burning CH4 emission in grassland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

The total CH4 emission in grassland.

Return type:

float

geo_goblin.geo_lca_emissions.total_n2o_emission_grassland(land_use, past_land_use_data, transition_matrix, ef_country)

Calculate the total N2O emission from grassland. Includes N2O emissons from land use change to grassland and N2O emissions from burning grassland. N2O emissions from drainage and rewetting are not included as they are accounted for in the Agricultural soils category in the national inventory report.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: - float: Total N2O emission from grassland.

geo_goblin.geo_lca_emissions.biomass_co2_from_conversion_to_wetland(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the CO2 removals from conversion to wetland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

CO2 removals from conversion to wetland.

Return type:

float

geo_goblin.geo_lca_emissions.unmanaged_wetland_ch4_emission(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CH4 emissions from unmanaged wetland.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

The CH4 emissions from unmanaged wetland.

Return type:

float

geo_goblin.geo_lca_emissions.rewetting_co2_organic_soils_in_wetland(ef_country, transition_matrix, land_use_data, past_land_use_data)
geo_goblin.geo_lca_emissions.burning_co2_wetland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CO2 emissions from burning wetland.

Parameters:
  • ef_country (string): Emission factor country.

  • transition_matrix (landcover_lca.models.TransitionMatrixCategory): The transition matrix.

  • land_use_data (landcover_lca.models.LandUseCollection): The current/future land use data.

  • past_land_use_data (landcover_lca.models.LandUseCollection): The past land use data.

Returns:

CO2 emissions from burning wetland.

Return type:

float

geo_goblin.geo_lca_emissions.burning_ch4_wetland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CH4 emissions from burning wetlands.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

CH4 emissions from burning wetlands.

Return type:

float

geo_goblin.geo_lca_emissions.burning_n2o_wetland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the N2O emissions from burning in wetland areas.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

N2O emissions from burning in wetland areas.

Return type:

float

geo_goblin.geo_lca_emissions.total_co2_emission_wetland(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculates the total CO2 emission from wetland based on different factors. Includes CO2 emissions from drainage, biomass, and burning.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns: float: Total CO2 emission from wetland.

geo_goblin.geo_lca_emissions.total_ch4_emission_wetland(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the total CH4 emission from wetlands. Includes CH4 emissions from drainage and burning.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

Total CH4 emission from wetlands.

Return type:

float

geo_goblin.geo_lca_emissions.total_n2o_emission_wetland(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the total N2O emission from wetland. Includes N2O emissions from drainage and burning.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

Total N2O emission from wetland.

Return type:

float

geo_goblin.geo_lca_emissions.mineral_soils_co2_from_forest_to_cropland(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculates the CO2 emissions from mineral soils due to land use change from forest to cropland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

CO2 emissions from mineral soils in the land use change.

Return type:

float

geo_goblin.geo_lca_emissions.mineral_soils_co2_from_grassland_to_cropland(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculates the CO2 emissions from mineral soils due to land use change from grassland to cropland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

CO2 emissions from mineral soils in the land use change.

Return type:

float

geo_goblin.geo_lca_emissions.burning_ch4_cropland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CH4 emissions from burning cropland.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

CH4 emissions from burning cropland in kilograms.

Return type:

float

geo_goblin.geo_lca_emissions.burning_n2o_cropland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the N2O emissions from burning cropland.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

N2O emissions from burning cropland.

Return type:

float

geo_goblin.geo_lca_emissions.total_co2_emission_cropland(land_use_data, past_land_use_data, transition_matrix_data, ef_country)

Calculates the total CO2 emission from cropland based on the given inputs. Includes conversion of forest to cropland and conversion of grassland to cropland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

Total CO2 emission from cropland.

Return type:

float

geo_goblin.geo_lca_emissions.total_ch4_emission_cropland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the total CH4 emissions from cropland. Burning is the only source of CH4 emissions from cropland.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

Total CH4 emissions from cropland.

Return type:

float

geo_goblin.geo_lca_emissions.total_n2o_emission_cropland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the total N2O emission from cropland. Burning is the only source of N2O emissions from cropland.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

Total N2O emission from cropland.

Return type:

float

geo_goblin.geo_lca_emissions.drainage_co2_organic_soils_in_settlement(land_use, ef_country)

Calculate the CO2 emissions from drainage of organic soils in settlements.

This function estimates the CO2 emissions from drainage of organic soils in settlements.

See Notes.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • ef_country (-) – The emission factor country.

Returns:

The estimated CO2 emissions from drainage of organic soils in settlements.

Return type:

float

Note

The function has not been validated and is not currently used. It overestimates drainage emissions because we forest is used as a reference for previous land_use of organic soil converted to settlement.

ef_co2_forest_to_settlement_drainage include onsite and offite emissions

geo_goblin.geo_lca_emissions.drainage_ch4_organic_soils_in_settlement(land_use, ef_country)

Calculate the estimated methane emissions from drainage of organic soils in settlements.

See Notes.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • ef_country (-) – The emission factor country.

Returns: - The estimated methane emissions from drainage of organic soils in settlements.

Note

The function has not been validated and is not currently used. This function underestimates drainage emissions by using forest as a reference for previous land use of organic soil converted to settlement.

geo_goblin.geo_lca_emissions.mineral_soils_co2_from_forest_to_settlement(land_use, ef_country)

Calculate the CO2 emissions from mineral soils due to forest-to-settlement conversion.

See Notes.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • ef_country (-) – The emission factor country.

Returns:

The calculated CO2 emissions from mineral soils.

Return type:

float

Notes

The function has not been validated and is not currently used.

geo_goblin.geo_lca_emissions.total_co2_settlement(land_use, ef_country)

Calculates the total CO2 emissions from settlement. Includes CO2 emissions from mineral soils and drainage.

See Notes.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • ef_country (-) – The emission factor country.

Returns:

The total CO2 emissions from settlement activities.

Return type:

float

Notes

The function has not been validated and is not currently used.

geo_goblin.geo_lca_emissions.total_ch4_settlement(land_use, ef_country)

Calculate the total CH4 emissions from settlement areas. Includes CH4 emissions from drainage.

See Notes.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • ef_country (-) – The emission factor country.

Returns:

The total CH4 emissions from settlement areas.

Return type:

float

Notes

The function has not been validated and is not currently used.

geo_goblin.geo_lca_emissions.total_co2_emission(land_use_data, past_land_use_data, transition_matrix_data, ef_country)

Calculates the total CO2 emission by summing the CO2 emissions from different land cover types. Types include cropland, forest, grassland, and wetland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

Total CO2 emission.

Return type:

float

geo_goblin.geo_lca_emissions.total_ch4_emission(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the total CH4 emission by summing the CH4 emissions from different land cover types. Types include cropland, forest, grassland, and wetland.

Parameters:
  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

  • transition_matrix (-) – The transition matrix.

  • ef_country (-) – Emission factor country.

Returns:

Total CH4 emission.

Return type:

float

geo_goblin.geo_lca_emissions.total_n2o_emission(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the total N2O emission by summing the N2O emissions from different land cover types. Types include cropland, forest, grassland, and wetland.

Parameters:
  • land_use_data (landcover_lca.models.LandUseCollection): The current/future land use data.

  • past_land_use_data (landcover_lca.models.LandUseCollection): The past land use data.

  • transition_matrix (landcover_lca.models.TransitionMatrixCategory): The transition matrix.

  • ef_country (string): Emission factor country.

Returns:

Total N2O emission.

Return type:

float

geo_goblin.geo_lca_emissions.exports_to_water_N_forest(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the N emissions to water from forests.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

N emissions to water from forests.

Return type:

float

geo_goblin.geo_lca_emissions.exports_to_water_P_forest(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the P emissions to water from forests.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

P emissions to water from forests.

Return type:

float

geo_goblin.geo_lca_emissions.exports_to_water_PO4e_forest(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate nutrient exports to water as PO4 equivalents.

Parameters:
  • ef_country (-) – Emission factor country.

  • transition_matrix (-) – The transition matrix.

  • land_use_data (-) – The current/future land use data.

  • past_land_use_data (-) – The past land use data.

Returns:

PO4e to water from forests.

Return type:

float