boundaryFit: Fit multiple boundary lines.

In pavel-fibich/TRADER: Tree Ring Analysis of Disturbance Events in R

Fit multiple boundary lines.

Description

Fit multiple boundary lines, write their results and choose the best one.

Usage

boundaryFit(boundaries, x, y, boundary = NULL, 
  store = TRUE, storedev = pdf, initNLS = NULL, prefix = NULL)

Arguments

boundaries	Data frame with segments (x-axis) and tops(y-axis).
x	x coordinates of all priors.
y	y coordinates of all priors.
boundary	Own boundary line function of one argument, eg. boundary=function(x) {5.0067*exp(-0.664*x)}
prefix	Prefix of saved files.
store	If to save figures.
storedev	Format for saving the graphical outputs, eg. pdf or jpeg.
initNLS	Vector for initialization of start values for nls (set a,b,c,d for nls).

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

Return list object with

fun	Fitted function (boundary line).
rsq	R square of the fit.
bestModel	Best fitted model.

Note

Check reference.

Author(s)

Pavel Fibich <[e-mail]>, Jan Altman <[e-mail]>, Tuomas Aakala <[e-mail]>, Jiri Dolezal <[e-mail]>

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

boundaryGet, plotBoundary, nls

Examples

data(relData)
bo<-boundaryGet(relData1)
bofit<-boundaryFit(bo$bo,bo$x,bo$y)

 plotBoundary(bo$bo,bo$x,bo$y,boundary=bofit$fun,rsq=bofit$rsq) 
 plotBoundary(bo$bo,bo$x,bo$y,boundary=function(x) {5.0067*exp(-0.664*x)}) 

pavel-fibich/TRADER documentation built on Feb. 12, 2024, 1:27 a.m.