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
- The latest stable version is dune-subgrid-2.0-2.tar.gz. It is compatible to the 2.0 release of the Dune core modules.
Version 0.8 of the dune-subgrid module is based on revision 212 in the development trunk. It requires the upcoming 1.2 release of the DUNE core modules and can be downloaded here: dune-subgrid-0.8.tar.gz
This version only supports grids with a single type of elements.
Please read the license information below and in the included files COPYING and KnownIssues.
Known Issues
Only grids with a single element type are supported
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.