bonsai_ipcc.waste.wastewater package

Submodules

bonsai_ipcc.waste.wastewater.elementary module

bonsai_ipcc.waste.wastewater.elementary.ch4_emissions(*ch4)

Equation 6.1a (tier 1)

Total CH4 emissions from domestic wastewater treatment and discharge.

Argument

ch4 (kg/year)float, list of floats

CH4 emissions of systems

returns:

VALUE – total CH4 emissions for treatment and discharge system (Gg/year)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.ch4_emissions_discharge(tow, s, ef, r)

Equation 6.1 (tier 1)

Calculates the CH4 emissions from domestic wastewater discharge per system.

Argument

tow (kg/year)float

organics in wastewater of the discharge system (kg bod/yr)

s (kg/year)float

organic component removed from the wastewater of the system (kg bod/yr)

ef (kg/kg)float

emission factor for the system (kg ch4 / kg bod)

r (kg/year)float

amount of CH4 recovered from the system (kg CH4 /yr)

returns:

VALUE – CH4 emissions for discharge system (kg/year)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.ch4_emissions_system_ind(tow, s, ef, r)

Equation 6.4 (tier 1)

Industrial wastewater Calculates the CH4 emissions from industrial wastewater treatment per system.

Argument

tow (kg/year)float

organics in wastewater of the treatment/discharge system (kg cod/yr)

s (kg/year)float

organic component removed from the wastewater of the system (kg cod/yr)

ef (kg/kg)float

emission factor for the system (kg ch4 / kg cod)

r (kg/year)float

amount of CH4 recovered from the system (kg CH4 /yr)

returns:

VALUE – CH4 emissions for treatment/discharge system (kg/year)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.ch4_emissions_treatment(tow, s, ef, r)

Equation 6.1 (tier 1)

Calculates the CH4 emissions from domestic wastewater treatment.

Argument

tow (kg/year)float

organics in wastewater of the treatment system (kg bod/yr)

s (kg/year)float

organic component removed from the wastewater of the system (kg bod/yr)

ef (kg/kg)float

emission factor for the system (kg ch4 / kg bod)

r (kg/year)float

amount of CH4 recovered from the system (kg CH4 /yr)

returns:

VALUE – CH4 emissions for treatment system (kg/year)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.ef_ch4_discharge(b0, mcf)

Equation 6.2 (tier 1)

Calculates the CH4 emission factor per discharge system.

Argument

b0 (kg/kg)float

maximum ch4 producing capacity (kg ch4/ kg bod)

mcf (kg/kg)float

methane correction factor (fraction)

returns:

VALUE – CH4 emission factor (kg/kg)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.ef_ch4_ind(b0, mcf)

Equation 6.5 (tier 1)

Industrial wastewater Calculates the CH4 emission factor per treatment/discharge system.

Argument

B0 (kg/kg)float

maximum CH4 producing capacity (kg CH4/ kg COD)

MCF (kg/kg)float

methane correction factor (fraction)

returns:

VALUE – CH4 emission factor (kg/kg)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.ef_ch4_treat(b0, mcf)

Equation 6.2 (tier 1)

Calculates the CH4 emission factor per treatment system.

Argument

b0 (kg/kg)float

maximum ch4 producing capacity (kg ch4/ kg bod)

mcf (kg/kg)float

methane correction factor (fraction)

returns:

VALUE – CH4 emission factor (kg/kg)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.n2o_effluent(n_effluent, ef_effluent)

Equation 6.7 (updated)

N2O emissions from domestic wastewater effluent

Argument

n_effluent (kg/yr)float

nitrogen in the effluent discharged to aquatic environments, kg n / yr

ef_effluent (kg/kg)float

emssion factor for N2O emissions from wastewater discharged to aquatic systems, kg N2O / kg N

returns:

VALUE – N2O_EFFLUENT (kg/yr) N2O emissions from domestic wastewater effluent

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.n2o_effluent_ind(n_effluent_ind, ef_effluent)

Equation 6.12

N2O emissions from industrial wastewater effluent

Argument

n_effluent_ind (kg/yr)float

nitrogen in industrial wastewater effluent discharged to aquatic environments, kg n / yr

ef_effluent (kg/kg)float

emssion factor for N2O emissions from wastewater discharged to aquatic systems, kg N2O / kg N

returns:

VALUE – N2O_EFFLUENT (kg/yr) N2O emissions from industrial wastewater effluent

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.n2o_emissions(*n2o)

Equation 6.x (tier 1)

Total N2O emissions from domestic wastewater treatment and discharge.

Argument

n20 (kg/year)float, list of floats

N2O emissions of systems

returns:

VALUE – total N2O emissions for treatment and discharge system (kg/year)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.n2o_plants(u, t, ef, tn_dom)

Equation 6.9 (updated)

N2O emissions from domestic wastewater treatment plants. Contrary to guidelines, no summation over treatments and income groups.

Argument

u (cap/cap)float

fraction of population in income group i in inventory year

t (kg/kg)float

degree of utilization of treatment/discharge system for each income group

ef kg/kg)float

emission factor for treatment/discharge system, kg n2o / kg n

tn_dom (kg/yr)float

total nitrogen in domestic wastewater in inventory year

returns:

VALUE – N2O_PLANTS (kg/yr) total N2O emissions from plants in inventory year

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.n2o_plants_ind(t_ind, ef, tn_ind)

Equation 6.11

N2O emissions from industrial wastewater treatment plants. Contrary to guidelines, no summation over treatments and income groups.

Argument

t_ind (kg/kg)float

degree of utilization of treatment/discharge system for each industry

ef kg/kg)float

emission factor for treatment/discharge system, kg n2o / kg n

tn_ind (kg/yr)float

total nitrogen in indsutrial wastewater in inventory year

returns:

VALUE – N2O_PLANTS (kg/yr) total N2O emissions from plants in inventory year

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.n_effluent_dom_system(tn_dom, t, n_rem)

Equation 6.8 (updated)

Total nitrogen in domestic wastewater effluent.

Argument

tn_dom (kg/year)float

total nitrogen in domestic wastewater in inventory year

t (kg/kg)float

degree of utilisation of treatment system

n_rem (kg/kg)float

fraction of total wastewater nitrogen removed during treatment

returns:

VALUE – N_EFFLUENT (kg/year) total nitrogen in the wastewater effluent discharged to aquatic environments

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.n_effluent_ind(tn_ind, t_ind, n_rem)

Equation 6.14

Total nitrogen in domestic wastewater effluent. Contrary to giudelines no summation over treatment type.

Argument

tn_ind (kg/year)float

total nitrogen in industrial wastewater in inventory year

t (kg/kg)float

degree of utilisation of treatment system in industry

n_rem (kg/kg)float

fraction of total wastewater nitrogen removed during treatment

returns:

VALUE – N_EFFLUENT (kg/year) total nitrogen in the industrial wastewater effluent discharged to aquatic environments

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.protein(protein_supply, fpc)

Equation 6.10a

Protein consumptions based on Protein supply (e.g. FAOSTAT data)

Argument

protein_supply (kg/cap/yr)float

annual per capita protein supply

fpc (kg/kg) float

fraction of protein consumed

returns:

VALUE – protein (kg/cap/yr) Protein consumption

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.s_aerob(s_mass, k_rem)

Equation 6.3b (tier 1)

Organic component removed as sludge from aerobic treatment plants.

Argument

s_mass (t/year)float

amount of raw sludge removed from wastewater treatment as dry mass

k_rem (kg/kg)float

sludge factor, kg BOD/ kg sludge

returns:

VALUE – organic component removed from wastewater (kg/year)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.s_septic(tow_septic, f)

Equation 6.3c (tier 1)

Organic component removed as sludge from septic systems.

Argument

tow_septic (kg/year)float

total organics in wastewater in septic systems, kg bod/ yr

f (kg/kg)float

fraction of the population managing their septic tank in compliance with instruction

returns:

VALUE – organic component removed from wastewater (kg/year)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.tn_domestic(p_treatment, protein, f_npr, n_hh, f_non_con, f_ind_com)

Equation 6.10

Total nitrogen in domesetic wastewater by treatment pathway.

Argument

p_treatment (cap/year)float

population who are served by the treatment pathway

protein (kg/cap/year)float

annual per capita protein consumption

f_npr (kg/kg)float

fraction of nitrogen in protein, default 0.16

n_hh (kg/kg)float

factor that adds nitrogen from household products to the wastewater, default 1.1

f_non_con (kg/kg)float

factor for nitrogen in non-consumed protein disposed in sewer system

f_ind_com (kg/kg)float

factor for industrial and commercial co-discharged protein into the sewer system

returns:

VALUE – TN_DOM (kg/year) total annual amount of nitrogen in domestic wastewater

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.tn_industry(p, w, tn)

Equation 6.13

Total nitrogen in wastewater entering treatment for industry.

Argument

p (t/year)float

total industry product

w (m3/t)float

wastewater generated for industrial sector product

tn (kg/kg)float

total nitrogen in untreated wastewater for industrial sector

returns:

VALUE – TN_IND (kg/year) total annual amount of nitrogen in industrial wastewater

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.tow_eff_treat_system(tow, t, tow_rem)

Equation 6.3d (tier 1)

Calculates total the amount of TOW in effluent. Contrary to the guidelines no summation over treatment systems is done.

Argument

tow (kg/year)float

total organics in wasterwater

t (kg/kg)float

degree of utilisation of treatment/discharge system

tow_rem (kg/kg)float

fraction of total wastewater organicas removed during wastewater treatment

returns:

VALUE – TOW_EFFFtreat per system (kg/year)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.tow_system(tow, u, t, i)

Equation 6.3a (tier 1)

Calculates total organics in domestic wastewater (TOW) per treatment/discharge system. Contrary to the guidelines the two dimensionless factors U and T are merged to one (UT), indicating the total share of system j in a country.

Argument

tow (kg/year)float

total organics in wasterwater

u (cap/cap) float

fraction of population per income group

t (kg/kg)float

degree of utilisation of treatment/discharge system j per income group i

i (kg/kg)float

correction factor for additional industrial BOD discharged into the system j

returns:

VALUE – TOW per system j (kg/year)

rtype:

float

bonsai_ipcc.waste.wastewater.elementary.ww_tech(ww, ww_per_tech)

Equation 6.x (not in guidelines)

amount of wastewater treated per technology

Argument

ww (kg/yr)float

amount of treated wastewater in a region and year

ww_per_tech kg/kg)float

amount of treated wastewater by a technology to the total amount (ratio)

returns:

VALUE – ww_tech (kg/yr) amount of treated wastewater per technology

rtype:

float

bonsai_ipcc.waste.wastewater.sequence module

Sequences to determine GHG emissions from wastewater.

Decision tree for CH4 (domestic wastewater):

• tier 1: wastewater is not a key category (treatment),

  no activity data available to categorize discharge by type of waterbody (discharge)

• tier 2: country-specific emission factors availablle for pathways (treatment),

  no country-specific method available to categorize discharge by type of waterbody (discharge)

• tier 3: country-specific method for facility-specific CH4 emissions available (treatment),

  country-specific method available to categorize discharge by type of waterbody (discharge)

Decision tree for CH4 (industrial wastewater):

• tier 1: wastewater is not a key category (treatment),

  wastewater is not a key category and no activity data to categoorize by type of waterbody (discharge)

• tier 2: wastewater outflow data for industrial sectors available (treatment),

  wastewater is not a key category and activity data to categoorize by type of waterbody (discharge)

• tier 3: country-specific method for individual facilities and sectors available (treatment and discharge)

Decision tree for N2O (domestic wastewater):

• tier 1: wastewater is not a key category (treatment),

  no activity data available to categorize discharge by type of waterbody (discharge)

• tier 2: country-specific emission factors availablle for pathways (treatment)

• tier 3: country-specific method for facility-specific N2O emissions available (treatment),

  country-specific method available to categorize discharge by type of waterbody (discharge)

Decision tree for N2O (industrial wastewater):

• tier 1: wastewater is not a key category (treatment),

  no activity data or country-specific method available to categorize by type of waterbody (discharge)

• tier 2: N and wastewater outflow data for industrial sectors available (treatment),

• tier 3: country-specific method for individual facilities and sectors available (treatment)

  country-specific method available to categorice by type of waterbody and (discharge)

bonsai_ipcc.waste.wastewater.sequence.tier1_ch4_domestic(year=2010, region='BG', activity='septic-tank', wwaterdischarge_type='freshwater_aquatic_tier1', uncertainty='def')

Template calculation sequence for tier 1 method.

CH4 Emissions for domestic wastewater treatment. Each step either calls an elementary equation, calls a parameter, or performs a simple operation like a loop or a conditional. Each step delivers one return value and unit to the list of variables.

Argument

yearint

year under study

regionstr

region under study

activitystr

wastewater treatment technology

wwaterdischarge_typestr

wastewater discharge type

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.waste.wastewater.sequence.tier1_ch4_industrial(year=2010, region='BG', product='ww_pulp', activity='coll_treat_aerob_centralised_industry', wwaterdischarge_type='freshwater_aquatic_tier1', uncertainty='def')

Template calculation sequence for tier 1 method.

CH4 Emissions for industrial wastewater treatment. Each step either calls an elementary equation, calls a parameter, or performs a simple operation like a loop or a conditional. Each step delivers one return value and unit to the list of variables.

Argument

yearint

year under study

regionstr

region under study

productstr

industry in which wastewater treatment occurs

activitystr

wastewater treatment technology

wwaterdischarge_typestr

wastewater discharge type

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.waste.wastewater.sequence.tier1_n2o_domestic(year=2010, region='DE', activity='uncoll_untreated', wwaterdischarge_type='freshwater_aquatic_tier1', uncertainty='def')

Template calculation sequence for tier 1 method.

N2O Emissions for domestic wastewater treatment. Each step either calls an elementary equation, calls a parameter, or performs a simple operation like a loop or a conditional. Each step delivers one return value and unit to the list of variables.

Argument

yearint

year under study

regionstr

region under study

activitystr

wastewater treatment technology

wwaterdischarge_typestr

wastewater discharge type

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.waste.wastewater.sequence.tier1_n2o_industrial(year=2010, region='BG', activity='uncoll_untreated', wwaterdischarge_type='freshwater_aquatic_tier1', product='ww_meat', uncertainty='def')

Template calculation sequence for tier 1 method.

N2O Emissions for industrial wastewater treatment. Each step either calls an elementary equation, calls a parameter, or performs a simple operation like a loop or a conditional. Each step delivers one return value and unit to the list of variables.

Argument

yearint

year under study

regionstr

region under study

activitystr

wastewater treatment technology

wwaterdischarge_typestr

wastewater discharge type

productstr

industry in which wastewater treatment occurs

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.waste.wastewater.sequence.tier2_ch4_domestic(year=2010, region='BG', activity='septic-tank', wwaterdischarge_type='freshwater_aquatic_other_tier2', uncertainty='def')

Template calculation sequence for tier 2 method.

CH4 Emissions for domestic wastewater treatment. Each step either calls an elementary equation, calls a parameter, or performs a simple operation like a loop or a conditional. Each step delivers one return value and unit to the list of variables.

Argument

yearint

year under study

regionstr

region under study

activitystr

wastewater treatment technology

wwaterdischarge_typestr

wastewater discharge type

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.waste.wastewater.sequence.tier2_ch4_industrial(year=2010, region='BG', product='pulp', activity='coll_treat_aerob_centralised_industry', wwaterdischarge_type='freshwater_aquatic_other_tier2', uncertainty='def')

Template calculation sequence for tier 2 method.

CH4 Emissions for industrial wastewater treatment. Each step either calls an elementary equation, calls a parameter, or performs a simple operation like a loop or a conditional. Each step delivers one return value and unit to the list of variables.

Argument

yearint

year under study

regionstr

region under study

productstr

industry in which wastewater treatment occurs

activitystr

wastewater treatment technology

wwaterdischarge_typestr

wastewater discharge type

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.waste.wastewater.sequence.tier2_n2o_domestic(year=2010, region='DE', activity='uncoll_untreated', wwaterdischarge_type='freshwater_aquatic_tier1', uncertainty='def')

Template calculation sequence for tier 2 method.

N2O Emissions for domestic wastewater treatment. Each step either calls an elementary equation, calls a parameter, or performs a simple operation like a loop or a conditional. Each step delivers one return value and unit to the list of variables.

Argument

yearint

year under study

regionstr

region under study

activitystr

wastewater treatment technology

wwaterdischarge_typestr

wastewater discharge type

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.waste.wastewater.sequence.tier2_n2o_industrial(year=2010, region='BG', activity='uncoll_untreated', wwaterdischarge_type='freshwater_aquatic_tier1', product='ww_meat', uncertainty='def')

Template calculation sequence for tier 2 method.

N2O Emissions for industrial wastewater treatment. Each step either calls an elementary equation, calls a parameter, or performs a simple operation like a loop or a conditional. Each step delivers one return value and unit to the list of variables.

Argument

yearint

year under study

regionstr

region under study

activitystr

wastewater treatment technology

wwaterdischarge_typestr

wastewater discharge type

productstr

industry in which wastewater treatment occurs

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