playSelectData {playwith} | R Documentation |
Part of the playwith Application Programming Interface.
playSelectData(playState = playDevCur(), prompt = paste("Click or drag to select data points;", "Right-click or Esc to cancel."), scales = "dynamic", foo = playRectInput(playState, prompt = prompt, scales = scales))
playState |
a playState object representing the plot, window and device. |
prompt |
text to display in the prompt. |
scales |
the default allows the user to hold Shift while dragging, to constrain the selection to x or y scales. Otherwise this should be one or more of "x" and "y", specifying which axes to select along. |
foo |
rectangular plot region structure, usually generated interactively. |
playSelectData
is similar to identify
.
The user is prompted to click or drag to select data points.
If a click, the nearest point is selected, if it is within 11 points.
If it is a drag, all points within the rectangular region are selected.
Note that data points can be selected from one panel of a multi-panel
lattice plot without specifying the panel beforehand.
playSelectData
returns NULL
if the user cancelled (e.g. by right-clicking).
Otherwise a list with:
|
character, specifies the plot space in which data points were selected.
See the space argument to playDo .
|
|
indices of the data points selected. This relies on the data being guessed
correctly from the plot call, unless data.points was specified explicitly.
|
|
values of the selected data points. |
|
logical, whether it was a click (otherwise a drag). |
|
position of click relative to the closest point,
as in the pos argument to text .
If is.click is false, this is NULL .
|
... |
as well as all the other elements returned by
playRectInput .
|
Felix Andrews felix@nfrac.org
if (interactive()) { library(lattice) playwith(xyplot(Sepal.Width ~ Petal.Width | Species, data = iris)) playSelectData() }