explore: Factor map dynamic exploration function

Description Usage Arguments Details Operation modes Author(s) Examples

Description

This function provides graphical tools for dynamically exploring the factor maps obtained in multivariate data analysis. Many operations like zooming, panning, and searching are possible. This is particularly usefull for large datasets, as it is very difficult to identify one particular item on a cluttered factor map.

Usage

1
explore(call.graph, scale.graph=1.3)

Arguments

call.graph

a call to a graphical function of the ade4 package (s.label, s.arrow, s.class, or s.value).

scale.graph

a scale factor used to resize the drawing. This is particularly usefull for small laptop screens.

Details

The main window displays the factor map corresponding to the first argument function call. Under this graph, three buttons can be used to close the window, save the graph in a file, and redraw the original graph. A scale widget allows to zoom in or out on the graph (this operation can be slow when the number of points is high).

In the top-right part of the main window, a small graph shows the density distribution of points on the factor map, and a red rectangle shows which part of the graph has been zoomed in.

Under this small graph, four radiobuttons can be used to set the operation mode (see below Operation modes). The Show commands in R console checkbox button allows to echoe the commands to the console.

The Find a point panel gives a list of the labels. Clicking on one label redraws the main graph, centering it around the selected item and displaying it in red. This is handy to locate rapidly a particular item. The text field just above the listbox can be used to type a character string. The list of labels is then searched dynamically as characters are typed and the list is restricted to labels matching the typed string.

The Label options panel is used only when in Labels mode (see below Operation modes).

At the bottom-right of the window, the Information panel lists item labels and x & y coordinates in a listbox.

Operation modes

Zoom mode is the default mode: clicking in the main graph window increases the zoom factor around the coordinates of the click. If a drag operation is performed (button press, mouse move, button release), then the zone defined by this operation is zoomed in.

Pan mode just moves the center of the main graph to the coordinates where the click occured.

Labels mode gives access to the four buttons of the label options panel. The two buttons Add all and Remove all remove all the labels (leaving only small black dots) or set them back in the graph. The Select... button display a listbox with all the labels, allowing to select some of them, which are then displayed on the factor map. The By values... button also allows to select labels, but based on the x and y numerical ranges.

Identify mode is usefull when labels are not displayed. It gives the label of the nearest item after a mouse click in the main graph window. Typical use is after zooming to separate cluttered points.

Author(s)

Jean Thioulouse jean.thioulouse@univ-lyon1.fr
Stephane Dray stephane.dray@univ-lyon1.fr

Examples

1
2
3
4
5
6
7
## Not run: 
## Start the GUI
data(meau)
acpmil <- dudi.pca(meau$mil, scannf=F)
explore(s.label(acpmil$li))

## End(Not run)

ade4TkGUI documentation built on May 2, 2019, 5 p.m.

Related to explore in ade4TkGUI...