iplots (version 1.1-8)

iset: iSet and iVar - managing data in iPlots

Description

iPlots maintain a separate copy of all data that are displayed in the iPlots. This allows iPlots to opearate even after the underlying data has been deleted in R. It also allows iPlots to use hot linking in all aspects, including update of plots on data changes.

This data management consists mainly of two classes: iset and ivar. The iset object encapsuletes an iSets which can be thought of as a kind of special data frame that allows linking of all variables contained therein. Each variable (or column in data.frame-speech) is represented by an ivar object encapsulating an iVar.

An instance of a ivar class can be use to create new iplots or update data in the existing iplots. Convenience operators on both ivar and iset objects include those such as length, subsetting and subassignment and therefor from user's point of view it is possible to use them transparently a data frames (iSet) or vectors (iVar). In addition, iSet supports methods such as names or dim.

iset returns the object corresponding to a given iSet.

isets returs objects for all iSets

Usage

iset(which=iset.cur())
isets()
# S3 method for iset
[[(x, i)
# S3 method for iset
$(x, name)
# S3 method for iset
$(x, name) <- value
# S3 method for iset
[[(x, i) <- value
# S3 method for iset
[(x, i = 1:(dim(x)[1]), j = 1:length(x))
# S3 method for iset
[(x, i = 1:(dim(x)[1]), j = 1:length(x)) <- value
# S3 method for iset
names(x) <- value
# S3 method for iset
names(x)
# S3 method for iset
length(x)
# S3 method for iset
dim(x)

Arguments

x

iset object

i

row (case) index

j

column (variable) index

value

replacement value

which

An integer specifying an iSet ID or a string specifying a name of the iSet.

name

name of the variable

See Also

ivar, iset.cur

Examples

# NOT RUN {
data(iris)
s <- iset.new("iris", iris)
rm(iris)
s[]
names(s)
dim(s)
length(s)
s[[1]]
s$Species
s[1:5,c("Sepal.Length","Petal.Length")]
rm(s)
# even if we get rid of the reference object,
# we can get it back
s <- iset()
s
# see ?ivar for more examples
# }