Learn R Programming

iSTAY (version 1.0.0)

iSTAY-package: Information-based stability and synchrony measures.

Description

iSTAY (information-based stability and synchrony measures) is an R package that provides functions to compute a continuum of information-based measures for quantifying the temporal stability of populations, communities, and ecosystems, as well as their associated synchrony, based on species (or species assemblage) biomass or other key variables. When biodiversity data are available, the package also enables the assessment of the corresponding diversity–stability relationships. The information-based measures are derived from Hill numbers parameterized by an order q > 0; see Chao et al. (2025) for the theoretical and methodological background. All measures are illustrated using temporal biomass data from the Jena experiment (Roscher et al. 2004; Weisser et al. 2017; Wagg et al. 2022). See the iSTAY vignette for examples with output.

Specifically, iSTAY provides the following measures for three types of analyses:

(1) Single time series: computes stability measures of order q > 0 and displays the corresponding stability profile for a time series (or for each time series analyzed individually). The stability profile illustrates how stability varies with the order q. When biodiversity data are available, iSTAY also assesses the diversity–stability relationship across individual time series.

(2) Multiple time series: computes four measures--gamma, alpha, and beta stability, as well as synchrony--and displays the corresponding profiles for multiple time series (or for each set of time series within a collection). When biodiversity data are available, iSTAY also assesses the diversity–stability and diversity–synchrony relationships.

(3) Hierarchical Series: computes four measures--gamma, alpha, and beta stability, as well as synchrony--for each hierarchical level, and provides the corresponding stability and synchrony profiles.

This package contains five main functions:

1. iSTAY_Single calculates stability measures of order q > 0 for a single time series of biomass or other relevant variables.

2. iSTAY_Multiple computes gamma, alpha, and beta stability, as well as synchrony for multiple time series of biomass or other relevant variables.

3. iSTAY_Hier computes gamma, alpha, and beta stability, as well as synchrony, at each hierarchical level for time series of biomass or other variables.

4. ggiSTAY_qprofile plots the stability and synchrony profiles based on the output obtained from the functions iSTAY_Single, iSTAY_Multiple or iSTAY_Hier.

5. ggiSTAY_analysis plots the diversity–stability and diversity–synchrony relationships based on the output obtained from the function iSTAY_Single or iSTAY_Multiple.

Arguments

References

Chao, A., Colwell, R. K., Shia J., Thorn, S., Yang, M.-Y., Mitesser, O., et al. (2025) A continuum of information-based temporal stability measures and their decomposition across hierarchical level. BioRxiv < https://doi.org/10.1101/2025.08.20.671203>

Roscher C. Schumacher, J., Baade, J., Wilcke, W., Gleixner, G., Weisser, W. W. et al. (2004). The role of biodiversity for element cycling and trophic interactions: an experimental approach in a grassland community. Basic and Applied Ecology, 5, 107–121.

Wagg, C., Roscher, C., Weigelt, A., Vogel, A., Ebeling, A., De Luca, E. et al. (2022) Biodiversity–stability relationships strengthen over time in a long-term grassland experiment. Nature Communications, 13, 7752.

Weisser, W. W., Roscher, C., Meyer, S. T., Ebeling, A., Luo, G., Allan, E. et al. (2017). Biodiversity effects on ecosystem functioning in a 15-year grassland experiment: Patterns, mechanisms, and open questions. Basic and Applied Ecology, 23, 1–73.