taxval: Handling of taxonomy in vegetation data.

taxvalR Documentation

Handling of taxonomy in vegetation data.

Description

Performs taxonomic valuation of species names according to synonomy, taxonomic level, unambiguous biotic content etc. Necessary prerequisite is information about taxonomic status (synonomy) and hierarchy (next higher aggregate). Until now only applicable for reference list 'GermanSL' (>= version 1.1, see References Section), which is valid in Germany and adjacent countries.

Usage

taxval(obs, refl, db, ag = c('conflict', 'adapt', 'preserve'), rank,
mono = c('species', 'higher', 'lower', 'preserve'), monolist = "monotypic-D",
maxtaxlevel = 'AGG', check.critical = TRUE, interactive = FALSE, ...)

Arguments

obs

data.frame of observations in TURBOVEG format, for example loaded with tv.obs

refl

Name of taxonomic reference list

db

a name of a Turboveg database directory containing tvabund.dbf, tvhabita.dbf and twin.set

ag

Treatment of children and parents within the dataset, see details

rank

If ag='adapt', rank specifies the taxonomic rank to which taxa should be coarsened to. All higher taxa in this taxonomic tree will be deleted, see maxtaxlevel.

mono

Should monotypic taxa be combined at subspecies = lower or species level = higher

monolist

Name of monotypic species list, must be in dBase format and in the same directory as the reference list, e.g. "monotypic-D" for the area of Germany.

maxtaxlevel

Maximum taxonomic levels to be used. See details.

check.critical

Check for critical names in your dataset and give warnings.'

interactive

Do you want to adapt the list of changes.

...

Other parameters passed to functions.

Details

Working with vegetation datasets, especially from different sources needs taxonomic valuation. The function tries to automate this process. Therefore the German taxonomic reference list (GermanSL, https://germansl.infinitenature.org ) contains additional taxon attributes (tax.dbf) and monotypic taxa of Germany (monotypic.dbf). Without an appropriate species list (see tax) the function will not work.

The taxonomic reference list needs Taxonrank corresponding to values given in taxlevels Possible values for adapting the taxonomic hierarchy within the dataset (child/parent taxa) are: preserve: Leave everything untouched. conflict: Dissolve only in case of conflicts, e.g. if a subspecies occurs also at the species level within the same dataset. In this case the subspecies will be aggregated to the higher level. adapt: Dissolve all nested taxa to e.g. species level for option ag. For this option also option rank, specifying the rank to which the taxa shall be adapted, must be given.

Monotypic taxa, e.g. a species which occur only with 1 subspecies in the survey area. They have to be combined, since otherwise two different (valid) taxa would denominate the same entity. If lower the higher taxon (e.g. species rank) is replaced by the lower level (subspecies rank). If neither lower nor higher monotypic species are preserved. Since the list of monotypic species strongly depends on the considered area you have to choose, which area is covered by your database and create an appropriate list of monotypic taxa. Within the package "monotypic-D.csv" is provided as a compilation of monotypic species within the GermanSL list.

Option maxtaxlevel determines the maximum taxonomic level within the given names, which should be used. All higher taxon observations are deleted. If you have a single field observation determined as Asteraceae spec. all your obervations of taxa from that family will be aggregated to the family level, if you choose ag=conflict.

Interactive If you want to manually adapt the taxonomic harmonization interactive=TRUE will create a table with all original names and NewTaxonID's according to the chosen rules. The table will be saved as taxvalDecisionTable.csv in your actual working directory. You can manipulate the column NewTaxonID. If you run taxval again (e.g. through function tv.veg) and a file with this name exist in your working directory, it will be used.

Value

Functions return the input dataframe of observations with harmonised taxon numbers.

Author(s)

Florian Jansen florian.jansen@uni-rostock.de

References

Jansen, F. and Dengler, J. (2008) GermanSL - eine universelle taxonomische Referenzliste f\"ur Vegetationsdatenbanken. Tuexenia, 28, 239-253. Jansen, F. and Dengler, J. (2010) Plant names in vegetation databases - a neglected source of bias. Journal of Vegetation Science, 21, 1179-1186.

See Also

tv.veg, tv.obs

Examples

## Not run: 
# Turboveg installation needed
 obs <- taxval(db='taxatest')
# For explanations see vignette('vegdata').

 veg <- tv.veg('taxatest')
 veg <- comb.species(veg, c('ARMEM-E','ARMEM-H'))

## End(Not run)


vegdata documentation built on May 29, 2024, 4:19 a.m.