pyforestry.sweden.siteindex.sis package

Submodules

pyforestry.sweden.siteindex.sis.eko_2008 module

pyforestry.sweden.siteindex.sis.eko_2008.eko_pm_2008_estimate_si_birch(altitude: float, latitude: float, vegetation: SwedenFieldLayer, ground_layer: SwedenBottomLayer, lateral_water: SwedenSoilWater, soil_moisture: SwedenSoilMoisture) → SiteIndexValue[source]

Estimate SIH50 (Site Index for Birch H50) with stand factors based on Ekö et al. (2008).

This function calculates the Site Index for Birch based on altitude, latitude, vegetation, ground layer, lateral water presence, and soil moisture type. The model is derived from empirical relationships provided in Ekö et al. (2008).

Parameters:

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

  • latitude (float) – Latitude in degrees.

  • vegetation (SwedenFieldLayer) – Vegetation type.

  • ground_layer (SwedenBottomLayer) – Ground layer type.

  • lateral_water (SwedenSoilWater) – Degree of lateral water flow.

  • soil_moisture (SwedenSoilMoisture) – Soil moisture class.

Returns:

Site index (H50) for Birch.

Return type:

SiteIndexValue

Raises:

ValueError – If the soil moisture type is not “mesic” (2) or “moist” (4).

References

Ekö, P.-M., Johansson, U., Petersson, N., Bergqvist, J., Elfving, B., Frisk, J. (2008). Current growth differences of Norway spruce (Picea abies), Scots Pine (Pinus sylvestris) and birch (Betula pendula and Betula pubescens) in different regions in Sweden. Scandinavian Journal of Forest Research, Vol. 23:4, pp. 307-318. DOI: https://doi.org/10.1080/02827580802249126

pyforestry.sweden.siteindex.sis.hagglund_lundmark_1979 module

pyforestry.sweden.siteindex.sis.hagglund_lundmark_1979.Hagglund_Lundmark_1979_SIS(latitude: float, altitude: float, soil_moisture: int | Sweden.SoilMoistureEnum, ground_layer: int | Sweden.BottomLayer, vegetation: int | Sweden.FieldLayer, soil_texture: int | Sweden.SoilTextureTill | Sweden.SoilTextureSediment, climate_code: float | str | Sweden.ClimateZone, lateral_water: int | Sweden.SoilWater, soil_depth: int | Sweden.SoilDepth, incline_percent: float, aspect: float, ditched: bool = False, peat: bool = False, gotland: bool = False, coast: bool = False, limes_norrlandicus: bool = False, nfi_adjustments: bool = True, species: str = 'Picea abies', dlan: int | Sweden.County | None = None) → float[source]

Estimate Site Index H100 for Scots Pine or Norway Spruce in Sweden by stand factors.

Source: Corrected functions from Appendix II for estimation of site index by site factors according to Hägglund and Lundmark (1977), in Hägglund, B. (1979) Ett system för bonitering av skogsmark - analys, kontroll och diskussion inför praktisk tillämpning. Rapport 14, Projekt HUGIN. Skogsvetenskapliga fakulteten, Sveriges Lantbruksuniversitet. Umeå. Sweden.

Hägglund, B., Lundmark, J-E. (1977) Skattning av höjdboniteten med ståndortsfaktorer: Tall och gran i Sverige. Research Notes nr. 28. Dept. Forest Ecology & Forest Soils. Royal College of Forestry. Stockholm. Sweden.

Details: Uses corrected functions from appendix II in Hägglund & Lundmark 1979, except for when used on peat soils, in which case functions f. 8.1 & f. 8.2. pages 138-139 from Hägglund & Lundmark (1977) is used.

Parameters:

  • species (str) – One of “Picea abies” (default) or “Pinus sylvestris”.

  • vegetation (int | Sweden.FieldLayer) – Integer 1-18 or enum member.

  • ground_layer (int | Sweden.BottomLayer) – Integer 1-6 or enum member.

  • latitude (float) – Decimal WGS84.

  • altitude (float) – Meters above sea level.

  • aspect (int) – Main aspect of the site. int 0-360.

  • incline_percent (float) – Incline of slope, in percent. Default == 0.

  • soil_moisture (int | Sweden.SoilMoistureEnum) – Integer 1-5 or enum member. 1: Dry, 2: Mesic, 3: Mesic-Moist, 4: Moist, 5: Wet

  • soil_texture (int | Sweden.SoilTextureTill | Sweden.SoilTextureSediment) – Integer 1-9 or enum member.

  • soil_depth (int | Sweden.SoilDepth) – Integer 1-5 or enum member. 1: Deep >70 cm, 2: Rather shallow 20-70 cm, 3: Shallow < 20 cm, 4: Varying. 5: New nfi designation ‘häll’, en: ‘outcrop’.

  • lateral_water (int | Sweden.SoilWater) – Integer 1-3 or enum member. 1: Seldom/never, 2: Shorter periods, 3: Longer periods.

  • ditched (bool) – FALSE (default) if plot affected by ditching.

  • climate_code (str | Sweden.ClimateZone) – One of: NA (default), ‘M1’, ‘M2’, ‘K1’, ‘K2’, ‘K3’ or enum member.

  • coast (bool) – FALSE (default) if plot is closer to coast than 50km.

  • limes_norrlandicus (bool) – FALSE (default) if plot is north of Sernanders Limes Norrlandicus (used for Peat soils only.)

  • gotland (bool) – FALSE (default) if plot is located in Gotland.

  • nfi_adjustments (bool) – TRUE (default) if adjustments based on NFI should be applied. N.B. This applies coastal correction n. of Limes norrlandicus always.

  • dlan (int | Sweden.County) – Optional. None (default). 1-31 according to NFI ID.

Returns:

Site Index H100 (meters). Will return NA & issue a warning message if no method was found.

Return type:

float

pyforestry.sweden.siteindex.sis.hagglund_lundmark_1979.NFI_SIS_PINE(**kwargs) → float[source]

Estimate Site Index H100 for Pine in Sweden by stand factors.

Source: Corrected functions from Appendix II for estimation of site index by site factors according to Hägglund and Lundmark (1977), in Hägglund, B. (1979) Ett system för bonitering av skogsmark - analys, kontroll och diskussion inför praktisk tillämpning. Rapport 14, Projekt HUGIN. Skogsvetenskapliga fakulteten, Sveriges Lantbruksuniversitet. Umeå. Sweden.

Hägglund, B., Lundmark, J-E. (1977) Skattning av höjdboniteten med ståndortsfaktorer: Tall och gran i Sverige. Research Notes nr. 28. Dept. Forest Ecology & Forest Soils. Royal College of Forestry. Stockholm. Sweden.

Details: Uses corrected functions from appendix II in Hägglund & Lundmark 1979, except for when used on peat soils, in which case functions f. 8.1 & f. 8.2. pages 138-139 from Hägglund & Lundmark (1977) is used.

Parameters:

  • vegetation (int | Sweden.FieldLayer) – Integer 1-18 or enum member.

  • groundLayer (int | Sweden.BottomLayer) – Integer 1-6 or enum member.

  • latitude (float) – Decimal WGS84.

  • altitude (float) – Meters above sea level.

  • aspect (int) – Main aspect of the site. int 0-360.

  • incline_percent (float) – Incline of slope, in percent. Default == 0.

  • soil_moisture (int | Sweden.SoilMoistureEnum) – Integer 1-5 or enum member. 1: Dry, 2: Mesic, 3: Mesic-Moist, 4: Moist, 5: Wet

  • soil_texture (int | Sweden.SoilTextureTill | Sweden.SoilTextureSediment) – Integer 1-9 or enum member.

  • soil_depth (int | Sweden.SoilDepth) – Integer 1-5 or enum member. 1: Deep >70 cm, 2: Rather shallow 20-70 cm, 3: Shallow < 20 cm, 4: Varying. 5: New nfi designation ‘häll’, en: ‘outcrop’.

  • lateral_water (int | Sweden.SoilWater) – Integer 1-3 or enum member. 1: Seldom/never, 2: Shorter periods, 3: Longer periods.

  • ditched (bool) – FALSE (default) if plot affected by ditching.

  • climate_code (str | Sweden.ClimateZone) – One of: NA (default), ‘M1’, ‘M2’, ‘K1’, ‘K2’, ‘K3’ or enum member.

  • coast (bool) – FALSE (default) if plot is closer to coast than 50km.

  • limes_norrlandicus (bool) – FALSE (default) if plot is north of Sernanders Limes Norrlandicus (used for Peat soils only.)

  • gotland (bool) – FALSE (default) if plot is located in Gotland.

  • nfi_adjustments (bool) – TRUE (default) if adjustments based on NFI should be applied. N.B. This applies coastal correction n. of Limes norrlandicus always.

Returns:

Site Index H100 (meters). Will return NA & issue a warning message if no method was found.

Return type:

float

pyforestry.sweden.siteindex.sis.hagglund_lundmark_1979.NFI_SIS_SPRUCE(**kwargs) → float[source]

Estimate Site Index H100 for Spruce in Sweden by stand factors.

Source: Corrected functions from Appendix II for estimation of site index by site factors according to Hägglund and Lundmark (1977), in Hägglund, B. (1979) Ett system för bonitering av skogsmark - analys, kontroll och diskussion inför praktisk tillämpning. Rapport 14, Projekt HUGIN. Skogsvetenskapliga fakulteten, Sveriges Lantbruksuniversitet. Umeå. Sweden.

Hägglund, B., Lundmark, J-E. (1977) Skattning av höjdboniteten med ståndortsfaktorer: Tall och gran i Sverige. Research Notes nr. 28. Dept. Forest Ecology & Forest Soils. Royal College of Forestry. Stockholm. Sweden.

Details: Uses corrected functions from appendix II in Hägglund & Lundmark 1979, except for when used on peat soils, in which case functions f. 8.1 & f. 8.2. pages 138-139 from Hägglund & Lundmark (1977) is used.

Parameters:

  • vegetation (int | Sweden.FieldLayer) – Integer 1-18 or enum member.

  • groundLayer (int | Sweden.BottomLayer) – Integer 1-6 or enum member.

  • latitude (float) – Decimal WGS84.

  • altitude (float) – Meters above sea level.

  • aspect (int) – Main aspect of the site. int 0-360.

  • incline_percent (float) – Incline of slope, in percent. Default == 0.

  • soil_moisture (int | Sweden.SoilMoistureEnum) – Integer 1-5 or enum member. 1: Dry, 2: Mesic, 3: Mesic-Moist, 4: Moist, 5: Wet

  • soil_texture (int | Sweden.SoilTextureTill | Sweden.SoilTextureSediment) – Integer 1-9 or enum member.

  • soil_depth (int | Sweden.SoilDepth) – Integer 1-5 or enum member. 1: Deep >70 cm, 2: Rather shallow 20-70 cm, 3: Shallow < 20 cm, 4: Varying. 5: New nfi designation ‘häll’, en: ‘outcrop’.

  • lateral_water (int | Sweden.SoilWater) – Integer 1-3 or enum member. 1: Seldom/never, 2: Shorter periods, 3: Longer periods.

  • ditched (bool) – FALSE (default) if plot affected by ditching.

  • climate_code (str | Sweden.ClimateZone) – One of: NA (default), ‘M1’, ‘M2’, ‘K1’, ‘K2’, ‘K3’ or enum member.

  • coast (bool) – FALSE (default) if plot is closer to coast than 50km.

  • limes_norrlandicus (bool) – FALSE (default) if plot is north of Sernanders Limes Norrlandicus (used for Peat soils only.)

  • gotland (bool) – FALSE (default) if plot is located in Gotland.

  • nfi_adjustments (bool) – TRUE (default) if adjustments based on NFI should be applied. N.B. This applies coastal correction n. of Limes norrlandicus always.

  • dlan (int | Sweden.County) – Optional. None (default). 1-31 according to NFI ID.

Returns:

H100 site index estimate. Will return NA & issue a warning message if no method was found.

Return type:

SiteIndexValue

pyforestry.sweden.siteindex.sis.tegnhammar_1992 module

pyforestry.sweden.siteindex.sis.tegnhammar_1992.tegnhammar_1992_adjusted_si_spruce(sih, dominant_age, latitude)[source]

Tegnhammar’s correction for SI 1992.

Parameters:

  • sih (float) – Site index in metres.

  • dominant_age (float) – Arithmetic mean of the age at breast height of the dominant trees.

  • latitude (float) – Latitude in degrees.

Returns:

Adjusted SIH in metres.

Return type:

float

pyforestry.sweden.siteindex.sis.tegnhammar_1992.tegnhammar_1992_adjusted_spruce_si_by_stand_variables(latitude: float, longitude: float, altitude: float, vegetation: int | SwedenFieldLayer, ground_layer: int | SwedenBottomLayer, aspect_main: int, soil_moisture: int | SwedenSoilMoisture, soil_depth: int | SwedenSoilDepth, soil_texture: int | SwedenSoilTextureTill | SwedenSoilTextureSediment, humidity: float | None = None, ditched: bool = False, lateral_water: int | SwedenSoilWater = 1, peat_humification: int | SwedenPeatHumification = SwedenPeatHumification.MEDIUM, epsg: str = 'EPSG:4326') → SiteIndexValue[source]

Calculate Tegnhammar’s adjusted Site Index from stand variables.

Source: Tegnhammar, L. (1992). “Om skattningen av ståndortsindex för gran”. Report 53. Dept. of Forest Survey. Swedish University of Agricultural Sciences. Umeå.

Parameters:

  • latitude (float) – Decimal degrees. Default WGS84, see parameter epsg.

  • longitude (float) – Decimal degrees. Default WGS84, see parameter epsg.

  • altitude (float) – Metres above sea level.

  • vegetation (int | Sweden.FieldLayer) – Vegetation type.

  • ground_layer (int | Sweden.BottomLayer) – Ground layer type.

  • aspect_main (int) – Aspect code. Use 0 if slope is below 5%.

  • soil_moisture (int | Sweden.SoilMoistureEnum) – Soil moisture 1-5.

  • soil_depth (int | Sweden.SoilDepth) – Soil depth class.

  • ( (soil_texture) – int | Sweden.SoilTextureTill | Sweden.SoilTextureSediment

  • ) – Soil texture code.

  • humidity (float | None, optional) – Humidity during the vegetation period in mm. If None it will be calculated.

  • ditched (bool) – True if affected by ditching.

  • lateral_water (int | Sweden.SoilWater) – Water availability code.

  • peat_humification (int | Sweden.PeatHumification) – Peat decomposition level.

  • epsg (str) – Coordinate system (default is WGS84: "EPSG:4326").

Returns:

Tegnhammar’s adjusted SI in metres.

Return type:

SiteIndexValue

pyforestry.sweden.siteindex.sis.tegnhammar_1992_adjusted_spruce_si_by_stand_variables module

pyforestry.sweden.siteindex.sis.tegnhammar_1992_adjusted_spruce_si_by_stand_variables.tegnhammar_1992_adjusted_spruce_si_by_stand_variables(latitude: float, longitude: float, altitude: float, vegetation: int | Sweden.FieldLayer, ground_layer: int | Sweden.BottomLayer, aspect_main: int, soil_moisture: int | Sweden.SoilMoistureEnum, soil_depth: int | Sweden.SoilDepth, soil_texture: int | Sweden.SoilTextureTill | Sweden.SoilTextureSediment, humidity: float | None = None, ditched: bool = False, lateral_water: int | Sweden.SoilWater = 1, peat_humification: int | Sweden.PeatHumification = SwedenPeatHumification.MEDIUM, epsg: str = 'EPSG:4326') → SiteIndexValue[source]

Wrapper for pyforestry.sweden.siteindex.sis.tegnhammar_1992() using explicit Sweden enums.

Module contents