RangeShiftR

The RangeShiftR package implements the RangeShifter simulation platform for R.

RangeShifter
is a state-of-the-art eco-evolutionary modelling platform that is becoming
increasingly used worldwide for both theoretical and applied purposes
(Bocedi et al. 2014).

RangeShifter is a spatially-explicit, individual-based simulation platform that
allows modelling species’ range dynamics, such as expansion and shifting, and
patch connectivity by linking complex local population dynamics and dispersal
behaviour, while also taking into account inter-individual variability and
evolutionary processes. RangeShifter is highly flexible in terms of the spatial
resolution and extent, and regarding the complexity of the considered ecological
processes. Due to its modular structure, the level of detail in demographic and
dispersal processes can be easily adapted to different research questions and
available data.

Installation

RangeShiftR is only available from this github repository.
(It may move to CRAN in the future.)

RangeShiftR has to be built from source and requires the package Rcpp as
well as a functional C++ compiler toolchain.

# Install RangeShiftR from GitHub:
devtools::install_github("RangeShifter/RangeShiftR-pkg", ref="main", subdir="RangeShiftR")

Usage and help

Please refer to our website for more information about RangeShifter simulation
platform. RangeShifter is accompanied by extensive documentation.

For getting acquainted with the software, we recommend to first read the manual to understand the conceptual underpinnings of RangeShifter.

Analogous to the RangeShifter GUI, we provide tutorials to learn the different features of RangeshiftR using example applications from Bocedi et al. (2014, 2021) and Malchow et al. (2021). These cover some of the main features of RangeShifter, and help becoming familiar with the software.

If you have any further question related to the general concepts and usage of RangeShifter, please browse earlier topics in the forum pages or add a new one. Often it is also helpful to review published studies using the RangeShifter modelling platform.

For technical questions related to the RangeShiftR package interface and which cannot be answered with the documentation provided above, please browse the issues section of this repository and open a new issues if required. We also offer technical support for the RangeShiftR package via mail (rangeshiftr@uni-potsdam.de) if you follow the guidelines of how to ask for help, e.g. guidelines given by StackOverflow:

Contributing

See Contributing guidelines

See also

• Compiled software and documentation
• RScore, source for RangeShifter's core code
• RangeShifter batch mode, source for the batch mode interface

Maintainer

• @JetteReeg

References

• Bocedi G, Palmer SCF, Pe’er G, Heikkinen RK, Matsinos YG, Watts K, Travis JMJ (2014).
  RangeShifter: A Platform for Modelling Spatial Eco-Evolutionary Dynamics and
  Species’ Responses to Environmental Changes. Methods in Ecology and Evolution 5: 388–96.

• Bocedi G, Palmer SCF, Malchow AK, Zurell D, Watts K, Travis JMJ (2021) RangeShifter 2.0: An extended and enhanced platform for modelling spatial eco-evolutionary dynamics and species’ responses to environmental changes. Ecography 44:1453-1462.

• Malchow AK, Bocedi G, Palmer SCF, Travis JMJ, Zurell D (2021) RangeShiftR: an R package for individual-based simulation of spatial eco-evolutionary dynamics and species’ responses to environmental change. Ecography 4: 1443-1452.