oce (version 1.0-1)

[[<-,section-method: Replace Parts of a Section Object

Description

The [[<- method works for all oce objects, i.e. objects inheriting from oce-class. 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.

Usage

# S4 method for section
[[(x, i, j, ...) <- value

Arguments

x

A section object, i.e. inheriting from section-class

i

The item to replace.

j

Optional additional information on the i item.

...

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.

    x[["temperatureUnits"]] <- list(unit=expression(degree*F),scale="")

Similarly, if i ends in Flag, then quality-control flags are set up as defined by result, e.g.

    x[["temperatureFlags"]] <- c(2,4,2,2)

Otherwise, a partial string match is sought among the names of items in the data slot of x. (This is done with pmatch.) 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 things related to section data: [[,section-method, as.section, handleFlags,section-method, initializeFlagScheme,section-method, plot,section-method, read.section, section-class, sectionAddStation, sectionGrid, sectionSmooth, sectionSort, section, subset,section-method, summary,section-method

Other functions that replace parts of oce objects: [[<-,adp-method, [[<-,amsr-method, [[<-,argo-method, [[<-,bremen-method, [[<-,cm-method, [[<-,coastline-method, [[<-,ctd-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, [[<-,tidem-method, [[<-,topo-method, [[<-,windrose-method

Examples

# NOT RUN {
# 1. Change section ID from a03 to A03
data(section)
section[["sectionId"]]
section[["sectionId"]] <- toupper(section[["sectionId"]])
section[["sectionId"]]
# 2. Add a millidegree to temperatures at station 10
section[["station", 10]][["temperature"]] <-
    1e-3 + section[["station", 10]][["temperature"]]
# }