Munin.Biomass.sweden package¶
Submodules¶
Munin.Biomass.sweden.Marklund1988 module¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988(species: str | None = None, component: str | None = None, *args, timber: Timber | None = None, **kwargs)[source]¶
Calculates the dry-weight biomass for individual trees in Sweden.
This function serves as a wrapper for the various biomass component functions developed by Marklund (1988). It selects the appropriate formula based on the tree species and the provided arguments.
- Parameters:
species (str) – The tree species. Must be one of ‘Picea abies’ (Norway spruce), ‘Pinus sylvestris’ (Scots pine), or ‘Betula’ (Birch).
DBH (float) – Diameter at breast height (1.3m), in centimeters.
height_m (Optional[float]) – Total tree height, in meters. Required for more accurate models for stem, bark, and branches.
age_at_breast_height (Optional[float]) – The age of the tree at breast height (1.3m). Used for some pine foliage models.
crown_base_height_m (Optional[float]) – Height from the ground to the lowest green branch, in meters. Used for some foliage and branch models.
is_southern_sweden (Optional[bool]) – Set to True if the tree is in southern Sweden, False if in northern Sweden. Affects some spruce component calculations.
- Returns:
A dictionary where keys are the biomass components (e.g., ‘stem’, ‘bark’, ‘living_branches’, ‘dead_branches’, ‘stump’, ‘roots’) and values are their calculated dry weight in kilograms (kg). Components that cannot be calculated with the provided inputs will be omitted.
- Return type:
Dict[str, float]
- Raises:
ValueError – If the species is not one of the recognized types or if required arguments are missing for a selected calculation.
- Source:
Marklund, Lars-Gunnar. (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å. 73 pp. ISSN 0348-0496. ISBN 91-576-3524-2.
Examples
>>> # Calculate biomass for a Norway spruce with only DBH >>> Marklund_1988_biomass_Sweden(species='Picea abies', DBH=20) {'stem': 148.8, 'stump': 34.6, 'roots_1mm': 30.0}
>>> # Calculate biomass for a Scots pine with DBH and height >>> Marklund_1988_biomass_Sweden(species='Pinus sylvestris', DBH=25, height_m=18) {'stem': 234.1, 'bark': 30.5, 'living_branches': 45.2, 'dead_branches': 5.1, 'stump': 55.7, 'roots_1mm': 49.8}
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_B12(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_B15(diameter_cm, height_m, relative_bark_thickness)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_B3(diameter_cm, height_m, double_bark_mm, age)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_B6(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_B9(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_S12(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_S15(diameter_cm, height_m, relative_bark_thickness)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_S3(diameter_cm, height_m, double_bark_mm, age)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_S6(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_S9(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T11(diameter_cm, height_m, relative_bark_thickness)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T12(diameter_cm, height_m, crown_base_height_m, relative_bark_thickness)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T15(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T18(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T21(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T24(diameter_cm, height_m, crown_base_height_m)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T27(diameter_cm, height_m, relative_bark_thickness)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T3(diameter_cm, height_m, double_bark_mm, age)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T4(diameter_cm, height_m, double_bark_mm, age, form_quotient5=None, form_quotient3=None, altitude_m=None)[source]¶
- Munin.Biomass.sweden.Marklund1988.Marklund_1988_T7(diameter_cm, height_m, double_bark_mm, age)[source]¶
Munin.Biomass.sweden.Petersson_Stahl_2006 module¶
- class Munin.Biomass.sweden.Petersson_Stahl_2006.PeterssonStahl2006[source]¶
Bases:
objectFunctions 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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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)[source]¶
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