Once the helper applications are installed (see below), you may need to inform XLS-Biplot where they are. This can be done using the "Configure helpers" dialog that is accessible from the File menu (or the BiplotMenu under Unix/X11). This dialog is also accessible form the "Export graphics..." dialog.
If you see "-not valid-" next to any of the buttons, it means that the path to the application is unknown to XLS-BiplotYou should click on the button and find the application.
If you are a XLISP-STAT user and have it installed in your computer, jump to the bottom of this section, otherwise read carefully the following lines.
You should have a file named xls-bp-win32-nnn.zip (see B.2) that contains most (if not all) you need to use XLS-Biplot. Unpack the file using some utility like WinZip or unzip. You can extract the files in any directory, as long you preserve the directory structure.
After unpacking the distribution, you should find in your directory these files:
|File or folder||Description|
|eXLS-Biplot.exe||Actually, it is XLISP-STAT|
|xlisp.wks||The workspace that has XLS-Biplot preloaded|
|examples||A folder with some examples discussed in this manual|
|fig2dev.exe||Graphic conversion utility|
|cygwin1.dll||Environment needed by fig2dev, see below|
|pstoedit||A folder containing the conversion utility|
|users-manual-html||A folder with several files for this manual|
The file cygwin1.dll should be moved to
c:\winNT or a
similar directory where programs (notably fig2dev) can find it.
You don't need to move fig2dev.exe anywhere, unless you want to use it from outside XLS-Biplot. In case you move it, be careful to inform XLS-Biplot where you put it (see below).
We recommend you to get and install Gsview and co. (see B.3). It is high quality software (and it is free) for viewing and processing postscript and pdf files.
Then you need to be sure that XLS-Biplot knows how to find the applications that are needed for file format conversion and graphics viewing. After starting XLS-Biplot(see 1.2), go to the menu BiplotMenu in the menu bar and choose Configure XLS-Biplot. If some of the application paths show -not valid- and you know that you have the application installed, try to tell XLS-Biplot where the executable file for the application resides.
Note that Ghostscript, Ghostview (gsview), Acroread, and xfig are not strictly needed to work with XLS-Biplot. They are only needed if you want to view or manipulate the files produced by XLS-Biplot. Without having them, you can insert your files into Word (for example) and view it there.
fig2dev and pstoedit are strictly needed to produce postscript or MS-windows metafiles (see 6). They are included in the distribution.
If you are a XLISP-STAT user and have it installed in your MS-Windows machine you should not extract the two firsts files listed above. You better get the lisp sources and put them in a folder named biplots and follow the directions given below for UNIX users. Contact the authors in case of trouble.
You should unpack the distribution file using
tar -zxf xls-biplot.tgz
or, if your tar program do not support -z
gzip -d < xls-biplot.tgz | tar -xvf -
on a directory of your choice. This will create a biplots directory there. Then, after starting Xlisp-Stat the usual way, you start XLS-Biplot by typing
To see if it works, type (test-bp) at the Xlisp-Stat prompt.
You should also go to "Configure helpers" in BiplotMenu to find the paths to the application used by XLS-Biplot (see 6).