
*************************
INSTALLATION INSTRUCTIONS
*************************

The present file has been extracted from the archive file by:

      gunzip <STDS.tar.gz   | tar xvf -
      which creates the ./STDS   directory

The procedure

      stds_INSTALL   (or ./stds_INSTALL  )

needs to be executed to customize all executable files and compile all programs.
It updates pathes in the different scripts and runs the compile script.
Once uncompressed and extracted STDS.tar.gz   can be purged.

The STDS   package will then be ready for use (see next Section).

NOTES:

> Compilation and execution have been tested on the following UNIX platforms:

      HP, IBM, SUN, Compaq Alpha, Mac G3/G4/G5/Intel.

      The compiling options depend on the compiler type.

      SGI workstations can also run the package
      with a few modifications. Please contact us.

      A PC LINUX version of this package has also been tested and
      is named STDS_PC.tar.gz.

> For complex band systems a free disk space of several hundreds of
      Megabytes is required.

> STDS and STDH (HITRAN output) scripts are in STDS/prog/exe directory.

> To use jobs it is highly recommanded to create first a calculation directory
  outside install directory.

> Launch the STDS and STDH scripts to get the explanations about their usage.

***********
DESCRIPTION
***********

The installation procedure described above creates the following directories:

  STDS/bin/
  STDS/ctrp/
  STDS/exp/
  STDS/gtd/
  STDS/jobs/
  STDS/para/
  STDS/prog/

- STDS/bin/    contains the executables (compiled FORTRAN programs only).

- STDS/ctrp/   contains parameter control files for fits arranged by molecule
               (one sub-directory per molecule).
               Example:

                  STDS/ctrp/70GeF4/0001

- STDS/exp/    contains assignment files arranged by molecule and by transition
               type.
               Example:

                  STDS/exp/70GeF4/dip/ASG_Burger

- STDS/gtd/    contains necessary coefficients for matrix element calculations.

- STDS/jobs/   contains UNIX jobs for

               1) calculation of spectra :
                    TRANSITIONS -> TDS    format output
                    HITRAN      -> HITRAN format output
               2) calculation of energy levels :
                    LEVELS
               3) calculation of energy levels with mixings :
                    mixing_examples
               4) experimental data fit :
                    fit_examples
               5) simulation of synthetic spectra :
                    simul_examples

- STDS/para/   contains Hamiltonian, dipole moment and polarisability parameters
               arranged by molecule.
               Example:

                  STDS/para/12CH4/Pa_DYADmGS

- STDS/prog/   contains three sub-directories:

               1) exe contains:
                 - STDS script that generates prediction ASCII files in the working directory
                   from any parameter file.
                 - STDH script that does the same thing as STDS but generates output in HITRAN
                   format.
                 - compile that compiles all the package programs. After installation,
                   it can be re-runned if different compiling options are needed.
                 - xasg, exasg and passx files that are used by the jobs.

               2) ppr contains the F95 sources of the different main programs.

               3) ssp contains the F95 sources of the different subroutines and functions.

               4) mod contains the F95 sources of the different modules.

************************************
MOLECULES AND BAND SYSTEMS INCLUDED
************************************

Please check the Web site

  http://icb.u-bourgogne.fr/OMR/SMA/SHTDS/STDS.html

for news and updates.

Available molecules and band systems can be found in

  STDS/jobs/TRANSITIONS/Test_all script.

The values of the arguments (especially Jmax and Smin) represent
"reasonable" extrapolations of spectra analyses.

The terminology of band systems ("UpState" or "LoState") is described
in J. Quant. Spectrosc. Rad. Transfer. 52, 459-479 (1994).

NOTE that many of the available predictions come from
unpublished works in progress (extensions _! or _!!).

STDS   is described in the following article:

  - Ch. Wenger and J.-P. Champion, J. Quant. Spectrosc. Radiat. Transfer 59,471-480 (1998).

For those who want to create their own calculation and fit jobs, they can modify the given
examples. The STDS   syntax is explained in the syntax_README file.

********
CONTACTS
********

         V.Boudon and C. Richard
         E-mail Vincent.Boudon@ube.fr
                Cyril.Richard@ube.fr

