NEWS

navmaps 1.3.0 (March 19, 2025)
----------------------------------------------------------------

NEW FEATURES

- planning_station_proximity() function that performs nearest 
  station and ith nearest station distance calculations and 
  summarizes results.
- planning_build_clusters() function that builds a cluster of 
  size max_stations for each station by traveling the shortest 
  possible distance to reach max_stations.

NEW FUNCTIONALITY

- Add Hamilton path solution to planning_solve_station_tsp().

BUG FIX

- Fix global variable error in planning_calc_survey_days().


navmaps 1.2.1 (March 13, 2025)
----------------------------------------------------------------

IMPROVEMENTS

- Add more outputs to planning functions introduced in 1.2.0.
- Added documentation for TimeZero functions and improved date
  time handling.


NEW LAYERS

- Add 2025 SSL rookery points and polygons to /assets/. 
  Generated using /analysis/ssl_rookeries/make_ssl_ntz_polygon.R.
- Removed historical NTZ and rookery files.


navmaps 1.2.0 (March 10, 2025)
----------------------------------------------------------------

NEW FEATURES

- Added two new functions, planning_solve_station_tsp() and 
  planning_calc_survey_days(), to estimate the number of days 
  required to complete a survey design given a station sampling 
  allocation and operational assumptions. Distance optimization 
  is accomplished using the nearest insertion method to solve 
  the traveling salesman problem (TSP).
  

navmaps 1.1.10 (June 9, 2024)
----------------------------------------------------------------

IMPROVEMENTS

- sf_to_globe_linestring(), sf_to_globe_points(), and 
  sf_to_globe_track() automatically convert inputs to WGS84 
  prior to writing to outputs to avoid unexpected behaviors.


navmaps 1.1.9 (April 29, 2024)
----------------------------------------------------------------

NEW FEATURES

- Added new sf_to_globe_track() and sf_to_kml_track() functions 
  that add POINT or LINESTRING data to Globe or TimeZero-formatted
  kml track files. Track files can be generated from POINT or 
  LINESTRING geometries by setting argument tracks = TRUE. 
  Valid output file types are .mdb, .accdb, and .csv.
  
  Globe example:
  
  sf_to_nav_file(x = {sf object}, 
                 file = "{output_name}.mdb"",
                 tracks = TRUE, 
                 software_format = "globe")
  
  TimeZero example: 
  
  sf_to_nav_file(x = {sf object}, 
                 file = "{output_name}.kml"",
                 tracks = TRUE, 
                 software_format = "timezero")
                 
- Added functions for extracting and converting data from a 
  TimeZero database: get_tz_data(), convert_tz_coords(), 
  convert_tz_date(), convert_tz_to_gps().

IMPROVEMENTS

- make_station_allocation() now accepts arguments for vessel_color
  and vessel_symbol, which allows uses to specify color and symbol
  values. If passed as a named vector, colors and symbols can be
  assigned to specific values in the vessel column field of the 
  input.
  

navmaps 1.1.8 (April 12, 2024)
----------------------------------------------------------------

NEW FEATURE

- Added a new extract_crabpot_unedited() function that extracts
  linestrings and points from a Globe database.


navmaps 1.1.7 (April 11, 2024)
----------------------------------------------------------------

NEW FEATURES

 - globe_to_sf() can now import spreadsheets (.csv, .xls, .xlsx)
   exported from Globe databases.


navmaps 1.1.6 (April 5, 2024)
----------------------------------------------------------------

IMPROVEMENTS

- Added option to export GLOBE INDEX fields using globe_to_sf(),
  by setting keep_index = TRUE.

BUG FIX

- Corrected issue with incorrect LINESTRING plotting order in 
  globe_to_sf().
  
- Modified internal functions for dms_string_to_dd() to permit 
  varying numbers of decimal digits in degree decimal minute 
  and degree minute decimal second coordinate string.
  

navmaps 1.1.5 (March 31, 2024)
----------------------------------------------------------------

NEW FEATURES

- Added safe_st_write(). This function is used to correct geometry
  issues and remove invalid geometries (e.g. linestrings with one
  point), then write geometries to a file.


navmaps 1.1.4 (March 29, 2024)
----------------------------------------------------------------

NEW FEATURES

- Added get_trawl_data_for_charts(). This function is used 
  internally at AFSC to retrieve AI and GOA catch and haul data 
  from RACEBASE and write it to csv files that Mark Zimmermann
  uses to produce survey charts in ArcGIS.


navmaps 1.1.3 (January 28, 2024)
----------------------------------------------------------------

NEW FEATURES

- Added transform_4326_to_3857() and transform_3857_to_4326()
  functions to convert between WGS84 Pseudo-mercator (used by
  Time Zero) and WGS84.
  
FUNCTIONALITY CHANGES
- get_connected() causes an error if the RODBC connection is not
  successfully established.


navmaps 1.1.2 (January 11, 2024)
----------------------------------------------------------------

IMPROVEMENTS

- globe_to_sf() can now import track data from Globe MS Access
  databases.


navmaps 1.1.1 (December 12, 2023)
----------------------------------------------------------------

FUNCTIONALITY CHANGES

- Added driver arguments to globe_to_sf() and write_to_access()
  to accomodate differences in access drivers among users. The
  default changed from "Microsoft Access Driver (*.mdb, *.accdb)"
  to "Microsoft Access Driver (*.mdb)"

IMPROVEMENTS

- Add farver (for color mapping).
- Update function documentation.


navmaps 1.1.0 (November 11, 2023)
----------------------------------------------------------------

NEW FEATURES

- Added a start_end_to_midpoint() function to calculate the 
  midpoint between pairs of coordinates in WGS84 (e.g. 
  start latitudes/longitudes, end latitudes/longitudes).