read.ctd.saiv() reads files that hold data acquired with a
SAIV model SD204 CTD profiler (reference 1). Since no
documentation on the format was available to the author,
this function was written based on examination of a particular
data file. This almost certainly will yield limitations
for other files, in particular for those with data names
that differ from those in the sample file (see
“Details” for this and other limitations).
Usage
read.ctd.saiv(
file,
encoding = "latin1",
debug = getOption("oceDebug"),
processingLog,
...
)Arguments
- file
a character string naming the file to be read.
- 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
an integer specifying whether debugging information is to be printed during the processing. This is a general parameter that is used by many
ocefunctions. Generally, settingdebug=0turns off the printing, while higher values suggest that more information be printed. If one function calls another, it usually reduces the value ofdebugfirst, so that a user can often obtain deeper debugging by specifying higherdebugvalues.- processingLog
ignored.
- ...
ignored.
Value
read.ctd.saiv() returns a ctd object.
Details
Some variable names are change to the oce convention, e.g.
"Sal." becomes "salinity", "Temp" becomes
"temperature", etc. In the first version of the code,
this renaming was done based on examination of a single file.
This list was expanded after a user kindly supplied a one-page
document that explains the variable names and units. As with
other functions for reading oce data, read.ctd.saiv()
resolves duplicate variable names by appending 2 to the second
instance, 3 to the third, etc.
As with other ctd objects, the [[ operator handles
both the original name from the file, and the converted oce
name.
It is worth noting the following oddities that were present
in the sample file upon which read.ctd.saiv() was based.
The header line that names the data columns ends with a tab, indicating the presence of 12 columns (the last unnamed), but the data contain only 11 columns. Therefore, the last tab character is ignored by
read.ctd.saiv().The test file lacked longitude and latitude information. This means that modern quantities like Absolute Salinity and Conservative Temperature cannot be computed. Users who know the location information ought to insert values into the object returned by
read.ctd.saiv()usingoceSetMetadata().Further to the previous point, it is not possible to compute pressure accurately from depth (which is what the header suggests the file contains) unless the latitude is known. In
read.ctd.saiv(), latitude is assumed to be 45 degrees north, which is the default used byswPressure().
References
SAIV A/S company website https://saiv.no/sd204-ctd-profiler
See also
Other things related to ctd data:
CTD_BCD2014666_008_1_DN.ODF.gz,
[[,ctd-method,
[[<-,ctd-method,
argo2ctd(),
as.ctd(),
cnvName2oceName(),
ctd,
ctd-class,
ctd.cnv.gz,
ctdDecimate(),
ctdFindProfiles(),
ctdFindProfilesRBR(),
ctdRaw,
ctdRepair(),
ctdTrim(),
ctd_aml_type1.csv.gz,
ctd_aml_type3.csv.gz,
d200321-001.ctd.gz,
d201211_0011.cnv.gz,
handleFlags,ctd-method,
initialize,ctd-method,
initializeFlagScheme,ctd-method,
oceNames2whpNames(),
oceUnits2whpUnits(),
plot,ctd-method,
plotProfile(),
plotScan(),
plotTS(),
read.ctd(),
read.ctd.aml(),
read.ctd.itp(),
read.ctd.odf(),
read.ctd.odv(),
read.ctd.sbe(),
read.ctd.ssda(),
read.ctd.woce(),
read.ctd.woce.other(),
setFlags,ctd-method,
subset,ctd-method,
summary,ctd-method,
woceNames2oceNames(),
woceUnit2oceUnit(),
write.ctd()
Other functions that read ctd data:
read.ctd(),
read.ctd.aml(),
read.ctd.itp(),
read.ctd.odf(),
read.ctd.sbe(),
read.ctd.ssda(),
read.ctd.woce(),
read.ctd.woce.other()