INTRODUCTION
============
This file provides details how to use the information  contained
in the Website of the book "Understanding Biplots" 
by Gower JC, Lubbe S and Le Roux NJ;
published by Wiley: Chichester; January 2011.
Corrections as well as bug fixes pertaining to "Understanding Biplots" 
and the R programs will be posted in the section "Corrections". This 
section will be updated on a regular basis. If needed, a FAQ section 
will also be provided with regular updates.

The Website contained three items to be downloaded:

1. The file: ReadMe.txt (this file)

2. The R package UBbipl in format: 
                 UBbipl_1.0.zip
				 UBbipl_1.0.tar.gz
				 UBbipl_1.0.tar
				 
3. A second R package UBFigs in zip format: 
				UBFigs_1.0.zip
				UBFigs_1.0.tar.gz
				UBFigs_1.0.tar
				
It is assumed that the reader/user has a basic knowledge of the R system
and has an installed version of R-2.10.0 or higher. Although UBbipl and 
UBFigs should also work on R-2.8.0 and R-2.9.0 the Help files would
not be of use in these systems. We intentionally do not provide complete
help files as users of UBbipl should consult "Understanding Biplots"
for a full understanding of our R code. 

The packages UBbipl and UBFigs are built under R-2.12.1 and provision 
is made for both 32 and 64 bit machines.

DOWNLOAD AND FIRST TIME USE
===========================
1. First read the file ReadMe.txt

2. Download and save the appropriate version of UBbipl to your computer.
   Then Install the package from within R. 

3. Download and save the appropriate version of UBFigs to your computer.
   Then Install the package from within R.

4. Attach UBbipl and UBFigs on the search path by 
   giving the instructions 
   
   > library(UBbipl)
   > library(UBFigs)
   
   from the R prompt.

5. Note that UBbipl can be used on its own but UBFigs depends on
   UBbipl being loaded.

6. It is recommended that first time users give the instructions

   > ?UBbipl
   and
   > ?UBFigs 
   
   from the R prompt to inspect the Index and other information
   regarding the two packages.
   
7. The help files of UBbipl_package and UBFigs_package (see 6 above)
   contain email addresses of the maintainer of the packages and 
   where additional information can be found as well as the reporting
   of bugs.
   
8. It might be necessary for Window users using 32 bit machines with
   versions of R prior to 2.12.0 to make the following change in the 
   folders where UBbipl is stored on their computers: in the libs folder
   of package UBbipl move the file UBbipl.dll from the subfolder i386
   one level up to be accessible immediately from folder libs.
       
Package UBbipl
==============
This package contains all the functions discussed in "Understanding
Biplots"

Package UBFigs
==============
This package contains the function calls to reproduce the figures in
"Understanding Biplots". Consult "Understanding Biplots" and the help
file index for details about the function calls.

With the exception of Fig.9.9() all functions should complete quite 
quickly -- at most within a few minutes. Function call Fig.9.9()
could take about two or more hours to complete.

3D Figures
==========
We urge users of "Understanding Biplots" to inspect all 3D figures in
the book interactively as follows:

Enter at the R prompt for example

> Fig.3.40()

An rgl window will open with the 3D figure. This graph window can then
interactively be resized, rotated and zoomed for a detailed inspection  
together with quality hard copies as needed.  
------------------------------------------------------------------------  				
John Gower, Sugnet Lubbe and Niel le Roux				