read.ids: Read Site-Tree-Core Ids

Description

This function tries to read site, tree, and core ids from a rwl data.frame.

Usage

read.ids(rwl, stc = c(3, 2, 3))

Arguments

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.

Value

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.

Details

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.

Examples

Run this code

data(ca533)
  read.ids(ca533,stc=c(3,2,3))