In ices-tools-prod/icesVMS: Link to the ICES Vessel Monitoring System and Logbook Database Web Services

library(knitr)
library(icesVMS)

icesVMS

icesVMS Functions to support the creation of ICES Fisheries Overviews, ....

icesVMS is implemented as an R package and available on GitHub and our CRAN-like repository

Installation

icesVMS can be installed from our CRAN-like repository using the standard install.packages() command

install.packages("icesVMS", repos = 'https://ices-tools-prod.r-universe.dev')

Usage

For a summary of the package:

library(icesVMS)
?icesVMS

Examples

Download c square information

All of the VMS data submitted to ICES is at the c square level (concise spatial query and representation system, [@reese03_csquares]), and to aid in the exploration of display of data summaries extracted from the ICES VMS/Logbook database there is a service to extract information related to a C square. For example, the following code returns a table of all the c squares in the Celtic Seas ecoregion (see https://ices.dk/community/advisory-process/Pages/ICES-ecosystems-and-advisory-areas.aspx):

celtic <- get_csquare(ecoregion = "Celtic Seas")
sr_32D5 <- get_csquare(stat_rec="32D5")
get_csquare(c_square = "7501:114:383:4")

These can be plotted by parsing the WKT (Well Known Text, https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) field (here using the sf package) and then plotting using ggplot2, for example:

ukwest <- get_csquare(ices_area = "6a")
ukwest <- sf::st_as_sf(ukwest, wkt = "wkt", crs = 4326)

ggplot2::ggplot() +
  ggplot2::geom_sf(data = ukwest, color = "lightblue", fill = "transparent")

Download bottom contact model parameters (BENTHIS)

To calculate swept area ratio by c_square, ICES uses methods developed by the BENTHIS project and within the WGSFD in which gear codes are used to imply the area swept by the gear for a given fishing speed. The parameters are available via:

benthis <- get_benthis_parameters()
kable(benthis)

These high level gear categories referred to as BenthisMet are connected to lower level metiers via a lookup table maintained by the WGSFD and available via:

metiers <- get_metier_lookup()
kable(metiers[1:10,c(2,4,6,7,11)])

Total landings by country

The VMS/Logbook database also gives access to total landings by country and year. This information is used in the ICES Fisheries Overviews. All data used in the Fisheries Overviews is published where possible, so this function provides open access to the aggregated landings weights.

benthis <- get_benthis_parameters()
kable(benthis)

References

ices-tools-prod/icesVMS documentation built on April 24, 2023, 2:31 a.m.