# interval.trend: Calculate pointer years using the interval trend method In pointRes: Analyzing Pointer Years and Components of Resilience

 interval.trend R Documentation

## 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)
``````

### 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.

### 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`.

### 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

### Author(s)

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

### 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"]

``````

pointRes documentation built on May 4, 2023, 5:10 p.m.