This function calculates pointer years on a data.frame
of
ring-width series using the Becker algorithm. The pointer years are
computed with adjustable thresholds of relative radial growth
variation and number of series displaying similar growth pattern
(i.e. positive or negative variations).
pointer(rwl, rgv.thresh = 10, nseries.thresh = 75, round.decimals = 2)
data.frame
with ring-width series as columns and
years as rows such as that produced by read.rwl
. numeric
giving the minimum absolute
relative radial growth variation (in percentage) above which the
growth change from the year t-1 to t is considered as
significant. Must be > 0. Values > 100 are possible but highly
unusual. See references. Defaults to 10. numeric
giving the minimum percentage
of series displaying significant relative radial growth variations
of a same sign above which the year t
is considered as
a pointer year. Positive significant variations will results in a
positive pointer year, negative ones in a negative pointer year.
This number ranges from 1 to 100. Defaults to 75. integer
indicating the number of
decimal places to be used for outputs. This number must be
positive. Defaults to 2. data.frame
containing the following columns (each row
corresponds to one position of the window): This calculates pointer years from ring-width series for each year
t
of the time period covered by the series using the
Becker algorithm. This algorithm is based on, first, the calculation
of the individual relative radial growth variation by comparison of
ring-width of year t
to that of year t-1
for
each series, and second, the inter-series comparison of both sign and
magnitude of these variations.
For example, if rgv.thresh
and
nseries.thresh
are set at 10 and 75 respectively, pointer
years will be defined as those years when at least 75% of the series
present an absolute relative radial growth variation higher than 10%.
Users unfamiliar with the Becker algorithm should refer to Becker et
al. (1994) and Mérian and Lebourgeois (2011) for further
details.
Becker, M., Nieminen, T. M., and Gérémia, F. (1994) Short-term variations and long-term changes in oak productivity in northeastern France – the role of climate and atmospheric CO2. Annals of Forest Science, 51(5), 477–492.
Mérian, P. and Lebourgeois, F. (2011) Size-mediated climate–growth relationships in temperate forests: A multi-species analysis. Forest Ecology and Management, 261(8), 1382–1391.
skel.plot
library(utils)
data(gp.rwl)
py <- pointer(rwl=gp.rwl, rgv.thresh=10, nseries.thresh=75,
round.decimals=2)
tail(py)
Run the code above in your browser using DataLab