Skip to content

RangeShiftR-package with new structure using subtree for RS core files

License

Notifications You must be signed in to change notification settings

RangeShifter/RangeShiftR-pkg

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 ([email protected]) if you follow the guidelines of how to ask for help, e.g. guidelines given by StackOverflow:

Contributing

See Contributing guidelines

See also

Maintainer

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.