brush(x, collab=<<see below>>, rowlab=<<see below>>, hist=F, spin=T)
dimnames(x)[[2]]
, if present,
or else the default is
"var 1"
,
"var 2"
, ...
dimnames(x)[[1]]
, if present,
or else the default is
"case 1"
,
"case 2"
, ...
TRUE
, marginal histograms will be drawn for each variable.
TRUE
, then a small spinning 3D scatterplot will be displayed.
For directions on using it see the
spin
command.
brush
is exited.
If no points are highlighted, nothing is returned.
x
in the style of
pairs
.
If requested, it will draw all the univariate histograms in the bottom margin
and/or a spinning 3-dimensional scatterplot of the data.
A scrolling list of all the case names is also present.
Elements of these can be interactively "highlighted" and "downlighted".
The only graphics devices under which this function works are
the
motif
,
openlook
,
X11
, the
apollo
(on an Apollo workstation only)
or the
suntools
(on a Sun workstation only).
LAYOUT.
There are four basic components of the
brush
layout: the scatterplots (and
histograms), the spin window, the case menu, and the
brush
control panel.
The control panel allows the user to change the style of brushing,
to make a hard copy of the plot or to leave the program.
QUITTING.
To exit
brush
, place the cursor over the box labeled
"Quit"
and
press the left mouse button (hold it down until it says
"Bye"
).
The
brush
layout will remain,
but a prompt will be given in the S-PLUS command window.
No other S-PLUS commands are evaluated until
brush
is exited.
BRUSHING.
Use the mouse to move the cursor over data points of interest:
points in a scatter plot, names in the case menu, or bars in a histogram.
Press the left button on the mouse to select those points under
the cursor and they will be highlighted on all of the data displays.
Press the middle button (both buttons on a two button mouse)
to "downlight" the points under the cursor.
To change the size of the brush, move the cursor to the
"brush size"
box.
Hold down the left button and a corner of the brush will follow the cursor
(the other corners will follow symmetrically).
You must start reshaping the brush from within the box labeled
"brush size"
but you can make the brush larger than that box by dragging the corner out.
The brush size controls the size of the area considered to
be under the influence of the cursor while you are highlighting points.
Near the
"brush size"
box lies the
"label/no label"
box.
One of the entries will be circled.
To change this option, place the cursor over the desired choice and press
the left mouse button.
When in the
"label"
state, each point which becomes highlighted
will have its row label printed next to it.
This produces a rather busy plot with large brush sizes.
There is also a box with a list of highlighting symbols.
Click over the symbol you wish to use (the one in use will be boxed).
Previously highlighted points will retain their highlighting symbol.
Another option is
"transient"
brushing versus
"persistent"
brushing.
When in the
"transient"
state, points are selected
only if they are under the current position of the brush;
when you move the brush with the button down to highlight
more points, the old points are automatically downlighted.
When in the
"persistent"
state, the highlighting status remains
even after the cursor is moved away.
One button (the left) is used to add highlighting, another
(the middle, or both buttons simultaneously for a two button mouse) is used
to remove highlighting.
THE CASE MENU.
The list of case names is often too long to fit on the screen,
so it is placed in a scrolling menu.
To move down (up) the list a page at a time,
press the left mouse button while the cursor is in the
"down more"
(
"up more"
) box at the bottom (top) of the list.
The slider in the panel to the right of the list represents where
in the list you are.
To move a long way through the list, click the left mouse button over the point
where you want the slider.
If you want to find a point with a certain name, click the left mouse button
on the
"Find"
box at the bottom of the list and it will ask
you to type the name you wish to find.
The "name" may be a "regular expression" as used by the
"vi"
or
"ed"
text editors.
If the name is in the list it will be selected.
If you are in the
"persistent"
state, the button you press on the
"Find"
box is significant: the left will highlight the chosen point,
the middle (both simultaneously on a two button mouse) will downlight it.
In the transient state all buttons are equal.
Note: the
"Find"
box is not available
when using
brush
with the
X11
device.
PRINTING.
To make a hardcopy of the
brush
display, press the left
mouse button in the
"Save"
box;
it will say
"Wait"
until the plot is finished.
See
printgraph
for a description of hardcopy printing.
Note: hardcopy for
brush
is currently available only with
suntools
.
Cleveland, W. S. and McGill, M. E., editors (1988). Dynamic Graphics for Statistics. Wadsworth & Brooks/Cole, Belmont, California.
brush(state.x77, hist=T)