src/packages.lisp

   1 ;;; -*- mode: lisp -*-
   2
   3 ;;; Time-stamp: <2009-02-04 10:19:31 tony>
   4 ;;; Creation:   <2008-03-11 19:18:34 user>
   5 ;;; File:       packages.lisp
   6 ;;; Author:     AJ Rossini <blindglobe@gmail.com>
   7 ;;; Copyright:  (c)2007--2008, AJ Rossini.  BSD, LLGPL, or GPLv2, depending
   8 ;;;             on how it arrives.
   9 ;;; Purpose:    package structure description for lispstat
  10
  11 ;;; What is this talk of 'release'? Klingons do not make software
  12 ;;; 'releases'.  Our software 'escapes', leaving a bloody trail of
  13 ;;; designers and quality assurance people in its wake.
  14
  15 ;;; This organization and structure is new to the 21st Century
  16 ;;; version.
  17
  18 (in-package :cl-user)
  19
  20 ;;; LispStat Basics
  21
  22 (defpackage :lisp-stat-object-system
  23   (:nicknames :ls-objects :lsos)
  24   (:use :common-lisp)
  25   (:shadow :call-method :call-next-method :slot-value)
  26   (:export ls-object objectp *object* kind-of-p make-object
  27            *message-hook*
  28            *set-slot-hook* slot-value self
  29            send call-next-method call-method
  30            defmeth defproto instance-slots proto-name))
  31
  32 (defpackage :lisp-stat-types
  33   (:documentation "Provides some typeing for LispStat, but is clearly
  34   a bit incomplete.")
  35   (:use :common-lisp)
  36   (:export fixnump
  37            check-nonneg-fixnum check-one-nonneg-fixnum
  38            check-one-fixnum check-one-real check-one-number))
  39
  40 (defpackage :lisp-stat-float
  41   (:use :common-lisp)
  42   (:export +stat-float-typing+ +stat-cfloat-typing+ +stat-float-template+
  43            machine-epsilon base-float makedouble
  44
  45            make-base-trans-fun-2 make-base-trans-fun
  46
  47            base-log base-exp base-expt base-sqrt base-sin base-cos
  48            base-tan base-asin base-acos base-atan base-sinh
  49            BASE-COSH BASE-TANH BASE-ASINH BASE-ACOSH BASE-ATANH
  50            BASE-ABS BASE-PHASE BASE-FFLOOR BASE-FCEILING BASE-FTRUNCATE
  51            BASE-FROUND BASE-SIGNUM BASE-CIS))
  52
  53 (defpackage :lisp-stat-compound-data
  54   (:use :common-lisp
  55         :lisp-stat-object-system
  56         :lisp-stat-types)
  57   (:shadowing-import-from :lisp-stat-object-system
  58                           slot-value
  59                           call-next-method call-method)
  60   (:export compound-data-p *compound-data-proto*
  61            compound-object-p
  62            compound-data-seq compound-data-length
  63            element-list element-seq
  64            sort-data order rank
  65            recursive-map-elements map-elements repeat
  66            check-sequence
  67            get-next-element make-next-element set-next-element
  68            ;; sequencep
  69            iseq ordered-nneg-seq
  70            select split-list which
  71            difference rseq
  72            flatten-list))
  73
  74 (defpackage :lisp-stat-macros
  75   (:use :common-lisp
  76         :lisp-stat-compound-data)
  77   (:export make-rv-function make-rv-function-1))
  78
  79 (defpackage :lisp-stat-basics
  80     (:use :common-lisp
  81           :lisp-stat-object-system
  82           :lisp-stat-types
  83           :lisp-stat-float
  84           :lisp-stat-macros
  85           :lisp-stat-compound-data)
  86   (:shadowing-import-from :lisp-stat-object-system
  87                           slot-value call-method call-next-method)
  88   (:export permute-array sum prod count-elements mean
  89            if-else sample))
  90
  91 (defpackage :lisp-stat-float
  92   (:use :common-lisp)
  93   (:export +stat-float-typing+ +stat-cfloat-typing+ +stat-float-template+
  94            machine-epsilon base-float makedouble
  95
  96            make-base-trans-fun-2 make-base-trans-fun
  97
  98            BASE-LOG BASE-EXP BASE-EXPT BASE-SQRT BASE-SIN BASE-COS
  99            BASE-TAN BASE-ASIN BASE-ACOS BASE-ATAN BASE-SINH
 100            BASE-COSH BASE-TANH BASE-ASINH BASE-ACOSH BASE-ATANH
 101            BASE-ABS BASE-PHASE BASE-FFLOOR BASE-FCEILING BASE-FTRUNCATE
 102            BASE-FROUND BASE-SIGNUM BASE-CIS))
 103
 104 (defpackage :lisp-stat-macros
 105   (:use :common-lisp
 106         :lisp-stat-compound-data)
 107   (:export make-rv-function make-rv-function-1))
 108
 109 ;;; NEW CLOS STRUCTURE
 110
 111 (defpackage :lisp-stat-data-clos
 112   (:use :common-lisp
 113         :lisp-matrix)
 114   (:export get-variable-matrix get-variable-vector
 115            ;; generic container class for data -- if small enough
 116            ;; could be value, otherwise might be reference.
 117            data-pointer))
 118
 119 #|
 120 (defpackage :lisp-stat-regression-linear-clos
 121   (:use :common-lisp
 122         :lisp-matrix
 123         :lisp-stat-data-clos)
 124   (:export regression-model))
 125 |#
 126
 127
 128 ;;; USER PACKAGES
 129
 130 (defpackage :lisp-stat-ffi-int
 131   (:use :common-lisp
 132         :cffi)
 133   (:export ccl-store-integer ccl-store-double ccl-store-ptr
 134            get-buf ))
 135
 136 (defpackage :lisp-stat-probability
 137   (:use :common-lisp
 138         :cffi
 139         :lisp-stat-ffi-int
 140         :lisp-stat-macros)
 141   (:export log-gamma set-seed
 142            uniform-rand
 143            normal-cdf normal-quant normal-dens normal-rand
 144            bivnorm-cdf
 145            cauchy-cdf cauchy-quant cauchy-dens cauchy-rand
 146            gamma-cdf gamma-quant gamma-dens gamma-rand
 147            chisq-cdf chisq-quant chisq-dens chisq-rand
 148            beta-cdf beta-quant beta-dens beta-rand
 149            t-cdf t-quant t-dens t-rand
 150            f-cdf f-quant f-dens f-rand
 151            poisson-cdf poisson-quant poisson-pmf poisson-rand
 152            binomial-cdf binomial-quant binomial-pmf binomial-rand))
 153
 154
 155 #| removed, replace by lisp-matrix
 156 (defpackage :lisp-stat-matrix
 157   (:use :common-lisp
 158         :cffi
 159         :lisp-stat-compound-data)
 160   (:export matrixp ;;  matrix -- conflicts!
 161            num-rows num-cols matmult identity-matrix diagonal
 162            row-list column-list inner-product outer-product
 163            cross-product
 164            ;; transpose bind-columns bind-rows
 165            array-data-vector vector-to-array
 166
 167            check-matrix check-square-matrix
 168
 169            copy-array copy-vector
 170            ))
 171 |#
 172
 173 #| replaced by lisp-matrix
 174 (defpackage :lisp-stat-linalg-data
 175   (:use :common-lisp
 176         :cffi
 177         :lisp-stat-ffi-int
 178         :lisp-stat-types
 179         :lisp-stat-compound-data
 180         :lisp-stat-matrix)
 181   (:export ;; more to add
 182       +mode-in+ +mode-re+ +mode-cx+ mode-of
 183
 184       la-data-mode la-allocate la-free
 185
 186       la-get-double la-put-double
 187       la-put-integer
 188
 189       la-matrix la-free-matrix la-matrix-to-data la-data-to-matrix
 190       la-vector la-free-vector la-vector-to-data la-data-to-vector ))
 191 |#
 192
 193 (defpackage :lisp-stat-math
 194    (:use :common-lisp
 195          :lisp-stat-object-system
 196          :lisp-stat-macros
 197          :lisp-stat-compound-data
 198          :lisp-stat-float)
 199    (:shadowing-import-from :lisp-stat-object-system
 200                            slot-value call-method call-next-method)
 201    (:shadow expt + - * / ** mod rem abs 1+ 1- log exp sqrt sin cos tan
 202            asin acos atan sinh cosh tanh asinh acosh atanh float random
 203            truncate floor ceiling round minusp zerop plusp evenp oddp
 204            < <= = /= >= > ;; complex
 205            conjugate realpart imagpart phase
 206            min max logand logior logxor lognot ffloor fceiling
 207            ftruncate fround signum cis)
 208    (:export ^ ** expt + - * / mod rem pmin pmax abs 1+ 1- log exp sqrt sin cos
 209            tan asin acos atan sinh cosh tanh asinh acosh atanh float random
 210            truncate floor ceiling round minusp zerop plusp evenp oddp < <= =
 211            /= >= > ;; complex
 212            conjugate realpart imagpart phase min max
 213            logand logior logxor lognot ffloor fceiling ftruncate fround
 214            signum cis)
 215    (:documentation "Vectorization of numerical functions"))
 216
 217
 218 #| ;; some of this goes back in, but not all of it?
 219 (defpackage :lisp-stat-linalg
 220   (:use :common-lisp
 221         :cffi
 222         :lisp-matrix
 223         :lisp-stat-math
 224         :lisp-stat-types
 225         :lisp-stat-float
 226         :lisp-stat-compound-data)
 227   (:shadowing-import-from :lisp-stat-math
 228           expt + - * / ** mod rem abs 1+ 1- log exp sqrt sin cos tan
 229           asin acos atan sinh cosh tanh asinh acosh atanh float random
 230           truncate floor ceiling round minusp zerop plusp evenp oddp
 231           < <= = /= >= > complex conjugate realpart imagpart phase
 232           min max logand logior logxor lognot ffloor fceiling
 233           ftruncate fround signum cis)
 234   (:export chol-decomp lu-decomp lu-solve determinant inverse
 235            sv-decomp qr-decomp rcondest make-rotation spline
 236            kernel-dens kernel-smooth
 237            fft make-sweep-matrix sweep-operator ax+y eigen
 238
 239            check-real ;; for optimize
 240
 241            covariance-matrix matrix print-matrix solve
 242            backsolve eigenvalues eigenvectors accumulate cumsum combine
 243            lowess))
 244
 245 |#
 246
 247
 248
 249
 250 (defpackage :lisp-stat-data
 251   (:documentation "Data management, integration, I/O, and other data technologies.")
 252   (:nicknames :ls-data)
 253   (:use :common-lisp
 254         :lisp-stat-object-system
 255         :lisp-stat-config
 256         :lisp-stat-types
 257         :lisp-stat-compound-data)
 258   (:shadowing-import-from :lisp-stat-object-system
 259                           slot-value call-method call-next-method)
 260   (:export open-file-dialog read-data-file read-data-columns load-data
 261            load-example *variables* *ask-on-redefine*
 262            def variables savevar undef))
 263
 264 (defpackage :lisp-stat-descriptive-statistics
 265  (:use :common-lisp
 266        :lisp-stat-data
 267        :lisp-stat-math
 268        :lisp-stat-compound-data
 269        :lisp-matrix
 270        :lisp-stat-basics)
 271    (:shadowing-import-from :lisp-stat-math ;; life is a vector!
 272       expt + - * / ** mod rem abs 1+ 1- log exp sqrt sin cos tan
 273       asin acos atan sinh cosh tanh asinh acosh atanh float random
 274       truncate floor ceiling round minusp zerop plusp evenp oddp
 275       < <= = /= >= > ;; complex
 276       conjugate realpart imagpart phase
 277       min max logand logior logxor lognot ffloor fceiling
 278       ftruncate fround signum cis)
 279    (:export standard-deviation quantile median interquartile-range
 280             fivnum sample))
 281
 282
 283 (defpackage :lisp-stat-regression-linear
 284   (:use :common-lisp
 285         :lisp-matrix
 286         :lisp-stat-object-system
 287 #|
 288         :lisp-stat-basics
 289         :lisp-stat-compound-data
 290         :lisp-stat-math
 291         :lisp-stat-descriptive-statistics
 292 |#
 293         )
 294   (:shadowing-import-from :lisp-stat-object-system
 295                           slot-value call-method call-next-method)
 296 #|
 297   (:shadowing-import-from :lisp-stat-math
 298       expt + - * / ** mod rem abs 1+ 1- log exp sqrt sin cos tan
 299       asin acos atan sinh cosh tanh asinh acosh atanh float random
 300       truncate floor ceiling round minusp zerop plusp evenp oddp
 301       < <= = /= >= > ;; complex
 302       conjugate realpart imagpart phase
 303       min max logand logior logxor lognot ffloor fceiling
 304       ftruncate fround signum cis)
 305 |#
 306   (:export regression-model regression-model-proto x y intercept
 307            ;; sweep-matrix
 308            basis weights included
 309            total-sum-of-squares residual-sum-of-squares
 310            predictor-names response-name case-labels))
 311
 312 (defpackage :lisp-stat
 313     (:documentation "Experimentation package for LispStat.  Serious
 314     work should be packaged up elsewhere for reproducibility.  By this
 315     I mean, creating a data/analytics/analysis package with the
 316     minimal set of objects required.")
 317   (:use :common-lisp
 318         :lisp-stat-object-system
 319         :lisp-stat-compound-data
 320         :lisp-stat-probability
 321         :lisp-stat-types
 322         :lisp-stat-float
 323         :lisp-stat-basics
 324         :lisp-stat-data
 325         :lisp-stat-math
 326         :lisp-matrix ;; conversion to a more robust linalg approach
 327         :lisp-stat-descriptive-statistics
 328         :lisp-stat-regression-linear)
 329   (:shadowing-import-from :lisp-stat-object-system
 330         slot-value call-method call-next-method)
 331   (:shadowing-import-from :lisp-stat-math
 332         expt + - * / ** mod rem abs 1+ 1- log exp sqrt sin cos tan
 333         asin acos atan sinh cosh tanh asinh acosh atanh float random
 334         truncate floor ceiling round minusp zerop plusp evenp oddp
 335         < <= = /= >= >
 336         ;;complex
 337         conjugate realpart imagpart phase
 338
 339         min max
 340         logand logior logxor lognot
 341         ffloor fceiling ftruncate fround
 342         signum cis)
 343   (:export
 344    ;; lsobjects :
 345    defproto defproto2
 346    defmeth send
 347
 348    ;; lstypes :
 349    fixnump check-nonneg-fixnum check-one-fixnum
 350    check-one-real check-one-number
 351
 352    ;; lsmacros:
 353
 354    ;; lsfloat :
 355    machine-epsilon
 356
 357    ;; compound :
 358    compound-data-p *compound-data-proto* compound-object-p
 359    compound-data-seq compound-data-length
 360    element-list element-seq
 361    sort-data order rank
 362    recursive-map-elements map-elements
 363    repeat
 364    check-sequence
 365    get-next-element make-next-element set-next-element
 366    ;; sequencep
 367    iseq
 368    ordered-nneg-seq
 369    select which
 370    difference rseq
 371
 372    ;; lsmath.lsp
 373    ^ ** expt + - * / mod rem pmin pmax abs 1+ 1- log exp sqrt sin cos
 374    tan asin acos atan sinh cosh tanh asinh acosh atanh float random
 375    truncate floor ceiling round minusp zerop plusp evenp oddp < <= =
 376    /= >= > ;; complex
 377    conjugate realpart imagpart phase min max
 378    logand logior logxor lognot ffloor fceiling ftruncate fround
 379    signum cis
 380
 381 #| ;; The following need to be re-found in lisp-matrix...
 382
 383    ;; matrices.lisp
 384    matrixp num-rows num-cols matmult identity-matrix diagonal row-list
 385    column-list inner-product outer-product cross-product transpose
 386    bind-columns bind-rows
 387
 388    ;; linalg.lisp
 389    chol-decomp lu-decomp lu-solve determinant inverse
 390    sv-decomp qr-decomp rcondest make-rotation spline
 391    kernel-dens kernel-smooth
 392    fft make-sweep-matrix sweep-operator ax+y eigen
 393    check-real
 394    covariance-matrix matrix print-matrix solve
 395    backsolve eigenvalues eigenvectors accumulate cumsum combine
 396    lowess
 397
 398    ;; in linalg.lisp, possibly not supported by matlisp
 399    spline kernel-dens kernel-smooth
 400
 401 |#
 402
 403    ;; optimize.lsp
 404    newtonmax nelmeadmax
 405
 406    ;; lispstat-macros
 407    make-rv-function make-rv-function-1
 408
 409    ;; data.lisp
 410    open-file-dialog read-data-file read-data-columns load-data
 411    load-example *variables* *ask-on-redefine*
 412    def variables savevar undef
 413
 414    ;; statistics.lsp  (descriptions, should probably be moved
 415    ;; later...?
 416    standard-deviation quantile median interquartile-range
 417    fivnum sample
 418
 419    ;; probability (dists.lisp)
 420    log-gamma set-seed
 421    uniform-rand normal-cdf normal-quant normal-dens
 422    normal-rand bivnorm-cdf cauchy-cdf cauchy-quant cauchy-dens
 423    cauchy-rand gamma-cdf gamma-quant gamma-dens gamma-rand
 424    chisq-cdf chisq-quant chisq-dens chisq-rand beta-cdf beta-quant
 425    beta-dens beta-rand t-cdf t-quant t-dens t-rand f-cdf f-quant
 426    f-dens f-rand poisson-cdf poisson-quant poisson-pmf poisson-rand
 427    binomial-cdf binomial-quant binomial-pmf binomial-rand
 428
 429    ;; Here is where we have a problem -- lispstat core should be core
 430    ;; data management and config problems, with packages providing
 431    ;; specialized extensions to LispStat, i.e. regression, nonlin
 432    ;; regression, bayesian regression via laplace approximation, etc.
 433
 434    ;; The following could be considered "recommended packages",
 435    ;; similar to the idea of the recommended packages in R.  Probably
 436    ;; we want them to do the exporting within that package, therefore
 437    ;; NOT being able to lock the "data-ish" package, but only the
 438    ;; subpackages prior to export.
 439
 440    ;; regression.lsp
 441    regression-model regression-model-proto x y intercept sweep-matrix
 442    basis weights included total-sum-of-squares residual-sum-of-squares
 443    predictor-names response-name case-labels
 444
 445    ;; nonlin.lsp
 446    nreg-model nreg-model-proto mean-function theta-hat epsilon
 447    count-limit verbose
 448
 449    ;; bayes.lsp
 450    bayes-model bayes-model-proto bayes-internals))
 451
 452
 453 ;;;; PACKAGES FOR USEABILITY
 454
 455 (defpackage :lisp-stat-data-examples
 456   (:documentation "Example data for unittests, examples, illustrations,")
 457   (:use :common-lisp
 458         :lisp-stat)
 459   (:shadowing-import-from :lisp-stat
 460       slot-value call-method call-next-method
 461
 462       expt + - * / ** mod rem abs 1+ 1- log exp sqrt sin cos tan
 463       asin acos atan sinh cosh tanh asinh acosh atanh float random
 464       truncate floor ceiling round minusp zerop plusp evenp oddp
 465       < <= = /= >= > > ;; complex
 466       conjugate realpart imagpart phase
 467       min max logand logior logxor lognot ffloor fceiling
 468       ftruncate fround signum cis
 469
 470       <= float imagpart)
 471   (:export iron aluminum absorbtion
 472            diabetes dlabs))
 473
 474
 475 (defpackage :lisp-stat-user
 476   (:documentation "Experimentation package for LispStat.
 477 Serious work should be placed in a similar package elsewhere for
 478 reproducibility.  But this should hint as to what needs to be
 479 done for a user- or analysis-package.")
 480   (:nicknames :ls-user)
 481   (:use :common-lisp
 482         :lisp-matrix
 483         :lisp-stat
 484         :lisp-stat-data-examples) ;; this last is to have 'things to play with'
 485   (:shadowing-import-from :lisp-stat
 486       slot-value call-method call-next-method
 487
 488       expt + - * / ** mod rem abs 1+ 1- log exp sqrt sin cos tan
 489       asin acos atan sinh cosh tanh asinh acosh atanh float random
 490       truncate floor ceiling round minusp zerop plusp evenp oddp
 491       < <= = /= >= > > ;; complex
 492       conjugate realpart imagpart phase
 493       min max logand logior logxor lognot ffloor fceiling
 494       ftruncate fround signum cis
 495
 496       <= float imagpart))
 497
 498 (defpackage :lisp-stat-unittests
 499   (:use :common-lisp :lift :lisp-stat :lisp-stat-data-examples)
 500   (:shadowing-import-from :lisp-stat
 501         slot-value call-method call-next-method ;; objects
 502         expt + - * / ** mod rem abs 1+ 1- log exp sqrt sin cos tan ;; lsmath
 503         asin acos atan sinh cosh tanh asinh acosh atanh float random
 504         truncate floor ceiling round minusp zerop plusp evenp oddp
 505         < <= = /= >= > ;; complex
 506         conjugate realpart imagpart phase
 507         min max logand logior logxor lognot ffloor fceiling
 508         ftruncate fround signum cis)
 509   (:export run-lisp-stat-tests run-lisp-stat-test scoreboard ; exec
 510            almost= almost=lists numerical=)) ; compare
 511
 512 (defpackage :lisp-stat-data-clos-example
 513   (:use :common-lisp
 514         :lift  :lisp-stat-unittests
 515         :lisp-stat-data-examples
 516         :lisp-stat-data-clos)
 517   (:export absorbtion aluminum iron))
 518
 519
 520 (defpackage :lisp-stat-optimize
 521  (:use :common-lisp
 522        :cffi
 523        :lisp-matrix
 524        :lisp-stat-ffi-int
 525        :lisp-stat-object-system
 526        :lisp-stat-types
 527        :lisp-stat-compound-data
 528        :lisp-stat-math
 529        :lisp-stat-float
 530        :lisp-stat-basics
 531 #|
 532        :lisp-stat-matrix
 533        :lisp-stat-linalg-data
 534        :lisp-stat-linalg
 535 |#
 536        )
 537  (:shadowing-import-from :lisp-stat-object-system
 538                          slot-value call-method call-next-method)
 539  (:shadowing-import-from :lisp-stat-math
 540            expt + - * / ** mod rem abs 1+ 1- log exp sqrt sin cos tan
 541            asin acos atan sinh cosh tanh asinh acosh atanh float random
 542            truncate floor ceiling round minusp zerop plusp evenp oddp
 543            < <= = /= >= > complex conjugate realpart imagpart phase
 544            min max logand logior logxor lognot ffloor fceiling
 545            ftruncate fround signum cis)
 546  (:export
 547      ;; derivatives
 548      numgrad numhess
 549
 550      ;; optimization
 551      newtonmax nelmeadmax))