From: schrage For each and every output format there is a class containing the
+parameters that determine how the output will look. All these classes
+have a sensible set of default parameters; you will only have
+to bother about setting parameters yourself if your desires are
+rather special. We shall commence with a brief description of
+these classes and the most important parameters you can set.
+
+This class provides the settings for ucd output. The values in brackets
+denote the default values.
+
+This class provides the settings for gnuplot output. At present it
+is empty.
+
+This class provides the settings for EPS output. The values in brackets
+denote the default values.
+
+This class provides the settings for PoVRay output. At present it
+is empty.
+
+This class provides the settings for General Mesh Viewer output. At present it
+is empty.
+
In order to write your data in ucd format you need to follow the
-steps described above.
+steps described in the section on the usage of
+
In order to write your data in gnuplot format you need to follow the
-steps described above.
+steps described in the section on the usage of
+ EPS output of deal.II data consists of the grid
+and the cells. The cells can be left empty, printed white (which leads
+to hidden-line removal) or colorized using a data vector. This format
+does not support gradient shading, i.e. each cell has one color which
+is taken from the value of the data in its centre. Coordinates
+have at most five digits, and the EPS files do not have an explicit
+bounding box, i.e. the bonding box is close to the graphics on
+all four sides. EPS output can only be used for two-dimensional
+data.
+ EPS otput is performed by calling
+PoVRay is a most comprehensive raytracer freely available at
+http://www.povray.org.
+This is also the place to start looking for more information
+on its features.
+ PoVRay output is accomplished by calling
+The General Mesh Viewer can display data in both 2D, 3D and cuts through
+data sets. More information on the gmv is available at
+
+http://www-xdiv.lanl.gov/XCM/gmv/GMVHome.html
+At present the gmv cannot output postscript or EPS data.
+
+gmv output is accomplished by calling
Graphics Formats
@@ -106,6 +107,114 @@ The graphics formats available in GridOut
are:
+
+
+
+Parameters for grid and data output
+
+UcdFlags
+
+
+
+
+bool write_preamble
(true):
+ Determines whether to write a preamble containing creation
+ date etc.
+ GnuplotFlags
+
+EpsFlags
+
+
+
+
+unsigned int height_vector
(0):
+ Number of the data vector to be used for generation of the height
+ information. The number is determined by the order in which
+ DataOut<dim>::add_data_vector
was called
+ for the different vectors.
+ unsigned int color_vector
(0):
+ Number of the data vector to be used for colorizing cells.
+ The number is determined by the order in which
+ DataOut<dim>::add_data_vector
was called
+ for the different vectors.
+ SizeType sizetype
(width):
+ Determines whether the width or the height is used to scale
+ the output. Can be set to width or height.
+ unsigned int size
(300):
+ Size of the output in points. One point is 1/72 inch.
+ double line_width
(0.5):
+ Width of a line in points. One point is 1/72 inch.
+ double azimut_angle
(60):
+ Viewing angle with respect to the positive z-axis.
+ double turn_angle
(30):
+ We quote the class documentation:
+ Angle by which the viewers position projected onto the
+ x-y-plane is rotated around the z-axis, in positive sense when
+ viewed from above. The unit are degrees, and zero
+ equals a position above or below the negative y-axis.
+
+ double z_scaling
(1):
+ Factor by which the z-axis is stretched compared to the
+ x- and y-axis.
+ bool draw_mesh
(true):
+ Determines whether the cell boundaries are drawn.
+ bool draw_cells
(true): Determines whether the
+ cells are drawn. If this flag is true and
+ shade_cells
is false the cells are filled with white.
+ bool shade_cells
(true):
+ Determines whether to colour cells.
+ ColorFunction color_function
(&default_color_function):
+ Determines the function to use for colouring the cells. The default
+ shifts the colours from black for the lowest values through the
+ spectrum towards white.
+ PovrayFlags
+GmvFlags
+
@@ -200,9 +309,9 @@ to a file if you want to use the data later on.
6.
Write your data to this ofstream. The second parameter denotes the
- output format to be used. It must be one of
ucd, gnuplot,
+ output format to be used. It must be one of
.
{ ucd, gnuplot,
gnuplot_draft,
- povray_mesh, eps, epsgrid, gmv
.
+ povray_mesh, eps, gmv }
@@ -235,7 +344,8 @@ It is possible to give cell data.
void DataOut<dim>::write(ostream &out, const OutputFormat output_format)
DataOut
.
The data is written using void write(ostream &out,"ucd")
.
DataOut
.
The data is written using
@@ -353,6 +464,56 @@ The data is written using
+Encapsulated Postscript (EPS)
+
+
+void DataOut<dim>::write_eps(ostream &out)
+PoVRay output
+
+
+DataOut<dim>::write_povray(ostream &out)
+At present there is no more information available on PoVRay output
+in deal.II.
+General Mesh Viewer (gmv) output
+
+
+void DataOut<dim>::write_gmv(ostream &out)
+There is no more information available on the output format.
+
@@ -381,7 +542,7 @@ to which parameters can be passed.
Step | @@ -421,7 +582,7 @@ to which parameters can be passed.
Step | @@ -480,10 +641,12 @@ to which parameters can be passed.
GridOut
data formatsThe ucd data format is described in the AVS developer's guide. There @@ -510,6 +673,33 @@ simpler method for writing ucd-files.
+Gnuplot output is performed by calling
+void write_gnuplot (const Triangulation<dim> &tria,
+ostream &out)
+It is controlled by the class GnuplotFlags
.
+
+In Gnuplot format the boundaries of each cell +are written as a sequence of lines to your output stream. +Output can be modified by the following flags: +
+GnuplotFlags::write_cell_numbers
:
+ If this is set the (internal) number of each cell is written to the
+ output file before the cell data.
+ GnuplotFlags::write_level
: If this flag
+ is set the refinement level of each cell is written as an
+ additional column. This can be used to raise the cells according
+ to their refinement level if a 2D-grid is plotted as 3D, or,
+ alternatively, to plot only the cells within a given range of
+ levels of refinement usingsplot [:][:][level1:level2] "filename"
+ +Contrary to, e.g., EPS, you do not need to set a viewpoint.