CMBFAST Online Tool Readme

This tarball contains a web interface to CMBFAST.  This interface was developed by
the LAMBDA team; any questions regarding it should be directed to LAMBDA.

Information regarding CMBFAST can be found at: 
http://www.cmbfast.org/cmbfast.html

The data input form HTML page does not define a complete web page.  However, it
does completely define the interface form.  The enclosed CSS file must be
associated with the page for the form to be correctly layed out.  JavaScript is
used to a little data entry verification and to display/hide inputs as different
options are selected; the user's browser must have JavaScript enabled for this
form to work.

*** Requirements:
- A local copy of CMBFAST.  This interface was developed using version 4.5.1.
- The form processor was written in Perl, and has been tested using Perl V5.6.0,
  and V5.8.0, and V5.8.2.
- GnuPlot is used to draw plots of some of the results.  It has been tested with
  V3.7.1 and V3.7.3.
- The CGI module that should come with a standard Perl installation.
- The HEALPix synfast application may be used to create maps from the output
  spectra.
- This application was designed and tested on a Linux operating system.

*** Inventory:
There are six files in this tarball:
- Readme.txt         - This file.
- cmbfast_form.html  - The HTML that defines and lays out the form.
- cmbfast.css        - A Cascading Style Sheet file used by the HTML to layout for
                       contents of the form.
- cmbfast_proc.pl    - The Perl script that processes the form inputs, runs CMBFAST,
                       and displays the output.  The Results function should be
		       modified to define your own layout.
- Local.pm           - A collection of routines used in a number of our
	               Perl scripts.
- CMBFAST.pm         - A collection of routines and constants common to the
	               CMBFAST web interface Perl scripts.

*** Installation:
0) Download and install CMBFAST and GnuPlot.
1) Copy the Perl scripts and packages into your CGI directory.
2) Create a cmbfast directory under the document root directory of the web site.
   Under this cmbfast directory, create an input and an output directory.
   
   Create the jlens.dat, jlgen.dat, and ujlgen.dat files needed by CMBFAST.
   Store them in the just-created input directory.  The LAMBDA versions may 
   be copied from:
     http://lambda.gsfc.nasa.gov/cmbfast/input/jlens.dat
     http://lambda.gsfc.nasa.gov/cmbfast/input/jlgen.dat
     http://lambda.gsfc.nasa.gov/cmbfast/input/ujlgen.dat
3) Perform the following modifications to the scripts:
   a) Local.pm
      - Set the $pwd constant to the full path to the Unix pwd command.
      - Set the $root constant to the path to the document root relative
        to the parent directory of the cgi-bin directory
	                      OR
        Modify the RootDir function to return the full path to the document 
        root directory.
   b) CMBFAST.pm
      - Set $node to the name of your web server.
      - Set the $docroot constant to the location of the cmbfast directory
        created in step 2.
      - Set the $outdir constant to the location of the output directory 
        created in step 2.
      - Set the $indir constant to the location of the input directory 
        created in step 2.
        Set the $cmbprc constants to the URL of the cmbfast_proc.pl script.
      - Edit CMBFastHdrContents and CMBFastFtr to format the web pages.
   c) cmbfast_proc.pl
      - Set the #!/usr/local/bin/perl line to the location of the perl
        executable on the web server.
      - Set the $cmbfast constant to the full path of the cmb executable
        (this is the primary CMBFAST program).
      - Set the gnuplot constant to the full path of the GnuPlot executable.
4) Create a web page for the form, using the cmbfast_form.html file as a starting
   point.  Be sure to include the CSS file in this page's header.

*** Change History

August 2003
-- Adapted to CMBFAST 4.3.

April 2004
-- Adapted to CMBFAST 4.5.1

January 2005
-- Corrected a client/server/firewall timeout issue.  

June 2005
-- Corrected an error in handling only one transfer function.

August 2006
-- Eliminated the cmbfast_form.pl script; form manipulation is now done entirely in Javascript.

-- Synfast support.