pointRes (version 2.0.2)

interval.trend: Calculate pointer years using the interval trend method

Description

The function calculates year-to-year growth changes for individual tree-ring series and defines interval trends for (the population of) trees using the pointer interval method according to Schweingruber et al. (1990), which is also extensively described in Jetschke et al. (2019). The minimum percentual growth change and the minimum percentage of trees that should display a negative (or positive) trend for that year to be considered as negative (or positive) pointer year, can be adjusted.

Usage

interval.trend(data, period = NULL, trend.thresh = 0, 
               IT.thresh = 95, make.plot = FALSE)

Value

The function returns a list containing the following components:

perc.diff

a matrix with percentual growth changes for individual tree-ring series

ITvalues

a matrix indicating positive (1), negative (0) and no interval trends (0.5) for individual tree-ring series

out

a data.frame containing the following columns: year - time stamp, nb.series - number of series considered, nature - number indicating whether the year is a positive (1), negative (-1) or no pointer year (0), and IT - mean overall interval trend

spec.param

a data.frame specifying the arguments used in the calculation

Arguments

data

a data.frame with tree-ring series (raw or detrended) as columns and years as rows (e.g., output of read.rwl of package dplR).

period

a vector specifying the start and end year of the analysis. Defaults to the full period covered by the data.

trend.thresh

a numeric specifying the threshold for a percentual growth change to be considered a trend. Defaults to 0.

IT.thresh

a numeric specifying the minimum percentage of trees that should display a negative (or positive) trend for that year to be considered as negative (or positive) pointer year. Defaults to 95.

make.plot

a logical specifying whether a line plot, showing mean annual interval-trend values, should be created. The plot highlights positive and negative pointer years with black triangles pointing up and down, respectively. Defaults to FALSE.

Author

Marieke van der Maaten-Theunissen, Ernst van der Maaten and Gottfried Jetschke.

Details

The function calculates year-to-year growth changes. For each tree and year, the interval trend is defined as 1 if a positive change exceeds trend.thresh, as 0 if a negative change falls below minus trend.thresh and as 0.5 if the absolute change is below trend.thresh. trend.thresh defaults to 0%. The interval trend for a population is defined as the average interval trend of the individual trees. A year is considered a negative (or positive) pointer year if the percentage of trees showing a decreasing (or increasing) trend exceeds IT.thresh (defaults to 95%). Hence, in case of a negative pointer year the mean overall interval trend falls below 1 - IT.thresh, for a positive pointer year the mean overall interval trend exceeds IT.thresh.

References

Jetschke, G., van der Maaten, E. and van der Maaten-Theunissen, M. (2019) Towards the extremes: a critical analysis of pointer year detection methods. Dendrochronologia 53: 55-62.

Schweingruber, F.H., Eckstein, D., Serre-Bachet, F. and Bräker, O.U. (1990) Identification, presentation and interpretation of event years and pointer years in dendrochronology. Dendrochronologia 8: 9-38.

Examples

## Calculate pointer years using interval.trend
## for a specified period and create a plot
data(s033)
IT <- interval.trend(s033, period = c(1950,2010), make.plot = TRUE)

## Calculate pointer years as years with at least 90% of the trees
## showing a positive/negative interval trend
data(s033)
IT <- interval.trend(s033, IT.thresh = 90)
IT$out[which(IT$out$nature == 1),"year"]
IT$out[which(IT$out$nature == -1),"year"]