Analysis Parameter Webpage

Author: Daniel Graves
Date:   2004/11/16
Modified: Mina Nozar
Date:   2005/05/31
====================

1) Overview

The analysis webpage consists mostly of static webpages.  Currently,
the only dynamic web page generates a webpage for parameters of a
particular gen, gen analysis, or set analysis.  It consists of 3
columns.  The first is the name of the environment variable.  The
second is the environment variable's value.  The third is a
description of the environment variable.

2) Parameter Description Database File: "param_desc.db"

The parameter description database, "param_desc.db", is under 
~e614/public_html/private/TWIST_2004_Analysis/parameters
and contains the description of the parameters set for a given mc gen
(production/analysis) and data set analysis.

The parameter description database is a Perl DB database created by the script
"mk_param_desc.pl" in ~e614/public_html/private/TWIST_2004_Analysis


3) Parameter Files

The parameter files are simply the environment variable files containing information 
on the parameters used during the generation and/or analysis of mc gen or data set. 
The are under ~e614/public_html/private/TWIST_2004_Analysis/parameters 

The parameter files are produced in the ~e614/tbsroot/<genXXX|setXXX>/common 
directory on West Grid and must currently be copied manually to the database directory
~e614/public_html/private/TWIST_2004_Analysis/parameters until a mechanism is 
established to copy the files automatically.

These files don't change after creation for a particular set/gen so they only need to 
be copied once.

4) Web Site Files

The website files are located in ~e614/public_html/private/TWIST_2004_Analysis.  
The web site is written in html except for the parameter page that dynamically 
creates a list of the parameters and their description, "showparam.pl".
"showparam.pl" takes an environment variable argument called QUERY_STRING.  
In Perl this is passed by calling the script in the web browser with a URL similar to
http://tw04.triumf.ca/private/TWIST_2004_Analysis/showparam.pl?set39anal1
The part after the ? sets QUERY_STRING to set39anal1 which is how
the script knows what parameters to display.  
The "showparam.pl" only works on tw04.triumf.ca (the parameter description database file
cannot be opened on e614db.triumf.ca)