pyforestry.sweden.height package#

Submodules#

pyforestry.sweden.height.nystrom_2000 module#

Nyström (2000) sapling height growth model (Table 4, Model M2).

Reference:

Nyström, K. (2000). Funktioner för att skatta höjdtillväxten i ungskog. Arbetsrapport 68. Inst. f skoglig resurshushållning och geomatik, SLU, Umeå.

pyforestry.sweden.height.nystrom_2000.sapling_height_growth_m(*, height_m: float, age_bh_years: float | AgeMeasurement, mean_height_m: float, total_height_sqr_m2_per_ha: float, total_height_sqr_std_m2_per_ha: float, temperature_sum: float, soil_moisture: SwedenSoilMoisture | None, field_layer: SwedenFieldLayer | None, damage_index: float = 0.0, edge_effect: float = 0.0, edge_effect_alt: float = 0.0, species: TreeName, period_years: float = 5.0) → float[source]#

Estimate sapling height growth (m) over period_years.

Source:

Nyström, K. (2000). Funktioner för att skatta höjdtillväxten i ungskog. Arbetsrapport 68. Inst. f skoglig resurshushållning och geomatik, SLU, Umeå.

Parameters:

  • height_m (float) – Current sapling height (m).

  • age_bh_years (float | AgeMeasurement) – Age at breast height (years). If an AgeMeasurement is provided, it must use Age.DBH. Negative numeric ages are treated as 1.0.

  • mean_height_m (float) – Mean height on plot (m).

  • total_height_sqr_m2_per_ha (float) – Sum of height^2 (m2/ha).

  • total_height_sqr_std_m2_per_ha (float) – Sum of height^2 for overstorey (m2/ha).

  • temperature_sum (float) – Temperature sum (degree-days; Odin 1983).

  • soil_moisture (Sweden.SoilMoistureEnum | None) – Soil moisture class.

  • field_layer (Sweden.FieldLayer | None) – Vegetation class used to derive rich/poor flags.

  • damage_index (float) – Damage indicator term from Nyström (2000); use 0.0 if unknown.

  • edge_effect (float) – Edge/border indicator term from Nyström (2000); use 0.0 if unknown.

  • edge_effect_alt (float) – Alternative edge term from Nyström (2000); use 0.0 if unknown.

  • species (TreeName) – Tree species.

  • period_years (float) – Growth period in years (default 5.0).

Returns:

Height growth over the period (m).

Return type:

float

Raises:

TypeError – If age_bh_years is not a float/int or AgeMeasurement with Age.DBH code.

Notes

The original model is calibrated for 5-year increments. Growth is scaled linearly when period_years differs from 5. damage_index, edge_effect and edge_effect_alt are retained as direct compatibility terms for the legacy Nyström (2000) implementation.

pyforestry.sweden.height.soderberg_1992 module#

Soderberg (1992) single-tree height models for Sweden.

Implements the height equations reported in:

Söderberg, U. (1992). Functions for forest management. Height, form height and bark thickness of individual trees. Report 52, SLU, Umeå.

Two variants are provided:

  • Stand-age (mean age) model.

  • Tree-age model.

pyforestry.sweden.height.soderberg_1992.soderberg_1992_height_stand_age_m(*, species: TreeName | str, diameter_cm: float, max_diameter_cm: float, mean_age_total_years: float, site_index_pine_m: float, latitude_deg: float, altitude_m: float, prop_pine: float, prop_spruce: float, prop_birch: float, part_of_sweden: str, near_coast: bool = False, south_east: bool = False, region5: bool = False, split_plot: bool = False) → float[source]#

Stand-age height model (m) from Söderberg (1992).

Parameters:

  • species (TreeName | str) – Tree species.

  • diameter_cm (float) – Diameter at breast height, cm.

  • max_diameter_cm (float) – Maximum diameter on plot, cm.

  • mean_age_total_years (float) – Mean total age (years).

  • site_index_pine_m (float) – Pine site index (H100), m.

  • latitude_deg (float) – Latitude, degrees.

  • altitude_m (float) – Altitude, m.

  • prop_pine (float) – Pine proportion of basal area (0..1).

  • prop_spruce (float) – Spruce proportion of basal area (0..1).

  • prop_birch (float) – Birch proportion of basal area (0..1).

  • part_of_sweden (str) – north, middle or south.

  • near_coast (bool) – Near-coast indicator (<50 km).

  • south_east (bool) – Southeast Sweden indicator.

  • region5 (bool) – Region 5 indicator.

  • split_plot (bool) – Split plot indicator.

Returns:

Tree height, m.

Return type:

float

pyforestry.sweden.height.soderberg_1992.soderberg_1992_height_tree_age_m(*, species: TreeName | str, diameter_cm: float, tree_age_bh_years: float, max_diameter_cm: float, stand_basal_area_m2_ha: float, dominant_species: TreeName | str, site_index_dominant_m: float, latitude_deg: float, altitude_m: float, prop_pine: float, prop_spruce: float, prop_birch: float, prop_beech: float = 0.0, part_of_sweden: str = 'south', maritime: bool = False, continental: bool = False, near_coast: bool = False, south_east: bool = False, region5: bool = False, split_plot: bool = False) → float[source]#

Tree-age height model (m) from Söderberg (1992).

Parameters:

  • species (TreeName | str) – Tree species.

  • diameter_cm (float) – Diameter at breast height, cm.

  • tree_age_bh_years (float) – Age at breast height, years.

  • max_diameter_cm (float) – Maximum diameter on plot, cm.

  • stand_basal_area_m2_ha (float) – Stand basal area, m²/ha (clamped to 80).

  • dominant_species (TreeName | str) – Dominant species for site index.

  • site_index_dominant_m (float) – Dominant site index (H100), m.

  • latitude_deg (float) – Latitude, degrees.

  • altitude_m (float) – Altitude, m.

  • prop_pine (float) – Pine proportion of basal area (0..1).

  • prop_spruce (float) – Spruce proportion of basal area (0..1).

  • prop_birch (float) – Birch proportion of basal area (0..1).

  • prop_beech (float) – Beech proportion of basal area (0..1).

  • part_of_sweden (str) – north, middle or south.

  • maritime (bool) – Maritime climate indicator.

  • continental (bool) – Continental climate indicator.

  • near_coast (bool) – Distance-to-coast < 50 km indicator.

  • south_east (bool) – Southeast Sweden indicator.

  • region5 (bool) – Region 5 indicator.

  • split_plot (bool) – Split plot indicator.

Returns:

Tree height, m.

Return type:

float

Module contents#

Swedish height equations and trajectory models.