pyforestry.sweden.siteindex.translate package#

Submodules#

pyforestry.sweden.siteindex.translate.agestam_1985 module#

Utility functions translating site index between species.

pyforestry.sweden.siteindex.translate.agestam_1985.agestam_1985_si_translation_pine_to_birch(si_pine: float) → float[source]#

Translate SI H100 for Pine to Birch according to Hägglund (1974), from Agestam (1985).

This function converts the site index (SI) H100 for Pine to Birch, based on empirical relationships presented by Agestam (1985).

Parameters:

si_pine (float) – Site index (SI) H100 for Pine in meters.

Returns:

Site index (SI) H100 for Birch in meters.

Return type:

float

Reference:

Agestam, E. (1985). “A growth simulator for mixed stands of pine, spruce, and birch in Sweden.” Diss. Swedish University of Agricultural Sciences. Report no. 15. Dept. of Forest Yield Research. ISBN 91-576-2528-x. Garpenberg, Sweden; page 79.

pyforestry.sweden.siteindex.translate.agestam_1985.agestam_1985_si_translation_spruce_to_birch(si_spruce: float) → float[source]#

Translate SI H100 for Spruce to Birch according to Hägglund (1974), from Agestam (1985).

This function converts the site index (SI) H100 for Spruce to Birch, based on empirical relationships presented by Agestam (1985).

Parameters:

si_spruce (float) – Site index (SI) H100 for Spruce in meters.

Returns:

Site index (SI) H100 for Birch in meters.

Return type:

float

Reference:

Agestam, E. (1985). “A growth simulator for mixed stands of pine, spruce, and birch in Sweden.” Diss. Swedish University of Agricultural Sciences. Report no. 15. Dept. of Forest Yield Research. ISBN 91-576-2528-x. Garpenberg, Sweden; page 79.

pyforestry.sweden.siteindex.translate.hagglund_1981_si_to_productivity module#

Translate H100 site index values to expected productivity.

This module implements the smoothed equations from Hägglund (1981) to convert H100 estimates to mean annual volume growth at the time of culmination. The function hagglund_1981_si_to_productivity() is the public entry point and accepts enumerated inputs for vegetation type, county and tree species.

pyforestry.sweden.siteindex.translate.hagglund_1981_si_to_productivity.hagglund_1981_si_to_productivity(h100_input: SiteIndexValue, main_species: TreeName, vegetation: SwedenFieldLayer, altitude: float, county: SwedenCounty) → float[source]#

Calculate smoothed productivity estimates in m3sk (cu.m.) from Hägglund 1981.

Parameters:

  • h100_input (SiteIndexValue) – Estimated stand top height object. Must be H100, meaning reference_age equals 100.

  • main_species (TreeName) – Main species (e.g., TreeSpecies.Sweden.picea_abies).

  • vegetation (Sweden.FieldLayer) – Vegetation enum member.

  • altitude (float) – Altitude in meters above sea level.

  • county (Sweden.County) – Swedish county enum member.

Returns:

Mean volume growth in m3sk / ha yr-1 at the time of culmination.

Return type:

float

Raises:

  • ValueError – If h100_input.reference_age value is not 100, or if H100 value is not positive.

  • TypeError – If input types are incorrect.

pyforestry.sweden.siteindex.translate.jonson_index module#

Jonson site index mapping helpers.

Provides:

  • A mapping from m3sk productivity to Jonson index class (1-8).

  • A wrapper that validates H100 SiteIndexValue inputs and derives m3sk via Hagglund (1981) before mapping to Jonson index.

pyforestry.sweden.siteindex.translate.jonson_index.jonson_index_from_m3sk(site_index_m3sk: float) → int[source]#

Map site index (m3sk/ha) to Jonson index class (1..8).

Parameters:

site_index_m3sk (float) – Productivity in m3sk/ha at MAI culmination.

Returns:

Jonson index class (1..8), where 1 is highest productivity.

Return type:

int

pyforestry.sweden.siteindex.translate.jonson_index.jonson_index_from_site_index(h100_input: SiteIndexValue, *, main_species: TreeName, vegetation: SwedenFieldLayer, altitude: float, county: SwedenCounty) → int[source]#

Translate H100 to Jonson index using Hagglund 1981 productivity.

Parameters:

  • h100_input (SiteIndexValue) – H100 site index value.

  • main_species (TreeName) – Main species (pine or spruce).

  • vegetation (Sweden.FieldLayer) – Field layer vegetation enum.

  • altitude (float) – Altitude in meters above sea level.

  • county (Sweden.County) – Swedish county enum.

Returns:

Jonson index class (1..8).

Return type:

int

Raises:

  • TypeError – If any input type is invalid.

  • ValueError – If H100 is not valid or not from a supported function.

pyforestry.sweden.siteindex.translate.leijon_1979 module#

Site index translations between pine and spruce from Leijon (1979).

pyforestry.sweden.siteindex.translate.leijon_1979.leijon_pine_to_spruce(H100_Pine)[source]#

Leijon 1979 function 7.2.

pyforestry.sweden.siteindex.translate.leijon_1979.leijon_spruce_to_pine(H100_Spruce)[source]#

Leijon 1979 function 7.1.

Module contents#

Re-exports of translation functions for Swedish site index.