ade4TkGUI {ade4TkGUI}R Documentation

Tcl/Tk GUI for the ade4 package


A Tcl/Tk GUI for some basic functions in the ade4 package.


ade4TkGUI(show = FALSE, history = FALSE)



a logical value. If TRUE, R commands executed in the GUI are echoed to the console.


a logical value. If TRUE, R commands executed in the GUI are stored in the R session history.


Right-click on ade4 function buttons to get help on these functions. You can also click on the questionhead icon in the dialog windows. This displays the R help for the corresponding function.

In all dialog windows, entries can either be filled with a Set button, or typed directly in the entry field. The Set button displays a listbox with a list of available objects in the global environment. This list is restricted to objects with an adequate type (dataframe, dudi, factor, etc). Entries can also be filled directly by typing the desired value. In this case, R expressions can also be entered, for example c("red", "green", "blue"), doubs$mil[1:20,1:5], meau$plan$dat , or 1:20.


The first row of buttons (- Data sets -) is used to load data sets, either from a tab-delimited text file exported from Excel (Read data file button), or from the ade4 package built-in datasets (Load a data set button; right-click to get help on the selected dataset).

The second block of buttons (- One table analyses -) gives access to simple analyses (like pca), in which only one table is analysed.

The third block (- One table with groups -) is for analyses in which the rows of the table belong to several groups. This is the case for example for discriminant analysis (discrimin) and for the within and between analyses (see ade4 documentation).

The fourth block (- Two tables analyses -) gives access to three analyses in which the relationships between two data tables are analysed. cca is the well known (at least in ecology) canonical correspondence analysis, coinertia can be seen as a robust alternative to cca when the number of samples is low, and pcaiv is principal components analyses with respect to instrumental variables (see ade4 documentation).

The fifth block (- Graphic functions -) contains three buttons that launch the dialog windows for three basic graphic functions in ade4 : s.label (scatter diagram of a factor map), s.class (scatter diagram with groups), s.value (scatter diagram with squares proportional to one variable).

Other graphic functions are available in the Graphics menu : s.arrow (scatter diagram with arrows), s.corcircle (correlation circle in normed pca), s.class (scatter diagram with convex hulls, using the chullSize argument), and s.match (scatter diagram of two paired clouds of points).

The sixth block (- Advanced graphics -) can be used for several things:

- dudi display displays a dialog window grouping all the components of a dudi. Each of these components is represented by a button which action is to draw a graphical display of the corresponding component. The axes used to draw theses graphics can be set by the user. The last row of buttons gives access to particular graphic functions that can be used according to the dudi type.

- MCTests displays a dialog window for computing Monte-Carlo tests after (e.g.) a between or coinertia analysis.

- ordiClust displays a dialog window for analysing cluster on ordination scores, providing a dynamic exploration of the clusters on the factor maps.

Menu bar

The menu bar at the top of the window can be used to launch the same functions, plus several others. All theses menus are tear-off.

The File menu can be used to read and load files and datasets, to edit a dataframe, and to quit R :

- Read text file allows to read a data file and store the result in a dataframe. It can be used to read standard Excel tab-delimited text files (with variable names on the first row and sample names in the first column, leaving the first cell empty). The name "clipboard" can be used to read a data table just copied from an Excel data sheet (so it is not necessary to save the data in a text file).

- Load data set allows to load a data set from the ade4 package.

- Edit data frame can be used to edit a dataframe.

- Quit R opens a dialog window to ask if the environment should be saved before quitting R.

The Windows menu allows to manage several graphical windows :

- New graphic window opens a new graphic window and makes it the active window. This is usefull to compare easily several graphics.

- Change graphic window changes the active window (i.e., the one into which the next graphic will be drawn).

- Save graphic window saves the graphic drawn in the active window into a disk file in several formats (postscript, pdf, etc).

The 1table, 1table+groups, 2tables, and Graphics menus give access to several other analysis methods and graphics.

History and command line echoing

If the show argument is set to TRUE, then all the commands executed in the GUI are echoed to the console. This is handy for complex commands, as it allows to check the exact syntax of the command that was executed.

If the history argument is set to TRUE, then the commands executed in the GUI (the same as the commands which are echoed to the console) are stored in the R session history buffer. For each command, the history buffer is written to a temporary disk file with savehistory(), the command is appended to this file, and the file is reread in memory with loadhistory().

The value (TRUE or FALSE) of both arguments is recalled in the title of the window (ade4TkGUI), so that different instances of the GUI launched simultaneously with different values for these arguments can be easily recognized.


Jean Thioulouse
Stephane Dray


## Not run: 
## Start the GUI

## End(Not run)

[Package ade4TkGUI version 0.3-1 Index]