Breakdown of the Madrigal installation script

The main Madrigal installation script is either madroot/doc/installMadrigal.gnu or madroot/doc/installMadrigal.solaris. On this page the main parts of that script are described.

configureMake - this tcl script edits all the Makefiles in place in the source directory, replacing keywords set in the madrigal.cfg file.

configureHtml - this tcl script edits the documentation files in the doc directory, replacing keywords set in the madrigal.cfg file, and copies them into the web servers document root as set in madrigal.cfg. If you as an administrator modify any documentation in the doc directory (such as to add site-specific documentation), run this script again to install your changes on the web server.

configureScripts - this tcl script edits all the python and tcl scripts in the source directory, putting the modified versions either in the web server's cgi directory, or in madroot/bin.

geo library - the Fortran geo library is next built using the Fortran compiler specified in madrigal.cfg. This library contains a large number of geometric and scientific routines called by the C library madrec. The library is installed in madroot/lib.

madrec library - the C madrec library is next built using the C compiler specified in madrigal.cfg. This library is the heart of Madrigal - it reads and writes Madrigal files, and derives all Madrigal parameters. Python, Tcl, and Matlab all call this library. The library is installed in madroot/lib.

madtclsh application - the madtclsh application is a tclsh extension with capabilities added from the madrec library. It is installed in madroot/bin, and is the application that runs the tcl scripts.

python application - the python application (version 2.3.5) is built next. Madrigal no longer allows for the use of an external version of python, since so many non-standard modules are needed. The large majority of Madrigal is built on python, which is in turn built on the madrec and geo libraries. Madrigal now automatically installs the following external modules in python:

Madrigal
PyXML-0.8.3
Numeric-23.8
matplotlib-0.83.2

configureExperiments - this tcl script edits all the metadata in each experiment to be sure the site id is the local one. This script also allows you to copy an experiment directory from one Madrigal site to another.

updateMetadata - the final step in the installation of Madrigal is the updating of metadata through the updateMaster and other scripts.