INSTALLATION INSTRUCTIONS

Prerequisites:
--------------

The following Perl modules must be installed on your system:

  LWP
  Algorithm::NaiveBayes
  YAML
  PDL
  SOAP::Lite
  HTML::Parser

These modules are available on CPAN (http://search.cpan.org).  Some of these
modules may already be pre-installed on your system.  To see if you have one
of these modules (LWP, for example), you can run:
  
  perl -MLWP -e ''
  perl -MYAML -e ''
  perl -MPDL -e ''
  etc.

In addition, the following packages are also required:

  Google API
  SVDPACKC

  * Google API

    Download the Google API from http://www.google.com/apis/ and unpack
    it in a convenient location on your machine (e.g., if you unpack it
    from your home directory, the APIs will reside in ~/googleapi).
    
    You will also need to get a license key from Google.  You can sign-up
    for a license key at the same URL.
    
  * SVDPACKC
    
    1) Download SVDPACKC from http://www.netlib.org/svdpack/ (get the
       file called svdpackc.tgz).
    
    2) If you're running on a Unix system, you need to uncomment the line
       that looks like this in las2.c:
       
       /*    #define  UNIX_CREAT    */
     
       I.e., you want UNIX_CREAT to be defined.

    3) In las2.h file change the values of the constants at or near lines
       16-18 as follows:

       #define LMTNW   900300001  /* max. size of working area allowed  */
       #define NMAX    30000     /* bound on ncol, order of A          */
       #define NZMAX   9000000  /* bound on number of nonzeros in a   */
    
    4) On most Unix systems, you _must_ modify the makefile to use
       ANSI C:

       CC = gcc -ansi

    5) Run 'make las2'

    5) Copy las2 to some place in your $PATH or point your PATH at
       the directory containing las2.  For example, if you have las2
       in ~/bin, then add this to your .bashrc and/or .bash_profile:
       
       export PATH=~/bin:PATH
  
       If you're using csh or tcsh, add the following to your .cshrc

       set path=(~/bin $path)
    
Basic method:
-------------
perl Makefile.PL
make
make install

If you don't have supervisor access, then you will need to specify
a PREFIX when you run Makefile.PL:

perl Makefile.PL PREFIX=~/seam LIB=~/lib
make
make install

In this case, the executables and man pages will be installed into
subdirectories of ~/seam.  The executable files will be in the 'bin'
subdirectory of the PREFIX.  For example, they would be in ~/seam/bin in the
example above.

The library files (.pm files) will be in a subdirectory of LIB.  You
will also need to set the variable PERL5LIB:

export PERL5LIB=$HOME/lib

To run:
-------
To run in student mode: 

$ seam.pl prompt.txt essay.txt $HOME/googleapi/GoogleSearch.wsdl \
  your_google_key log_file_name student

or

$ ~/seam/bin/seam.pl prompt.txt essay.txt $HOME/googleapi/GoogleSearch.wsdl \
  your_google_key log_file_name student


To run in developer mode:

$ seam.pl prompt.txt essay.txt $HOME/googleapi/GoogleSearch.wsdl \
 your_google_key log_file_name developer

or

$ ~/seam/bin/seam.pl prompt.txt essay.txt $HOME/googleapi/GoogleSearch.wsdl \
 your_google_key log_file_name developer


prompt.txt must be a plain-text file containing the prompt, and
essay.txt must be a plain-text file containing the essay (and only
the essay).  Recall that in the latter example, you need to have already
set PERL5LIB.


Samples
-------
The 'samples' directory contains sample essay and prompt files.  The essay
files end in .essay and the prompt files end in .prompt.

INSTALL THE WEB FILES
---------------------
You must have the Apache server running on your system.

1) run perl Makefile.PL

2) run make

3) copy the blib directory created by make to web/cgi-bin/SEAM/blib

  $ cp -Rf blib web/cgi-bin/RacingClub/blib

4) Update the settings at the top of web/cgi-bin/RacingClub/analysis.cgi
   to fit your system.  The settings are clearly set off inside a block
   like this:

   #------BEGIN EDIT CODE BLOCK------
   #...settings...
   #-------END EDIT CODE BLOCK-------

   At a minimum, you'll need to specify your Google API key, the
   location of the Google API .wsdl file, and the directory where you
   want log files to be stored.

5) copy web/cgi-bin/RacingClub to wherever CGI files go on your system
   (for example, ~/www/cgi-bin/RacingClub )

  $ cp -Rf web/cgi-bin/RacingClub ~/www/cgi-bin/RacingClub 

6) point your web browser at

   http://[your_host_name]/cgi-bin/RacingClub/welcome.cgi