A virtual base class for data models that store a selection, which might be of items, regions, or whatever. Clients can register handlers for selection changes and can create proxy models to transform selections, link across datasets and map selections to actions on the data.
This design is preliminary and subject to change.
Internally, the selection may be stored as any object, including as a
function that is invoked whenever the selection is stored or
retrieved. The function allows dynamic mapping of selections. Due to
this generality, the client should not access the selection
directly. Instead, it should explicitly coerce the selection object to
an interpretable representation. The set of supported coercions
depends on the subclass. For example,
ItemSelection has a
as.logical method that
coerces it to a logical vector, where an element is
TRUE if the
corresponding element in the dataset is selected.
Whenever the selection is changed, the
changed signal is
emitted. The signal has zero arguments. See the
package for details on using signals.
Eventually, a selection leads to the execution of some action by the
application. In interactive graphics, that action usually involves
scaling/transforming the selection to a modification on the data. The
x$scale(scaler, data) method tries to facilitate these
operaitons. All it does is create a handler for the
x that passes
data to the function
scaler, which implements the change.
Since any type of object can represent a selection, setting the
selection has very few constraints. There are several ways to modify
the selection. Not all of them will be supported by every subclass. In
the code snippets below,
x represents a
selection represents the primary representation of a
selection, like a logical vector.
x$replace(selection): this is supported by all
x$add(selection): the result contains the
union of the original selection and
x$subtract(selection): the result
contains the original selection except that indicated
x$intersect(selection): the result
contains the intersection of the original selection and
The intersection of the original selection and
deselected, that only in
selection is selected.
In interactive graphics, it is often necessary to link selections
within and across datasets. The
x$link(linker) method creates a
Selection object that proxies
x and maps the
linker. Changes to the selection
x will propagate via
linker to changes in the
proxy. Analogously, the
linker will pass modifications to the
proxy down to
linker may be provided as an integer vector, like that
match, but it is usually a function, as that
allows very general linking strategies. As an example, let us consider
a simple linker between two datasets based on key matching. We assume
that the keys,
dest_keys, are in the
enclosure of our linker function.
1 2 3 4 5 6
linker function takes one or two arguments, depending on
whether the selection is being retrieved or stored. When the selection
is being retrieved,
source_selection is passed as the only
argument. The duty of the
linker is then to retrieve the
underlying selection from
source_selection (through coercion,
see above) and figure out which keys in the destination selection
match the selected source keys. The
new_dest_value argument is
provided whenever the selection is being stored/set. In that case, the
analogous operation is performed, in the opposite direction. The
symmetry here is fairly obvious, and
is a utility for facilitating the implementation of such two-way
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.