spectacles (version 0.5-2-2)

features: Retrieves or sets the data slot of a SpectraDataFrame object.

Description

Either retrieves the attributes values from the data slot of a SpectraDataFrame object, or upgrades a Spectra object to a SpectraDataFrame object by initialising its data slot by a suitable "data.frame" object.

Usage

# S4 method for SpectraDataFrame
features(object,exclude_id)
# S4 method for Spectra
features(object,safe,exclude_id,key,append) <- value

Arguments

object

a Spectra object

exclude_id

see below

value

see below

safe

see below

key

see below

append

see below

Value

The features methods return a data.frame object, while the "features<-" methods return a SpectraDataFrame object.

Methods

x=Spectra

features(object, safe=TRUE, key=NULL, exclude_id=TRUE) <- value

rll

object A Spectra object safe Logical. If TRUE, data is being added to the object using a SQL join (using a key field given by the key option), otherwise it is assumed the order of the rows is consitent with the order of the rows in object key Character, name of the column of the data.frame storing the ids for the SQL join. Ignored if safe is FALSE. exclude_id Logical, if TRUE, ids used for the SQL join are removed from the data slot after the join.

x=SpectraDataFrame

features(obj, exclude_id=TRUE)

features(obj, safe=TRUE, key=NULL, exclude_id=TRUE, append=TRUE) <- value

rll object A SpectraDataFrame object safe Logical. If TRUE, data is being added to the object using a SQL join (using a key field given by the key option), otherwise it is assumed the order of the rows is consitent with the order of the rows in object key Character, name of the column of the data.frame storing the ids for the SQL join. Ignored if safe is FALSE. exclude_id Logical. For the features method, if TRUE, the spectra ids are added to the data.frame that is returned. For the "features<-" method, If TRUE, ids used for the SQL join are removed from the data slot after the join. append Logical, if TRUE, the data is appended to any existing data. if FALSE, the data provided is erasing any existing data.

See Also

spectra, wl, SpectraDataFrame-class

Examples

# NOT RUN {
# Loading example data
data(oz)
spectra(oz) <- sr_no ~ ... ~ 350:2500

# Printing available data
features(oz)

# Promoting a Spectra to a SpectraDataFrame object
s <- as(oz, "Spectra")

# Generating dummy data
d <- data.frame(
  id = ids(oz), 
  foo = runif(nrow(oz)), 
  bar = sample(LETTERS[1:5], size = nrow(oz), replace = TRUE)
)
head(d)

# Affecting data to Spectra object
features(s, key = 'id') <- d

# Adding data to an existing SpectraDataFrame object
features(oz, key = 'id') <- d
features(oz)

# Replacing data of an existing SpectraDataFrame object
features(oz, key = 'id', append = FALSE) <- d
features(oz)

# }