MyNixOS website logo
Description

Interface to the iDigBio Data API.

An interface to iDigBio's search API that allows downloading specimen records. Searches are returned as a data.frame. Other functions such as the metadata end points return lists of information. iDigBio is a US project focused on digitizing and serving museum specimen collections on the web. See <https://www.idigbio.org> for information on iDigBio.

Build Status

Installation

This should automatically install the package from a CRAN mirror if you have one configured:

install.packages("ridigbio")
	

If R says the package is unavailable, you may not have set a CRAN mirror. You can do so with:

chooseCRANmirror()

If R says that a binary package is not available, your version of R may be too old. Please review the versions of R that CRAN has built packages for on the CRAN ridigbio package page. You can download the source package and install manually if there is no package built for your version of R. You may also need to install any dependencies.

install.packages("ridigbio", type="source")

On Linux, you may encounter an error during the installation process if you do not have libcurl installed. The method for installing libcurl will vary between distributions, but on Ubuntu you can install the latest version via:

sudo apt install libcurl4

Basic usage

library("ridigbio")
idig_search_records(rq=list(genus="galax"))
idig_search_records(rq=list(family="holothuriidae"), limit=1000)

Complete list of terms that can be used is available here

IMPORTANT: R Function Changes

Default fields returned to users have been updated to return research-grade fields. ridigbio use to returns datecollected by default, which we do not recommend to be used in scientific research. When a data provider does not provide a full date in the Darwin Core eventDate field, this complete value or the missing parts (i.e., month and/or day) are randomly generated and thus may lack any real meaning. The generated dates are difficult to detect, as they are randomly distributed. We are currently working to modify our ingestion pipeline to avoid randomly generating dates. However, dates remain an issue across biodiversity aggregators and the solution is not clear (see GBIF for example).

To prevent user misuse of this term, we will no longer be providing the datecollected field by default and will instead be returning the following fields:

data.dwc:eventDate data.dwc:year data.dwc:month data.dwc:day

Please be advised that these fields are in a text only format and will need to be sorted another way as addressed in this issue.

License

MIT.

Metadata

Version

0.3.8

License

Unknown

Platforms (75)

    Darwin
    FreeBSD
    Genode
    GHCJS
    Linux
    MMIXware
    NetBSD
    none
    OpenBSD
    Redox
    Solaris
    WASI
    Windows
Show all
  • aarch64-darwin
  • aarch64-genode
  • aarch64-linux
  • aarch64-netbsd
  • aarch64-none
  • aarch64_be-none
  • arm-none
  • armv5tel-linux
  • armv6l-linux
  • armv6l-netbsd
  • armv6l-none
  • armv7a-darwin
  • armv7a-linux
  • armv7a-netbsd
  • armv7l-linux
  • armv7l-netbsd
  • avr-none
  • i686-cygwin
  • i686-darwin
  • i686-freebsd
  • i686-genode
  • i686-linux
  • i686-netbsd
  • i686-none
  • i686-openbsd
  • i686-windows
  • javascript-ghcjs
  • loongarch64-linux
  • m68k-linux
  • m68k-netbsd
  • m68k-none
  • microblaze-linux
  • microblaze-none
  • microblazeel-linux
  • microblazeel-none
  • mips-linux
  • mips-none
  • mips64-linux
  • mips64-none
  • mips64el-linux
  • mipsel-linux
  • mipsel-netbsd
  • mmix-mmixware
  • msp430-none
  • or1k-none
  • powerpc-netbsd
  • powerpc-none
  • powerpc64-linux
  • powerpc64le-linux
  • powerpcle-none
  • riscv32-linux
  • riscv32-netbsd
  • riscv32-none
  • riscv64-linux
  • riscv64-netbsd
  • riscv64-none
  • rx-none
  • s390-linux
  • s390-none
  • s390x-linux
  • s390x-none
  • vc4-none
  • wasm32-wasi
  • wasm64-wasi
  • x86_64-cygwin
  • x86_64-darwin
  • x86_64-freebsd
  • x86_64-genode
  • x86_64-linux
  • x86_64-netbsd
  • x86_64-none
  • x86_64-openbsd
  • x86_64-redox
  • x86_64-solaris
  • x86_64-windows