tridas.vocabulary {dplR}

Browse and Check Standard TRiDaS Vocabulary

Description

This function can be used to browse the TRiDaS vocabulary by category.

Usage

tridas.vocabulary(category = c("dating type", "measuring method",
                      "shape", "location type", "variable", "unit",
                      "remark", "dating suffix", "presence / absence",
                      "complex presence / absence", "certainty"),
                  idx = NA, term = NA, match.exact = FALSE)

Arguments

category

Vocabulary category as a character vector of length one. One of "dating type", "measuring method", "shape", "location type", "variable", "unit", "remark", "dating suffix", "presence / absence", "complex presence / absence", "certainty". Partial matches are allowed.

idx

A numeric vector. Index to the character vector containing the vocabulary of the given category.

term

A character vector. One or more (partial) terms to look for in the given category.

match.exact

A logical value. If TRUE, partial matching of term is not used. Defaults to FALSE.

Details

The Tree Ring Data Standard (TRiDaS) is described in Jansma et. al (2010).

The function has four usage modes:

1. When idx is given, returns item number idx in the given category. There may be several numbers in idx, in which case multiple items are returned.

2. When term contains one or more items and match.exact is TRUE, checks whether any of the terms is an exact match in the given category

3. When term contains one or more items and match.exact is FALSE, expands partial matches of the terms in the vocabulary of the given category

4. When only category is given, returns the complete vocabulary in the given category

Value

In mode 1

A character vector, same length as in idx

In mode 2

A logical value

In mode 3

A character vector, same length as in term

In mode 4

A character vector

Author(s)

Mikko Korpela

References

Jansma, E., Brewer, P. W., and Zandhuis, I. (2010) TRiDaS 1.1: The tree-ring data standard. Dendrochronologia, 28(2), 99–130.

See Also

read.tridas, write.tridas

Examples

## Show all entries in category "measuring method"
tridas.vocabulary(category = "measuring")

## Show item number one in category "complex presence / absence"
tridas.vocabulary(category = "complex", idx = 1)

## Check whether "half section" exists in category "shape"
tridas.vocabulary(category = "shape", term = "half section",
                  match.exact = TRUE)

## Return unabbreviated matches to several queries in category "remark"
tridas.vocabulary(category = "remark",
                  term = c("trauma", "fire", "diffuse"))