DATA MINING Desktop Survival Guide by Graham Williams
Desktop Survival Project Home List of Figures List of Tables Data Mining Introduction Data Mining with Rattle Data Exploring Data Transforming Data Cluster Analysis Association Analysis Classification and Regression Models Evaluation and Deployment Issues Moving into R Troubleshooting Beyond Rattle R Data Graphics in R Understanding Data Preparing Data Descriptive and Predictive Analytics Issues Evaluating Models Reporting Cluster Analysis Text Mining Text Mining Algorithms Bagging Bayes Classifier Cluster Analysis Conditional Trees Hierarchical Clustering K-Nearest Neighbours Linear Models Neural Networks Support Vector Machines Open Products AlphaMiner Borgelt Data Mining Suite KNime R Rattle Weka Closed Products C4.5 Clementine Equbits Foresight GhostMiner InductionEngine ODM Enterprise Miner Statistica Data Miner TreeNet Virtual Predict Appendicies Installing GTK, R, and Rattle Glossary Bibliography Index

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.0.2) and MS/Windows (Section A.0.3) 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.

(Please note that I do not have access to a Macintosh and so the following comments come from users of Rattle and have not been personally tested. They are provided in the hope they may be useful.)

1. Install the GTK+ libraries
    
   GNU/Linux: these libraries will already be installed if you are running Gnome, but make sure you also have libglade installed. If you are not running Gnome you may need to install the GTK+ libraries in your distribution. Either way, with Debian and Ubuntu you can simply install the Glade package:
   
   

   Debian: wajig install libglade2-0
   

   
   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 gtk-dev-2.12.9-win32-2.exe
   

   
   An alternative on MS/Windows that seems to work quite well^A.7 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.)

   Mac/OSX: install the latest version of the GTK+ library, including libglade, by downloading the gtk2-runtime.dmg package (under ``Other binaries'') from http://r.research.att.com/.

   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.

2. 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^A.8 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.
   
   

   MS/Windows: run R-2.8.0-win32.exe
   

   
   

   Mac/OSX: download the package from CRAN or from http://r.research.att.com/ and install it.

   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!
   
   

   $ R
   
   R version 2.7.0 (2008-04-22)
   Copyright (C) 2008 The R Foundation for Statistical Computing
   ISBN 3-900051-07-0
   
   R is free software and comes with ABSOLUTELY NO WARRANTY.
   You are welcome to redistribute it under certain conditions.
   Type 'license()' or 'licence()' for distribution details.
   
     Natural language support but running in an English locale
   
   R is a collaborative project with many contributors.
   Type 'contributors()' for more information and
   'citation()' on how to cite R or R packages in publications.
   
   Type 'demo()' for some demos, 'help()' for on-line help, or
   'help.start()' for an HTML browser interface to help.
   Type 'q()' to quit R.
   
   [Previously saved workspace restored]
   
   >
   

   
   

3. Install RGtk2
    
   The RGtk2 package is available on CRAN and from the RGtk2^A.9 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)
   

   
   

4. 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 dependencies option. Otherwise list them all out in the command (or even just list the ones we want for now):
   
   

   R: > install.packages("rattle", dependencies=TRUE)
   

   
   or
   
   

   R: > install.packages(c("ada", "amap", "arules", "bitops", 
          "cairoDevice", "cba", "combinat", "doBy", "ellipse", 
          "fEcofin", "fCalendar", "fBasics", "fpc", 
          "gdata", "gtools", "gplots", "Hmisc", "kernlab", 
          "mice", "network", "pmml", "randomForest", "reshape",
          "rggobi", "ROCR", "RODBC", "rpart", "RSvgDevice", 
          "XML"))
   

   
   

5. Install Rattle
    
   From within R we can install Rattle directly from CRAN with:
   
   

   R: > install.packages("rattle")
   

   
   An alternative is to install the most recent release from Togaware:
   
   

   R: > install.packages("rattle", 
                         repos="http://rattle.togaware.com")
   

   
   

   If these don't work for some reason you can also download the latest version of the rattle package directly from Togaware^A.10. 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.124.zip", repos=NULL)
   

   
   or from the command line:
   
   

   Mac: R CMD INSTALL rattle_2.3.124.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.124.tar.gz.tar
   

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

6. 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:
   
   

   R: > rattle()
   

   
   

When starting up Rattle the main window will be displayed. You will see a welcome message and a hint about using Rattle (see Figure A.1).

Figure A.1: The Rattle window.

Support further development through the purchase of the PDF version of the book.
PDF version is properly formatted and forms a comprehensive book (draft with over 600 pages).
Brought to you by Togaware.