read.xbt: Read an xbt file

Description

Two file types are handled: (1) the "sippican" format, used for Sippican XBT files, handled with read.xbt.edf(), and (2) the "noaa1" format, handled with read.xbt.noaa1(). The first of these is recognized by read.oce(), but the second must be called directly with read.xbt.noaa1().

Usage

read.xbt(
  file,
  type = "sippican",
  longitude = NA,
  latitude = NA,
  encoding = "latin1",
  debug = getOption("oceDebug"),
  processingLog
)

Value

An xbt object.

Arguments

file: a connection or a character string giving the name of the file to load.
type: character string indicating type of file, with valid choices being "sippican" and "noaa1".
longitude, latitude: optional signed numbers indicating the longitude in degrees East and latitude in degrees North. These values are used if type="sippican", but ignored if type="noaa1", because those files contain location information.
encoding: a character value that indicates the encoding to be used for this data file, if it is textual. The default value for most functions is "latin1", which seems to be suitable for files containing text written in English and French.
debug: a flag that turns on debugging. The value indicates the depth within the call stack to which debugging applies.
processingLog: if provided, the action item to be stored in the log. This parameter is typically only provided for internal calls; the default that it provides is better for normal calls by a user.

Author

Dan Kelley

References

Sippican, Inc. "Bathythermograph Data Acquisition System: Installation, Operation and Maintenance Manual (P/N 308195, Rev. A)," 2003. https://pages.uoregon.edu/drt/MGL0910_Science_Report/attachments/MK21_ISA_Manual_Rev_A.pdf.

Examples

Run this code

library(oce)
xbt <- read.oce(system.file("extdata", "xbt.edf", package="oce"))
summary(xbt)
plot(xbt)

Run the code above in your browser using DataLab