From: schrage Date: Thu, 24 Jun 1999 15:37:34 +0000 (+0000) Subject: Added GridOut. X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=3333efde0c59b351f8574b9fb00b012ae1ba2da1;p=dealii-svn.git Added GridOut. git-svn-id: https://svn.dealii.org/trunk@1459 0785d39b-7218-0410-832d-ea1e28bc413d --- diff --git a/deal.II/doc/tutorial/chapter-1.elements/output.html b/deal.II/doc/tutorial/chapter-1.elements/output.html index cfe1a12aa8..f46f737a51 100644 --- a/deal.II/doc/tutorial/chapter-1.elements/output.html +++ b/deal.II/doc/tutorial/chapter-1.elements/output.html @@ -15,19 +15,24 @@ -

Data Output

+

Grid and Data Output

Graphics Formats

deal.II provides a class called DataOut -dealing with the output of grid and simulation data. It is fairly versatile -and handles a -number of different data formats. There are, however, some limitations -with regard to grouping of components and the degrees of freedom. +dealing with the output of simulation data and a class called +GridOut handling the output of grid (triangulation) data. +Both are +fairly versatile +and can handle a +number of different data formats. +As of this writing (26/6/99) DataOut is being revised. +When this revision is finished the descriptions below will be updated.

+

DataOut graphics formats

-The graphics formats available are: +The graphics formats available in DataOut are:

+

GridOut graphics formats

+

+The graphics formats available in GridOut are: +

+ + +

Limitations of the DataOut class

@@ -79,6 +97,13 @@ to a file if you want to use the data later on. 1. + Use the correct include-file. + + #include <basic/data_out.h> + + + + 2. Create an object of this class with the right dimension. It takes no initialization parameters. @@ -86,7 +111,7 @@ to a file if you want to use the data later on. - 2. + 3. Attach a DoFHandler object to your DataOut @@ -100,7 +125,7 @@ to a file if you want to use the data later on. - 3. + 4. Add data vectors to be written to a file. The second and third argument are the name of the vector and its physical units. @@ -113,7 +138,7 @@ to a file if you want to use the data later on. - 4. + 5. Generate an ostream (and, normally, attach it to a file). @@ -123,7 +148,7 @@ to a file if you want to use the data later on. - 5. + 6. Write your data to this ostream. The second parameter denotes the output format to be used. It must be one of ucd, gnuplot, @@ -136,8 +161,9 @@ to a file if you want to use the data later on. +

DataOut data formats

-

Unstructured Cell Data (ucd)

+

Unstructured Cell Data (ucd)

The ucd data format is described in the AVS developer's guide. There @@ -145,7 +171,7 @@ are a binary and a ASCII version of this format. deal.II uses the ASCII ucd format.

-

Limitations of the ucd format

+

Limitations of the ucd format

Only node based data can be written, higher order elements are written with their node values, not with interior or line values. This is @@ -154,7 +180,7 @@ it is not possible to give model data since this is not widely supported. It is possible to give cell data.

-

Usage of the ucd format

+

Usage of the ucd format

In order to write your data in ucd format you need to follow the @@ -163,9 +189,9 @@ The data is written using void write(ostream &out,"ucd").

-

Gnuplot data format

+

Gnuplot data format

-

Understanding gnuplot data

+

Understanding gnuplot data

The gnuplot data format is a pure ASCII format where each line is @@ -183,7 +209,7 @@ A somewhat more elaborate description can be found in the Gnuplot User's Guide (Postscript)

-

Viewing gnuplot data

+

Viewing gnuplot data

In order to view a one-dimensional plot you use
@@ -208,7 +234,7 @@ to be plotted.

-

Limitations of the gnuplot data format

+

Limitations of the gnuplot data format

The limitations of the gnuplot data format have been well described in the @@ -224,7 +250,7 @@ each cell being straight lines. You won't see the structure of the solution in t

-

The two different qualities of gnuplot output

+

The two different qualities of gnuplot output

The limitations mentioned above can to some extent be remedied, and that is why there is also an option for high quality output. @@ -258,7 +284,7 @@ if there are any. -

Usage of the gnuplot data format

+

Usage of the gnuplot data format

In order to write your data in gnuplot format you need to follow the @@ -276,6 +302,65 @@ The data is written using +

General description of the usage of +GridOut

+ +

+What exactly it is you need to do in order to make use of the +GridOut +class is described in the table below. Note that data is written to an +ostream. That means you have to attach your ostream +to a file if you want to use the data later on. Note also that all the +methods are static. There is no need to create a +GridOut object. +

+ + + + + + + + + + + + + + + + + + + + + + + +
Usage of the GridOut class
Step + Function + Call +
1.Use the correct include-file. + #include <basic/grid_out.h> +
2. + Generate an ostream (and, normally, attach it to a file). + + ostream out; + +
3. + Write your data to this ostream by calling the appropriate + write method giving your triangulation object and + the output file type as parameters. output_format + is one of {gnuplot, eps}. + void GridOut<dim>::write(const Triangulation<dim> & tria,ostream &out, cont OutputFormat output_format)
+
+ +

GridOut data formats

+ +

Gnuplot data format

+ +

Encapsulated Postscript

+