warbleR (version 1.1.1)

querxc: Access Xeno-Canto recordings and metadata

Description

querxc downloads recordings and metadata from Xeno-Canto (http://www.xeno-canto.org/).

Usage

querxc(qword, download = FALSE, X = NULL, parallel = 1)

Arguments

qword

Character vector of length one indicating the genus, or genus and species, to query Xeno-Canto database. For example, Phaethornis or Phaethornis longirostris. (http://www.xeno-canto.org/).

download

Logical argument. Downloads recording file names and associated metadata if FALSE. If TRUE, recordings are also downloaded to working directory as .mp3 files. Default is FALSE.

X

Data frame with the same columns as the output of the function, or at least the following columns: Genus, Specific_epithet and Recording_ID. Only the recordings listed in the data frame will be download (download argument is automatically se

parallel

Numeric. Controls whether parallel computing is applied. It specifies the number of cores to be used. Default is 1 (e.i. no parallel computing). For windows OS the warbleR from github to run parallel.

Value

• If X is not provided the function returns a data frame with the following recording information: recording ID, Genus, Specific epithet, Subspecies, English name, Recordist, Country, Locality, Latitude, Longitude, Vocalization type, Audio file, License, URL, Quality,Time, Date. Sound files in .mp3 format are downloaded into the working directory if download = TRUE or if X is provided.

Details

This function queries for avian vocalization recordings in the open-access online repository Xeno-Canto (http://www.xeno-canto.org/). It can return recordings metadata or can also download the associated sound files.

Examples

# First create empty folder
dir.create(file.path(getwd(),"temp"))
setwd(file.path(getwd(),"temp"))
df1 <- querxc("Phaethornis anthophilus", download = FALSE)
View(df1)

#downloading files
querxc("Phaethornis anthophilus", download = TRUE)
#check this folder!!
getwd()

# remove example directory
unlink(getwd(),recursive = TRUE)