PDELab
======

PDELab[0] is a PDE solver toolbox built on top of DUNE, the Distributed and Unified
Numerics Environment [1].

The main intention is to provide a good set of high-level abstractions to allow
for a reasonably quick development of simulation codes, while at the same time
offering the flexibility to implement new numerical methods and optimize for
specific simulation scenarios.

This package contains the PDELab library code. For application examples see the
companion package dune-pdelab-howto.

If you have downloaded a release tarball, you can find the autogenerated Doxygen
API documentation in doc/doxygen/html. Otherwise, you can build this documentation
yourself by calling "make doc". Note that you need Doxygen and GraphViz available at
configure time to be able to build the documentation.

If you need help, please ask on our mailinglist [8]. Bugs can also be submitted
to the PDELab bugtracker at [9] instead.

Dependencies
------------

PDELab depends on the following software packages:

* DUNE core libraries (dune-common, dune-geometry, dune-grid, dune-istl,
  dune-localfunctions) version 2.2.x, and their respective dependencies.

* The dune-typetree library, version 1.0.x, which you can obtain from [10].

* PDELab's compiler requirements differ slightly from the underlying DUNE
  libraries: We require at least GCC 4.0, although we only regurlarly test GCC
  versions from GCC 4.2 onward. Compile times are greatly reduced if the
  compiler supports the new C++11 standard (GCC 4.3 and newer). PDELab is not
  regularly tested with ICC, but we also support the clang compiler (3.1+).

The following software is optional

* PETSc 3.3 [5] - there is an experimental backend for PETSc vectors and
  matrices. See RELEASE_NOTES for details.

* Eigen 3.1.0 [6] - there is an experimental backend for Eigen vectors and
  matrices as well as some solvers. See RELEASE_NOTES for details.

For a full explanation of the DUNE installation process please read
the installation notes [2] or the build system HOWTO [3].

License
-------

The PDELab library, headers and test programs are free open-source software,
dual-licensed under version 3 or later of the GNU Lesser General Public License
and version 2 of the GNU General Public License with a special run-time exception.

See the file COPYING for full copying permissions.

Installation
------------

Short installation instructions can be found in file INSTALL. For the
full instructions please see [1].

Links
-----

 0. http://www.dune-project.org/pdelab/
 1  http://www.dune-project.org
 2. http://www.dune-project.org/doc/installation-notes.html
 3. http://dune-project.org/doc/buildsystem/buildsystem.pdf
 4. http://gcc.gnu.org/onlinedocs/libstdc++/faq.html#faq.license
 5. http://www.mcs.anl.gov/petsc/
 6. http://eigen.tuxfamily.org
 8. http://lists.dune-project.org/mailman/listinfo/dune-pdelab
 9. http://users.dune-project.org/projects/dune-pdelab/issues
10. http://git.dune-project.org/repositories/dune-typetree.