bbs_meta_regions: Get state/province/territory metadata for North American...

Description Usage Arguments Details Value Author(s) References Examples

Description

Get a data frame with the names and codes for states/provinces/territories used in North American Breeding Bird Survey (BBS), and optionally, the names of the corresponding zip files containing 10-stop and 50-stop count data.

Usage

1
bbs_meta_regions(bbs_dir = bbs_ftp(), zip_files = FALSE)

Arguments

bbs_dir

Directory from which to get data. Defaults to the USGS FTP directory for the most recent BBS release. May alternatively be a path to a local directory, or ftp address for an older BBS release.

zip_files

Include names of zip files containing 10-stop and 50-stop data? Defaults to FALSE.

Details

Note that not all regions have a zip file. As of 2017 there is no data for Mexico, Puerto Rico, or Washington D.C.

Value

A data.frame with the following columns:

country_num

integer code for country

country_name

name of country

state_num

integer code for state/province/territory

state_name

name of state/province/territory

If zip_files = TRUE, also includes the column:

ten_stop_file

name of zip file with 10-stop survey data (or NA if region does not have a zip file)

fifty_stop_file

name of zip file with 50-stop survey data (or NA if region does not have a zip file)

Author(s)

Bob O'Hara

Patrick Barks <patrick.barks@gmail.com>

References

Pardieck, K.L., D.J. Ziolkowski Jr., M. Lutmerding and M.-A.R. Hudson. 2018. North American Breeding Bird Survey Dataset 1966-2017, version 2017.0. U.S. Geological Survey, Patuxent Wildlife Research Center. https://doi.org/10.5066/F76972V8

Examples

1
2
3
4
5
6
7
8
9
## Not run: 

# get from USGS ftp server
regions <- bbs_meta_regions()

# get from local working directory
regions <- bbs_meta_regions(bbs_dir = ".")

## End(Not run)

patrickbarks/bbs documentation built on May 28, 2019, 12:34 a.m.