warbleR (version 1.1.7)

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)
# 
## ---------------------------------------------