Breakdown of the Madrigal installation script

The main Madrigal installation script is madroot/installMadrigal. On this page the main parts of that script are described.

checkConfig - this tcl script checks the validity of the entries in the madrigal.cfg file.

setPermissions - this tcl script sets appropriate file permissions

configureSource - this tcl script edits any scripts in the source directory that need hard-coded keywords set in the madrigal.cfg file. It also installs some files needed by the IRI model.

Autotools (configure, make, make install) then runs from the madroot/source directory and compiles and installs:

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 build directory is madroot/source/madf/geolib. The library is installed in madroot/lib. To rebuild this library manually, cd to that directory and run make and make install. The application looker1 is also built from Fortran. The build directory is madroot/source/madf/applications. The executable is installed in madroot/bin. To rebuild this program manually, cd to that directory and run make and make install.

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 and Tcl all call this library. The build directory is madroot/source/madc/madrec. The library is installed in madroot/lib. To rebuild this library manually, cd to that directory and run make and make install.

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. The build directory is madroot/source/madc/madtcl. To rebuild this program manually, cd to that directory and run make and make install.

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.

python application - the python application (version 2.5.2) is built next.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: pyxml, numpy, and matplotlib.

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.