boundaryLineALL: Overal function for Black and Abrams 2003 method or "pure...

View source: R/trader.R

boundaryLineALLR Documentation

Overal function for Black and Abrams 2003 method or "pure boundary line".

Description

Boundary-line method scales the percent growth change of Nowacki & Abrams (1997).

Usage

boundaryLineALL(data, releases = NULL, m1 = 10, m2 = 10, boundary = NULL, 
  buffer = 2, criteria = 0.2, criteria2 = 0.5, segment = 0.5, 
  segment2 = 0.5, drawing = TRUE, gfun = mean, 
  length = 2, notop = 10, notop2 = 10, storedev = pdf, prefix = NULL, ...)

Arguments

data

A data.frame with series as columns and years as rows such as that produced by read.* function of dplR .

releases

Optional parameter usable for precomputed releases.

m1

Determines the number of years to be averaged (including target year) for period prior the potential releas.

m2

Determines the number of years to be averaged (including target year) for period prior the potential releas.

boundary

Boundary line function of one argument, eg. boundary=function(x) {5.0067*exp(-0.664*x)}

buffer

Number of years determining how close to one another two releases can be.

criteria

Threshold for detection of moderate release

criteria2

Threshold for detection of major release.

segment

Determines length of the segment on which prior growth will be divided

segment2

Determines length of the segment on which first mm of prior growth will be divided.

prefix

Prefix of saved files.

drawing

If TRUE, graphical outputs for individual trees.

gfun

Determines if M1 and M2 values are mean or median for selected period.

length

Determines how many years have to be given critera exceeded to be considered as release.

notop

Number of highest data points for fitting the boundary line.

notop2

Number of highest data points for fitting the boundary line in the segments for first mm.

storedev

Format for saving the graphical outputs, eg. pdf or jpeg.

...

Further arguments pasted to plot function.

Details

Boundary-line method scales the percent growth change of Nowacki & Abrams (1997) according to growth rate prior to disturbance. In their example, Black & Abrams (2003) defined moderate and major releases as those falling within 20-49.9%, and 50-100% of the boundary line, respectively. Advantage of the boundary-line is standardization, which takes into account the relationships among tree age, size, and canopy class determining radial growth rate (Black et al. 2004). On the downside, Black et al. (2009) suggest approximately 50000 ring width measurements is necessary for boundary line determination for a given species (Black et al. 2009).

Value

Write many tables and figures in the current directory.

Note

Check reference.

Author(s)

Pavel Fibich <pavel.fibich@prf.jcu.cz>, Jan Altman <altman.jan@gmail.com>, Tuomas Aakala <tuomas.aakala@helsinki.fi>, Jiri Dolezal <jiriddolezal@gmail.com>

References

Black, B.A. & Abrams, M.D. (2003) Use of boundary-line growth patterns as a basis for dendroecological release criteria. Ecological Applications, 13, 1733-1749.
Black, B.A., Abrams, M.D., Gagen, M., Daniels, L.D., Kipfmueller, K.F., Speer, J.H. & Anchukaitis, K.J. (2004) Development and application of boundary-line release criteria. Dendrochronologia, 22, 31-42.
Black, B.A., Abrams, M.D., Rentch, J.S. & Gould, P.J. (2009) Properties of boundary-line release criteria in North American tree species. Annals of Forest Science, 66.

See Also

noblabrams, doAll

Examples

data(relData)
boundaryLineALL(relData1)
 boundaryLineALL(relData1,length=3,buffer=4,storedev=pdf,
  boundary=function(x) {5.0067*exp(-0.664*x)} ) 

TRADER documentation built on May 29, 2024, 2:35 a.m.