merged from ansiClib
[CommonLispStat.git] / README
1  -*- mode: text -*-
4 Common Lisp Stat: 
6 After a few false starts, I (Tony Rossini) finally know how I want to
7 proceed.  First, we update CLS.  Then, continue with TSL.  Separation
8 is needed, so that we can make everything separate.
10 We are working with SBCL and CLISP implementations to keep a wide
11 range of target platforms, as well as to challenge the system by the
12 two more common CL implementations (compiled, and byte-compiled).
14 This is done to provide a point of comparison as well as a means for
15 building upon.
21 ============
23 File Dependencies from 9 Feb 2007
25 Package lisp-stat-object-system
26    self contained
28 Package lisp-stat-fastmap
29    self contained, new.
31 Package lisp-stat-basics:
32    lsbasics
33    compound
34    lsmacros
35    dists
36    ladata
37    linalg
38    matrices
39    lsfloat
40    lsmath
41    lisp-stat-sequence
43  lisp-stat-matrix  (matrices)
44    lisp-stat-sequence (sequence)
46  lisp-stat-sequence (sequence)
47    lisp-stat-compound-data (compound)
49  lisp-stat-compound-data (compound)
50    common-lisp
51    lisp-stat-object-system (lsobject)
52    lisp-stat-fastmap
54 lisp-stat-fastmap
55    common-lisp   
59 ============
60 Original, dating to Oct 30, 1991.
62 This is Lisp-Stat 1.0 Alpha 1, a first attempt at producing a Common
63 Lisp version of Lisp-Stat. This version contains NO graphics, but
64 should implement all the non-graphical facilities of Lisp-Stat.  
66 The implementation uses C code from XLISP-STAT for linear algebra and
67 probability distributions, so this code is dependent an a CL's foreign
68 function interface. At this time, three CL's are supported: AKCL (at
69 least verision 1-600) for UNIX systems, Franz' Allegro CL for UNIX
70 systems, and Macintosh CL (version 2.0b1). Separate README files
71 describe each version
73 On A DEC 3100 or 5000 the AKCL version of Lisp-Stat runs about half as
74 fast as xlispstat on a standard battery of tests if xlispstat is given
75 an (expand 30) command. I seem to recall that on a sun3 this the AKCL
76 code and xlispstat code run at about the same speed. I have not yet
77 confirmed this. If so, then the relative performance of the AKCL
78 version to xlispstat may be quite hardware-dependent. The Allegro
79 version on a DEC 5000 is considerably slower and larger than the AKCL
80 version, but I have not yet figured out how to tune Allegro's memory
81 management. The Macintosh CL version seems to run at least as fast as
82 xlispstat on the Macintosh.
84 To port this code to another CL, you need to
86         Edit defsys.lsp to add any necessary definitions
88         Add a top level to lstoplevel.lsp (this is only needed if you
89         want to recover the history mechanism, which is broken by
90         shadowing *, etc.)
92         Write versions of the lisp and/or C glue files to interface to
93         the C code in lib.
95         Experiment with tuning the memory management to run reasonably
96         in statistical applications.
98 If you do port this code to another CL, please let me know so I can
99 add it to this distribution.
101 Luke Tierney
102 School of Statistics
103 University of Minnesota
104 Minneapolis, MN 55455