lca_emission

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.

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_remaining_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
horticulture_co2_peat_export(ef_country, year, ...)	Calculate the CO2 emissions from horticulture peat export.
biomass_co2_from_removals_wetland(land_use_data, ...)	Calculate the CO2 emissions from biomass removals in wetland.
drainage_co2_organic_soils_in_wetland(land_use_data, ...)	Calculate CO2 emissions from drained organic soils in wetland.
unmanaged_wetland_ch4_emission(ef_country, ...)	Calculate the CH4 emissions from unmanaged wetland.
drainage_ch4_organic_soils_in_wetland(ef_country, ...)	Calculate the CH4 emissions from drainage of organic soils in wetland areas.
drainage_n2o_organic_soils_in_wetland(ef_country, ...)	Calculate the N2O emissions from drainage of organic soils in wetland areas.
rewetting_co2_organic_soils_in_wetland(ef_country, ...)	Calculate the CO2 emissions from rewetting organic soils in wetland.
rewetting_ch4_organic_soils_in_wetland(ef_country, ...)	Calculate the CH4 emissions from rewetting organic soils in wetland.
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.

Attributes

t_to_kg
kt_to_kg
C_to_N
kha_to_ha

lca_emission.t_to_kg = 1000.0

lca_emission.kt_to_kg = 1000000.0

lca_emission.C_to_N

lca_emission.kha_to_ha = 1000.0

lca_emission.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.

lca_emission.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

lca_emission.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

lca_emission.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.

lca_emission.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.

lca_emission.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.

lca_emission.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.

lca_emission.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

lca_emission.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

lca_emission.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.

lca_emission.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

lca_emission.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

lca_emission.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.

lca_emission.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

lca_emission.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.

lca_emission.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.

lca_emission.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.

lca_emission.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.

lca_emission.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.

lca_emission.mineral_soils_co2_grassland_remaining_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.

lca_emission.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.

lca_emission.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

lca_emission.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.

lca_emission.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

lca_emission.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

lca_emission.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 –

lca_emission.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.

lca_emission.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.

lca_emission.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.

lca_emission.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

lca_emission.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

lca_emission.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.

lca_emission.horticulture_co2_peat_export(ef_country, year, calibration_year)

Calculate the CO2 emissions from horticulture peat export.

Parameters:

• ef_country (str) – Emission factor country

• year (int) – The year for which the emissions are calculated.

• calibration_year (int) – The year used for calibration.

Returns:

The CO2 emissions from horticulture peat export in metric tons.

Return type:

float

lca_emission.biomass_co2_from_removals_wetland(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate the CO2 emissions from biomass removals in 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: - The CO2 emissions from biomass removals in wetland.

lca_emission.drainage_co2_organic_soils_in_wetland(land_use_data, past_land_use_data, transition_matrix, ef_country)

Calculate CO2 emissions from drained organic soils in wetland.

Paramters:

• 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:

CO2 emissions from drained organic soils in wetland.

Return type:

float

lca_emission.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

lca_emission.drainage_ch4_organic_soils_in_wetland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CH4 emissions from drainage of organic soils 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: - CH4 emissions from organic soils in wetland areas.

lca_emission.drainage_n2o_organic_soils_in_wetland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the N2O emissions from drainage of organic soils in wetland areas.

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: - The N2O emissions from organic soils in wetland areas.

lca_emission.rewetting_co2_organic_soils_in_wetland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CO2 emissions from rewetting organic soils in 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 CO2 emissions from rewetting organic soils in wetland.

lca_emission.rewetting_ch4_organic_soils_in_wetland(ef_country, transition_matrix, land_use_data, past_land_use_data)

Calculate the CH4 emissions from rewetting organic soils in 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 rewetting organic soils in wetland.

lca_emission.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

lca_emission.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

lca_emission.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

lca_emission.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.

lca_emission.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

lca_emission.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

lca_emission.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

lca_emission.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

lca_emission.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

lca_emission.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

lca_emission.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

lca_emission.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

lca_emission.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

lca_emission.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

lca_emission.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.

lca_emission.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.

lca_emission.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.

lca_emission.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.

lca_emission.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

lca_emission.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

lca_emission.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