rcites

rcites: An R package to access the CITES Speciesplus database - Published in JOSS (2018)

https://github.com/ropensci/rcites

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 8 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org, zenodo.org
  • Committers with academic emails
    1 of 11 committers (9.1%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords

api-client cites database endangered-species r r-package rstats trade

Keywords from Contributors

weather-data
Last synced: 4 months ago · JSON representation

Repository

:package: R package to access the CITES Speciesplus database

Basic Info
Statistics
  • Stars: 14
  • Watchers: 6
  • Forks: 6
  • Open Issues: 1
  • Releases: 4
Topics
api-client cites database endangered-species r r-package rstats trade
Created about 8 years ago · Last pushed almost 3 years ago
Metadata Files
Readme Changelog Contributing License Codemeta

README.md

rcites

R CMD Check codecov status Project Status: Active – The project has reached a stable, usable state and is being actively developed. ROpenSci status CRAN status CRAN downloads Zenodo DOI JOSS DOI

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:

R install.packages("rcites")

The development version can be installed via the remotes :package:

R 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:

Prefix information

The package functions have three different prefixes:

  • set_ for set_token() to initially set the API token
  • spp_ for the key features
  • rcites_ 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

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:

  1. taxize that inspired the structuring of this repository/package;

  2. 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.

ropensci_footer

Owner

  • Name: rOpenSci
  • Login: ropensci
  • Kind: organization
  • Email: info@ropensci.org
  • Location: Berkeley, CA

JOSS Publication

rcites: An R package to access the CITES Speciesplus database
Published
November 20, 2018
Volume 3, Issue 31, Page 1091
Authors
Jonas Geschke ORCID
Museum für Naturkunde Berlin - Leibniz Institute for Research on Evolution and Biodiversity, Berlin, Germany
Kevin Cazelles ORCID
Department of Integrative Biology, University Of Guelph, Guelph, Ontario, Canada
Ignasi Bartomeus ORCID
Estación Biológica de Doñana (EBD-CSIC), Sevilla, Spain
Editor
Karthik Ram ORCID
Tags
CITES Speciesplus taxonomy endangered species illegal wildlife trade species legislation species distribution

CodeMeta (codemeta.json)

{
  "@context": "https://doi.org/10.5063/schema/codemeta-2.0",
  "@type": "SoftwareSourceCode",
  "identifier": "rcites",
  "description": "A programmatic interface to the Species+ <https://speciesplus.net/> database via the Species+/CITES Checklist API <https://api.speciesplus.net/>.",
  "name": "rcites: R Interface to the Species+ Database",
  "relatedLink": [
    "https://docs.ropensci.org/rcites/",
    "https://CRAN.R-project.org/package=rcites"
  ],
  "codeRepository": "https://github.com/ropensci/rcites",
  "issueTracker": "https://github.com/ropensci/rcites/issues",
  "license": "https://spdx.org/licenses/MIT",
  "version": "1.3.0.9000",
  "programmingLanguage": {
    "@type": "ComputerLanguage",
    "name": "R",
    "url": "https://r-project.org"
  },
  "runtimePlatform": "R version 4.2.2 Patched (2022-11-10 r83330)",
  "provider": {
    "@id": "https://cran.r-project.org",
    "@type": "Organization",
    "name": "Comprehensive R Archive Network (CRAN)",
    "url": "https://cran.r-project.org"
  },
  "author": [
    {
      "@type": "Person",
      "givenName": "Kevin",
      "familyName": "Cazelles",
      "email": "kevin.cazelles@gmail.com",
      "@id": "https://orcid.org/0000-0001-6619-9874"
    },
    {
      "@type": "Person",
      "givenName": "Jonas",
      "familyName": "Geschke",
      "email": "jonas.e.geschke@gmail.com",
      "@id": "https://orcid.org/0000-0002-5654-9313"
    },
    {
      "@type": "Person",
      "givenName": "Ignasi",
      "familyName": "Bartomeus",
      "@id": "https://orcid.org/0000-0001-7893-4389"
    }
  ],
  "contributor": [
    {
      "@type": "Person",
      "givenName": "Jonathan",
      "familyName": "Goldenberg"
    },
    {
      "@type": "Person",
      "givenName": "Marie-Bé",
      "familyName": "Leduc"
    },
    {
      "@type": "Person",
      "givenName": "Yasmine",
      "familyName": "Verzelen"
    }
  ],
  "maintainer": [
    {
      "@type": "Person",
      "givenName": "Kevin",
      "familyName": "Cazelles",
      "email": "kevin.cazelles@gmail.com",
      "@id": "https://orcid.org/0000-0001-6619-9874"
    }
  ],
  "softwareSuggestions": [
    {
      "@type": "SoftwareApplication",
      "identifier": "knitr",
      "name": "knitr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=knitr"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "testthat",
      "name": "testthat",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=testthat"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "tibble",
      "name": "tibble",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=tibble"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "rmarkdown",
      "name": "rmarkdown",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=rmarkdown"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "rworldmap",
      "name": "rworldmap",
      "version": ">= 1.3.6",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=rworldmap"
    },
    {
      "@type": "SoftwareApplication",
      "identifier": "vcr",
      "name": "vcr",
      "version": ">= 1.2.0",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=vcr"
    }
  ],
  "softwareRequirements": {
    "1": {
      "@type": "SoftwareApplication",
      "identifier": "R",
      "name": "R",
      "version": ">= 3.1.0"
    },
    "2": {
      "@type": "SoftwareApplication",
      "identifier": "cli",
      "name": "cli",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=cli"
    },
    "3": {
      "@type": "SoftwareApplication",
      "identifier": "curl",
      "name": "curl",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=curl"
    },
    "4": {
      "@type": "SoftwareApplication",
      "identifier": "httr",
      "name": "httr",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=httr"
    },
    "5": {
      "@type": "SoftwareApplication",
      "identifier": "jsonlite",
      "name": "jsonlite",
      "provider": {
        "@id": "https://cran.r-project.org",
        "@type": "Organization",
        "name": "Comprehensive R Archive Network (CRAN)",
        "url": "https://cran.r-project.org"
      },
      "sameAs": "https://CRAN.R-project.org/package=jsonlite"
    },
    "SystemRequirements": null
  },
  "fileSize": "1963.126KB",
  "citation": [
    {
      "@type": "SoftwareSourceCode",
      "author": [
        {
          "@type": "Person",
          "givenName": "Jonas",
          "familyName": "Geschke"
        },
        {
          "@type": "Person",
          "givenName": "Kevin",
          "familyName": "Cazelles"
        },
        {
          "@type": "Person",
          "givenName": "Ignasi",
          "familyName": "Bartomeus"
        },
        {
          "@type": "Person",
          "givenName": "Jonathan",
          "familyName": "Goldenberg"
        },
        {
          "@type": "Person",
          "givenName": "Marie-Bé",
          "familyName": "Leduc"
        },
        {
          "@type": "Person",
          "givenName": "Yasmine",
          "familyName": "Verzelen"
        },
        {
          "@type": "Person",
          "givenName": "Noam",
          "familyName": "Ross"
        },
        {
          "@type": "Person",
          "givenName": "Margaret",
          "familyName": "Siple"
        }
      ],
      "name": "{rcites}: An R package to access the CITES Species+ database",
      "url": "https://docs.ropensci.org/rcites/",
      "description": "R package version 1.3.0.9000"
    }
  ],
  "releaseNotes": "https://github.com/ropensci/rcites/blob/master/NEWS.md",
  "readme": "https://github.com/ropensci/rcites/blob/main/README.md",
  "contIntegration": [
    "https://github.com/ropensci/rcites/actions/workflows/R-CMD-check.yaml",
    "https://app.codecov.io/gh/ropensci/rcites"
  ],
  "developmentStatus": "https://www.repostatus.org/#active",
  "review": {
    "@type": "Review",
    "url": "https://github.com/ropensci/software-review/issues/244",
    "provider": "https://ropensci.org"
  },
  "keywords": [
    "cites",
    "api-client",
    "trade",
    "endangered-species",
    "r-package",
    "database",
    "r",
    "rstats"
  ]
}

GitHub Events

Total
  • Watch event: 1
Last Year
  • Watch event: 1

Committers

Last synced: 5 months ago

All Time
  • Total Commits: 448
  • Total Committers: 11
  • Avg Commits per committer: 40.727
  • Development Distribution Score (DDS): 0.587
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email 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 (Top 20 + Academic)

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • 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 requests: 17
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • KevCaz (30)
  • JonasGeschke (9)
  • ibartomeus (7)
  • noamross (1)
  • wajra (1)
  • fleurhierink (1)
  • maelle (1)
  • eveskew (1)
  • FVFaleiro (1)
Pull Request Authors
  • KevCaz (15)
  • JonasGeschke (1)
  • noamross (1)
Top Labels
Issue Labels
enhancement (11) continuous integration (7) bug (6) question (3) web API related (1)
Pull Request Labels
enhancement (1)

Packages

  • Total packages: 2
  • Total downloads:
    • cran 318 last-month
  • Total dependent packages: 0
    (may contain duplicates)
  • Total dependent repositories: 2
    (may contain duplicates)
  • Total versions: 8
  • Total maintainers: 1
proxy.golang.org: github.com/ropensci/rcites
  • Versions: 2
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 4 months ago
cran.r-project.org: rcites

R Interface to the Species+ Database

  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 2
  • Downloads: 318 Last month
Rankings
Forks count: 9.6%
Stargazers count: 15.1%
Dependent repos count: 19.3%
Average: 22.6%
Dependent packages count: 28.8%
Downloads: 40.3%
Maintainers (1)
Last synced: 4 months ago

Dependencies

.github/workflows/R-CMD-check.yaml actions
  • 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
DESCRIPTION cran
  • 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