The [[<- method works for all oce objects.
The purpose, as with the related extraction method, [[,
is to insulate users from the internal details of oce
objects, by looking for items within the various storage
slots of the object. Items not actually stored can also be
replaced, including units and data-quality
flags.
Arguments
- x
a ctd object.
- i
character value naming the item to replace.
- j
optional additional information on the
iitem.- ...
optional additional information (ignored).
- value
The value to be placed into
x, somewhere.
Details
As with [[ method, the procedure works in steps.
First, the metadata slot of x is checked to
see whether it contains something named with i.
If so, then the named item is replaced with value.
Otherwise, if the string value of i ends in Unit, then the
characters preceding that are taken as the name of a variable, and
the metadata slot of x is updated to store that unit, e.g.
Similarly, if i ends in Flag, then quality-control
flags are set up as defined by result, e.g.
Otherwise, pmatch() is used for a partial-string match with
the names of the items that are in the data slot of x.
The first item found (if any) is then updated to hold the value result.
If none of these conditions is met, a warning is issued.
See also
Other functions that replace parts of oce objects:
[[<-,adp-method,
[[<-,amsr-method,
[[<-,argo-method,
[[<-,bremen-method,
[[<-,cm-method,
[[<-,coastline-method,
[[<-,echosounder-method,
[[<-,g1sst-method,
[[<-,gps-method,
[[<-,ladp-method,
[[<-,landsat-method,
[[<-,lisst-method,
[[<-,lobo-method,
[[<-,met-method,
[[<-,oce-method,
[[<-,odf-method,
[[<-,rsk-method,
[[<-,sealevel-method,
[[<-,section-method,
[[<-,tidem-method,
[[<-,topo-method,
[[<-,windrose-method,
[[<-,xbt-method
Other things related to ctd data:
CTD_BCD2014666_008_1_DN.ODF.gz,
[[,ctd-method,
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.saiv(),
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()
Examples
data(ctd)
summary(ctd)
#> CTD Summary
#> -----------
#>
#> * Instrument: SBE 25
#> * Temp. serial no.: 1140
#> * Cond. serial no.: 832
#> * File: "/Users/kelley/git/oce/create_data/ctd/ctd.cnv"
#> * Original file: c:\seasoft3\basin\bed0302.hex
#> * Start time: 2003-10-15 15:38:38
#> * Sample interval: 1 s
#> * Cruise: Halifax Harbour
#> * Vessel: Divcom3
#> * Station: Stn 2
#> * Mean Location: 44.684N 63.644W
#> * Data Overview
#>
#> Min. Mean Max. Dim. NAs OriginalName
#> scan 130 220 310 181 0 "scan"
#> timeS [s] 129 219 309 181 0 "timeS"
#> pressure [dbar] 1.48 22.885 44.141 181 0 "pr"
#> depth [m] 1.468 22.698 43.778 181 0 "depS"
#> temperature [°C, IPTS-68] 2.919 7.5063 14.237 181 0 "t068"
#> salinity [PSS-78] 29.916 31.219 31.498 181 0 "sal00"
#> flag 0 0 0 181 0 "flag"
#>
#> * Processing Log
#>
#> - 2018-11-14 20:03:47 UTC: `create 'ctd' object`
#> - 2018-11-14 20:03:47 UTC: `read.ctd.sbe(file = file, debug = 10, processingLog = processingLog)`
#> - 2018-11-14 20:03:47 UTC: `oce.edit(x = ctd, item = "startTime", value = as.POSIXct(gsub("1903", "2003", format(ctd[["startTime"]])), tz = "UTC") + 4 * 3600, reason = "file had year=1903, instead of 2003", person = "Dan Kelley")`
# Move the CTD profile a nautical mile north.
ctd[["latitude"]] <- 1 / 60 + ctd[["latitude"]] # acts in metadata
# Increase the salinity by 0.01.
ctd[["salinity"]] <- 0.01 + ctd[["salinity"]] # acts in data
summary(ctd)
#> CTD Summary
#> -----------
#>
#> * Instrument: SBE 25
#> * Temp. serial no.: 1140
#> * Cond. serial no.: 832
#> * File: "/Users/kelley/git/oce/create_data/ctd/ctd.cnv"
#> * Original file: c:\seasoft3\basin\bed0302.hex
#> * Start time: 2003-10-15 15:38:38
#> * Sample interval: 1 s
#> * Cruise: Halifax Harbour
#> * Vessel: Divcom3
#> * Station: Stn 2
#> * Mean Location: 44.701N 63.644W
#> * Data Overview
#>
#> Min. Mean Max. Dim. NAs OriginalName
#> scan 130 220 310 181 0 "scan"
#> timeS [s] 129 219 309 181 0 "timeS"
#> pressure [dbar] 1.48 22.885 44.141 181 0 "pr"
#> depth [m] 1.468 22.698 43.778 181 0 "depS"
#> temperature [°C, IPTS-68] 2.919 7.5063 14.237 181 0 "t068"
#> salinity [PSS-78] 29.926 31.229 31.508 181 0 "sal00"
#> flag 0 0 0 181 0 "flag"
#>
#> * Processing Log
#>
#> - 2018-11-14 20:03:47 UTC: `create 'ctd' object`
#> - 2018-11-14 20:03:47 UTC: `read.ctd.sbe(file = file, debug = 10, processingLog = processingLog)`
#> - 2018-11-14 20:03:47 UTC: `oce.edit(x = ctd, item = "startTime", value = as.POSIXct(gsub("1903", "2003", format(ctd[["startTime"]])), tz = "UTC") + 4 * 3600, reason = "file had year=1903, instead of 2003", person = "Dan Kelley")`