Coerce Something Into an Oce Object
as.oce(x, ...)an item containing data. This may be data frame, list, or an oce object.
optional extra arguments, passed to conversion functions
as.coastline or ODF2oce, if these are used.
as.oce returns an object inheriting from oce-class.
This function is limited and not intended for common use.
In most circumstances, users should employ a function such
as as.ctd to construct specialized oce sub-classes.
as.oce creates an oce object from data contained within its
first argument, which may be a list, a data frame, or an object
of oce-class. (In the last case, x is
simply returned, without modification.)
If x is a list containing items named longitude and
latitude, then as.coastline is called (with
the specified … value) to create a coastline object.
If x is a list created by read_odf from the (as
yet unreleased) ODF package developed by the Bedford Institute of
Oceanography, then ODF2oce is called (with
no arguments other than the first) to calculate a return value.
If the sub-class inference made by ODF2oce is
incorrect, users should call that function directly, specifying
a value for its coerce argument.
If x has not been created by read_odf, then the names
of the items it contains are examined, and used to try to infer
the proper return value. There
are only a few cases (although more may be added if there is
sufficient user demand). The cases are as follows.
If x contains items named temperature,
pressure and either salinity or conductivity,
then an object of type ctd-class will be returned.
If x contains columns named longitude and latitude,
but no other columns, then an object of class coastline-class
is returned.