bootstrap_ELA: Energy landscape analysis with bootstrap resampled SA results

In ELAplus: Energy Landscape Analysis for Ecological Communities

Energy landscape analysis with bootstrap resampled SA results

Description

Running energy landscape analysis with bootstrap sampling of estimated saresults

Performs ELA and ELPruning using SA fitting results based on the bootstrap resampled occurrence and environmental data using bootstrap_SA.

Basically, representative ELA results with original occurrence and environmental data should be given by ela=ela, alternatively the function can select a representative parameter where commonly appearing stable states are most frequent.

The function computes bootstrap energy distributions for all stable states and tipping points appearing in the specified pruned landscape. Energies that are not present in a given trial are stored as NaN in the summary table.

Usage

bootstrap_ELA(
  bs_params,
  ocmat,
  ela = NULL,
  env = NULL,
  enmat = NULL,
  threads = 1,
  reporting = FALSE
)

Arguments

bs_params	output of bootstrap_SA. list of estimated parameters using bootstrap resampled data set.
ocmat	community composition matrix.
ela	representative ELA result (output of ELA). If NULL, the function returns the most representative one.
env	target environmental factor.
enmat	array of the vectors of environmental factors for each sample. Normalization required.
threads	number of cores (threads) used for calculation.
reporting	enable/disable the reporting function.

Value

A list with two elements: (1) representative pruned ELA result (stable states, energies, tipping points, tipping energies), (2) a data frame of bootstrap energies (rows = state IDs, columns = trials) with NaN for missing states.

ELAplus documentation built on May 28, 2026, 5:09 p.m.