rcites
An R package to access information from the Speciesplus database, a centralised portal to key information on species of global concern.
https://github.com/ropensci/rcites
Category: Biosphere
Sub Category: Terrestrial Wildlife
Keywords
api-client cites database endangered-species r r-package rstats trade
Keywords from Contributors
ecology rmarkdown weather-data blog computational-ecology biodiversity rcpp hugo openscience
Last synced: about 24 hours ago
JSON representation
Repository metadata
:package: R package to access the CITES Speciesplus database
- Host: GitHub
- URL: https://github.com/ropensci/rcites
- Owner: ropensci
- License: other
- Created: 2017-12-11T09:59:27.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2023-02-20T01:13:04.000Z (about 2 years ago)
- Last Synced: 2025-02-07T07:41:34.158Z (3 months ago)
- Topics: api-client, cites, database, endangered-species, r, r-package, rstats, trade
- Language: R
- Homepage: https://docs.ropensci.org/rcites
- Size: 4.75 MB
- Stars: 14
- Watchers: 7
- Forks: 6
- Open Issues: 1
- Releases: 4
-
Metadata Files:
- Readme: README.md
- Changelog: NEWS.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Codemeta: codemeta.json
README.md
rcites
An R package to access information from the Speciesplus database via the Speciesplus/CITES Checklist API. The package is available for download from CRAN (stable version) and Github (development version).
Please see the release paper for background information about the Convention on International Trade in Endangered Species of Wild Fauna and Flora (CITES), the Speciesplus database and basic information about the aim of the package.
Installation
The package can be installed from CRAN:
install.packages("rcites")
The development version can be installed via the remotes
📦
remotes::install_github("ropensci/rcites")
Setup requirements and use
To set up a connection to the CITES Speciesplus database, a personal authentication token is required. Please see the vignette for details how to get a token and how to set the token for package use: Get started with rcites
Additional information about specific use examples are provided for the
African bush elephant (Loxodonta africana).
The package usage for querying multiple species is described in another
vignette entitled 'Bulk analysis with rcites'.
Key features
Once the token is set, the package has five key features:
spp_taxonconcept()
: access the Speciesplus taxon concept and retrieve a taxon idspp_cites_legislation()
: access CITES legislation dataspp_eu_legislation()
: access EU legislation dataspp_distributions()
: access a taxon distribution dataspp_references()
: access a listing reference data
Prefix information
The package functions have three different prefixes:
set_
forset_token()
to initially set the API tokenspp_
for the key featuresrcites_
for helper functions that are called within the key features
Citation information
When citing, please refer to both the package citation and the release paper.
Contributors
-
Reviewers of the package:
-
Editor: Scott Chamberlain
-
Reporting issue(s):
- @FVFaleiro
- @eveskew
- @fleurhierink
- @wajra
Resources
Another package dealing with data from and about CITES, providing access to its
wildlife trade database: cites
While creating this package, we greatly benefited from:
-
taxize that inspired the structuring of this repository/package;
-
the
httr
vignette: Managing secrets, which is extremely helpful for packages dealing with API.
Code of Conduct
Please note that this project is released with a Contributor Code of Conduct.
By participating in this project you agree to abide by its terms.
Also, please read the Terms and Conditions of Use of Speciesplus Data:
https://speciesplus.net/terms-of-use.
Owner metadata
- Name: rOpenSci
- Login: ropensci
- Email: [email protected]
- Kind: organization
- Description:
- Website: https://ropensci.org/
- Location: Berkeley, CA
- Twitter: rOpenSci
- Company:
- Icon url: https://avatars.githubusercontent.com/u/1200269?v=4
- Repositories: 307
- Last ynced at: 2023-03-10T20:30:59.242Z
- Profile URL: https://github.com/ropensci
GitHub Events
Total
- Watch event: 1
Last Year
- Watch event: 1
Committers metadata
Last synced: 5 days ago
Total Commits: 448
Total Committers: 11
Avg Commits per committer: 40.727
Development Distribution Score (DDS): 0.587
Commits in past year: 0
Committers in past year: 0
Avg Commits per committer in past year: 0.0
Development Distribution Score (DDS) in past year: 0.0
Name | Commits | |
---|---|---|
Kevin Cazelles | k****e@u****a | 185 |
JonasGeschke | j****e@h****e | 176 |
Kevin Cazelles | k****z@p****m | 32 |
Nacho | n****o@a****r | 22 |
Yasmine-Verzelen | y****n@i****e | 12 |
Kevin Cazelles | k****s@i****o | 9 |
Marie-Bé | m****0@u****a | 4 |
Geschke | J****e@m****e | 4 |
Noam Ross | n****s@g****m | 2 |
Tamora James | t****1@s****k | 1 |
Jeroen Ooms | j****s@g****m | 1 |
Committer domains:
- sheffield.ac.uk: 1
- mfn-berlin.de: 1
- uottawa.ca: 1
- insileco.io: 1
- inbo.be: 1
- hotmail.de: 1
- uoguelph.ca: 1
Issue and Pull Request metadata
Last synced: 2 days ago
Total issues: 52
Total pull requests: 17
Average time to close issues: 3 months
Average time to close pull requests: 7 days
Total issue authors: 9
Total pull request authors: 3
Average comments per issue: 6.33
Average comments per pull request: 1.65
Merged pull request: 17
Bot issues: 0
Bot pull requests: 0
Past year issues: 0
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 0
Past year pull request authors: 0
Past year average comments per issue: 0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0
Top Issue Authors
- KevCaz (30)
- JonasGeschke (9)
- ibartomeus (7)
- wajra (1)
- maelle (1)
- FVFaleiro (1)
- noamross (1)
- fleurhierink (1)
- eveskew (1)
Top Pull Request Authors
- KevCaz (15)
- JonasGeschke (1)
- noamross (1)
Top Issue Labels
- enhancement (11)
- continuous integration (7)
- bug (6)
- question (3)
- web API related (1)
Top Pull Request Labels
- enhancement (1)
Package metadata
- Total packages: 1
-
Total downloads:
- cran: 252 last-month
- Total dependent packages: 0
- Total dependent repositories: 2
- Total versions: 6
- Total maintainers: 1
cran.r-project.org: rcites
R Interface to the Species+ Database
- Homepage: https://docs.ropensci.org/rcites/
- Documentation: http://cran.r-project.org/web/packages/rcites/rcites.pdf
- Licenses: MIT + file LICENSE
- Latest release: 1.3.0 (published about 2 years ago)
- Last Synced: 2025-04-25T02:01:39.351Z (2 days ago)
- Versions: 6
- Dependent Packages: 0
- Dependent Repositories: 2
- Downloads: 252 Last month
-
Rankings:
- Forks count: 9.635%
- Stargazers count: 15.098%
- Dependent repos count: 19.265%
- Average: 22.609%
- Dependent packages count: 28.751%
- Downloads: 40.298%
- Maintainers (1)
Dependencies
- actions/checkout v3 composite
- r-lib/actions/check-r-package v2 composite
- r-lib/actions/setup-pandoc v2 composite
- r-lib/actions/setup-r v2 composite
- r-lib/actions/setup-r-dependencies v2 composite
- R >= 3.1.0 depends
- cli * imports
- curl * imports
- httr * imports
- jsonlite * imports
- knitr * suggests
- rmarkdown * suggests
- rworldmap >= 1.3.6 suggests
- testthat * suggests
- tibble * suggests
- vcr >= 1.2.0 suggests
Score: 10.647209019059007