query fishery specimen data from the AKFIN server

q_fsh_specimen(
  year,
  species,
  area,
  db,
  add_fields = NULL,
  print_sql = FALSE,
  save = TRUE
)

Arguments

year: max year to retrieve data from
species: 3 digit species codes (e.g., 201) - can place multiple in a vector c(201, 131)
area: bs, ai, goa, or hwc, wc, hg, hbs - can do multiples c("bs","ai")
db: data server to connect to (akfin)
add_fields: add other columns to the database (must currently exist on server). "*" will return all table columns available
print_sql: outputs the sql query instead of calling the data (default: false)
save: saves a file to the data/raw folder, otherwise sends output to global enviro (default: true)

Value

saves fishery specimen data as data/raw/fish_specimen_data.csv or outputs to the global environment, also saves a copy of the SQL code used for the query and stores it in the data/sql folder.

Examples

if (FALSE) {
db <- afscdata::connect("akfin")
q_fsh_specimen(year=2022, species=301, area = "goa", db = db)
}