-----------------------------------------------------------------
               README FOR CODE_ASTER INSTALLATION
                      SOURCES DISTRIBUTION
     $Id: README_SOURCES,v 2.7 2004/05/07 16:24:24 mcourtoi Exp $
-----------------------------------------------------------------

SUMMARY :
   0. LICENCE
   1. DISTRIBUTION
      1.1 ABOUT ASTK
   2. REQUIRED PRODUCTS
   3. INSTALLATION
   4. TESTED PLATFORMS

For those that don't like to read ;-) step to "3. INSTALLATION".

For further informations visit http://www.code-aster.org


-----------------------------------------------------------------
0. LICENCE :
   Code_Aster is distributed under the terms of the GNU General
   Public Licence. The text is available at :
      http://www.code-aster.org/telechargement_doc/GPL.txt


-----------------------------------------------------------------
1. DISTRIBUTION :
   The package "aster_src_NNN.tar" contains :
      - this README !
      - aster.tar.gz : source of the version NNN
      - astk.tar.gz : graphic interface for Code_Aster
      - UTILS/ : auxiliary installation files
      - install.sh : main installation script

   The package contains Code_Aster and ASTK (see 1.1), some other
   products are required, please read next section to know what
   products and version you must install.
   The installation of ASTK is optionnal.


1.1. ABOUT ASTK :
   ASTK is the graphic interface to manage Code_Aster studies.
   ASTK allows to run Code_Aster on a local or remote machine.
   Do not hesitate to use Code_Aster Forum for any suggestions
   or remarks about this product.
   Code_Aster Forums at http://www.code-aster.org/forum.


-----------------------------------------------------------------
2. REQUIRED PRODUCTS :
   You can download these products from http://www.code-aster.org
   Some products are absolutelly necessary :
      - Python 2.2.x
        (it works with 2.3.x, but you need modify "python_v"
        value in UTILS/main.sh file)
      - Tcl/Tk librairies 8.4.x
      - X11 library
      - med 2.1.5 with hdf 5.1.4.4
      - BLAS library or equivalent depending on platform
        As Blas are not a standard on all platform, change BLAS
        variable in UTILS/main_aster.sh file to set the correct
        name or "" to ignore it (but it will need at link).
      - metis version edf-3.1

   Optionnal librairies/modules :
      - Numerical Python 20.3 for MACR_RECAL Code_Aster commands
      - Gnuplot 3.7.1 and Gnuplot-Python module 1.5
      - Tkinter for Eficas
      - Python MegaWidget 0.8.5 for Eficas (try 1.2 if problem)

   Optionnal tools :
      - ASTK 1.1 : Tcl/Tk interface to run Code_Aster (prepare
        and start calculations using run_aster, included in the
        distribution)
      - Eficas 1.6 : ASter Command FIle Editor
      - Homard 6.2 : refinement and de-refinement mesh tool
      - GIBI 2000 : mesh generator and post-processor
        (based on commands file)
      - XmGrace 5.1 : to create 2D graph
      - GMSH 1.51 : interactive mesh generator and post-processor

   Remark : Only tools directly called from a Code_Aster
      execution are tested during installation process.
      These tools are : metis, Homard, Gnuplot and Gibi.


-----------------------------------------------------------------
3. INSTALLATION :
   Be sure required products are installed, the installation
   procedure could help you to find them on your machine.
   
   Just type : ./install.sh
   and answer to questions. You could consult your choices later
   in the log file (install.log).

   Remark : to construct a development version and so to give it
            another version number than STAn.p,
            change pseudo_vers value in 'UTILS/main.sh'.


-----------------------------------------------------------------
4. TESTED PLATFORMS :
   The installation procedure and Code_Aster has been tested on :
      - Linux kernel 2.4.x
      - Sun Solaris 2.6 (32 bits)
      - Sun Solaris 2.8 (64 bits)
      - Compaq AlphaServer ES45 TRU64 5.1
      - SGI Origin2000 IRIX64 6.5

   This should work on most of others unix platforms.
   If you success on another platform, post your change
   (installation procedure, compiler options...) to Code_Aster
   forum : http://www.code-aster.org/forum

   If it's failed, ask your questions to the "Installation"
   forum thread.

-----------------------------------------------------------------
