Installation Details

Below is a detailed step-by-step guide for installing Rattle.
Simpler instructions for installing Rattle are provided in
previous sections for Ubuntu and Debian
(Section A.3) and MS/Windows
(Section A.4) and might be preferred
to the more detailed discussion below.

For a particular operating system (e.g., GNU/Linux), be sure to follow
the relevant instructions.

Install the GTK+ libraries

GNU/Linux: these libraries will already be installed if you
are running Gnome.
MS/Windows: download the self-installing package,
gtk-dev-2.12.9-win32-2.exe,
from http://sourceforge.net/projects/gladewin32 and open it
(e.g., double click its icon once it is downloaded to your Desktop)
to install the libraries:

MS/Windows: run Glade3-3.6.1.exe

An alternative on MS/Windows that seems to work quite
wellA.1 is to run an R script that will install
everything required for GTK+. This R script installs the
rggobi
package (and other things it depends on). You
can start up R (after installing R as in step 2 below) and
then type the command:

source("http://www.ggobi.org/downloads/install.r")

This installs the GTK libraries for MS/Windows and the
rggobi
package for R. (You need R installed
already of course--see the next step.)

All Operating Systems: after installing GTK+ or any of the
other libraries, be sure to restart the R console, if you have
one running. This will ensure that R finds the newly installed
libraries.

Install R

GNU/Linux: R is packaged for many GNU/Linux
distributions. For example, on Debian and Ubuntu install the
packages with:

Debian: $ wajig install r-recommended

MS/Windows: the binary distribution can be obtained from
the R Project
website. Download the self-installing package and open it--the
install process will begin. Generally, accept all of the default
options that are offered in the installation process.

All Operating Systems: to confirm you have installed R
start up a Terminal and enter the command R (that's just
the capital letter R). If the response is that the command is not
found, then R is not yet installed!

Install RGtk2

The RGtk2
package is available on CRAN and from the
RGtk2
web site. If you have
installed all of the dependent R packages in the previous step
then you won't need to install it here. Otherwise, from R use:

R: > install.packages("RGtk2")

Or to install the most recent release:

R: > install.packages("RGtk2",repos="http://www.ggobi.org/r/")

GNU/Linux: you install the appropriate package for your
distribution. On Debian and Ubuntu this is done with:

Debain: $ wajig install r-cran-gtk2

All Operating Systems: to confirm you have RGtk2 installed
enter the following R command:

R: > library(RGtk2)

Install R Packages

The following additional R packages are used by Rattle, and
without them some functionality will be missing. Rattle will
gracefully handle them being missing so we can install them when
needed, or else all at once as int he examples below. If we perform
an action where Rattle indicates a package is missing, we can
then install the package, if we wish. Type
?install.packages at the R prompt for further help on
installing packages.

To automatically get all of the packages suggested by Rattle (and
suggested by its dependencies in turn), use the
Roption[]dependencies option. Otherwise list them all out in the
command (or even just list the ones we want for now):

If these don't work for some reason you can also download the latest
version of the rattle package directly from
Togaware. Download either
the .tar.gz file for GNU/Linux and Mac/OSX, or the
.zip file for MS/Windows. Install the package from within
R:

R: > install.packages("rattle_2.3.126.zip", repos=NULL)

or from the command line:

Mac: R CMD INSTALL rattle_2.3.126.tar.gz

Use the name of the file as it was downloaded. Sometimes filename is
munged when downloaded so check the name, as it might be:

rattle_2.3.126.tar.gz.tar

You can either correct the name or use this name in the command.

Start Rattle

From an X Windows terminal if we are using GNU/Linux, or from an
XTerminal if using Mac/OSX, or from the Rgui.exe if using MS/Windows
(we call all these, generically, the R Console), we can load the rattle package into R's
library:

R: > library(rattle)

This loads the Rattle functionality (which is also available without
running the Rattle GUI). To start the Rattle GUI simply run the
command: