alberta3

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

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

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

                 _________ ALBERT/ __________ src/ _______|--- 1d/
                /                         \               |--- 2d/ 
               /__________ BLAS/           -- doc/        |--- 3d/
              /                                           |--- Common/
             /____________ DEMO/ __ src/ _______|--- 1d/  |--- ALBERT??_?/
albert-1.2/ *                                   |--- 2d/  
             \____________ ALBERT_UTIL/         |--- 3d/
              \                                 |--- Common/
               \__________ PLOT_ANSI/ __ src/
                \
                 \________ SOLVER/ __ src/
                  \
                   \______ [gltools-2-4/] optional
                    \
                     \____ configure.ac and other distribution
                           files

1) ALBERT
The main package.

2) BLAS
Basic Linear Algebra Subroutines, these are compiled if the system on which ALBERT 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.albert" which resides in $installdir/include together with the C-header files. They are meant to faciliate the first steps with ALBERT.

4) ALBERT_UTIL
This package contains the old ALBERT util.c file, now split into several smaller source files. It is compiled to form a separate utility library (message macros, ALBERT memory allocation routines, etc.) and should linked to any program using the ALBERT 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 ALBERT.


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

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


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

The configure file accepts an option called

 --with-gltools=PATH

where 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.

Default library mode is to install static and shared libraries. Change this via

  --enable-shared=?? and/or --enable-static=??

where ?? is "yes" or "no". Finally, the option

  --enable-el_index

builds versions of the ALBERT libraries with C Preprocessor macro "EL_INDEX" set to 1. See the ALBERT documentation for details.

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.