Calculates the degree synchrony in species abundances within a community over time. Includes the option for two different synchrony metrics. The first, developed by Loreau and de Mazancourt (2008), compares the variance of the aggregated community with the variance of individual components. The second, developed by Gross et al. (2014), compares the average correlation of each individual species with the rest of the aggregated community.
synchrony(
df,
time.var,
species.var,
abundance.var,
metric = "Loreau",
replicate.var = NA
)
A data frame containing time, species and abundance columns and an optional column of replicates
The name of the time column
The name of the species column
The name of the abundance column
The synchrony metric to return:
"Loreau": The default metric, calculates synchrony following Loreau and de Mazancourt (2008).
"Gross": Calculates synchrony following Gross et al. (2014).
The name of the optional replicate column
The synchrony
function returns a numeric synchrony value unless a replication column is specified in the input data frame.
If replication is specified, the function returns a data frame with the following attributes:
synchrony: A numeric column with the synchrony values.
replicate.var: A column that shares the same name and type as the replicate.var column in the input data frame.
The input data frame needs to contain columns for time, species and abundance; time.var, species.var and abundance.var are used to indicate which columns contain those variables. If multiple replicates are included in the data frame, that column should be specified with replicate.var. Each replicate should reflect a single experimental unit - there must be a single abundance value per species within each time point and replicate.
Gross, Kevin, Bradley J. Cardinale, Jeremy W. Fox, Andrew Gonzalez, Michel Loreau, H. Wayne Polley, Peter B. Reich, and Jasper van Ruijven. (2014) "Species richness and the temporal stability of biomass production: A new analysis of recent biodiversity experiments." The American Naturalist 183, no. 1: 1-12. doi:10.1086/673915.
Loreau, Michel, and Claire de Mazancourt. (2008) "Species synchrony and its drivers: Neutral and nonneutral community dynamics in fluctuating environments." The American Naturalist 172, no. 2: E48-66. doi:10.1086/589746.
# NOT RUN {
data(knz_001d)
synchrony(knz_001d[knz_001d$subplot=="A_1",],
time.var = "year",
species.var = "species",
abundance.var = "abundance") # for one subplot
# }
# NOT RUN {
synchrony(knz_001d,
time.var = "year",
species.var = "species",
abundance.var = "abundance",
replicate.var = "subplot") # across all subplots
synchrony(knz_001d,
time.var = "year",
species.var = "species",
abundance.var = "abundance",
replicate.var = "subplot",
metric="Gross") # With Gross et al. (2014) metric.
# }
Run the code above in your browser using DataLab