et_bontrans {et.nwfva}

Umrechnung von Bonitäten (Ertragsklasse und Oberhöhenbonitiät)

Description

Bestimmt für eine gegebene Baumart und Ausgangs-Bonität die Ziel-Bonität als relative Ertragsklasse oder absolute Oberhöhenbonität (Oberhöhe H100 im Alter 100 in Metern). Die Umrechnung basiert auf den in den neuen Ertragstafeln der NW-FVA (Albert et al. 2021) je Baumart und Ertragsklasse angegebenen Oberhöhen H100 im Alter 100, d.h. der dort gewählten Bonitätsstaffelung. Die Umrechnung erfolgt entweder über einen funktionalisierten Bonitätsfächer oder über Inter-/Extrapolation der Ertragstafeln mittels Dreisatz.

Usage

et_bontrans(art, bon, richtung = "abs_zu_rel", methode = "funktional")

Arguments

art

Baumartenbezeichnung entweder als Kürzel, deutscher Name, lateinischer Name oder in niedersächsischer Kodierung. Für vorhandene Arten siehe et_liste().

bon

Bonität als Zahl. Zulässig sind relative Ertragsklassen im Interval [-2,4] bzw. [-3,7] bei Methode "klassisch" bzw. "funktional" und absolute Bonitäten entsprechend. Welche Art der Ausgangs-Bonität hier übergeben wird bestimmt der Parameter richtung.

richtung

Umrechnung von absoluter Oberhöhenbonitäten zu relativer Ertragsklasse ("abs_zu_rel") oder umgkehrt ("rel_zu_abs"). Parameter kann gekürzt werden, solange er eindeutig bleibt.

methode

Die Umrechnung erfolgt über funktionalisierte Bonitätsfächer ("funktional") oder über Inter-/Extrapolation der Ertragstafeln mittels Dreisatz ("klassisch"). Parameter kann gekürzt werden, solange er eindeutig bleibt.

Value

Numerischer Vektor mit gesuchten Bonitäten, je nach richtung entweder absolute Oberhöhenbonitäten oder relative Ertragsklassen. Für Werte außerhalb des zulässigen Bonitätsintervalls wird NA ausgegeben.

Author(s)

Robert Nuske (klassisch), Kai Staupendahl (funktional)

References

Albert M., Nagel J., Schmidt M., Nagel R.-V., Spellmann H. (2021): Eine neue Generation von Ertragstafeln für Eiche, Buche, Fichte, Douglasie und Kiefer [Datensatz]. Version 1.0. Zenodo. https://doi.org/10.5281/zenodo.6343906

See Also

et_hoehe() zur Ermittlung der Bestandeshöhen und et_bonitaet() zur Bonitierung.

Examples

et_bontrans("Kiefer", bon=27)
et_bontrans("Kiefer", bon=27, richtung="abs_zu_rel", methode="klassisch")

arten <- c("fi", "fi", "bu", "dgl")
h100 <- c(34.5, 29.3, 36, 40)
et_bontrans(art=arten, bon=h100, richtung="abs_zu_rel")
et_bontrans(art=arten, bon=h100, richtung="abs_zu_rel", methode="klassisch")

et_bontrans("Kiefer", bon=1.5, richtung="rel_zu_abs", methode="funk")
et_bontrans("Kiefer", bon=1.5, richtung="rel_zu_abs", methode="klass")

arten <- c("fi", "fi", "bu", "dgl")
ertragsklassen <- c(2.5, 0.3, 1, 2.4)
et_bontrans(art=arten, bon=ertragsklassen, richtung="rel_zu", methode="funk")
et_bontrans(art=arten, bon=ertragsklassen, richtung="rel_zu", methode="klass")