Dune::BackupRestoreFacility< YaspGrid< dim, TensorProductCoordinates< ctype, dim > > > Struct Template Reference

facility for writing and reading grids More...

#include <dune/grid/yaspgrid/backuprestore.hh>

Static Public Member Functions
static void	backup (const Grid &grid, const std::string &filename)
	write a hierarchic grid to disk More...
static void	backup (const Grid &grid, std::ostream &stream)
	write a hierarchic grid to disk More...
static Grid *	restore (const std::string &filename, Comm comm=Comm())
	read a hierarchic grid from disk More...
static Grid *	restore (std::istream &stream, Comm comm=Comm())
	read a hierarchic grid from disk More...

Detailed Description

template<int dim, class ctype>
struct Dune::BackupRestoreFacility< YaspGrid< dim, TensorProductCoordinates< ctype, dim > > >

facility for writing and reading grids

The BackupRestoreFacility allows writing hierarchic grids to disk and reading them back into another program.

It is guaranteed that all index sets and id sets are preserved by the backup / restore process. The result of restore is undefined, if the number of processes in a parallel program differs from the number of processes used on backup.

There are two pairs of backup / restore methods:

• methods writing into one or more dedicated files,
• methods operating on a std::stream.

These techniques may not be mixed, i.e., you cannot write the grid into files and read it back from a stream or vice versa. While operating on a std::stream might be convenient, a grid written in another language than C++ might need to emulate this method by writing through a temporary file.

Note

The backup and restore methods might not be implemented for each grid. In this case one can catch the Dune::NotImplemented exception and do something else.

Template Parameters

Grid	type of grid

Member Function Documentation

backup() [1/2]

template<int dim, class ctype >

static void Dune::BackupRestoreFacility< YaspGrid< dim, TensorProductCoordinates< ctype, dim > > >::backup ( const Grid &  grid, const std::string &  filename  )

inlinestatic

write a hierarchic grid to disk

Parameters

[in]	grid	grid to write
[in]	filename	filename of the file to create

Note

This method might create multiple files based on the filename plus internal extension.

References Dune::BackupRestoreFacility< Grid >::backup(), and Dune::YaspGrid< dim, Coordinates >::comm().

backup() [2/2]

template<int dim, class ctype >

static void Dune::BackupRestoreFacility< YaspGrid< dim, TensorProductCoordinates< ctype, dim > > >::backup ( const Grid &  grid, std::ostream &  stream  )

inlinestatic

write a hierarchic grid to disk

Parameters

[in]	grid	grid to write
[in]	filename	filename of the file to create

Note

This method might create multiple files based on the filename plus internal extension.

References Dune::YaspGrid< dim, Coordinates >::begin(), Dune::Torus< Communication, d >::dims(), Dune::YaspGrid< dim, Coordinates >::end(), Dune::YaspGrid< dim, Coordinates >::isPeriodic(), Dune::YaspGrid< dim, Coordinates >::levelSize(), Dune::YaspGrid< dim, Coordinates >::maxLevel(), Dune::YaspGrid< dim, Coordinates >::overlapSize(), and Dune::YaspGrid< dim, Coordinates >::torus().

restore() [1/2]

template<int dim, class ctype >

static Grid * Dune::BackupRestoreFacility< YaspGrid< dim, TensorProductCoordinates< ctype, dim > > >::restore ( const std::string &  filename, Comm  comm = Comm()  )

inlinestatic

read a hierarchic grid from disk

Parameters

[in]

filename

filename of the file to read

Returns

a pointer to the grid (allocated by new)

Note

This method might require multiple files based on the filename plus some extension.

Parameters

comm	Communication object.

References Dune::BackupRestoreFacility< Grid >::restore().

restore() [2/2]

template<int dim, class ctype >

static Grid * Dune::BackupRestoreFacility< YaspGrid< dim, TensorProductCoordinates< ctype, dim > > >::restore ( std::istream &  stream, Comm  comm = Comm()  )

inlinestatic

read a hierarchic grid from disk

Parameters

[in]

filename

filename of the file to read

Returns

a pointer to the grid (allocated by new)

Note

This method might require multiple files based on the filename plus some extension.

Parameters

comm	Communication object.

References DUNE_THROW, Dune::YaspGrid< dim, Coordinates >::globalRefine(), Dune::YaspGrid< dim, Coordinates >::refineOptions(), and Dune::size().

---

The documentation for this struct was generated from the following file:

• dune/grid/yaspgrid/backuprestore.hh