warbleR (version 1.1.9)

xcmaps: Maps of 'Xeno-Canto' recordings by species

Description

xcmaps creates maps to visualize the geographic spread of 'Xeno-Canto' recordings.

Usage

xcmaps(X, img = TRUE, it = "jpeg", res = 100, labels = F)

Arguments

X

Data frame output from querxc.

img

A logical argument specifying whether an image file of each species map should be returned, default is TRUE.

it

A character vector of length 1 giving the image type to be used. Currently only "tiff" and "jpeg" are admitted. Default is "jpeg".

res

Numeric argument of length 1. Controls image resolution. Default is 100 (faster) although 300 - 400 is recommended for publication/ presentation quality.

labels

A logical argument defining whether dots depicting recording locations are labeled. If TRUE then the Recording_ID is used as label.

Value

A map of 'Xeno-Canto' recordings per species (image file), or a faceted plot of species map(s) in the active graphic device.

Details

This function creates maps for visualizing the geographic spread of recordings from the open-access online repository 'Xeno-Canto' (http://www.xeno-canto.org/). The function takes the output of querxc as input. Maps can be displayed in the graphic devide or saved as images in the working directory.

Examples

# NOT RUN {
# search in xeno-canto
X <- querxc("Phaethornis anthophilus", download = FALSE)

#create image in R graphic device
xcmaps(X, img = FALSE)

#or save it as a file in the working directory
xcmaps(X)

# }