flag_ranges: flag_ranges

In jf15558/FAU.JFS: What the Package Does (One Line, Title Case)

Description

Function to compare stratigraphic ranges in x to a set of reference ranges from y. A list of two elements is returned. The first is a dataframe summarising the overall error status, specific error counts FAD and LAD differences, and the 95% density distributions of the FAD and LAD errors for each unique taxon in the column of x denoted by the first element of xcols. If a taxon in x is not present in y, it is assigned the status 000 and its other entries in the returned dataframe will be NA. The second element of the returned list is the error code for every individual element of the column of x denoted by the first element of xcols - this will have the same number of rows as x. If x is a range table rather than an occurrence dataset, then the two list elements will have the same number of rows. Ranges for comparison may be supplied directly in y, or y may be another occurrence dataset, in which case

Usage

flag_ranges(
  x = NULL,
  y = NULL,
  xcols = c("genus", "max_ma", "min_ma"),
  ycols = NULL,
  verbose = TRUE
)

Arguments

x	Stratigraphic range data for taxa as a whole or for individual fossil occurrences
y	The same as in x. This is the dataset to which ranges will be compared
xcols	A character vector of length three specifying, in the following order, the taxonomic name, stratigraphic base (FAD) and stratigraphic top (LAD) columns in x.
ycols	An optional character vector of length three for the same column types as in xcols, but for dataset y. This is useful if the column names differ between the datasets
verbose	A logical of length one determining if the flagging progress should be reported to the console

Value

A list of two dataframes, the first recording overall error statistics, the second recording error types for each element of x

See Also

age_ranges is called internally to generate the range table for comparison.

jf15558/FAU.JFS documentation built on Jan. 21, 2022, 6:52 a.m.