|
static std::unique_ptr< Grid > | read (const std::string &fileName, bool verbose=true, bool insertBoundarySegments=true) |
|
static std::unique_ptr< Grid > | read (const std::string &fileName, std::vector< int > &boundarySegmentToPhysicalEntity, std::vector< int > &elementToPhysicalEntity, bool verbose=true, bool insertBoundarySegments=true) |
| Read Gmsh file, possibly with data. More...
|
|
static void | read (Dune::GridFactory< Grid > &factory, const std::string &fileName, bool verbose=true, bool insertBoundarySegments=true) |
|
static void | read (Dune::GridFactory< Grid > &factory, const std::string &fileName, DataFlagArg boundarySegmentData, DataArg elementData, bool verbose=true) |
| read Gmsh file, possibly with data More...
|
|
static void | read (Dune::GridFactory< Grid > &factory, const std::string &fileName, std::vector< int > &boundarySegmentToPhysicalEntity, std::vector< int > &elementToPhysicalEntity, bool verbose, bool insertBoundarySegments) |
| Read Gmsh file, possibly with data. More...
|
|
template<typename GridType>
class Dune::GmshReader< GridType >
Read Gmsh mesh file.
Read a .msh (version 2) file generated using Gmsh and construct a grid using the grid factory interface.
The file format used by gmsh can hold grids that are more general than the simplex grids that the gmsh grid generator is able to construct. We try to read as many grids as possible, as long as they are valid files. You can test this by checking whether gmsh will load the file and display its content.
All grids in a gmsh file live in three-dimensional Euclidean space. If the world dimension of the grid type that you are reading the file into is less than three, the remaining coordinates are simply ignored.
- Note
- Recent versions of Gmsh introduced a new .msh file format (version 4) with a different syntax. This is currently not supported by GmshReader. One can export to an older .msh version as follows:
- select File→Export (or CTRL+E)
- select file format
.msh
- a dialog asks for options
- select 'Version 2 ASCII' and mark 'Save all elements'
template<typename GridType >
Construct a Gmsh reader object (alternatively use one of the static member functions)
Construct a Gmsh reader object from a file name
- Parameters
-
To pass several options, combine them with the |-operator like this
ReaderOptions
Option for the Gmsh mesh file reader.
Definition: gmshreader.hh:756
Read Gmsh mesh file.
Definition: gmshreader.hh:805
Per default the reader has enabled the following options
Passing any option to the interface will overwrite these defaults.
A Dune grid object can be obtained via the createGrid()
member
template<typename GridType >
static void Dune::GmshReader< GridType >::read |
( |
Dune::GridFactory< Grid > & |
factory, |
|
|
const std::string & |
fileName, |
|
|
DataFlagArg |
boundarySegmentData, |
|
|
DataArg |
elementData, |
|
|
bool |
verbose = true |
|
) |
| |
|
inlinestatic |
read Gmsh file, possibly with data
- Parameters
-
factory | The GridFactory to fill. |
fileName | Name of the file to read from. |
boundarySegmentData | Container to fill with boundary segment physical entity data, or std::ignore , or a bool value. Boundary segments are inserted when a container or true is given, otherwise they are not inserted. |
elementData | Container to fill with element physical entity data, or std::ignore . |
verbose | Whether to be chatty. |
Containers to fill with data must be std::vector<int>
lvalues. Element data is indexed by the insertion index of the element, boundarySegment data is indexed by the insertion index of the boundary intersection. These can be obtained from the factory
, and are lost once the grid gets modified (refined or load-balanced).
- Note
- At the moment the data containers are still filled internally, even if they are ignored. So not having to pass them is more of a convenience feature and less of an optimization. This may however change in the future.