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

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

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

The procedure

      c4vtds_INSTALL (or ./c4vtds_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 C4vTDS.tar.gz can be purged.

The C4vTDS 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 C4vTDS_PC.tar.gz.

> 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:

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

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

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

                  C4vTDS/ctrp/SF535Cl/001000

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

                  C4vTDS/exp/SF535Cl/dip/ASG_Burger_nu1

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

- C4vTDS/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).

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

                  C4vTDS/para/SF535Cl/Pa_001000m000000

- C4vTDS/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/C4VTDS.html

for news and updates.

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

C4vTDS uses the Oh-C4v reorientation formalism described in the following articles :

  - M. Rotger, V. Boudon and M. Loete, J. Mol. Spectrosc., 200, 123-130 (2000),
  - M. Rotger, V. Boudon and M. Loete, J. Mol. Spectrosc., 200, 131-137 (2000).

For those who want to create their own calculation and fit jobs, they can modify the given
examples. The C4vTDS 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

