View source: R/pop.decline.fit.R
pop.decline.fit | R Documentation |
Fitting statistical models to the decline on the number of mature individuals across time "can be used to extrapolate population trends, so that a reduction of three generations can be calculated" (IUCN 2019). This function provide a comparison of five different models and returns the predictions of the model with best fit to data.
pop.decline.fit(
x = NULL,
models = "all",
project.years = NULL,
plot.fit = TRUE,
max.count = 50,
...
)
x |
a data frame containing in the first column a vector of (estimated) population size and in the second column a vector of years for which the population sizes is available |
models |
a vector containing the names of the statistical models to be fitted to species population data |
project.years |
a vector containing the years for which the number of mature individuals should be predicted using the best candidate statistical model |
plot.fit |
logical. Should the fit of the best model be plotted against the population data? |
max.count |
numerical. Maximum number of attempts to fit piece-wise models. Default to 50. |
... |
other parameters to be passed as arguments for
function |
The names of the columns of the data frame x
do not matter, as long as
population sizes are in the first column and years in the second.
By default, the function compares the fit of six statistical models to the population trends, namely: linear, quadratic, exponential, logistic, generalized logistic and piece-wise. But, as stated in IUCN (2019), the model used to do the predictions makes an important difference. So, model fit to data should not be the only or most important criteria to choose among models. Users should preferably choose one or two of the models based on the best available information of types of threat (i.e. patterns of exploitation or habitat loss), life history and ecology of the taxon being evaluated or any other processes that may contribute to population decline. See IUCN (2019) for more details on the assumptions of each model.
The linear and exponential patterns of decline are fully described in IUCN
(2019) and are easy to be described statistically through a model (see
Figure 4.2, pg. 33 of IUCN 2019). But IUCN (2019) also recognizes the
existence of more "complex patterns of decline". To describe more complex
patterns, pop.decline.fit
provides fits to logistic and piece-wise
patterns of decline. Despite the options of models provided by
pop.decline.fit
, depending on the numbers of observations or the
patterns of decline, many or none of the models may provide a good fit to
data. This reinforces the role of the user in choosing the more appropriate
pattern for the area or taxon considered.
For simplicity, the population size data provided is transformed into proportions using the maximum population estimate provided. Therefore, models are fitted to proportional data, but the projections are returned in proportions and in the original scale. As suggested in IUCN (2019), no model fit is performed if only two estimates of population size are provided.
Some more technical notes on model fitting and selection. Here, we use a quadratic model as an equivalent to the accelerating model described in IUCN (2019), but note that the quadratic model can generate non-realistic projections depending on the population data or on the years chosen for the projection (see example). Fitting piece-wise models can be unstable (model fitting is quite sensitive to the start parameters) and may take a while to converge; so, it should preferably be used when many years of population size data are available. For simplicity, only piece-wise models with up to 3 breaks and linear functions between breaks are provided. For time intervals > 80, the best model among the candidate models is chosen based on Akaike Information Criterion, or AIC; the corrected AIC or the AICc (Anderson and Burnham, 2004) is used for time intervals < 80.
Renato A. Ferreira de Lima & Gilles Dauby
D. Anderson and K. Burnham (2004). Model selection and multi-model inference. Second edition. Springer-Verlag, New York.
IUCN 2019. Guidelines for Using the IUCN Red List Categories and Criteria. Version 14. Standards and Petitions Committee. Downloadable from: http://www.iucnredlist.org/documents/RedListGuidelines.pdf.
## Creating vectors with the population data and time intervals
#(adapted from the IUCN 2019 workbook for Criterion A, available
#at: https://www.iucnredlist.org/resources/criterion-a)
pop = c(10000, 9100, 8200, 7500, 7000)
yrs = c(1970, 1975, 1980, 1985, 1990)
pop.data <- cbind.data.frame(pop.size = pop, years = yrs)
## Fitting data with different models and settings
# All models, without and with the plot of the model fit to data
pop.decline.fit(pop.data, plot.fit = FALSE)
pop.decline.fit(pop.data)
# Different model combinations
pop.decline.fit(pop.data, models = c("exponential","quadratic"))
pop.decline.fit(pop.data, models = c("quadratic", "exponential"))
# Projecting/interpolating population size estimates
pop.decline.fit(pop.data, models = "exponential", project.years = c(1960, 2005))
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.