iplots (version 1.1-7)

iset.list: iSet management functions.

Description

These functions are used to manage iSets. An iSets groups all iPlots which use the same data as a basis. All iPlots belonging to an iSet are linked, that is selecting cases in one iPlot cause the same cases to be highlighted in all other iPlots based on the same iSet. The linking is done on case-level, therefore the variables should have the same number of cases.

You can get the iset object by calling the iset function. An iset object can be used in a way similar to data frames, so subsetting and other operations work as expected. Subassignment is always done "live", so changeing parts of the data will cause plots to be updated accordingly.

There is always exactly one current iSet. An initial iSet called "default" is created when the iplots library is loaded. All new iPlots are created using the current iSet. The set of functions described here allow the manipulation of iSets.

Note that changing the iSet also has an effect on iplot.list and iobj.list since iPlots are linked to their iSets.

iset.new creates a new iSet and makes it current

iset.list returns all iSets

iset.cur returns the ID of the current iSet

iset.next and iset.prev return the ID of the next resp. previous iSet in the list relative to the iSet specified by the argument.

iset.set makes the iSet with the specified ID current.

iset.rm removes the given iSet and all associated plots. Note that this may cause the current set ID may change (even if some other iSet is removed).

print.iset prints an iSet object.

Usage

iset.new(name=NULL, payload=NULL)
iset.list()
iset.cur()
iset.next(which=iset.cur())
iset.prev(which=iset.cur())
iset.set(which=iset.next())
iset.rm(which=iset.cur())
# S3 method for iset
print(x, ...)

Arguments

name

Name of the new iSet. If no name is specified, an automatic name of the form "data.X" is created where "X" is an integer. The name can be used instead on an ID in many cases.

payload

Initial contents of the iSet in the form of a list/data.frame or NULL if an empty iSet is desired.

which

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

x

An iSet object to print

...

further parameters to be passed to print

Methods

show

signature(object = "iset"): is mapped to print.iset

See Also

iset, iplot.list, iobj.list