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

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

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

The procedure

      d2htds_INSTALL (or ./d2htds_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 D2hTDS.tar.gz can be purged.

The D2hTDS 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, Linux.

      The compiling options depend on the compiler type.

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

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

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

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

The installation procedure described above creates the following directories:

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

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

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

                  D2hTDS/ctrp/12C2H4/000000000001

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

                  D2hTDS/exp/12C2H4/dip/ASG_VanderAuwera_nu12

- D2hTDS/jobs/ contains UNIX jobs for

               1) calculation of spectra (one directory per molecule),
               2) experimental data fit (examples only in fit_examples).
               3) simulation of synthetic spectra (examples only in simul_examples).
               4) specific Stark examples.

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

                  D2hTDS/para/12C2H4/Pa_000000000001m000000000000

- D2hTDS/prog/ contains three sub-directories:

               1) exe contains:
                 - 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/D2HTDS.html

for news and updates.

NOTE: The jobs that can be found in the subdirectories of D2hTDS/jobs can be used
      just as they are.

D2hTDS is described in the following article:

  - Ch. Wenger, W. Raballand, M. Rotger and V. Boudon, J. Quant. Spectrosc. Radiat. Transfer, 95, 521-538 (2005).

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

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

         M. Rotger, V. Boudon and C. Richard
         E-mail Maud.Rotger@univ-reims.fr
                Vincent.Boudon@ube.fr
                Cyril.Richard@ube.fr

