read.tridas(fname, ids.from.titles = FALSE, ids.from.identifiers = TRUE, combine.series = TRUE, trim.whitespace = TRUE, warn.units = TRUE)character vector giving the file name of the
TRiDaS file. logical flag indicating whether to
override the (tree, core, radius, measurement) structure imposed by
the element hierarchy (element, sample, radius, measurementSeries)
of the file. If TRUE, measurement series will be rearranged
by matching titles in the file at the aforementioned four levels of
the hierarchy. Defaults to FALSE, i.e. the element hierarchy
of the file will be used. logical flag indicating whether to
(partially) override the element hierarchy of the file. If
TRUE, measurement series will be grouped according to
matching identifiers at the measurementSeries level, where
identifiers are available. The changes caused by this option are
applied on top of the structure imposed by the file or computed from
matching titles if ids.from.titles == TRUE. Defaults
to TRUE. logical flag indicating whether to
combine two or more measurement series with the same set of (tree,
core, radius, measurement) ID numbers. Each set of
combined measurement series will be represented by one column of a
resulting data.frame. Overlapping years of combined series do not
produce a warning. If several data points are available for a given
year, the function chooses one in a rather arbitrary manner. This
option can only have effect when ids.from.titles ||
ids.from.identifiers. logical flag indicating whether to
replace repeated white spaces in the text content of the file with
only one space. Defaults to TRUE, i.e. excess white space
will be trimmed from the text. logical flag indicating whether to warn
about unitless measurements and “strange” units. The
function expects measurements in units that can be converted to
millimetres. Defaults to TRUE: warnings will be given. For
example, density measurements will trigger warnings, which can be
disabled by setting this option to FALSE. data.frame or a list of data.frames with
the series in columns and the years as rows. Contains measurements
(data.frame. data.frame or a list of data.frames with columns
named "tree", "core", "radius", and
"measurement", together giving a unique numeric ID
for each column of the data.frame(s) in
measurements.If !combine.series && (ids.from.titles || ids.from.identifiers), some rows may be non-unique. data.frame or a list of data.frames with
columns named "tree", "core", "radius", and
"measurement", containing the data.frame(s) in measurements. data.frame or a list of data.frames
containing wood completeness information. Column names are a subset
of the following, almost self-explanatory set:
"pith.presence", "heartwood.presence",
"sapwood.presence",
"last.ring.presence", "last.ring.details",
"bark.presence",
"n.sapwood", "n.missing.heartwood",
"n.missing.sapwood",
"missing.heartwood.foundation",
"missing.sapwood.foundation",
"n.unmeasured.inner", "n.unmeasured.outer". character vector giving the unit of the
measurements. Length equals the number of data.frames in
measurements. numeric vector giving the project
ID, i.e. the position of the corresponding
data.frame in measurements. Length equals the
number of data.frames. character vector giving the title of the
project of each data.frame in measurements.
Length equals the number of data.frames. data.frame giving the site ID
(position of element(s) within a data.frame in measurements. May have
several columns to reflect the possibly nested
elements. data.frame giving the site
() title of each data.frame in
measurements. May have several columns to reflect the
possibly nested elements. data.frame showing the taxonomic name for each
data.frame in measurements. Contains some of
the following columns: "text", "lang",
"normal", "normalId", "normalStd". The first
two are a free-form name and its language, and the rest are related
to a normalized name. data.frame showing the measured variable of
each data.frame in measurements. Contains some
of the following columns: "text", "lang",
"normal", "normalId", "normalStd",
"normalTridas". The first two are a free-form name and its
language, and the rest are related to a normalized name. list of measurements with unknown years,
together with metadata. Elements are a subset of the following:numeric vector or a list of such vectors
containing measurement series character vector giving the unit of the
measurements. Length equals the number of measurement series in
undated$data data.frame with columns named "tree",
"core", "radius", and "measurement",
together giving a numeric ID for each measurement
series in undated$data. The rows are
guaranteed to be unique only when comparing measurement series
with the same project.id and site.id,
but not if ids.from.titles ||
ids.from.identifiers. data.frame with columns named
"tree", "core", "radius", and
"measurement", containing the undated$data numeric vector giving the project
ID of each measurement series in
undated$data character vector giving the project
title of each measurement series in
undated$data data.frame giving the site ID of
each measurement series in undated$data data.frame giving the site title of
each measurement series in undated$data data.frame containing the variable of
each measurement series in undated$data data.frame containing taxonomic names of
each measurement series in undated$data data.frame containing wood
completeness information of each measurement series in
undated$data list of calculated series of values, together
with metadata. Elements are a subset of the following:numeric vector or a list of such vectors
containing calculated series of values.list of data.frames, one for each
series in derived$data, giving links to the
measurements used to form the corresponding derived series.
Each data.frame has a subset of the following columns:
"idRef" (reference to a series in the same file),
"xLink" (URI), "identifier", and
"domain" (identifier and its domain, not necessarily in
the same file).numeric vector giving the project
ID of each derived series in
derived$datanumeric vector giving the ID (order
of appearance in the project) of each derived series in
derived$datacharacter vector giving the title of each
derived series in derived$datacharacter vector giving the project
title of each derived series in derived$datacharacter vector giving the unit of the
derived series. Length equals the number of series in
derived$data.character vector giving the
standardizing method of the derived series. Length equals the
number of series in derived$data.data.frame containing the variable of
each series in derived$datadata.frame containing the type of various
entities, and metadata related to each type element.
Contents are NA where the metadata is not applicable (e.g.,
no tree.id when the type element refers to a
project). Columns are a subset of the following:data.frame containing comments to various
entities, and metadata related to each comments element.
Contents are NA where the metadata is not applicable. Columns
are a subset of the following:data.frame containing identifiers of
various entities, and metadata related to each identifier
element. Contents are NA where the metadata is not
applicable. Columns are a subset of the following:list of remarks concerning individual measured
or derived values, with some of the following items:data.frame with the following columns:data.frame in
measurementsdata.framedata.framedata.frame with the following columns:undated$datadata.frame with the following columns:derived$datadata.frame or a list of
data.frames with one item per project. Each
data.frame contains information about the research
laboratories involved in the project. Columns are a subset of the
following:data.frame or a list of
data.frames with one item per project. Each
data.frame contains information about the systems in which
the research project is registered. Columns are the following:data.frame containing the altitude of
trees. Columns are the following:data.frame containing links to preferred
measurement series. Columns are a subset of the following:The Tree Ring Data Standard (TRiDaS) is described in Jansma et. al (2010). Information about the current version of the standard can be found from TRiDaS website.
The parameters used for rearranging (ids.from.titles,
ids.from.identifiers) and combining
(combine.series) measurement series only affect the four
lowest levels of document structure: element, sample, radius,
measurementSeries. Series are not reorganized or combined at the
upper structural levels (project, object).
TRiDaS – The Tree Ring Data Standard. http://www.tridas.org/.
read.rwl, read.tucson,
read.compact, read.fh,
write.tridas