pyforestry.sweden.biomass package

Submodules

pyforestry.sweden.biomass.marklund_1988 module

Allometric biomass functions from Marklund (1988), Report 45.

Faithful transcription of every function in Marklund, L.-G. (1988) ‘Biomassafunktioner för tall, gran och björk i Sverige’ (Biomass functions for pine, spruce and birch in Sweden), SLU Dept. of Forest Survey, Report 45, Umeå. Each function returns component DRY WEIGHT in kg. The published constants already include the Baskerville bias correction for the log back-transformation, so exp(const + Σβ·x) is used directly. Function ids (T-/G-/B-) follow the report (T=Tall/pine, G=Gran/spruce, B=Björk/birch).

pyforestry.sweden.biomass.marklund_1988.Marklund_1988(species=None, component=None, *, timber=None, **kwargs)

Dry-weight biomass (kg) for a single tree following Marklund (1988), Report 45.

Selects the most detailed published function for each requested component whose required inputs are supplied. Pass a Timber / SweTimber as the first argument, or give species plus the measured variables as keywords (units per the kernel docstrings, e.g. diameter_cm, height_m, double_bark_mm, crown_base_height_m, age_bh_years, site_index_pine_m …).

Parameters:

• species – Canonical species string (e.g. "pinus sylvestris") or a timber object as the first positional argument.

• component – One of the keys in species_map for the species. If omitted, a dict of every computable component is returned.

• timber – Optional timber object (alternative to passing it positionally).

• **kwargs – Measured predictor values (see kernel docstrings for units).

Returns:

A float biomass in kg for a single component, else a dict mapping each computable component to its biomass in kg.

Raises:

ValueError – Unknown species/component, or no function matched the inputs.

Source:

Marklund, L.-G. (1988). Biomassafunktioner för tall, gran och björk i Sverige [Biomass functions for pine, spruce and birch in Sweden]. Report 45, Dept. of Forest Survey, Swedish University of Agricultural Sciences, Umeå.

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B1(*, diameter_cm) → float

Birch stem over bark dry weight (kg) — Marklund (1988) B-1.

Source: Marklund (1988) Report 45, function B-1, printed p59. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B10(*, diameter_cm, height_m, double_bark_mm, age_bh_years, diameter_increment_5yr_mm, max_diameter_cm, north_coordinate_100km) → float

Birch stem bark dry weight (kg) — Marklund (1988) B-10.

Source: Marklund (1988) Report 45, function B-10, printed p64. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm] :param age_bh_years: age at breast height [years] :param diameter_increment_5yr_mm: last-5-year diameter increment i5 [mm] :param max_diameter_cm: diameter of thickest tree on a 10 m radius plot D_max [cm] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B11(*, diameter_cm) → float

Birch living branches (incl. needles) dry weight (kg) — Marklund (1988) B-11.

Source: Marklund (1988) Report 45, function B-11, printed p65. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B12(*, diameter_cm, height_m, north_coordinate_100km) → float

Birch living branches (incl. needles) dry weight (kg) — Marklund (1988) B-12.

Source: Marklund (1988) Report 45, function B-12, printed p65. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B13(*, diameter_cm, height_m, crown_base_height_m, north_coordinate_100km) → float

Birch living branches (incl. needles) dry weight (kg) — Marklund (1988) B-13.

Source: Marklund (1988) Report 45, function B-13, printed p66. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param crown_base_height_m: green crown base height krg [m] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B14(*, diameter_cm, height_m, age_bh_years, crown_base_height_m, crown_radius_m, diameter_increment_5yr_mm, north_coordinate_100km) → float

Birch living branches (incl. needles) dry weight (kg) — Marklund (1988) B-14.

Source: Marklund (1988) Report 45, function B-14, printed p66. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years] :param crown_base_height_m: green crown base height krg [m] :param crown_radius_m: crown radius kr [m] :param diameter_increment_5yr_mm: last-5-year diameter increment i5 [mm] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B15(*, diameter_cm) → float

Birch dead branches dry weight (kg) — Marklund (1988) B-15.

Source: Marklund (1988) Report 45, function B-15, printed p67. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B16(*, diameter_cm, height_m) → float

Birch dead branches dry weight (kg) — Marklund (1988) B-16.

Source: Marklund (1988) Report 45, function B-16, printed p67. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B17(*, diameter_cm, height_m, north_coordinate_100km, altitude_km) → float

Birch dead branches dry weight (kg) — Marklund (1988) B-17.

Source: Marklund (1988) Report 45, function B-17, printed p68. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000] :param altitude_km: altitude above sea level [km]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B2(*, diameter_cm, height_m) → float

Birch stem over bark dry weight (kg) — Marklund (1988) B-2.

Source: Marklund (1988) Report 45, function B-2, printed p59. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B3(*, diameter_cm, height_m, age_bh_years) → float

Birch stem over bark dry weight (kg) — Marklund (1988) B-3.

Source: Marklund (1988) Report 45, function B-3, printed p60. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B4(*, diameter_cm) → float

Birch stem wood dry weight (kg) — Marklund (1988) B-4.

Source: Marklund (1988) Report 45, function B-4, printed p61. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B5(*, diameter_cm, height_m) → float

Birch stem wood dry weight (kg) — Marklund (1988) B-5.

Source: Marklund (1988) Report 45, function B-5, printed p61. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B6(*, diameter_cm, height_m, double_bark_mm, age_bh_years, north_coordinate_100km) → float

Birch stem wood dry weight (kg) — Marklund (1988) B-6.

Source: Marklund (1988) Report 45, function B-6, printed p62. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm] :param age_bh_years: age at breast height [years] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B7(*, diameter_cm) → float

Birch stem bark dry weight (kg) — Marklund (1988) B-7.

Source: Marklund (1988) Report 45, function B-7, printed p63. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B8(*, diameter_cm, height_m) → float

Birch stem bark dry weight (kg) — Marklund (1988) B-8.

Source: Marklund (1988) Report 45, function B-8, printed p63. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_B9(*, diameter_cm, height_m, double_bark_mm, age_bh_years, north_coordinate_100km) → float

Birch stem bark dry weight (kg) — Marklund (1988) B-9.

Source: Marklund (1988) Report 45, function B-9, printed p64. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm] :param age_bh_years: age at breast height [years] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G1(*, diameter_cm) → float

Norway spruce stem over bark dry weight (kg) — Marklund (1988) G-1.

Source: Marklund (1988) Report 45, function G-1, printed p40. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G10(*, diameter_cm, height_m, double_bark_mm, age_bh_years, max_diameter_cm, site_index_pine_m, site_index_spruce_m) → float

Norway spruce stem bark dry weight (kg) — Marklund (1988) G-10.

Source: Marklund (1988) Report 45, function G-10, printed p45. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm] :param age_bh_years: age at breast height [years] :param max_diameter_cm: diameter of thickest tree on a 10 m radius plot D_max [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine)

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G11(*, diameter_cm) → float

Norway spruce living branches (incl. needles) dry weight (kg) — Marklund (1988) G-11.

Source: Marklund (1988) Report 45, function G-11, printed p46. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G12(*, diameter_cm, height_m) → float

Norway spruce living branches (incl. needles) dry weight (kg) — Marklund (1988) G-12.

Source: Marklund (1988) Report 45, function G-12, printed p46. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G13(*, diameter_cm, height_m, crown_base_height_m, site_index_pine_m, site_index_spruce_m) → float

Norway spruce living branches (incl. needles) dry weight (kg) — Marklund (1988) G-13.

Source: Marklund (1988) Report 45, function G-13, printed p47. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param crown_base_height_m: green crown base height krg [m] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine)

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G14(*, diameter_cm, height_m, age_bh_years, crown_base_height_m, crown_radius_m, diameter_increment_5yr_mm, max_diameter_cm) → float

Norway spruce living branches (incl. needles) dry weight (kg) — Marklund (1988) G-14.

Source: Marklund (1988) Report 45, function G-14, printed p47. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years] :param crown_base_height_m: green crown base height krg [m] :param crown_radius_m: crown radius kr [m] :param diameter_increment_5yr_mm: last-5-year diameter increment i5 [mm] :param max_diameter_cm: diameter of thickest tree on a 10 m radius plot D_max [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G15(*, diameter_cm) → float

Norway spruce needles dry weight (kg) — Marklund (1988) G-15.

Source: Marklund (1988) Report 45, function G-15, printed p48. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G16(*, diameter_cm, height_m) → float

Norway spruce needles dry weight (kg) — Marklund (1988) G-16.

Source: Marklund (1988) Report 45, function G-16, printed p48. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G17(*, diameter_cm, height_m, crown_base_height_m) → float

Norway spruce needles dry weight (kg) — Marklund (1988) G-17.

Source: Marklund (1988) Report 45, function G-17, printed p49. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param crown_base_height_m: green crown base height krg [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G18(*, diameter_cm, height_m, age_bh_years, crown_base_height_m, crown_radius_m, diameter_increment_5yr_mm, max_diameter_cm) → float

Norway spruce needles dry weight (kg) — Marklund (1988) G-18.

Source: Marklund (1988) Report 45, function G-18, printed p49. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years] :param crown_base_height_m: green crown base height krg [m] :param crown_radius_m: crown radius kr [m] :param diameter_increment_5yr_mm: last-5-year diameter increment i5 [mm] :param max_diameter_cm: diameter of thickest tree on a 10 m radius plot D_max [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G19(*, diameter_cm) → float

Norway spruce dead branches dry weight (kg) — Marklund (1988) G-19.

Source: Marklund (1988) Report 45, function G-19, printed p50. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G2(*, diameter_cm, height_m) → float

Norway spruce stem over bark dry weight (kg) — Marklund (1988) G-2.

Source: Marklund (1988) Report 45, function G-2, printed p40. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G20(*, diameter_cm, height_m) → float

Norway spruce dead branches dry weight (kg) — Marklund (1988) G-20.

Source: Marklund (1988) Report 45, function G-20, printed p50. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G21(*, diameter_cm, height_m, crown_base_height_m) → float

Norway spruce dead branches dry weight (kg) — Marklund (1988) G-21.

Source: Marklund (1988) Report 45, function G-21, printed p51. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param crown_base_height_m: green crown base height krg [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G22(*, diameter_cm, height_m, crown_base_height_m, diameter_increment_5yr_mm, max_diameter_cm) → float

Norway spruce dead branches dry weight (kg) — Marklund (1988) G-22.

Source: Marklund (1988) Report 45, function G-22, printed p51. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param crown_base_height_m: green crown base height krg [m] :param diameter_increment_5yr_mm: last-5-year diameter increment i5 [mm] :param max_diameter_cm: diameter of thickest tree on a 10 m radius plot D_max [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G23(*, diameter_cm) → float

Norway spruce stump-root system dry weight (kg) — Marklund (1988) G-23.

Source: Marklund (1988) Report 45, function G-23, printed p52. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G24(*, diameter_cm, site_index_pine_m, site_index_spruce_m) → float

Norway spruce stump-root system dry weight (kg) — Marklund (1988) G-24.

Source: Marklund (1988) Report 45, function G-24, printed p52. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine)

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G25(*, diameter_cm, site_index_pine_m, site_index_spruce_m, moist_soil, peat_soil, lateral_water_long) → float

Norway spruce stump-root system dry weight (kg) — Marklund (1988) G-25.

Source: Marklund (1988) Report 45, function G-25, printed p53. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine) :param moist_soil: indicator 1 if moist/wet firm land FUKT_MARK else 0 :param peat_soil: indicator 1 if peat land TORV_MARK else 0 :param lateral_water_long: indicator 1 if long-period lateral water LANG_OVSI else 0

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G26(*, diameter_cm) → float

Norway spruce stump dry weight (kg) — Marklund (1988) G-26.

Source: Marklund (1988) Report 45, function G-26, printed p54. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G27(*, diameter_cm, site_index_pine_m, site_index_spruce_m, north_coordinate_100km) → float

Norway spruce stump dry weight (kg) — Marklund (1988) G-27.

Source: Marklund (1988) Report 45, function G-27, printed p54. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine) :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G28(*, diameter_cm) → float

Norway spruce roots >= 5 cm dry weight (kg) — Marklund (1988) G-28.

Source: Marklund (1988) Report 45, function G-28, printed p55. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G29(*, diameter_cm, site_index_pine_m, site_index_spruce_m) → float

Norway spruce roots >= 5 cm dry weight (kg) — Marklund (1988) G-29.

Source: Marklund (1988) Report 45, function G-29, printed p55. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine)

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G3(*, diameter_cm, height_m, age_bh_years, form_quotient3, form_quotient5) → float

Norway spruce stem over bark dry weight (kg) — Marklund (1988) G-3.

Source: Marklund (1988) Report 45, function G-3, printed p41. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years] :param form_quotient3: form quotient d3/d [-] (0 if d3 not measured) :param form_quotient5: form quotient d5/d [-] (0 if d5 not measured)

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G30(*, diameter_cm, height_m, age_bh_years, site_index_pine_m, site_index_spruce_m, moist_soil, peat_soil, lateral_water_long) → float

Norway spruce roots >= 5 cm dry weight (kg) — Marklund (1988) G-30.

Source: Marklund (1988) Report 45, function G-30, printed p56. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine) :param moist_soil: indicator 1 if moist/wet firm land FUKT_MARK else 0 :param peat_soil: indicator 1 if peat land TORV_MARK else 0 :param lateral_water_long: indicator 1 if long-period lateral water LANG_OVSI else 0

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G31(*, diameter_cm) → float

Norway spruce roots < 5 cm dry weight (kg) — Marklund (1988) G-31.

Source: Marklund (1988) Report 45, function G-31, printed p57. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G32(*, diameter_cm, site_index_pine_m, site_index_spruce_m) → float

Norway spruce roots < 5 cm dry weight (kg) — Marklund (1988) G-32.

Source: Marklund (1988) Report 45, function G-32, printed p57. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine)

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G33(*, diameter_cm, site_index_pine_m, site_index_spruce_m, moist_soil, peat_soil) → float

Norway spruce roots < 5 cm dry weight (kg) — Marklund (1988) G-33.

Source: Marklund (1988) Report 45, function G-33, printed p58. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine) :param moist_soil: indicator 1 if moist/wet firm land FUKT_MARK else 0 :param peat_soil: indicator 1 if peat land TORV_MARK else 0

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G4(*, diameter_cm) → float

Norway spruce stem wood dry weight (kg) — Marklund (1988) G-4.

Source: Marklund (1988) Report 45, function G-4, printed p42. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G5(*, diameter_cm, height_m) → float

Norway spruce stem wood dry weight (kg) — Marklund (1988) G-5.

Source: Marklund (1988) Report 45, function G-5, printed p42. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G6(*, diameter_cm, height_m, age_bh_years, form_quotient3, form_quotient5) → float

Norway spruce stem wood dry weight (kg) — Marklund (1988) G-6.

Source: Marklund (1988) Report 45, function G-6, printed p43. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years] :param form_quotient3: form quotient d3/d [-] (0 if d3 not measured) :param form_quotient5: form quotient d5/d [-] (0 if d5 not measured)

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G7(*, diameter_cm) → float

Norway spruce stem bark dry weight (kg) — Marklund (1988) G-7.

Source: Marklund (1988) Report 45, function G-7, printed p44. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G8(*, diameter_cm, height_m) → float

Norway spruce stem bark dry weight (kg) — Marklund (1988) G-8.

Source: Marklund (1988) Report 45, function G-8, printed p44. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_G9(*, diameter_cm, height_m, site_index_pine_m, site_index_spruce_m) → float

Norway spruce stem bark dry weight (kg) — Marklund (1988) G-9.

Source: Marklund (1988) Report 45, function G-9, printed p45. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine)

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T1(*, diameter_cm) → float

Scots pine stem over bark dry weight (kg) — Marklund (1988) T-1.

Source: Marklund (1988) Report 45, function T-1, printed p20. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T10(*, diameter_cm, height_m) → float

Scots pine stem bark dry weight (kg) — Marklund (1988) T-10.

Source: Marklund (1988) Report 45, function T-10, printed p24. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T11(*, diameter_cm, height_m, double_bark_mm) → float

Scots pine stem bark dry weight (kg) — Marklund (1988) T-11.

Source: Marklund (1988) Report 45, function T-11, printed p25. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T12(*, diameter_cm, height_m, double_bark_mm, crown_base_height_m) → float

Scots pine stem bark dry weight (kg) — Marklund (1988) T-12.

Source: Marklund (1988) Report 45, function T-12, printed p25. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm] :param crown_base_height_m: green crown base height krg [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T13(*, diameter_cm) → float

Scots pine living branches (incl. needles) dry weight (kg) — Marklund (1988) T-13.

Source: Marklund (1988) Report 45, function T-13, printed p26. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T14(*, diameter_cm, height_m) → float

Scots pine living branches (incl. needles) dry weight (kg) — Marklund (1988) T-14.

Source: Marklund (1988) Report 45, function T-14, printed p26. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T15(*, diameter_cm, height_m, crown_base_height_m, north_coordinate_100km) → float

Scots pine living branches (incl. needles) dry weight (kg) — Marklund (1988) T-15.

Source: Marklund (1988) Report 45, function T-15, printed p27. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param crown_base_height_m: green crown base height krg [m] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T16(*, diameter_cm, height_m, age_bh_years, crown_base_height_m, crown_radius_m, diameter_increment_5yr_mm) → float

Scots pine living branches (incl. needles) dry weight (kg) — Marklund (1988) T-16.

Source: Marklund (1988) Report 45, function T-16, printed p27. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years] :param crown_base_height_m: green crown base height krg [m] :param crown_radius_m: crown radius kr [m] :param diameter_increment_5yr_mm: last-5-year diameter increment i5 [mm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T17(*, diameter_cm) → float

Scots pine needles dry weight (kg) — Marklund (1988) T-17.

Source: Marklund (1988) Report 45, function T-17, printed p28. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T18(*, diameter_cm, height_m) → float

Scots pine needles dry weight (kg) — Marklund (1988) T-18.

Source: Marklund (1988) Report 45, function T-18, printed p28. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T19(*, diameter_cm, height_m, crown_base_height_m, north_coordinate_100km) → float

Scots pine needles dry weight (kg) — Marklund (1988) T-19.

Source: Marklund (1988) Report 45, function T-19, printed p29. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param crown_base_height_m: green crown base height krg [m] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T2(*, diameter_cm, height_m) → float

Scots pine stem over bark dry weight (kg) — Marklund (1988) T-2.

Source: Marklund (1988) Report 45, function T-2, printed p20. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T20(*, diameter_cm, height_m, age_bh_years, crown_base_height_m, crown_radius_m, diameter_increment_5yr_mm, altitude_km) → float

Scots pine needles dry weight (kg) — Marklund (1988) T-20.

Source: Marklund (1988) Report 45, function T-20, printed p29. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years] :param crown_base_height_m: green crown base height krg [m] :param crown_radius_m: crown radius kr [m] :param diameter_increment_5yr_mm: last-5-year diameter increment i5 [mm] :param altitude_km: altitude above sea level [km]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T21(*, diameter_cm) → float

Scots pine dead branches dry weight (kg) — Marklund (1988) T-21.

Source: Marklund (1988) Report 45, function T-21, printed p30. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T22(*, diameter_cm, height_m) → float

Scots pine dead branches dry weight (kg) — Marklund (1988) T-22.

Source: Marklund (1988) Report 45, function T-22, printed p30. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T23(*, diameter_cm, height_m, north_coordinate_100km, altitude_km) → float

Scots pine dead branches dry weight (kg) — Marklund (1988) T-23.

Source: Marklund (1988) Report 45, function T-23, printed p31. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000] :param altitude_km: altitude above sea level [km]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T24(*, diameter_cm, height_m, age_bh_years, diameter_increment_5yr_mm, max_diameter_cm, north_coordinate_100km, altitude_km) → float

Scots pine dead branches dry weight (kg) — Marklund (1988) T-24.

Source: Marklund (1988) Report 45, function T-24, printed p31. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param age_bh_years: age at breast height [years] :param diameter_increment_5yr_mm: last-5-year diameter increment i5 [mm] :param max_diameter_cm: diameter of thickest tree on a 10 m radius plot D_max [cm] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000] :param altitude_km: altitude above sea level [km]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T25(*, diameter_cm) → float

Scots pine stump-root system dry weight (kg) — Marklund (1988) T-25.

Source: Marklund (1988) Report 45, function T-25, printed p32. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T26(*, diameter_cm, site_index_pine_m, site_index_spruce_m, north_coordinate_100km) → float

Scots pine stump-root system dry weight (kg) — Marklund (1988) T-26.

Source: Marklund (1988) Report 45, function T-26, printed p32. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine) :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T27(*, diameter_cm, age_bh_years, site_index_pine_m, site_index_spruce_m, altitude_km, dry_soil, moist_soil, peat_soil, lateral_water_long, lateral_water_short) → float

Scots pine stump-root system dry weight (kg) — Marklund (1988) T-27.

Source: Marklund (1988) Report 45, function T-27, printed p33. :param diameter_cm: diameter over bark at breast height [cm] :param age_bh_years: age at breast height [years] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine) :param altitude_km: altitude above sea level [km] :param dry_soil: indicator 1 if dry firm land TORR_MARK else 0 :param moist_soil: indicator 1 if moist/wet firm land FUKT_MARK else 0 :param peat_soil: indicator 1 if peat land TORV_MARK else 0 :param lateral_water_long: indicator 1 if long-period lateral water LANG_OVSI else 0 :param lateral_water_short: indicator 1 if short-period lateral water KORT_OVSI else 0

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T28(*, diameter_cm) → float

Scots pine stump dry weight (kg) — Marklund (1988) T-28.

Source: Marklund (1988) Report 45, function T-28, printed p34. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T29(*, diameter_cm, age_bh_years, north_coordinate_100km) → float

Scots pine stump dry weight (kg) — Marklund (1988) T-29.

Source: Marklund (1988) Report 45, function T-29, printed p34. :param diameter_cm: diameter over bark at breast height [cm] :param age_bh_years: age at breast height [years] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T3(*, diameter_cm, height_m, double_bark_mm, age_bh_years) → float

Scots pine stem over bark dry weight (kg) — Marklund (1988) T-3.

Source: Marklund (1988) Report 45, function T-3, printed p21. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm] :param age_bh_years: age at breast height [years]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T30(*, diameter_cm, age_bh_years, north_coordinate_100km, altitude_km, dry_soil, moist_soil, peat_soil, lateral_water_any) → float

Scots pine stump dry weight (kg) — Marklund (1988) T-30.

Source: Marklund (1988) Report 45, function T-30, printed p35. :param diameter_cm: diameter over bark at breast height [cm] :param age_bh_years: age at breast height [years] :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000] :param altitude_km: altitude above sea level [km] :param dry_soil: indicator 1 if dry firm land TORR_MARK else 0 :param moist_soil: indicator 1 if moist/wet firm land FUKT_MARK else 0 :param peat_soil: indicator 1 if peat land TORV_MARK else 0 :param lateral_water_any: indicator 1 if any-period lateral water OVSI else 0

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T31(*, diameter_cm) → float

Scots pine roots >= 5 cm dry weight (kg) — Marklund (1988) T-31.

Source: Marklund (1988) Report 45, function T-31, printed p36. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T32(*, diameter_cm, site_index_pine_m, site_index_spruce_m, north_coordinate_100km) → float

Scots pine roots >= 5 cm dry weight (kg) — Marklund (1988) T-32.

Source: Marklund (1988) Report 45, function T-32, printed p36. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine) :param north_coordinate_100km: RT90 north coordinate NKO [100 km units = northing_m/100000]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T33(*, diameter_cm, site_index_pine_m, site_index_spruce_m, altitude_km, dry_soil, moist_soil, peat_soil) → float

Scots pine roots >= 5 cm dry weight (kg) — Marklund (1988) T-33.

Source: Marklund (1988) Report 45, function T-33, printed p37. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine) :param altitude_km: altitude above sea level [km] :param dry_soil: indicator 1 if dry firm land TORR_MARK else 0 :param moist_soil: indicator 1 if moist/wet firm land FUKT_MARK else 0 :param peat_soil: indicator 1 if peat land TORV_MARK else 0

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T34(*, diameter_cm) → float

Scots pine roots < 5 cm dry weight (kg) — Marklund (1988) T-34.

Source: Marklund (1988) Report 45, function T-34, printed p38. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T35(*, diameter_cm, site_index_pine_m, site_index_spruce_m) → float

Scots pine roots < 5 cm dry weight (kg) — Marklund (1988) T-35.

Source: Marklund (1988) Report 45, function T-35, printed p38. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine)

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T36(*, diameter_cm, site_index_pine_m, site_index_spruce_m, altitude_km) → float

Scots pine roots < 5 cm dry weight (kg) — Marklund (1988) T-36.

Source: Marklund (1988) Report 45, function T-36, printed p39. :param diameter_cm: diameter over bark at breast height [cm] :param site_index_pine_m: site index H100 for pine SItall [m] (0 if site indexed by spruce) :param site_index_spruce_m: site index H100 for spruce SIgran [m] (0 if site indexed by pine) :param altitude_km: altitude above sea level [km]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T4(*, diameter_cm, height_m, double_bark_mm, age_bh_years, form_quotient3, form_quotient5, altitude_km) → float

Scots pine stem over bark dry weight (kg) — Marklund (1988) T-4.

Source: Marklund (1988) Report 45, function T-4, printed p21. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm] :param age_bh_years: age at breast height [years] :param form_quotient3: form quotient d3/d [-] (0 if d3 not measured) :param form_quotient5: form quotient d5/d [-] (0 if d5 not measured) :param altitude_km: altitude above sea level [km]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T5(*, diameter_cm) → float

Scots pine stem wood dry weight (kg) — Marklund (1988) T-5.

Source: Marklund (1988) Report 45, function T-5, printed p22. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T6(*, diameter_cm, height_m) → float

Scots pine stem wood dry weight (kg) — Marklund (1988) T-6.

Source: Marklund (1988) Report 45, function T-6, printed p22. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T7(*, diameter_cm, height_m, double_bark_mm, age_bh_years) → float

Scots pine stem wood dry weight (kg) — Marklund (1988) T-7.

Source: Marklund (1988) Report 45, function T-7, printed p23. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm] :param age_bh_years: age at breast height [years]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T8(*, diameter_cm, height_m, double_bark_mm, age_bh_years, form_quotient3, form_quotient5, altitude_km) → float

Scots pine stem wood dry weight (kg) — Marklund (1988) T-8.

Source: Marklund (1988) Report 45, function T-8, printed p23. :param diameter_cm: diameter over bark at breast height [cm] :param height_m: tree height [m] :param double_bark_mm: double bark thickness at breast height [mm] :param age_bh_years: age at breast height [years] :param form_quotient3: form quotient d3/d [-] (0 if d3 not measured) :param form_quotient5: form quotient d5/d [-] (0 if d5 not measured) :param altitude_km: altitude above sea level [km]

pyforestry.sweden.biomass.marklund_1988.Marklund_1988_T9(*, diameter_cm) → float

Scots pine stem bark dry weight (kg) — Marklund (1988) T-9.

Source: Marklund (1988) Report 45, function T-9, printed p24. :param diameter_cm: diameter over bark at breast height [cm]

pyforestry.sweden.biomass.petersson_1999 module

Above-ground biomass functions after Petersson (1999).

class pyforestry.sweden.biomass.petersson_1999.Petersson1999

Bases: object

Above-ground biomass models for common Swedish tree species.

The formulas implemented here originate from:

Petersson, H. (1999). Biomassafunktioner för trädfaktorer av tall, gran och björk i Sverige. Report 59, Dept. of Forest Resources and Geomatics, Swedish University of Agricultural Sciences.

static biomass(species: TreeName | str, diameter_cm: float | Diameter_cm, height_m: float, age_at_breast_height: float | AgeMeasurement, SI: SiteIndexValue | float, five_years_radial_increment_mm: float, peat: bool, latitude: float, longitude: float, altitude: float, dominant_species: TreeName | str | None = None) → dict

Calculate biomass for a given species.

Parameters:

• species – Tree species name or enum value.

• diameter_cm – Diameter at breast height in centimetres.

• height_m – Tree height in metres.

• age_at_breast_height – Age at breast height in years.

• SI – Site index for the stand. Numeric values require dominant_species.

• five_years_radial_increment_mm – Radial increment over five years in millimetres.

• peat – True if soil is peat (>30 cm deep).

• latitude – Latitude in decimal degrees.

• longitude – Longitude in decimal degrees.

• altitude – Altitude in metres above sea level.

• dominant_species – Species used when SI is numeric.

Returns:

Dry weight components in grams keyed by component name.

Return type:

dict

Raises:

• TypeError – If species is not a valid tree species.

• ValueError – If the species is not supported.

static birch(diameter_cm: float | Diameter_cm, height_m: float, age_at_breast_height: float | AgeMeasurement, SI: SiteIndexValue | float, five_years_radial_increment_mm: float, peat: bool, latitude: float, longitude: float, altitude: float, dominant_species: TreeName | str | None = None) → dict

Biomass components for birch (Betula spp.).

Parameters:

• diameter_cm – Diameter at breast height in centimetres. If a Diameter_cm instance is supplied it must refer to a 1.3 m over-bark measurement.

• height_m – Tree height in metres.

• age_at_breast_height – Age at breast height in years.

• SI – Site index for the stand. Numeric values require dominant_species.

• five_years_radial_increment_mm – Radial increment over five years in millimetres.

• peat – True if soil is peat (>30 cm deep).

• latitude – Latitude in decimal degrees.

• longitude – Longitude in decimal degrees.

• altitude – Altitude in metres above sea level.

• dominant_species – Species used for SI when SI is numeric.

Returns:

Dry weight components in grams keyed by component name.

Return type:

dict

static pine(diameter_cm: float | Diameter_cm, height_m: float, age_at_breast_height: float | AgeMeasurement, SI: SiteIndexValue | float, five_years_radial_increment_mm: float, peat: bool, latitude: float, longitude: float, altitude: float, dominant_species: TreeName | str | None = None) → dict

Biomass components for a Scots pine.

Parameters:

• diameter_cm – Diameter at breast height in centimetres. Diameter_cm must describe a 1.3 m, over-bark measurement when used.

• height_m – Tree height in metres.

• age_at_breast_height – Age at breast height in years.

• SI – Site index of the stand. When numeric, dominant_species must define pine or spruce.

• five_years_radial_increment_mm – Radial increment over five years in millimetres.

• peat – True if soil is peat (>30 cm deep).

• latitude – Latitude in decimal degrees.

• longitude – Longitude in decimal degrees.

• altitude – Altitude in metres above sea level.

• dominant_species – Species used for SI when SI is numeric.

Returns:

Dry weight components in grams keyed by component name.

Return type:

dict

static spruce(diameter_cm: float | Diameter_cm, height_m: float, age_at_breast_height: float | AgeMeasurement, SI: SiteIndexValue | float, five_years_radial_increment_mm: float, peat: bool, latitude: float, longitude: float, altitude: float, dominant_species: TreeName | str | None = None) → dict

Biomass components for a Norway spruce.

Parameters:

• diameter_cm – Diameter at breast height in centimetres. If Diameter_cm is given, it must represent 1.3 m measurement height and be taken over bark.

• height_m – Tree height in metres.

• age_at_breast_height – Age at breast height in years.

• SI – Site index for the stand. When numeric, dominant_species must specify pine or spruce.

• five_years_radial_increment_mm – Radial increment over five years in millimetres.

• peat – True if soil is peat (>30 cm deep).

• latitude – Latitude in decimal degrees.

• longitude – Longitude in decimal degrees.

• altitude – Altitude in metres above sea level.

• dominant_species – Species used for SI when SI is numeric.

Returns:

Dry weight components in grams keyed by component name.

Return type:

dict

pyforestry.sweden.biomass.petersson_stahl_2006 module

Below-ground biomass functions, Petersson & Ståhl (2006).

Source:

Petersson, H. & Ståhl, G. (2006). Functions for below-ground biomass of Pinus sylvestris, Picea abies, Betula pendula and Betula pubescens in Sweden. Scandinavian Journal of Forest Research 21(S7):84-93. doi:10.1080/14004080500486864

class pyforestry.sweden.biomass.petersson_stahl_2006.PeterssonStahl2006

Bases: object

Functions for below-ground biomass of birch, pine, and spruce in Sweden.

This class implements a series of allometric functions to calculate the below-ground biomass (stump and roots) for several common tree species in Sweden: Betula (birch), Pinus sylvestris (Scots pine), and Picea abies (Norway spruce).

The functions are based on the models developed by Petersson and Ståhl (2006). They allow for the estimation of biomass for roots with a diameter greater than or equal to 2 mm or 5 mm. For pine and spruce, more complex models are available that incorporate additional variables such as tree age, basal area, and soil conditions to improve accuracy.

The primary method, below_ground_biomass, provides a unified interface to access the appropriate model based on the provided parameters.

References

Petersson, H., & Ståhl, G. (2006). Functions for below-ground biomass of Pinus sylvestris, Picea abies, Betula pendula and Betula pubescens in Sweden. Scandinavian Journal of Forest Research, 21(sup7), 84-93. DOI: 10.1080/014004080500486864

static below_ground_biomass(species, root_detail, **kwargs)

Selects and evaluates the appropriate below-ground biomass function.

This method dynamically selects the correct biomass function based on the species and the desired root size detail. It attempts to find the most complex model that can be satisfied by the provided keyword arguments.

For instance, if all arguments for a _3 model (e.g., pine_root_5mm_3) are supplied, that model will be used. If not, it will fall back to the simpler _2 or _1 models.

Note

Diameter must be provided as diameter_cm in centimeters. It will be automatically converted to millimeters for the calculations.

Parameters:

• species (str) – The tree species. Must be one of ‘birch’, ‘pine’, or ‘spruce’.

• root_detail (int) – The minimum root diameter to include. Must be 2 or 5 (mm).

• **kwargs – Keyword arguments required by the specific biomass functions. Common arguments include: - diameter_cm (float): Tree diameter at breast height in cm. (Required) - age_at_breast_height (int): Age at breast height. - age_basal_area_weighted (float): Basal area weighted stand age. - basal_area (float): Stand basal area in m^2/ha. - crown_length (float): Crown length in meters. - dry_soil (int): 1 if soil is dry, 0 otherwise.

Returns:

The calculated below-ground biomass in kilograms (kg).

Return type:

float

Raises:

ValueError – If an invalid species or root_detail is given, or if the provided arguments do not match any available function for the selected species and root detail.

static birch_root_2mm(diameter_mm)

Calculates ln(biomass) for birch roots >= 2 mm.

Parameters:

diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static birch_root_5mm(diameter_mm)

Calculates ln(biomass) for birch roots >= 5 mm.

Parameters:

diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static pine_root_2mm_1(diameter_mm)

Calculates ln(biomass) for pine roots >= 2 mm using only diameter.

Parameters:

diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static pine_root_2mm_2(diameter_mm, age_at_breast_height)

Calculates ln(biomass) for pine roots >= 2 mm using diameter and age.

Parameters:

• diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

• age_at_breast_height (int) – Tree age at breast height in years.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static pine_root_2mm_3(diameter_mm, age_basal_area_weighted, dry_soil)

Calculates ln(biomass) for pine roots >= 2 mm with detailed parameters.

Parameters:

• diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

• age_basal_area_weighted (float) – Basal area weighted mean age of the stand.

• dry_soil (int) – Dummy variable for dry soil (1 if dry, 0 otherwise).

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static pine_root_5mm_1(diameter_mm)

Calculates ln(biomass) for pine roots >= 5 mm using only diameter.

Parameters:

diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static pine_root_5mm_2(diameter_mm, age_at_breast_height)

Calculates ln(biomass) for pine roots >= 5 mm using diameter and age.

Parameters:

• diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

• age_at_breast_height (int) – Tree age at breast height in years.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static pine_root_5mm_3(diameter_mm, age_basal_area_weighted, dry_soil)

Calculates ln(biomass) for pine roots >= 5 mm with detailed parameters.

Parameters:

• diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

• age_basal_area_weighted (float) – Basal area weighted mean age of the stand.

• dry_soil (int) – Dummy variable for dry soil (1 if dry, 0 otherwise).

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static spruce_root_2mm_1(diameter_mm)

Calculates ln(biomass) for spruce roots >= 2 mm using only diameter.

Parameters:

diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static spruce_root_2mm_2(diameter_mm, age_at_breast_height)

Calculates ln(biomass) for spruce roots >= 2 mm using diameter and age.

Parameters:

• diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

• age_at_breast_height (int) – Tree age at breast height in years.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static spruce_root_2mm_3(diameter_mm, age_basal_area_weighted, basal_area, crown_length, dry_soil)

Calculates ln(biomass) for spruce roots >= 2 mm with detailed parameters.

Parameters:

• diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

• age_basal_area_weighted (float) – Basal area weighted mean age of the stand.

• basal_area (float) – Stand basal area in m^2/ha.

• crown_length (float) – Length of the tree crown in meters.

• dry_soil (int) – Dummy variable for dry soil (1 if dry, 0 otherwise).

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static spruce_root_5mm_1(diameter_mm)

Calculates ln(biomass) for spruce roots >= 5 mm using only diameter.

Parameters:

diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static spruce_root_5mm_2(diameter_mm, age_at_breast_height)

Calculates ln(biomass) for spruce roots >= 5 mm using diameter and age.

Parameters:

• diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

• age_at_breast_height (int) – Tree age at breast height in years.

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

static spruce_root_5mm_3(diameter_mm, age_at_breast_height, basal_area, crown_length, dry_soil)

Calculates ln(biomass) for spruce roots >= 5 mm with detailed parameters.

Parameters:

• diameter_mm (float) – Tree diameter at breast height (1.3 m) in millimeters.

• age_at_breast_height (int) – Tree age at breast height in years.

• basal_area (float) – Stand basal area in m^2/ha.

• crown_length (float) – Length of the tree crown in meters.

• dry_soil (int) – Dummy variable for dry soil (1 if dry, 0 otherwise).

Returns:

The natural logarithm of below-ground biomass in grams.

Return type:

float

Module contents

Expose Swedish tree biomass models.