next up previous
Next: About this document ... Up: XLS-Biplot User's Manual (Version Previous: Technical details

Subsections



Details for Lispers

It should be easy to call some of the main functions of XLS-Biplot from other Xlisp-Stat programs. The main functions are in file bp-proto.lsp. Instead of sending :new to bp-proto, you should call make-biplot, that has the following defun:

(defun make-biplot (&key data title var-labels case-labels 
                         save-pathname biplot-type (show t) 
                         (canned "" canned-set))
  "Args: ...
:DATA is mandatory, it should be a nested list of equal length rows
:TITLE, a string for the data name
:VAR-LABELS a list of strings, as many as columns in :DATA
:CASE-LABELS a list of strings, as many as rows in :DATA
:SAVE-PATHNAME a string, a filename or pathname to save files in, without extension
:CANNED, if given, one of the strings: \"PCA with normalization\" 
                                       \"PCA without normalization\"
                                       \"Simple CA\"
                                       \"Logratio analysis\"
                                       \"Ratio maps/Spectral analysis\"
:BIPLOT-TYPE: Can be any of 'form 'covariance 'sym-map 'sym-biplot.
"
...
...
    bp))

The function make-biplot returns a bp-proto object and shows it if :show was t. To this object you can send many messages (see the file bp-proto.lsp).

Compiling and making a XLS-Biplot workspace

Execution of XLisp-Stat files is faster when compiled. To make sure that you are using the compiled files, you should type
(compile-bp-files)
after your first loading of the biplot.lsp file.

If you would like to have a workspace with XLS-Biplot preloaded on it, you should change to the directory where XLS-Biplot files reside and then type
(load "makebiplotwks")
This should create a workspace named biplot.wks. (If you are working under Windoze, you should stop doing that, well, I mean, you should take a look at the end of the file makebiplotwks.lsp and possibily modify some paths there).

As documented in Xlisp-Stat, you may then call from the shell prompt
xlispstat -w/path/to/biplot.wks

Under MS-Windows, you may create an icon in your desktop being a link with a similar content as destination.

For Vista's users

If you have Vista (http://forrest.psych.unc.edu/research/) installed, look for the main executable file, usually named ViSta.exe and make a direct link icon on your desktop with
c:\path\to\ViSta.exe -wc:\path\to\biplots\xlisp.wks as the destiny, where xlisp.wks should be the one provided with the XLS-Biplot zip file, or a biplot.wks you made following the directions in previous section.


next up previous
Next: About this document ... Up: XLS-Biplot User's Manual (Version Previous: Technical details
Frederic Udina
2005-03-15