(This is a first draft, correction is ovbiously needed, but I hope it can be useful...)
Welcome to XLS-Biplot, a program to build and manipulate biplots. Biplots are statistical graphics that represent in the same plot variables and cases. Biplots can be seen as the multivariate analogue of scatter-plots: they give a graphical representation of a multivariate sample and they superimpose on the display a representation of the variables on which the sample is measured.
For example, the Biplot in the figure displays a data set of grades obtained by 132 students in three parts of an exam ("Test", "Ex1" and "Ex2"). The arrows in the plot represent the variables, showing for example that "Test" and "Ex2" are quite orthogonal. The dots represent the cases, the students. We will often use this example in this manual.
XLS-Biplot is based on XLISP-STAT, a LISP dialect with statistical and graphical extensions created by Luke Tierney http://www.stat.umn.edu. That implies that XLS-Biplot can run under UNIX (including many flavors of UNIX and LINUX), MS-Windows (32-bits versions such as Windows 95, 98, NT, 2000) and also on Macintosh (It has been sucessfully tested on the Unix side of Mac OS X 10.3).
This User's Manual has two published versions made out from a single TeX file. We recommend having the HTML version (that can be read using any web Browser) open while using the program. The static text version is probably less useful.
In what follows, subsections 1.1 and 1.2 explain how to start the program. Section 2 explains the basics of using the program and refer to other sections for deeper discussion. Section 3 is about biplots, some theory about its construction and interpretation. Section 4 tells you how to prepare your data for feeding it to XLS-Biplot and get a Biplot representing it. It also explains how to save your biplots in several formats. Section 5 gives all the details on the interactivity that allows the user to study and modify the Biplot in its window using the mouse. Finally, section 6 explain how to obtain and use graphical output from XLS-Biplot, in order to include the graphics in several environments, screen or high quality publishing media.
In some appendices at the end of this manual we include the more technical information, including section B on how to get and install the program and other auxiliary programs (also this manual). There is also a section (D) intended to explain to XLISP-STAT users some innerties of the program and how to use it from other XLISP-STAT programs.
You should have a copy of XLISP-STAT installed and running in your UNIX box. See appendix B on how to get it. You would need also the lisp files for XLS-Biplot, as described in the same appendix. Let's say that they are in the directory biplot-dir.
Then you start Xlisp-stat, usually tyiping xlispstat in a terminal window and you get the xlisp prompt. There you type
(load "biplot-dir/biplot")and you'll see some listing of the files being loaded.
You should see a BiplotMenu menu in what is called the XLISP-STAT Fake menu bar. Next section, 2, explains the first steps with the program. A command-line oriented user would like now to type
(test-bp)to get a first-and-quick Biplot window example built on some random data.
If for any reason you want to compile or recompile the lisp files of
XLS-Biplot, you may do it easily with the call
You should have, in the same directory, at least two files: XLS-Biplot.exe and xlisp.wks. See appendices A and B on how to get these and other files for a complete installation.
Double click on XLS-Biplot.exe to start it.
Then, you could choose File:Make example in the menu bar (or in the BiplotMenu under Unix) to obtain a sample Biplot to play with. Next section, 2, explains the first steps with the program.
You may find help for using XLS-Biplot in: