calcBFASTrec: Post-disturbance slope and recovery metrics derived from...

In RETURN-project/BenchmarkRecovery: Benchmark recovery indicators derived from remote sensing time series

Description

Post-disturbance slope and recovery metrics derived from BFAST0n trend segments. The calcBFASTrec function derives a set of recovery indicators after fitting a segmented trend in the time series. Using the breakpoints function of the strucchange package, a segmented trend is fitted (hereafter called BFAST0n trend segments). The detected break showing the largest change (in absolute values) is assumed to represent the disturbance. Using the segmented trend and detected disturbance date, the RRI, R80p, YrYr and the slope of the post-disturbance trend segment are derived as recovery indicators.

Usage

calcBFASTrec(tsio, obspyr, h, nPre, nDist, nPostMin, nPostMax, seas = F)

Arguments

tsio	vector of observations (time series)
obspyr	number of observations in one year
h	This parameter defines the minimal segment size either given as fraction relative to the sample size or as an integer giving the minimal number of observations in each segment.
nPre	number of years prior to the disturbance used to calculate the pre-disturbance value
nDist	number of months used to quantify the time series value during the disturbance
nPostMin	min number of years after the disturbance used to quantify the recovery
nPostMax	max number of years after the disturbance used to quantify the recovery
seas	TRUE or FALSE, include seasonal term when detecting breaks?
breaks	'BIC' or 'LWZ': criteria used to define the optimal number of breaks (desactivated)

Value

a list containing the RRI, R80p, YrYr recovery indicator derived from the BFAST0n trend segments and slope of the trend segment after the disturbance (sl).

RETURN-project/BenchmarkRecovery documentation built on July 13, 2021, 5:47 p.m.