Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mlysy/nicherover

Niche Region and Niche Overlap Metrics for Multidimensional Ecological Niches
https://github.com/mlysy/nicherover

Last synced: 2 months ago
JSON representation

Niche Region and Niche Overlap Metrics for Multidimensional Ecological Niches

Awesome Lists containing this project

README

        

# nicheROVER: Niche Region and Niche Overlap Metrics for Multidimensional Ecological Niches

*Martin Lysy, Ashley Stasko, Heidi Swanson*

---

### Description

This **R** package uses a probabilistic method to calculate niche regions and pairwise niche overlap using multidimensional niche indicator data (e.g., stable isotopes, environmental variables, etc.). The niche region is defined as the joint probability density function of the multidimensional niche indicators at a user-defined probability alpha (e.g., 95%). Uncertainty is accounted for in a Bayesian framework, and the method can be extended to three or more indicator dimensions. It provides directional estimates of niche overlap, accounts for species-specific distributions in multivariate niche space, and produces unique and consistent bivariate projections of the multivariate niche region. The article by [Swanson et al. (Ecology, 2015)](https://esajournals.onlinelibrary.wiley.com/doi/full/10.1890/14-0235.1) provides a detailed description of the methodology. See the [package vignette](https://CRAN.R-project.org/package=nicheROVER/vignettes/ecol-vignette.html) for a worked example using fish stable isotope data.

### Installation

The CRAN version (1.1.2) is available [here](https://CRAN.R-project.org/package=nicheROVER).

For the GitHub development version, first install the **R** package [**`devtools`**](https://CRAN.R-project.org/package=devtools), then run
```{r}
devtools::install_github("mlysy/nicheROVER", ref = "master")
```

### Usage

A step-by-step walkthrough of a basic analysis is provided in the package [vignette](https://CRAN.R-project.org/package=nicheROVER/vignettes/ecol-vignette.html).

Find the basic `niche.plot()` and `niche.par.plot()` options a bit rigid? This [blog post](https://blog.benjaminhlina.com/posts/post-with-code/nicheROVER-ggplot/nicheROVER_ggplot.html) shows how to create equivalent plots from scratch using [**ggplot2**](https://ggplot2.tidyverse.org/), which can then be customized at will.