R: Browse and Check Standard TRiDaS Vocabulary

tridas.vocabulary {dplR} | R Documentation

## 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"))

[Package dplR version 1.7.2 Index]