eb_sightings: Read a eBird personal sightings file

In mstrimas/auklet: Analysis and Visualization of Your eBird Sightings

Description

Your personal eBird sightings can be downloaded as a CSV file through the eBird website. This function reads the eBird data file, cleans up the variable names, and performs some basic processing.

Usage

eb_sightings(file, countable = FALSE)

Arguments

file	character; name of your personal eBird sightings files. This file can be downloaded from the eBird website.
countable	logical; whether to only return countable species, i.e. those that are counted on your life list by eBird.

Details

Some "species" reported on ebird are not true species. For example, they may be domestic or not resolved to the species level (e.g. Empidonax sp. or Greater/Lesser Yellowlegs), in which case they do not count towards your life list. Alternatively, sightings may be reported below the species level (e.g. subspecies or recognizable forms), in which case they must be rolled up to species level prior to reporting. Addiontal fields from the ebird taxonomy (eb_taxonomy) are added to the sightings data set to resolve these cases. The category field can be used to identify different categories of "species". The report_as, species_common, and species_scientific fields identify the true species corresponding to taxa reported below species. these fields are all NA for taxa not resolvable to species.

Value

A dplyr::tibble, with additional class eb_sightings, containing your personal sightings.

Examples

system.file("extdata/MyEBirdData.csv", package = "auklet") %>%
  eb_sightings()

mstrimas/auklet documentation built on May 29, 2019, 2:57 p.m.