read.xbt: Read an xbt file

In dankelley/oce: Analysis of Oceanographic Data

Read an xbt file

Description

Three file types are handled: (1) the "sippican" format of Sippican XBT files with space-separated data columns, (2) a related ⁠"sippican2⁠ format, (also known as MK21 export format) in which data columns are separated by tab characters, and (3) the "noaa1" format. These three types are handled either by setting type to the named string, or by directly calling read.xbt.edf(), read.xbt.edf2(), or read.xbt.noaa1().

Usage

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

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", "sippican2", 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.

Value

An xbt object.

Author(s)

Dan Kelley

References

1. 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.

See Also

Other things related to xbt data: [[,xbt-method, [[<-,xbt-method, as.xbt(), plot,xbt-method, read.xbt.noaa1(), read.xbt.noaa2(), subset,xbt-method, summary,xbt-method, xbt, xbt-class, xbt.edf, xbt2.edf

Examples

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

dankelley/oce documentation built on March 1, 2025, 6:36 p.m.