Basic Design-Based GAP Data Products

The scripts therein reproducibly produce our typical data products.

This code is always in development. Find code used for various reports in the code releases.

This code is primarally maintained by:

Emily Markowitz (Emily.Markowitz AT noaa.gov; @EmilyMarkowitz-NOAA)

Zack Oyafuso (Zack.Oyafuso AT noaa.gov; @zoyafuso-NOAA)

Alaska Fisheries Science Center,

National Marine Fisheries Service,

National Oceanic and Atmospheric Administration,

Seattle, WA 98195

Table of contents

• Cite this data
  • Access Constraints
• Relevant publications
• Suggestions and Comments
  • Run notes
  • R Version Metadata
  • NOAA README
  • NOAA License

User Resources

• GitHub repository

• Access Tips and Documentation for All Production Data

• Fisheries One Stop Shop (FOSS)

• Groundfish Assessment Program Bottom Trawl Surveys

• AFSCs Resource Assessment and Conservation Engineering Division

• Survey code books

• Publications and Data Reports

• Research Surveys conducted at AFSC

Cite this data

Use the below bibtext citations, as cited in our groups citation repository for citing the data created and maintained in this repo. Add note = {Accessed: mm/dd/yyyy} to append the day this data was accessed. Included here are AFSC RACE Groundfish and Shellfish Assessment Programs:

• Design-Based Production Data (NOAA Fisheries Alaska Fisheries Science Center, Goundfish Assessment Program, 2024).
  
• Public Data hosted on the Fisheries One Stop Shop (FOSS) Data Platform (NOAA Fisheries Alaska Fisheries Science Center, 2024).

Access Constraints

There are no legal restrictions on access to the data. They reside in public domain and can be freely distributed.

User Constraints: Users must read and fully comprehend the metadata prior to use. Data should not be used beyond the limits of the source scale. Acknowledgement of AFSC Groundfish Assessment Program, as the source from which these data were obtained, in any publications and/or other representations of these data, is suggested.

General questions and more specific data requests can be sent to nmfs.afsc.gap.metadata@noaa.gov or submitted as an issue on our GitHub Organization. The version of this data used for stock assessments can be found through the Alaska Fisheries Information Network (AKFIN). For questions about the eastern Bering Sea surveys, contact Duane Stevenson (Duane.Stevenson@noaa.gov). For questions about the Gulf of Alaska or Aleutian Islands surveys, contact Ned Laman (Ned.Laman@noaa.gov). For questions specifically about crab data in any region, contact Mike Litzow (Mike.Litzow@noaa.gov), the Shellfish Assessment Program lead.

For questions, comments, and concerns specifically about the Fisheries One Stop Shop (FOSS) platform, please contact us using the Comments page on the FOSS webpage.

Relevant publications

r source("https://raw.githubusercontent.com/afsc-gap-products/citations/main/cite/current_data_tm.r") # srvy_cite

Learn more about these surveys (Hoff, 2016; Markowitz et al., 2024, 2024; Siple et al., 2024; Von Szalay et al., 2023; Zacher et al., 2024).

Suggestions and Comments

If you see that the data, product, or metadata can be improved, you are invited to create a pull request, submit an issue to the GitHub organization, or submit an issue to the codes repository.

Run notes

Will need to install miktex and run the following code in the console.

r # https://yihui.org/tinytex/r/#debugging update.packages(ask = FALSE, checkBuilt = TRUE) tinytex::tlmgr_update() tinytex::reinstall_tinytex() options(tinytex.verbose = TRUE)

r install.packages("tinytex") require("tinytex") install_tinytex(force = TRUE) tlmgr_install('montserrat') xelatex('Report.tex')

R Version Metadata

r sessionInfo()

## R version 4.4.3 (2025-02-28 ucrt)
## Platform: x86_64-w64-mingw32/x64
## Running under: Windows 10 x64 (build 19045)
## 
## Matrix products: default
## 
## 
## locale:
## [1] LC_COLLATE=English_United States.utf8  LC_CTYPE=English_United States.utf8    LC_MONETARY=English_United States.utf8
## [4] LC_NUMERIC=C                           LC_TIME=English_United States.utf8    
## 
## time zone: America/Los_Angeles
## tzcode source: internal
## 
## attached base packages:
## [1] stats     graphics  grDevices utils     datasets  methods   base     
## 
## other attached packages:
##  [1] akfingapdata_0.1.0 odbc_1.6.1         DBI_1.2.3          RODBC_1.3-26       ftExtra_0.6.4      badger_0.2.4       scales_1.4.0      
##  [8] stringr_1.5.1      here_1.0.1         flextable_0.9.7    kableExtra_1.4.0   janitor_2.2.1      readxl_1.4.5       tidyr_1.3.1       
## [15] readr_2.1.5        magrittr_2.0.3     googledrive_2.1.1  dplyr_1.1.4        akgfmaps_4.0.3     terra_1.8-42       stars_0.6-8       
## [22] abind_1.4-8        sf_1.0-20          ggplot2_3.5.2      gapindex_3.0.2     devtools_2.4.5     usethis_3.1.0     
## 
## loaded via a namespace (and not attached):
##   [1] gridExtra_2.3           remotes_2.5.0           rlang_1.1.6             snakecase_0.11.1        e1071_1.7-16           
##   [6] compiler_4.4.3          systemfonts_1.2.3       vctrs_0.6.5             profvis_0.4.0           pkgconfig_2.0.3        
##  [11] fastmap_1.2.0           ellipsis_0.3.2          promises_1.3.2          rmarkdown_2.29          tzdb_0.5.0             
##  [16] sessioninfo_1.2.3       ragg_1.4.0              purrr_1.0.4             bit_4.6.0               rvcheck_0.2.1          
##  [21] xfun_0.52               cachem_1.1.0            jsonlite_2.0.0          blob_1.2.4              later_1.4.2            
##  [26] uuid_1.2-1              parallel_4.4.3          R6_2.6.1                stringi_1.8.7           RColorBrewer_1.1-3     
##  [31] pkgload_1.4.0           lubridate_1.9.4         cellranger_1.1.0        Rcpp_1.0.14             knitr_1.50             
##  [36] zoo_1.8-14              dlstats_0.1.7           readtext_0.91           FNN_1.1.4.1             timechange_0.3.0       
##  [41] httpuv_1.6.16           tidyselect_1.2.1        rstudioapi_0.17.1       yaml_2.3.10             viridis_0.6.5          
##  [46] codetools_0.2-20        miniUI_0.1.2            pkgbuild_1.4.7          lattice_0.22-7          tibble_3.2.1           
##  [51] intervals_0.15.5        shiny_1.10.0            withr_3.0.2             askpass_1.2.1           evaluate_1.0.3         
##  [56] units_0.8-7             proxy_0.4-27            urlchecker_1.0.1        zip_2.3.2               xts_0.14.1             
##  [61] xml2_1.3.8              BiocManager_1.30.25     pillar_1.10.2           KernSmooth_2.23-26      generics_0.1.3         
##  [66] rprojroot_2.0.4         sp_2.2-0                spacetime_1.3-3         hms_1.1.3               xtable_1.8-4           
##  [71] class_7.3-23            glue_1.8.0              gdtools_0.4.2           tools_4.4.3             data.table_1.17.0      
##  [76] fs_1.6.6                grid_4.4.3              cli_3.6.5               gstat_2.1-3             textshaping_1.0.1      
##  [81] officer_0.6.8           fontBitstreamVera_0.1.1 gargle_1.5.2            viridisLite_0.4.2       svglite_2.1.3          
##  [86] gtable_0.3.6            yulab.utils_0.2.0       digest_0.6.37           fontquiver_0.2.1        classInt_0.4-11        
##  [91] htmlwidgets_1.6.4       farver_2.1.2            memoise_2.0.1           htmltools_0.5.8.1       lifecycle_1.0.4        
##  [96] httr_1.4.7              mime_0.13               fontLiberation_0.1.0    openssl_2.3.2           bit64_4.6.0-1

NOAA README

This repository is a scientific product and is not official communication of the National Oceanic and Atmospheric Administration, or the United States Department of Commerce. All NOAA GitHub project code is provided on an as is basis and the user assumes responsibility for its use. Any claims against the Department of Commerce or Department of Commerce bureaus stemming from the use of this GitHub project will be governed by all applicable Federal law. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by the Department of Commerce. The Department of Commerce seal and logo, or the seal and logo of a DOC bureau, shall not be used in any manner to imply endorsement of any commercial product or activity by DOC or the United States Government.

NOAA License

Software code created by U.S. Government employees is not subject to copyright in the United States (17 U.S.C. 105). The United States/Department of Commerce reserve all rights to seek and obtain copyright protection in countries other than the United States for Software authored in its entirety by the Department of Commerce. To this end, the Department of Commerce hereby grants to Recipient a royalty-free, nonexclusive license to use, copy, and create derivative works of the Software outside of the United States.

U.S. Department of Commerce | National Oceanographic and Atmospheric Administration | NOAA Fisheries