validate (version 0.1.4)

confront: Confront data with a (set of) expressionset(s)

Description

Confront data with a (set of) expressionset(s)

Usage

confront(dat, x, ref, ...)
## S3 method for class 'data.frame,indicator,ANY':
confront(dat, x, key = NULL, ...)
## S3 method for class 'data.frame,validator,ANY':
confront(dat, x, key = NULL, ...)
## S3 method for class 'data.frame,validator,environment':
confront(dat, x, ref, key = NULL,
  ...)
## S3 method for class 'data.frame,validator,data.frame':
confront(dat, x, ref, key = NULL,
  ...)
## S3 method for class 'data.frame,validator,list':
confront(dat, x, ref, key = NULL, ...)

Arguments

dat

An R object carrying data

x

An R object carrying rules.

ref

Optionally, an R object carrying reference data. See examples for usage.

...

Options used at execution time (especially 'raise'). See voptions.

key

(optional) name of identifying variable in x.

Using reference data

When reference data sets are given, it is assumed that rows in the reference data are ordered corresponding to the rows of dat, except when a key is specified. In that case, all reference datasets are matched against the rows of dat using key Nonmatching records are removed from datasets in ref. If there are records in dat that are not in ref, then datasets in ref are extended with records containing only NA. In particular, this means that wen reference data is passed in an environment, those reference data sets may altered by the call to confront.

Technically, reference data will be stored in an environment that is the parent of a (created) environment that contains the columns of dat.

See Also

• voptions

summary,validation-method, aggregate,validation-method, sort,validation-method summary,indication-method indicator, indicator-class validator, validator-class

Examples

# An example using reference data
v <- validator(weight == ref$weight)
summary(confront(women, v, women))

# Usging custom names for reference data
v <- validator(weight == test$weight)
summary( confront(women,v, list(test=women)) )

# Reference data in an environment
e <- new.env()
e$test <- women
v <- validator(weight == test$weight)
summary( confront(women, v, e) )

# the effect of using a key
w <- women
w$id <- letters[1:nrow(w)]
v <- validator(weight == ref$weight)

# with complete data; already matching
values( confront(w, v, w, key='id'))

# with scrambled rows in reference data (reference gets sorted according to dat)
i <- sample(nrow(w))
values(confront(w, v, w[i,],key='id'))

# with incomplete reference data
values(confront(w, v, w[1:10,],key='id'))