explore              package:ade4TkGUI              R Documentation

_F_a_c_t_o_r _m_a_p _d_y_n_a_m_i_c _e_x_p_l_o_r_a_t_i_o_n _f_u_n_c_t_i_o_n

_D_e_s_c_r_i_p_t_i_o_n:

     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.

_U_s_a_g_e:

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

_A_r_g_u_m_e_n_t_s:

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.

_D_e_t_a_i_l_s:

     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.

_O_p_e_r_a_t_i_o_n _m_o_d_e_s:

     '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.

_A_u_t_h_o_r(_s):

     Jean Thioulouse jthioulouse@biomserv.univ-lyon1.fr 
      Stephane Dray dray@biomserv.univ-lyon1.fr

_E_x_a_m_p_l_e_s:

     ## Not run: 
     ## Start the GUI
     data(meau)
     acpmil <- dudi.pca(meau$mil, scannf=F)
     explore(s.label(acpmil$li))
     ## End(Not run)

