The Dune-Subgrid Module

About

Dune-subgrid is a module for the DUNE environment. The dune-subgrid module allows to mark elements of another hierarchical dune grid. The set of marked elements can then be accessed as a hierarchical dune grid in its own right. Dune-Subgrid provides the full grid interface including adaptive mesh refinement. Further information on the features, interface and implementation of dune-subgrid can be found in the dune-subgrid paper.

Download

Known Issues

Please read the license information below and in the included files COPYING and KnownIssues.

Installation

Unpack the downloaded archive to the directory containing your dune modules and use the dunecontrol script of the dune-common module to configure and build it.

Documentation

The use of dune-subgrid is described in this paper. The module itself also contains a class documentation created with doxygen.

Publications

Please cite the dune-subgrid paper in any publication using the dune-subgrid module:

C. Gräser and O. Sander, The dune-subgrid Module and Some Applications, Computing 8 (4), 2009, pp. 269-290

License

The dune-subgrid library and headers are licensed under version 2 of the GNU General Public License (see below), with a special exception for linking and compiling against dune-subgrid, the so-called "runtime exception." The license is intended to be similiar to the GNU Lesser General Public License, which by itself isn't suitable for a template library.

The exact wording of the exception reads as follows:

As a special exception, you may use the dune-subgrid source files as part of a software library or application without restriction. Specifically, if other files instantiate templates or use macros or inline functions from one or more of the dune-subgrid source files, or you compile one or more of the dune-subgrid source files and link them with other files to produce an executable, this does not by itself cause the resulting executable to be covered by the GNU General Public License. This exception does not however invalidate any other reasons why the executable file might be covered by the GNU General Public License.

This licence clones the one of the libstc++ library. For further implications of this library please see their license page.

See the file included COPYING for full copying permissions.

Contact

Please contact the dune-subgrid developers Carsten Gräser and Oliver Sander for bug reports.

Imprint

Please refer to the imprint of the scientific computing group.