read.ids {dplR} | R Documentation |
This function tried to read site, tree and core ids from a rwl
data.frame
.
read.ids(rwl, stc = c(3, 2, 3))
rwl |
a data.frame with series as columns and years as rows
such as that produced by read.rwl or ca533 |
stc |
a vector of three integers summing to eight. These indicate the number of chracters of to split the site code (stc[1]), the tree ids (stc[2]), and the core ids (stc[3]). Defaults to c(3, 2, 3). See details for further information. |
Because dendrochronologists often take more than one core per tree, it is occasionally useful to calculate within vs. between tree variance. The International Tree Ring Data Bank (ITRDB) allows the first eight characters in an rwl file for series ids but these are often shorter. Typically the creators of rwl files use a logical labeling method that can allow the user to determine the tree and core id from the label.
Argument stc tells how each series separate into site, tree, and core ids.
For instance a series code might be “ABC011” indicating site
“ABC”, tree 1, core 1. If this format is consistent then the stc mask
would be c(3,2,3) allowing up to three characters for the core id (i.e., pad
to the right). If it is not possible to divine the scheme (and often it is not
possible to machine read ids), then the output data.frame
can be built
manually. See below for format.
A data.frame
with column one named “tree” giving a numeric id
for each tree and column two named “core” giving a numeric id for
each core. The original series ids are copied from rwl as rownames.
Andy Bunn
data(ca533) read.ids(ca533,stc=c(3,2,3))