fetch_bbs_data

<code>fetch_bbs_data</code> uses File Transfer Protocol (FTP) to fetch Breeding Bird
 Survey data from the United States Geological Survey (USGS) FTP site. This
 is the raw data that is uploaded to the site before any analyses are performed.
 A package-specific directory is created on the user's computer (see documentation of
 <code>rappdirs::appdir</code> for details of where this directory lives), and the BBS
 data is saved to that directory for use by other functions.
 Before downloading any data, the user must thoroughly read through the terms
 and conditions of the user of the data and type the word "yes" to agree.

The North American Breeding Bird Survey (BBS) is a long-running
program that seeks to monitor the status and trends of the breeding birds in
North America. Since its start in 1966, the BBS has accumulated over 50 years
of data for over 500 species of North American Birds. Given the temporal and
spatial structure of the data, hierarchical Bayesian models are used to assess
the status and trends of these 500+ species of birds. 'bbsBayes' allows you to perform
hierarchical Bayesian analysis of BBS data. You can run a full
model analysis for one or more species that you choose, or you can take
more control and specify how the data should be stratified, prepared
for 'JAGS', or modelled. The functions provided here allow you to replicate
analyses performed by the United State Geological Survey (USGS, see Link
and Sauer (2011) <doi:10.1525/auk.2010.09220>) and Canadian Wildlife Service
(CWS, see Smith and Edwards (2020) <doi:10.1101/2020.03.26.010215>).

Brandon P.M. Edwards

bbsBayes

Hierarchical Bayesian Analysis of North American BBS Data

Adam C. Smith

fetch_bbs_data function

<dl><dt>level</dt>
<dd>A string, either "state" or "stop", specifying which counts to
fetch. Defaults to "state", which provides counts beginning in 1966,
aggregated in five bins, each of which contains cumulative counts from 10 of
the 50 stops along a route. Specifying "stop" provides stop-level data
beginning in 1997, which includes counts for each stop along routes
individually. Note that stop-level data is not currently supported by
the modeling utilities in bbsBayes.</dd>
<dt>release</dt>
<dd>Integer: what yearly release is desired? options are 2022 (default including data through 2021 field season) or 2020 (including data through 2019)</dd>
<dt>quiet</dt>
<dd>Logical: should progress bars be suppressed? Defaults to FALSE</dd>
<dt>force</dt>
<dd>Logical: if BBS data already exists on computer, should it be overwritten? Defaults to FALSE</dd></dl>

Arguments

Fetch Breeding Bird Survey dataset — fetch_bbs_data

<dl>

<dt>level</dt>
<dd>A string, either "state" or "stop", specifying which counts to
fetch. Defaults to "state", which provides counts beginning in 1966,
aggregated in five bins, each of which contains cumulative counts from 10 of
the 50 stops along a route. Specifying "stop" provides stop-level data
beginning in 1997, which includes counts for each stop along routes
individually. Note that stop-level data is not currently supported by
the modeling utilities in bbsBayes.</dd>


<dt>release</dt>
<dd>Integer: what yearly release is desired? options are 2022 (default including data through 2021 field season) or 2020 (including data through 2019)</dd>


<dt>quiet</dt>
<dd>Logical: should progress bars be suppressed? Defaults to FALSE</dd>


<dt>force</dt>
<dd>Logical: if BBS data already exists on computer, should it be overwritten? Defaults to FALSE</dd>

</dl>

fetch_bbs_data: Fetch Breeding Bird Survey dataset

Description

Usage

Value

Arguments