Installing the diversity.lsp software

The diversity.lsp software is described in a User's Manual.

There are three steps to install the diversity.lsp software.

  1. Download and install XLisp-Stat;
  2. Download and install the diversity.lsp software;
  3. Configure your web browser.

Install XLisp-Stat

Lisp-Stat is an extensible statistical computing environment for data analysis, statistical instruction and research, with an emphasis on providing a framework for exploring the use of dynamic graphical methods. Implementations of XLISP-STAT, a version of Lisp-Stat based on the XLISP language, are available for the Macintosh, UNIX systems running X11, and for MS Windows (16 bit and 32 bit versions are available). The primary documentation is the book LISP-STAT: An Object-Oriented Environment for Statistical Computing and Dynamic Graphics by Luke Tierney. There are installation instructions for Macintosh and Windows. XLisp-Stat is included in many Linux distributions. Notes and a tutorial are also available.

Follow the installation instructions to create a directory for the XLISP-STAT executable that contains subdirectories Data, Autoload, and Examples. On my Gnu/Linux system this is/usr/lib/xlispstat/, but the path name will vary depending on the operating system you use and where you choose to install the software.

Install diversity.lsp

Create a subdirectory of the XLISP-STAT executable directory named Diversity.

After the Diversity directory is created you should have a directory structure that looks something like this:

total 1543
drwxr-xr-x   6 root     root         1024 Jan  8 12:59 ./
drwxr-xr-x  54 root     root        12288 Jan 27 20:52 ../
drwxr-xr-x   2 root     root         1024 Dec 23 03:22 Autoload/
drwxr-xr-x   2 root     root         1024 Dec 23 03:22 Data/
drwxr-xr-x   2 root     root         1024 Jan 16 22:18 Diversity/
drwxr-xr-x   2 root     root         1024 Dec 23 03:22 Examples/
-rwxr-xr-x   1 root     root       795972 Aug 30 12:55 xlisp*
-rw-r--r--   1 root     root       147573 Aug 30 12:55 xlisp.hlp
-rw-r--r--   1 root     root       608206 Aug 30 12:55 xlisp.wks

Copy the zipped diversity.lsp software to the Diversity subdirectory and unzip it.

Your Diversity subdirectory should contain the following five files:

  Length     Date   Time    Name
 --------    ----   ----    ----
     1667  04-24-99 13:05   data-objects.lsp
     1010  01-09-00 12:19   div-utils.lsp
    36005  01-16-00 16:20   diversity.lsp
     5474  04-24-99 13:05   onlisp-utility-functions.lsp
    14141  01-15-00 16:16   utility.lsp
 --------                   -------
    58297                   5 files

Two of these files represent work by other programmers. The onlisp-utility-functions are from the book On Lisp: Advanced Techniques for Common Lisp by Paul Graham. The utility.lsp file is from Hani J. Doss and Balasubramanian Narasimhan, Dynamic Display of Changing Posterior in Bayesian Survival Analysis: The Software.

Prepare your web browser

The particulars of this step will vary according to the web browser and operating system you use. The object is to let the browser know that 1) file suffix .xli is associated with mime type application/x-xlispstat, and 2) the default action when downloading an .xli file is to launch XLisp-Stat and pass it the downloaded file.

In Netscape on Unix this is done with Edit|Preferences|Navigator|Applications. In the resulting form, MIMEType is set to application/x-xlispstat, Suffixes to .xli, and Handled by Application to rxvt -e xlispstat %s.

Netscape on Windows NT is similar, but you should set Handled by Application to Wxls32 %1.

Expected results

To test your setup, download a test file. It should load the diversity.lsp software and display the message "Your diversity.lsp software appears to be set up correctly." If it doesn't, then please re-install the software according to the instructions.