v4.0.1

akgfmaps 4.0.1 (January 7, 2025)

BUG FIX

• Change STATION fields to use GRID_X-GRID_Y-STRATUM naming
  convention.

v4.0.0

akgfmaps 4.0.0 (January 3, 2025)

This major update replaces and updates shapefiles from multiple
bottom trawl survey regions and adopts standard field naming
conventions across regions. This update ensure consistency
across survey spatial products but breaks backwards
compatibility.

MAJOR CHANGES TO get_base_layers()

• The function can retrieve layers for multiple regions at
  once, e.g.:
  get_base_layers(select.region = c("ebs", "ai"))

• New design.year argument can retrieve layers for a specific
  survey design, such as the Gulf of Alaska survey design that
  was used from 1984-2023:
  get_base_layers(select.region = "goa", design.year = 1984)

  If not specified, returns the most recent design.

• The use.survey.bathymetry argument in get_base_layers() is now
  deprecated because they are unnecessary now that EBS bathymetry
  files have been updated.

• A legacy version of the function, get_base_layers_v3(), and
  associated shapefiles are provided temporarily as a bridge
  to help with backwards compatibility.

• Column names for sf objects returned by the function have
  changed to match GAP_PRODUCTS and RACEBASE.

  • survey.area columns:
    • AREA_ID: AREA_ID used in GAP_PRODUCTS for the survey
      area.
    • SURVEY_DEFINITION_ID: Survey ID (6 = Chukchi,
      47 = GOA, 52 = AI, 78 = EBS Slope, 98 = EBS shelf,
      143 = NBS).
    • SURVEY_NAME: Name of the survey as a character
      vector (e.g., "Aleutian Islands Bottom Trawl Survey")
    • DESIGN_YEAR: Year the design was implemented.
    • AREA_M2: Area in m^2.
    • geometry: simple features WKT geometry
  • survey.strata columns:
    • STRATUM: Survey stratum that corresponds with AREA_ID
      in GAP_PRODUCTS or STRATUM in RACEBASE.
    • SURVEY_DEFINITION_ID: Same as above.
    • DESIGN_YEAR: Same as above.
    • AREA_M2: Same as above.
    • geometry: Same as above.
  • survey.grid columns:
    • SURVEY_DEFINITION_ID: Same as above.
    • DESIGN_YEAR: Same as above.
    • GRID_ID: Corresponds with AI_GRIDID or GOA_GRIDID
      used by GAP.
    • STATION: Corresponds with STATIONID field in RACEBASE
      and STATION field in GAP_PRODUCTS.
    • AREA_M2: Same as above.
    • geometry: Same as above.

MAJOR CHANGES TO VECTOR GEOMETRY FILES

1. Bottom trawl survey layer field names have been standardized
   across regions.
2. Bottom trawl survey layers are provided in geopackages
   (.gpkg) instead of standalone shapefiles.
   • Groundfish/BTS:
     • /inst/extdata/afsc_bottom_trawl_surveys.gpkg
   • Crab strata:
     • /inst/extdata/all_crab_from_akgfmaps_grid.gpkg
3. INPFC strata for bottom trawl surveys are in
   /inst/extdata/afsc_bottom_trawl_surveys.gpkg

v3.6.2

akgfmaps 3.6.2 (January 2, 2024)

BUG FIX

• Fixed gap in GOA stratum polygon around Samalga Pass to close
  issue #104.

v3.6.1

akgfmaps 3.6.1 (December 20, 2024)

BUG FIX

• Correct coordinates for longline survey station 20 by replacing
  inst/extdata/LL_Survey_Stations_Active2023.shp with
  inst/extdata/LonglineStationsActive.shp
• Revert EBS shelf stratum shapefile to 2022 version.
• Remove land area (STRATUM = 0) from GOA survey area polygon in
  inst/extdata/goa_area.shp
• Remove land area (STRATUM = 0) from AI survey area polygon in
  inst/extdata/ai_area.shp

v3.6.0

akgfmaps 3.6.0 (December 11, 2024)

FUNCTIONALITY CHANGES

• rasterize_and_mask() no longer supports 'raster' class from
  the raster package.
• Functions that allow set.crs = "auto" now use Alaska Albers
  Equal Area (EPSG:3338) by default instead of region-specific
  PROJ4s strings. The change is intended to ensure forward
  compatibility by using 'standard' coordinate reference
  systems.

NEW FEATURES

• Added new functions to access layers that were included in
  akmarineareas2 (github.com/MattCallahan-NOAA/akmarineareas2).

  • get_adfg_areas(): Alaska Department of Fish and Game (ADFG)
    Statistical Areas
  • get_esr_regions(): Alaska Ecosystem Status Report (ESR)
    regions
  • get_bsierp_regions(): Bering Sea Integrated Ecosystem
    Research Program (BSIERP) regions

  Layers are retrieved from a file Geodatabase (.gdb;
  inst/extdata/Alaska_Marine_Management_Areas.gdb) provided
  by Matt Callahan -- thanks, Matt!

• Added get_crab_strata() function to retrieve crab stratum
  layers. Support for Bristol Bay RKC, Pribilof Islands
  RKC, Pribilof Islands BKC, St. Matthew's BKC, Norton Sound
  RKC, eastern Bering Sea snow crab, and eastern Bering Sea
  Tanner crab. Layers provided by Emily Ryznar -- thanks,
  Emily!

• get_base_layers(high.resolution.coast = TRUE) returns
  high resolution (1:63,360 scale) 2017 Alaska Department
  of Natural Resources coastline shapefile
  (https://tinyurl.com/4hvr3psb). The high resolution version
  is recommended for spatial analyses that require masking.
  The default option (high.resolution.coast = FALSE) returns
  a lower resolution coastline that loads faster and is
  suitable for general mapping/visualization.

IMPROVEMENTS

• Removed dplyr and raster removed from imports/dependencies.

BUG FIX

• Rename inst/extadata/NMFS Reporting Areas.shp to
  inst/extadata/NMFS_Reporting_Areas.shp to meet recommended
  portability standards for R packages.

3.5.4

akgfmaps 3.5.4 (September 23, 2024)

BUG FIX

• Fix label formatting issue in make_idw_map() and
  make_idw_stack().

3.5.3

akgfmaps 3.5.3 (May 22, 2024)

BUG FIX

• NMFS Statistical Area 659 is now included in the output of
  get_nmfs_areas(). It had been erroneously not included in the
  output.

3.5.2

akgfmaps 3.5.2 (May 20, 2024)

IMPROVEMENTS

• Replace PROJ4 strings with EPSG IDs.

v3.5.1

akgfmaps 3.5.1 (April 10, 2024)

IMPROVEMENTS

• get_base_layers() now accepts an argument to split land
  polygons into east and west when set.crs is a geographic
  coordinate system. The default is to split using
  split.land.at.180 = TRUE. Set this to FALSE when shifting
  coordinates afterwards.

NEW FEATURES

• Added make_wkt_table(), a function that calculates areas of
  simple features geometries in km^2, then converts simple
  features objects to data.frames where well-known text (WKT)
  strings represent geometries.

v3.5.0

akgfmaps 3.5.0 (March 19, 2024)

FUNCTIONALITY CHANGES

• The 2024 EBS shelf survey will not include corner stations
  around the Pribilof Islands and St. Matthew. Therefore,
  get_base_layers() now returns a survey.grid without corner
  stations for the EBS/SEBS. Users can still access a survey.grid
  with corner stations by setting include.corners = TRUE in
  get_base_layers, i.e.:

  get_base_layers(include.corners = TRUE)

  See also:

  DeFilippo, L., Kotwicki, S., Barnett, L., Richar, J., Litzow,
  M.A., Stockhausen, W.T., Palof, K., 2023. Evaluating the impacts
  of reduced sampling density in a systematic fisheries-
  independent survey design. Front. Mar. Sci. 10, 1–16.
  https://doi.org/10.3389/fmars.2023.1219283