plot_ebird_phen: Create species phenology plots (monthly) of eBird species...

Description Usage Arguments Value Examples

View source: R/plot_ebird_phen.R

Description

This function generates, for each queried polygon, a phenology plot of eBird sightings by month. The user can choose between displaying the proportion of only complete checklists or all available checklists. The number of checklists is indicated graphically.

Usage

1
2
plot_ebird_phen(geo_ebird_df, species = NULL, which_polys = NULL,
  complete_only = TRUE)

Arguments

geo_ebird_df

a data.frame created by geo_ebird

species

a character string of length = 1 indicating the species to visualize. If NULL (the default), the user is presented with a list of available species from which to choose. Use the accepted American Ornithologists' Union name (see http://checklist.aou.org/taxa), insensitive to capitalization (e.g., "PuRpLe MaRtIn" works).

which_polys

character vector of the names of polygons to plot. Default (NULL) is to generate a plot showing all polygons. This argument is insensitive to capitalization.

complete_only

logical indicating whether only eBird checklists designated as reporting all species observed (i.e., complete checklists; default = TRUE) should be used to calculate proportion of checklists or whether all available checklists should be used (FALSE)

Value

a ggplot object

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
## Not run: 
# Get shapefile
SErefuges <- rgdal::readOGR("../GIS", "refuges", verbose = FALSE, stringsAsFactors = FALSE)

# Query eBird records within Piedmont NWR and 10 km buffer
piedmont <- geo_ebird(SErefuges, which_polys = "Piedmont", buffers = c(0, 10))

# Plot phenology of Pileated Woodpecker
# Species not case sensitive
plot_ebird_phen(piedmont, species = "PiLEAted WOOdPECKer")

## End(Not run)

adamdsmith/geobird documentation built on June 3, 2017, 12:52 p.m.