bbs_meta_weather: Get weather and environmental metadata for North American...
In patrickbarks/bbs: North American Breeding Bird Survey (BBS) in R

Description Usage Arguments Value Author(s) References Examples

Get a data frame with weather and environmental data from the North American Breeding Bird Survey (BBS). This data comes from the BBS file Weather.csv. See also files WeatherInf.txt and weathercodes.txt for further details.

1	bbs_meta_weather(bbs_dir = bbs_ftp())

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.

A data.frame with the following columns:

`route_data_id`	integer code for unique combinations of country_num, state, route, rpid, and year
`country_num`	integer code for country: 124 (Canada), 484 (Mexico), 840 (United States)
`state_num`	integer code for state/province/territory
`route`	integer code for route (unique within states)
`rpid`	integer code for Run Protocol ID (see BBS file RunProtocolID.txt)
`year`	integer survey year
`month`	integer survey month (1-12)
`day`	integer survey day (1-31)
`obs_n`	integer identification code for human observer
`total_spp`	total number of species recorded on that run of the route
`start_temp`	temperature recorded at the beginning of the run of the route
`end_temp`	temperature recorded at the end of the run of the route
`temp_scale`	scale in which the temperature was recorded: F (Fahrenheit), C (Celsius)
`start_wind`	Beaufort wind speed code recorded at the beginning of the run of the route (see BBS file weathercodes.txt)
`end_wind`	Beaufort wind speed code recorded at the end of the run of the route (see BBS file weathercodes.txt)
`start_sky`	Weather Bureau sky code recorded at the beginning of the run of the route (see BBS file weathercodes.txt)
`end_sky`	Weather Bureau sky code recorded at the end of the run of the route (see BBS file weathercodes.txt)
`start_time`	time the run of the route began (in 24 hour local time)
`end_time`	time the run of the route ended (in 24 hour local time)
`assistant`	logical indicating whether another person assisted
`quality_current_id`	logical indicating whether the run took place under suitable weather conditions, and within suitable time, date, and route completion criteria (see BBS file WeatherInf.txt)
`run_type`	integer indicating whether the run is acceptable (1) or not (0) by BBS standards (see BBS file runtype.pdf)

Bob O'Hara

Patrick Barks <patrick.barks@gmail.com>

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

## Not run: 

# get from USGS ftp server
weather <- bbs_meta_weather()

# get from local working directory
weather <- bbs_meta_weather(bbs_dir = ".")

## End(Not run)