get_FN121_Trawl: Get FN121_Trawl - Trawl data from FN_Portal API

In AdamCottrill/glfishr: Fetch fisheries assessment data from the FN Portal

Get FN121_Trawl - Trawl data from FN_Portal API

Description

This function accesses the api endpoint for fn121trawl records. fn121trawl records contain details on the vessel, its speed and direction, and warp. Other relevant details for each SAM are found in the FN121 table. This function takes an optional filter list which can be used to return records based on attributes of the SAM including site depth, start and end date and time, effort duration, gear, and location as well as attributes of the projects they are associated with such as project code, or part of the project code, lake, first year, last year, protocol, etc. This function can also take filters related to the vessel/warp.

Usage

get_FN121_Trawl(
  filter_list = list(),
  with_121 = FALSE,
  show_id = FALSE,
  to_upper = TRUE
)

Arguments

filter_list	list
with_121	When 'FALSE', the default, only the trawl fields from the FN121 table are returned. To return the whole FN121 table (excluding limnology, weather, and trapnet fields), use 'with_121 = TRUE'.
show_id	When 'FALSE', the default, the 'slug' field is hidden from the data frame. To return this field as part of the data frame, use 'show_id = TRUE'.
to_upper	should the names of the dataframe be converted to upper case?

Details

Use show_filters("fn121trawl") to see the full list of available filter keys (query parameters). Refer to https://intra.glis.mnr.gov.on.ca/fn_portal/api/v1/swagger/ and filter by "fn121trawl" for additional information.

Value

dataframe

Author(s)

Adam Cottrill [e-mail]

Examples

fn121_trawl <- get_FN121_Trawl(list(lake = "ER", year = 2018))
fn121_trawl <- get_FN121_Trawl(list(lake = "ER", year = 2018), with_121 = TRUE)
fn121_trawl <- get_FN121_Trawl(list(lake = "ER", year = 2018, mu_type = "qma"), with_121 = TRUE)
fn121_trawl <- get_FN121_Trawl(list(lake = "ER", year = 2018), show_id = TRUE)

AdamCottrill/glfishr documentation built on Aug. 9, 2024, 5:47 p.m.