examples/01-basicEDA.lisp

   1 ;;; -*- mode: lisp -*-
   2
   3 ;;; Time-stamp: <2010-02-10 14:23:42 tony>
   4 ;;; Creation:   <2009-04-19 09:41:09 tony>
   5 ;;; File:       basic-eda.lisp
   6 ;;; Author:     AJ Rossini <blindglobe@gmail.com>
   7 ;;; Copyright:  (c)2009--, AJ Rossini.  BSD, MIT, LLGPL, or
   8 ;;;             GPLv2+, or GPLv3+ depending on how it arrives.
   9 ;;; Purpose:    Example of basic exploratory data analysis in CLS.
  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 (in-package :cls-examples)
  16
  17 ;; We assume that the "loading-data.lisp" code has been run, and one
  18 ;; now wants to analyze the data loaded into *chickwts-df*
  19
  20 (load (localized-pathto "loading-data.lisp")
  21       :verbose t)
  22
  23 *chickwts*
  24
  25 ;; Summarize is the basic EDA tool -- it accepts symbols or lists of
  26 ;; symbols, to describe what, when, and how to do it.  The resulting
  27 ;; data structure has a means for re-invoking the result as well as
  28 ;; partial storage of key results (when appropriate) as well as
  29 ;; metadata about the results (time / context if provided).
  30
  31 ;; numerical: (txt / *ml /  ,  variable / stream / spec'd to file)
  32 ;; visual: (static/dynamic, fixed/interactive) (need better term than fixed)
  33
  34 ;; context -- using dataset metadata, to drive the resulting summary.
  35 ;; dataset metadata:
  36 ;; #1 sampling scheme -
  37 ;;       retro / prospect  collection
  38 ;;       random, biased, convenience sampling;
  39 ;; #2 purpose of dataset integration/manipulation
  40 ;; #3 sampling/temporal component of variables
  41 ;;
  42
  43 (defparameter *my-df-smry-num*
  44   (summarize *chickwts* :type 'numerical :io 'listing)
  45   "First numerical summary of *my-df-smry*")
  46
  47 (defparameter *my-df-smry-num*
  48   (summarize *my-df*
  49              :type 'numerical
  50              :io 'report-pdf
  51              :device '(file "output.pdf"))
  52   "First numerical summary of *my-df-smry*")
  53
  54 (defparameter *my-df-smry-vis*
  55   (summarize *my-df*
  56              :type 'visual
  57              :io 'interactive
  58              :device 'xwin)
  59   "visual summary")
  60
  61 (defparameter *my-df-smry-vis*
  62   (summarize *my-df* :type 'visual :io 'interactive-dynamic)
  63   "visual summary")
  64
  65 (defparameter *my-df-smry-vis*
  66   (summarize *my-df* :type 'visual :io 'static)
  67   "visual summary")