Reference documentation for deal.II version 8.4.1
Namespaces | Classes | Enumerations
Graphical output
Collaboration diagram for Graphical output:




struct  DataOutBase::Patch< dim, spacedim >
struct  DataOutBase::OutputFlagsBase< FlagsType >
struct  DataOutBase::DXFlags
struct  DataOutBase::UcdFlags
struct  DataOutBase::GnuplotFlags
struct  DataOutBase::PovrayFlags
struct  DataOutBase::EpsFlags::RgbValues
struct  DataOutBase::EpsFlags
struct  DataOutBase::GmvFlags
struct  DataOutBase::TecplotFlags
struct  DataOutBase::VtkFlags
struct  DataOutBase::SvgFlags
struct  DataOutBase::Deal_II_IntermediateFlags
struct  DataOutBase::DataOutFilterFlags
struct  DataOutBase::DataOutFilter::Point3Comp
class  DataOutBase::DataOutFilter
class  DataOutInterface< dim, spacedim >
class  DataOutReader< dim, spacedim >
struct  GridOutFlags::DX
struct  GridOutFlags::Msh
struct  GridOutFlags::Ucd
struct  GridOutFlags::Gnuplot
struct  GridOutFlags::EpsFlagsBase
struct  GridOutFlags::Eps< dim >
struct  GridOutFlags::Eps< 1 >
struct  GridOutFlags::Eps< 2 >
struct  GridOutFlags::Eps< 3 >
struct  GridOutFlags::XFig
struct  GridOutFlags::Svg
struct  GridOutFlags::MathGL
struct  GridOutFlags::Vtk
struct  GridOutFlags::Vtu
class  GridOut
class  MatrixOut
struct  MatrixOut::Options
class  DataOut< dim, DoFHandlerType >
class  DataOut_DoFData< DoFHandlerType, patch_dim, patch_space_dim >
class  DataOutFaces< dim, DoFHandlerType >
class  DataOutRotation< dim, DoFHandlerType >
class  DataOutStack< dim, spacedim, DoFHandlerType >
struct  DataOutStack< dim, spacedim, DoFHandlerType >::DataVector
class  DataPostprocessor< dim >
class  DataPostprocessorScalar< dim >
class  DataPostprocessorVector< dim >
class  DoFPrintSolverStep< dim, SolverType, VectorType >


enum  DataOutBase::EpsFlags::SizeType { DataOutBase::EpsFlags::width, DataOutBase::EpsFlags::height }
enum  DataOutBase::VtkFlags::ZlibCompressionLevel
enum  DataOutBase::OutputFormat {
  DataOutBase::default_format, DataOutBase::none, DataOutBase::dx, DataOutBase::ucd,
  DataOutBase::gnuplot, DataOutBase::povray, DataOutBase::eps, DataOutBase::gmv,
  DataOutBase::tecplot, DataOutBase::tecplot_binary, DataOutBase::vtk, DataOutBase::vtu,
  DataOutBase::svg, DataOutBase::deal_II_intermediate, DataOutBase::hdf5
enum  GridOutFlags::EpsFlagsBase::SizeType
enum  GridOutFlags::XFig::Coloring { GridOutFlags::XFig::material_id, GridOutFlags::XFig::level_number, GridOutFlags::XFig::subdomain_id, GridOutFlags::XFig::level_subdomain_id }
enum  GridOutFlags::Svg::Background { GridOutFlags::Svg::transparent, GridOutFlags::Svg::white, GridOutFlags::Svg::dealii }
enum  GridOutFlags::Svg::Coloring {
  GridOutFlags::Svg::none, GridOutFlags::Svg::material_id, GridOutFlags::Svg::level_number, GridOutFlags::Svg::subdomain_id,
enum  GridOut::OutputFormat {
  GridOut::none, GridOut::dx, GridOut::gnuplot, GridOut::eps,
  GridOut::ucd, GridOut::xfig, GridOut::msh, GridOut::svg,
  GridOut::mathgl, GridOut::vtk, GridOut::vtu
enum  DataOut< dim, DoFHandlerType >::CurvedCellRegion
enum  DataOut_DoFData< DoFHandlerType, patch_dim, patch_space_dim >::DataVectorType { DataOut_DoFData< DoFHandlerType, patch_dim, patch_space_dim >::type_dof_data, DataOut_DoFData< DoFHandlerType, patch_dim, patch_space_dim >::type_cell_data, DataOut_DoFData< DoFHandlerType, patch_dim, patch_space_dim >::type_automatic }
enum  DataOutStack< dim, spacedim, DoFHandlerType >::VectorType

Detailed Description

deal.II generates three types of output: it can write triangulations/meshes in formats understood by several mesh readers (including those of deal.II itself), and it can create output used for visualization of data. Finally, it can output matrices in a graphical format.

Visualization of data

deal.II supports, through the DataOutBase class, a large number of popular visualization formats, such as those used by the OpenDX, gmv, or gnuplot programs. A complete list of supported formats is listed in the documentation of the DataOutBase class.

The DataOutBase class is only responsible for actually writing some intermediate format in a number of different visualization formats. This intermediate format is generated by classes derived, directly or indirectly, from DataOutBase. For example, the DataOut class is most often used to generate this intermediate format from a triangulation, a DoFHandler object (that associates a particular finite element class with the triangulation), and one or more data vectors. The DataOut class creates intermediate data from each cell, which is subsequently written by the DataOutBase class in some final format. Almost all example programs, starting with step-3, make use of this method of generating output.

The DataOutFaces class is another way to create intermediate format from simulation data. However, instead of creating visualization data from each cell of the triangulation, it only creates information for all faces of cells that are located on the surface (though the class has a way to override the choice for which faces output should be generated). While this may not be particularly interesting in 2d (the faces would only be line segments) it is often helpful in 3d if what one really wants to know is the shape of the domain or the value of one variable on the surface. Using the DataOutFaces class then saves the effort of generating and storing data for all interior cells, which can be very expensive for large 3d simulations.

A third class, the DataOutRotation class, allows to take a two-dimensional simulation and generate three-dimensional data from it by rotating the two-dimensional domain around a given axis. This is mostly useful for the visualization of simulations that use the rotational symmetry of, for example, a cylinder.

Finally, the DataOutStack class allows to visualize data from time dependent simulations in the space-time domain: it collects the results from each time step and at the end outputs all of this information at once as a space-time file.

Grid output

Meshes, without any data vectors associated with it, can be written in a number of formats as well. This is done through the GridOut class, and the documentation of that class lists the supported formats.

Several of the tutorial programs, notably step-1, step-6, step-9, step-10, step-12, and step-14 demonstrate the use of the GridOut class.

Matrix output

Through the MatrixOut class, deal.II can also give a graphical visualization of matrices, in the form of color or skyline plots. The MatrixOut class uses the DataOutBase for output. Therefore, matrices can be visualized in all formats supported by the latter class.

Enumeration Type Documentation

Enum denoting the possibilities whether the scaling should be done such that the given size equals the width or the height of the resulting picture.


Scale to given width.


Scale to given height.

Definition at line 602 of file data_out_base.h.

A data type providing the different possible zlib compression levels.

Definition at line 904 of file data_out_base.h.

Provide a data type specifying the presently supported output formats.


Use the format already stored in the object.


Do not write any output.


Output for OpenDX.


Output in the UCD format for AVS.


Output for the Gnuplot tool.


Output for the Povray raytracer.


Output in encapsulated PostScript.


Output for GMV.


Output for Tecplot in text format.


Output for Tecplot in binary format. Faster and smaller than text format.


Output in VTK format.


Output in VTK format.


Output in SVG format.


Output in deal.II intermediate format.


Output in HDF5 format.

Definition at line 1223 of file data_out_base.h.

Enum denoting the possibilities whether the scaling should be done such that the given size equals the width or the height of the resulting picture.

Definition at line 288 of file grid_out.h.

An enum used for deciding which field is used for coloring the cells.


Convert the material id into the cell color.


Convert the level into the cell color.


Convert the global subdomain id into the cell color.


Convert the level subdomain id into the cell color.

Definition at line 519 of file grid_out.h.

Background style.


Use transparent value of SVG.


Use white background.


Use a gradient from white (top) to steelblue (bottom), and add date and time plus a deal.II logo. Automatically draws a margin.

Definition at line 623 of file grid_out.h.

Cell coloring.


No cell coloring.


Convert the material id into the cell color (default)


Convert the level number into the cell color.


Convert the subdomain id into the cell color.


Convert the level subdomain id into the cell color.

Definition at line 648 of file grid_out.h.

Declaration of a name for each of the different output formats. These are used by the generic output function write() to determine the actual output format.


Do nothing in write()


write() calls write_dx()


write() calls write_gnuplot()


write() calls write_eps()


write() calls write_ucd()


write() calls write_xfig()


write() calls write_msh()


write() calls write_svg()


write() calls write_mathgl()


write() calls write_vtk()


write() calls write_vtu()

Definition at line 840 of file grid_out.h.

template<int dim, typename DoFHandlerType = DoFHandler<dim>>
enum DataOut::CurvedCellRegion

Enumeration describing the region of the domain in which curved cells shall be created.

Definition at line 174 of file data_out.h.

template<typename DoFHandlerType, int patch_dim, int patch_space_dim = patch_dim>
enum DataOut_DoFData::DataVectorType

Type describing what the vector given to add_data_vector() is: a vector that has one entry per degree of freedom in a DoFHandler object (such as solution vectors), or one entry per cell in the triangulation underlying the DoFHandler object (such as error per cell data). The value type_automatic tells add_data_vector() to find out itself (see the documentation of add_data_vector() for the method used).


Data vector entries are associated to degrees of freedom


Data vector entries are one per grid cell


Find out automatically

Definition at line 532 of file data_out_dof_data.h.

template<int dim, int spacedim = dim, typename DoFHandlerType = DoFHandler<dim,spacedim>>
enum DataOutStack::VectorType

Data type declaring the two types of vectors which are used in this class.

Definition at line 116 of file data_out_stack.h.