taxval | R Documentation |
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.
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, ...)
obs |
data.frame of observations in TURBOVEG format, for example loaded with |
refl |
Name of taxonomic reference list |
db |
a name of a Turboveg database directory containing |
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. |
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. |
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.
Functions return the input dataframe of observations with harmonised taxon numbers.
Florian Jansen florian.jansen@uni-rostock.de
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.
tv.veg, tv.obs
## 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)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.