bonsai_ipcc.agriculture.soils package

Submodules

bonsai_ipcc.agriculture.soils.elementary module

bonsai_ipcc.agriculture.soils.elementary.crop(yield_fresh, dry)

Equation 11.7

DRY- WEIGHT CORRECTION OF REPORTED CROP YIELDS (tier1)

Argument

yield_fresh (kg/ha)float

harvested fresh yield for crop

dry (kg/kg)float

dry matter fraction of harvested crop

returns:

VALUE – crop (kg/ha)

rtype:

float

bonsai_ipcc.agriculture.soils.elementary.f_am(n_mms, frac_feed, frac_fuel, frac_cnst)

Equation 11.4

N FROM ANIMAL MANURE APPLIED TO SOILS (tier1)

Argument

n_mms (kg/year)float

amount of managed manure N available for soil application, feed, fuel or construction

frac_feed (kg/kg)float

fraction of managed manure used for feed

frac_fuel (kg/kg)float

fraction of managed manure used for fuel

frac_cnst (kg/kg)float

fraction of managed manure used for construction

returns:

VALUE – f_on (kg/year)

rtype:

float

bonsai_ipcc.agriculture.soils.elementary.f_cr(crop, r_ag, area, n_ag, frac_remove, frac_burnt, frac_renew, c_f, rs, n_bg)

Equation 11.6

N FROM CROP RESIDUES AND FORAGE /PASTURE RENEWAL (TIER 1)

Argument

crop (kg/ha/year)float

harvested annual dry matter yield for crop

r_ag (kg//ha/year)float

ratio of above-ground residue dry matter to harvested yield for crop

area (ha/year)float

total annual area harvested of crop

frac_renew (kg/kg)float

fraction of total area under crop T that is renewed annually

frac_burnt (kg/kg)float

fraction of annual harvested area of crop

frac_remove (kg/kg)float

fraction of above-ground residues of crop removed annually for purposes such as feed, bedding and construction

c_f (kg/kg)float

combustion factor

rs (kg/ha)float

ratio+ of below-ground root biomass to above-ground shoot biomass for crop

n_bg (kg/kg)float

N content of below-ground residues for crop

returns:

VALUE – f_cr (kg/year)

rtype:

float

bonsai_ipcc.agriculture.soils.elementary.f_on(f_am, f_sew, f_comp, f_ooa)

Equation 11.3

N FROM ORGANIC N ADDITIONS APPLIED TO SOILS (tier1)

Argument

f_am (kg/year)float

total annual amount of organic N fertiliser applied to soils other than by grazing animals

f_sew (kg/year)float

annual amount of animal manure N applied to soils

f_comp (kg/year)float

annual amount of total sewage N

f_ooa (kg/year)float

annual amount of total compost N applied to soils

returns:

VALUE – f_on (kg/year)

rtype:

float

bonsai_ipcc.agriculture.soils.elementary.f_prp(n, nex, ms)

Equation 11.5

N IN URINE AND DUNG DEPOSITED BY GRAZING ANIMALS ON PASTURE, RANGE AND PADDOCK (tier1)

Argument

n (species/yr)float

umber of head of livestock species/category in the country

nex (kg/species/yr)float

annual average N excretion per head of species/category in the country

returns:

VALUE – f_prp (kg/yr)

rtype:

float

bonsai_ipcc.agriculture.soils.elementary.f_som(delta_c_mineral, r)

Equation 11.8 N MINERALISED IN MINERAL SOILS AS A RESULT OF LOSS OF SOIL C THROUGH CHANGE IN LAND USE OR MANAGEMENT (TIERS 1 AND 2)

Argument

delta_c (t/yr)float

average annual loss of soil carbon for each land-use type

r (t/t)float

C:N ratio of the soil organic matter

returns:

VALUE – f_som (kg/yr)

rtype:

float

bonsai_ipcc.agriculture.soils.elementary.n2o_n_direct(n2o_n_inputs, n2o_n_os, n2o_n_prp)

Equation 11.1

DIRECT N2O EMISSIONS as N FROM MANAGED SOILS (TIER 1)

Argument

n2o_n_inputs (kg/year)float

annual direct N 2O–N emissions produced from managed soils.

n2o_n_os (kg/year)float

annual direct N 2O–N emissions from N inputs to managed soils.

n2o_n_prp (kg/kg)float

annual direct N 2O–N emissions from managed organic soil.

returns:

VALUE – DIRECT N2O EMISSIONS FROM MANAGED SOILS as N (kg/year)

rtype:

float

bonsai_ipcc.agriculture.soils.elementary.n2o_n_inputs(f_sn, f_on, f_cr, f_som, ef1)

Equation 11.1

annual direct N 2O–N emissions from N inputs to managed soil (tier1) also applicable for rice.

Argument

f_sn (kg/year)float

annual amount of synthetic fertiliser N applied to soils

f_on (kg/year)float

annual amount of animal manure, compost, sewage sludge and other organic N additions applied to soils

f_cr (kg/year)float

annual amount of N in crop residues

f_som (kg/year)float

annual amount of N in mineral soils that is mineralised, in association with loss of soil C from soil organic matter as a result of changes to land use or management

ef1 (kg/kg)float

emission factor for N2O emissions from N inputs (also for rice)

returns:

VALUE – n2o_n_inputs (kg/year)

rtype:

float

bonsai_ipcc.agriculture.soils.elementary.n2o_n_os(f_os, ef2)

Equation 11.1

annual direct N2O–N emissions from managed organic soils (tier1) modified - different sub-paramaters are merged into two.

Argument

f_os (ha)float

annual area of managed/drained organic soils

ef2 (kg/ha/year)float

emission factor for N 2O emissions from drained/managed organic soil

returns:

VALUE – n2o_n_os (kg/year)

rtype:

float

bonsai_ipcc.agriculture.soils.elementary.n2o_n_prp(f_prp, ef3)

Equation 11.1

annual direct N2O–N emissions from urine and dung inputs to grazed soil (tier1) modified - different sub-paramaters are merged into two.

Argument

f_prp (kg/yr)float

annual amount of urine and dung N deposited by grazing animals on pasture, range and paddock

ef3 (kg/kg)float

emission factor for N2O emissions from urine and dung N deposited on pasture, range and paddock by grazing animals

returns:

VALUE – n2o_n_prp (kg/year)

rtype:

float

bonsai_ipcc.agriculture.soils.sequence module

Sequences to determine GHG emissions from managed soils.

bonsai_ipcc.agriculture.soils.sequence.tier1_n2o_inputs(year=2019, region='DE', product='wheat_spring', landuse_type='CL-ANNUAL', cultivation_type='N_unspec', climate_zone='temperate', moisture_regime='wet', landusechange=False, uncertainty='def')

Tier 1 method N2O Emissions.

Direct emissions from nitrogen inputs into landuse.

Argument

yearint

year under study

regionstr

region under study

productstr

crop type.

landuse_typestr

type of landuse

cultivation_typestr

type of land cultivation

climate_zonestr

climate zone of region

moisture_regimestr

moisture regime of region

landusechangedict

{“year_ref”: 2020, “landusechange_type”: “CL_CL”}

uncertaintystr

‘analytical’, ‘monte_carlo’ or a property dimension, e.g. ‘def’

returns:

VALUE – Inlcudes the results of each step of the sequence.

rtype:

DataClass

bonsai_ipcc.agriculture.soils.sequence.tier1_n2o_os(year=2019, region='DE', landuse_type='CL', climate_zone='temperate', uncertainty='def')

Tier 1 method N2O Emissions.

Direct emissions from managed organic soils.

Argument

yearint

year under study

regionstr

region under study

landuse_typestr

type of landuse

climate_zonestr

climate zone of region

uncertaintystr

‘analytical’, ‘monte_carlo’ or a property dimension, e.g. ‘def’

returns:

VALUE – Inlcudes the results of each step of the sequence.

rtype:

DataClass

bonsai_ipcc.agriculture.soils.sequence.tier1_n2o_prp(year=2010, region='DE', landuse_type='CL', product='cattle-dairy', climate_zone='temperate', uncertainty='def')

Tier 1 method N2O Emissions.

Direct emissions from urine and dung inputs inputs into landuse.

Argument

yearint

year under study

regionstr

region under study

landuse_typestr

type of landuse

productstr

crop type.

climate_zonestr

climate zone of region

uncertaintystr

‘analytical’, ‘monte_carlo’ or a property dimension, e.g. ‘def’

returns:

VALUE – Inlcudes the results of each step of the sequence.

rtype:

DataClass

bonsai_ipcc.agriculture.soils.sequence.tier2_n2o_direct(year=2019, region='DE', product='wheat_spring', landuse_type='CL', cultivation_type='N_unspec', species_type='cattle-dairy', moisture_regime='wet', climate_zone='temperal', uncertainty='def')

Tier 2 method N2O Emissions.

Direct emissions from landuse. TODO: split up so that emission can be allocated to activity and product

Argument

yearint

year under study

regionstr

region under study

productstr

crop type.

landuse_typestr

type of landuse

cultivation_typestr

type of land cultivation

climate_zonestr

climate zone of region

moisture_regimestr

moisture regime of region

landusechangedict

{“year_ref”: 2020, “landusechange_type”: “CL_CL”}

uncertaintystr

‘analytical’, ‘monte_carlo’ or a property dimension, e.g. ‘def’

returns:

VALUE – Inlcudes the results of each step of the sequence.

rtype:

DataClass

Module contents