brush(x, collab=<<see below>>, rowlab=<<see below>>, hist=F, spin=T)
Graphical parameters may also be supplied as arguments to this function (see par).
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.
brush(state.x77, hist=T)