ForestElementsR (version 2.0.1)

as_fe_species_master: Cast Appropriate Objects Into a fe_stand_master Species Class Object

Description

If the cast is forward ambiguous, the function terminates with an error. "Forward ambiguous" means that one code in the original object corresponds to more than one codes in the goal coding. If the cast loses information, a warning is raised, but the cast is performed. "Information loss" in this context means that several codes from the orginal coding correspond to only one code in the goal coding.

Usage

as_fe_species_master(x)

Value

If a meaningful cast is possible, an fe_species_master object is returned

Arguments

x

The object to be cast, either a vector of types integer, double, or character or an object of one of the supported fe_species classes

Details

Note that a cast where only one species id from the original coding translates in a goal coding which represents a group of species is NOT considered losing information (i.e. backward ambiguous), because of the 1:1 match in the constellation of the specific cast.

Examples

as_fe_species_master(c("abies_001", "fagus_001")) # character

# cast other fe_species classes
as_fe_species_master(
  fe_species_tum_wwk_short(as.character(c(1, 1, 1, 3, 3, 5)))
)
as_fe_species_master(
  fe_species_ger_nfi_2012(as.character(c(20, 20, 10, 30, 30, 100)))
)
as_fe_species_master(
  fe_species_bavrn_state(as.character(c(10L, 40L, 40L, 20L)))
)
as_fe_species_master(
  fe_species_tum_wwk_long(as.character(c(10L, 30L, 88L, 87L)))
)

# display the casting result in terms of scientific species names
as_fe_species_master(c("abies_001", "fagus_001")) |> format("sci")