R/class-glatos_receivers.r

In jsta/glatos: A package for the Great Lakes Acoustic Telemetry Observation System

#' Constructor function for the class glatos_receivers
#' 
#' @description Constructor function for the class glatos_receivers.
#' Currently barebones and only used inside read_glatos_receivers.
#'
#' @param x A data.frame or data.table created from a standard glatos 
#' receiver_location file.
#' 
#' @return A data.frame of class \code{glatos_receivers}:
#'
#' @note
#' This function may be developed in the future to dictate conversion 
#' constuction from a data frame. 

glatos_receivers <- function(x)  {

  #coerce to data.frame if not
  if(inherits(x, "data.table")) x <- as.data.frame(x)
  if(!inherits(x, "data.frame")) stop("x must be data.frame")
  
  #add new class as first but keep existing (e.g., data.frame)
  class(x) <- c("glatos_receivers", class(x))
  
  return (x)
}