alberta3

ALBERTA:   an Adaptive multi Level finite element toolbox using 
          Bisectioning refinement and Error control by Residual
          Techniques

I) Introduction
===============

This is ALBERTA Version 1.2. For the installation process refer to INSTALL.
Contained in the package are the following subpackages:

                 __________ ALBERTA/ __________ src/ _______|--- 1d/
                /                          \               |--- 2d/ 
               /___________ BLAS/           -- doc/        |--- 3d/
              /                                            |--- Common/
             /_____________ DEMO/ __ src/ _______|--- 1d/  |--- ALBERTA??_?/
alberta-1.2/ *                                    |--- 2d/  
             \_____________ ALBERTA_UTIL/         |--- 3d/
              \                                  |--- Common/
               \___________ PLOT_ANSI/ __ src/
                \
                 \_________ SOLVER/ __ src/
                  \
                   \_______ GRAPE/  __ mesh/ ____|--- 2d/
                    \                            |--- 3d/
                     \                           |--- Common/
                      \
                       \___ [gltools-2-4/] optional
                        \
                         \_ configure.ac and other distribution
                            files

1) ALBERTA
The main package.

2) BLAS
Basic Linear Algebra Subroutines, these are compiled if the system on which ALBERTA will run does not supply them.

3) DEMO
A few demonstration programs. This subpackage includes several small Makefile.in's in which configure substitutes values like installation paths for libraries and headers. This directory can be copied elsewhere by the user after installation. The Makefiles include "Makefile.alberta" which resides in $installdir/include together with the C-header files. They are meant to faciliate the first steps with ALBERTA.

4) ALBERTA_UTIL
This package contains the old ALBERTA util.c file, now split into several smaller source files. It is compiled to form a separate utility library (message macros, ALBERTA memory allocation routines, etc.) and should linked to any program using the ALBERTA package.
It can also be used as a standalone utility library.

5) PLOT_ANSI
PLOT_ANSI provides tools for displaying X11 graphics, if gltools is not used.

6) SOLVER
Linear and nonlinear solver routines for ALBERTA.

7) GRAPE
GRAPE interface for ALBERTA. Only for non-parametric FE of dimension 2 and 3.
"make" will create "alberta_grapeXX" and alberta_moviXX" where XX is in {22, 33}.
"make install" will install those programs below PREFIX/bin.

The GRAPE interface is only installed when the GRAPE library and header file
are available on your system (determined at configure time, use 
"configure --help" for apropriate command line switches for "configure").

II) External packages
=====================

The gltools package is not part of ALBERTA. If it is detected during installation, the file ALBERTA/src/Common/gltools.c is included in the ALBERTA libraries. The user can specify the path of an already installed gltools-package as a configure option, see below.


III) Configure options
======================

"configure --help" will give you a summary of available options. The file
"INSTALL" contains generic configuration instructions and a description of
generic command line options for configure.

The remaining (i.e. ALBERTA specific) options are explained here:

  --with-gltools=PATH
        PATH is the path of a gltools-2-4 directory possible installed
        on the system. The default value where gltools-2-4 is searched
        is the build directory. The default installation path is also
        the build directory. This can be changed via

  --prefix=PREFIX         install architecture-independent files in PREFIX.
        NOTE: this is different from the default GNU installation prefix,
        which would be "/usr/local/".

  --enable-shared=?? and/or --enable-static=??
        Default library mode is to install static and shared libraries.
        This can be changed using these switches, 
        where ?? is "yes" or "no".

  --enable-el_index
        builds versions of the ALBERTA libraries with C Preprocessor
        macro "EL_INDEX" set to 1. See the ALBERTA documentation for
        details.

  --without-GRAPE
        do not even attempt to detect GRAPE. As a result, the GRAPE
        interface will not be compiled.

  --with-GRAPE-lib=DIR
        Location of "libgr.a" or "libgr.so" on your system. If
        "libgr.so" is installed at "/foo/bar/lib/libgr.so", then DIR
        should be set to "/foo/bar/lib/".

  --with-GRAPE-headers=DIR
        Location of the GRAPE header file "grape.h". If "grape.h" is
        installed at "/foo/bar/include/grape.h", then DIR should be
        set to "/foo/bar/include/".

We recommend setting the environment variables "CFLAGS" and "FFLAGS" to "", so that "configure" does NOT automatically substitute a "-g" debugging option while compiling, as well as using the highest possible optimization flag "-O???" during a build of (non-debug) libraries.