support glatos workbook version 1.4; fix #272

Author: chrisholbrook

DESCRIPTION

@@ -2,8 +2,8 @@ Package: glatos
 Type: Package
 Title: A package for the Great Lakes Acoustic Telemetry Observation System
 Description: Functions useful to members of the Great Lakes Acoustic Telemetry Observation System https://glatos.glos.us; many more broadly relevant to simulating, processing, analysing, and visualizing acoustic telemetry data.
-Version: 0.9.0.9001
-Date: 2025-09-12
+Version: 0.9.0.9002
+Date: 2025-09-24
 Depends: R (>= 3.6.0)
 Imports:
 		av,

NAMESPACE

@@ -8,6 +8,7 @@ export(as_glatos_animals)
 export(as_glatos_detections)
 export(as_glatos_receivers)
 export(calc_collision_prob)
+export(cast)
 export(check_dependencies)
 export(check_vdat)
 export(check_vue)
@@ -30,6 +31,7 @@ export(glatos_check_col_classes)
 export(glatos_check_col_names)
 export(glatos_detections)
 export(glatos_receivers)
+export(identify_workbook_version)
 export(install_ffmpeg)
 export(interpolate_path)
 export(is_glatos_animals)
@@ -56,6 +58,7 @@ export(read_vdat_csv)
 export(read_vemco_tag_specs)
 export(read_vue_detection_csv)
 export(read_vue_event_csv)
+export(read_workbook_project)
 export(real_sensor_values)
 export(receiver_line_det_sim)
 export(residence_index)
@@ -72,6 +75,7 @@ export(vrl2csv)
 export(vue_convert)
 export(write_vdat_csv)
 import(data.table)
+import(readxl)
 import(sp)
 importFrom(data.table,foverlaps)
 importFrom(dplyr,"%>%")

NEWS.md

@@ -1,10 +1,22 @@
 ----
 
-# glatos 0.9.0 dev (2025-09-12)
+# glatos 0.9.0 dev (2025-09-24)
 
 
 ### New features
 
+- Added support for GLATOS workbook version 1.4 (xlsx file) in 
+`read_glatos_workbook()`. 
+  - Excel workbooks in version 1.4 have no macros and have column headers 
+  in the first row (v. 1.3 has an empty first row and usually had macros).
+  - Added new input argument `simplify` which allows (when `simplify = TRUE`)
+  return of a list with the same structure as the input workbook (e.g., 
+  columns named "Deployment", "Recovery", "Tagging", ...). 
+  - Disallow multiple columns with the same name (returns an error). In earlier 
+  versions, a suffix was added to all but the first in each set of duplicate 
+  column names. 
+  - fixes [issue #272](https://github.com/ocean-tracking-network/glatos/issues/272)
+
 - Added support for parquet files in `read_otn_detections()`.
   - fixes [issue #254](https://github.com/ocean-tracking-network/glatos/issues/254)
 

R/class-glatos_workbook.r

@@ -7,7 +7,7 @@
 #' (*.xlsm) file.
 #'
 #' @return A list of class `glatos_workbook` created from a standard GLATOS
-#'   data workbook (*.xlsm) file with three elements:
+#'   data workbook (*.xlsx or *.xlsm) file with three elements:
 #' \describe{
 #'   \item{metadata}{A list with data about the project.}
 #'   \item{animals}{A data frame with data about tagged animals.}
@@ -16,7 +16,7 @@
 #'
 #' @note
 #' This function may be developed in the future to dictate conversion
-#' constuction from a data frame.
+#' construction from a data frame.
 #'
 #' @keywords internal