This package generates geospatial layers for marine navigation and GIS software for use during bottom trawl surveys. The package retrieves and loads spatial data, conducts data processing steps to prepare layers for software, then writes data from simple features objects with well-known text (WKT) geometries to .kml, .gpx, .mdb, .accdb, and .shp formats that are used by Globe, OpenCPN, TimeZero, and ArcMap.
- Installation
- Map layers and data sources
- Creating navigation layers
- Setting colors and symbols
- How to add options for new navigation software
- Download and format moorings data
- Navigation software and GIS files: Make files that are used in marine navigation software (TimeZero, Globe, Olex) and GIS software to coordinate at-sea operations for the AI, GOA, EBS, NBS.
- Survery charts: Make printable survey charts for the EBS and NBS.
- Scientific Research Plan: Make tables and figures for AI and GOA SRPs.
- ADFG Report: Make tables for the AI and GOA ADFG reports.
| Layer Name | Description | Type | Regions | Sources | Update |
|---|---|---|---|---|---|
| Survey Strata | Survey stratum polygons | Lines or polygons | EBS, NBS, AI, GOA | akgfmaps package | See akgfmaps releases |
| Survey Grid | Survey grid polygons with station name and stratum info. | Lines or polygons | EBS, NBS | akgfmaps package | See akgfmaps releases |
| Survey Stations | Survey station centroids with station name and stratum info. | Marks | EBS, NBS | akgfmaps package | See akgfmaps releases |
| Trawlable/Untrawlable Grid | Survey station grid with station name, stratum, and trawlable/untrawlable/unknown designation. | Lines or polygons | AI, GOA | akgfmaps and GOA/AI station tables | Annual |
| Trawlable/Untrawlable Stations | Survey station centroids with station name, stratum, and trawlable/untrawlable/unknown designation. | Marks | AI, GOA | akgfmaps package, GOA/AI station tables | Annual |
| Historical Tow Starts | Historical tow starts with performance code, year/cruise, and vessel info. | Marks | EBS, NBS, AI, GOA | race_base_data.hauls, race_data.events, race_data.surveys, race_data.survey_definitions, racebase.performace | Annual |
| Historical Tow Midpoint | Historical tow midpoint calculated from GPS data. Includes performance code, year/cruise, and vessel info. | Marks | AI, GOA | race_data.hauls, race_data.cruises, race_data.events, race_data.surveys, race_data.survey_definitions, racebase.performance | Annual |
| Historical Towpaths | Historical towpaths based on smoothed GPS data. Includes performance code, year/cruise, and vessel info. | Lines | EBS, NBS, AI, GOA | race_data.cruises, race_data.hauls, race_data.position_headers, race_data.positions, race_data.datum_codes | |
| Station Allocation | Station allocation by vessel for the AI or GOA surveys. | Marks | AI, GOA | StationAllocationAIGOA | Annual |
| Navigation hazards (buoys/moorings/wrecks) | Location, depth, and contact information for hazards. | Marks | EBS/NBS, AI, GOA | USCG. Link | Annual (last update: Jan 28, 2025) |
| Steller Sea Lion No Transit Zones | Survey no transit zones around Steller Sea Lion rookeries. | Lines or polygons | EBS, AI, GOA | A. Jahn (NOAA/AKRO) | Last update: March 2025 |
| Steller Sea Lion Critical Habitat | Steller Sea Lion Critical Habitat areas. | Polygons | EBS, AI, GOA | NOAA Fisheries. Link | Last update: March 2023 |
| Humpback Whale Critical Habitat | Humpback Whale Critical Habitat areas. | Lines or polygons | EBS, AI, GOA | NOAA Fisheries. Link | Last update: March 23,2023 |
| North Pacific Right Whale Critical Habitat | North Pacific Right Whale Critical Habitat areas | Lines or polygons | EBS/NBS, AI, GOA | NOAA Fisheries. Link | Last update: April 2022 |
| Sea Otter Critical Habitat | Sea Otter Critical Habitat areas. | Lines or polygons | EBS/NBS, AI, GOA | USFWS. Link | |
| Spectacled Eider Critical Habitat | Spectacled Eider Critical Habitat in the northern Bering Sea | Lines or polygons | EBS/NBS | USFWS. Link | Last update: April 2, 2023 |
| Cook Inlet Beluga Whale Critical Habitat | Cook Inlet Beluga Whale Critical Habitat in Cook Inlet | Lines or polygons | GOA | NOAA Fisheries Link | Last update: April 2022 |
| Skate Nursery HAPC | Amendment 104 Skate nursery HAPC | Lines or polygons | EBS | NOAA. Link | Last update: April 11, 2024 |
| Crab pot storage | Storage locations for crab pot strings. | Lines or polygons | AI, GOA | Provided by vessels. | Annual |
This package is primarily intended for use with 64-bit installations of R. However, reading/writing legacy Globe MS Access Databases (.mdb and .accdb) requires the use of 32-bit R and 32-bit drivers. Therefore, the recommended installation method depends on whether you will be working with 32-bit Globe MS Access databases. The R Project ceased producing new 32-bit versions of R after version 4.1.3, released on March 10, 2022.
This is the preferred installation method if you won't be reading or writing from .mdb and .accdb files. I'd suggest installing this for your latest version of R if you're producing layers for software other than Globe.
library(remotes)
install_github("afsc-gap-products/navmaps", auth_token = gh::gh_token())
Some users have had difficulties installing 32-bit R caused by issues installing/upgrading the rlang and purrr packages. If you already have R version 4.1.0-4.1.3 and Rtools40 installed, you can skip to step 3.
- Install 64-bit and 32-bit versions of R Version 4.1.X
- Install Rtools40.
- Open the 64-bit installation of R 4.1.X.
- If purrr and rlang are already installed, uninstall them using remove.packages()
- Install the rlang package.
- Install the purrr package (the binary, DO NOT COMPILE/BUILD FROM SOURCE).
- Install the navmaps package:
library(remotes)
install_github("afsc-gap-products/navmaps", auth_token = gh::gh_token())
- Close the 64-bit installation of R.
- Open the 32-bit installation of R that has the same version number as the 64-bit installation you used to complete the steps above.
- Check that the proper drivers are installed:
library(navmaps)
# Should return an error if drivers aren't detected or do nothing if .mdb or .accdb drivers are installed.
.check_driver()
# You can also view the list of drivers. The one you'll need is named 'Microsoft Access Driver (*.mdb)'
odbc::odbcListDrivers()
If the 32-bit installation fails:
- In R Studio, navigate to Tools > Global Options.
- Switch to a 32-bit installation of R.
- Restart R Studio and check that the start-up messages show you're using a 32-bit version of R.
- Clone the navmaps repository locally.
- Create a new R Studio 'R Package' project in your local navmaps directory.
- Install the package using Build > Install (Ctrl+Shift+B); you may need to first install dependencies individually.
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.
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