README.Rmd

originr
========

```{r echo=FALSE}
knitr::opts_chunk$set(
  warning = FALSE,
  message = FALSE,
  collapse = TRUE,
  comment = "#>"
)
```

[![cran checks](https://cranchecks.info/badges/worst/originr)](https://cranchecks.info/pkgs/originr)
[![R-check](https://github.com/ropensci/originr/workflows/R-check/badge.svg)](https://github.com/ropensci/originr/actions?query=workflow%3AR-check)
[![codecov.io](https://codecov.io/github/ropensci/originr/coverage.svg?branch=master)](https://codecov.io/github/ropensci/originr?branch=master)
[![rstudio mirror downloads](http://cranlogs.r-pkg.org/badges/originr)](https://github.com/r-hub/cranlogs.app)
[![cran version](http://www.r-pkg.org/badges/version/originr)](https://cran.r-project.org/package=originr)

Species Origin Data

Data sources:

* Encyclopedia of Life http://eol.org
* Flora Europaea http://rbg-web2.rbge.org.uk/FE/fe.html
* Global Invasive Species Database http://www.iucngisd.org/gisd
* Native Species Resolver http://bien.nceas.ucsb.edu/bien/tools/nsr/nsr-ws/
* Integrated Taxonomic Information Service http://www.itis.gov/
* Global Register of Introduced and Invasive Species http://www.griis.org/

## Install

Stable CRAN version

```{r eval=FALSE}
install.packages("originr")
```

Development version

```{r eval=FALSE}
remotes::install_github("ropensci/originr")
```

```{r}
library("originr")
```

## EOL invasive species datasets

Datasets included:

* `gisd100` - 100 of the World's Worst Invasive Alien Species
(Global Invasive Species Database) http://eol.org/collections/54500
* `gisd` - Global Invasive Species Database 2013 http://eol.org/collections/54983
* `isc` - Centre for Agriculture and Biosciences International Invasive Species
Compendium (ISC) http://eol.org/collections/55180
* `daisie` - Delivering Alien Invasive Species Inventories for Europe (DAISIE) Species
List http://eol.org/collections/55179
* `i3n` - IABIN Invasives Information Network (I3N) Species
http://eol.org/collections/55176
* `mineps` - Marine Invaders of the NE Pacific Species http://eol.org/collections/55331

An example using `mineps`

```{r}
eol(name='Ciona intestinalis', dataset='mineps')
```

## Native Species Resolver

```{r}
nsr("Pinus ponderosa", "United States")
```

## Global Invasive Species Database

```{r}
sp <- c("Carpobrotus edulis", "Rosmarinus officinalis")
gisd(sp)
```

## Flora Europaea

```{r}
flora_europaea("Lavandula stoechas")
```

## Meta

* Please [report any issues or bugs](https://github.com/ropensci/originr/issues).
* License: MIT
* Get citation information for `originr` in R doing `citation(package = 'originr')`
* Please note that this package is released with a [Contributor Code of Conduct](https://ropensci.org/code-of-conduct/). By contributing to this project, you agree to abide by its terms.