[cig-commits] commit 1951 by bangerth to /var/svn/dealii/aspect

[dealii.demon at gmail.com]

Revision 1951

Document last changes to visualization output.

U   trunk/aspect/doc/manual/manual.tex


http://www.dealii.org/websvn/revision.php?repname=Aspect+Repository&path=%2F&rev=1951&peg=1951

Diff:
Modified: trunk/aspect/doc/manual/manual.tex
===================================================================
--- trunk/aspect/doc/manual/manual.tex	2013-10-10 00:07:04 UTC (rev 1950)
+++ trunk/aspect/doc/manual/manual.tex	2013-10-10 00:32:15 UTC (rev 1951)
@@ -1397,6 +1397,7 @@
 -rw------- 1 b     35 Dec  1 15:13 solution-00001.visit
 ...
 -rw-r--r-- 1 b    997 Dec  1 15:13 solution.pvd
+-rw-r--r-- 1 b    997 Dec  1 15:13 solution.visit
 -rw------- 1 b    924 Dec  1 15:13 statistics
 \end{lstlisting}
 The purpose of these files is as follows:
@@ -1445,22 +1446,28 @@
   simply creates both kinds of files in each time step in which graphical data
   is produced.
 
-  The final file of this kind, 	exttt{solution.pvd} is a file that
-  describes to Paraview which 	exttt{solution-xxxx.pvtu} jointly form
-  a complete simulation by listing the 	exttt{.pvtu} files of all
-  timesteps together with the simulation time to which they correspond.
+  The final two files of this kind, 	exttt{solution.pvd} and
+  	exttt{solution.visit}, are files that
+  describes to Paraview and Visit, respectively, which
+  	exttt{solution-xxxx.pvtu} and 	exttt{solution-xxxx.yyyy.vtu} jointly form 
+  a complete simulation. In the former case, the file lists the 	exttt{.pvtu}
+  files of all 
+  timesteps together with the simulation time to which they correspond. In the
+  latter case, it actually lists all 	exttt{.vtu} that belong to one
+  simulation, grouped by the timestep they correspond to.
   To visualize an entire simulation, not just a single time step, it is
-  therefore simplest to just load this 	exttt{solution.pvd} file.
+  therefore simplest to just load one of these files, depending on whether you
+  use Paraview or Visit.%
+  ootnote{At the time of writing this, current versions of Visit (starting
+    with version 2.5.1) actually have a bug that prevents them from
+    successfully reading the 	exttt{solution.visit} or
+    	exttt{solution-xxxx.visit} files -- Visit believes that each of these
+    files corresponds to an individual time step, rather than that a whole
+    group of files together form one time step. This bug is not fixed in Visit
+    2.6.3, but may be fixed in later versions.}
 
-  The final file of this kind, 	exttt{solution.pvd} is a file that
-  describes to Paraview which 	exttt{solution-xxxx.pvtu} jointly form
-  a complete simulation by listing the 	exttt{.pvtu} files of all
-  timesteps together with the simulation time to which they correspond.
-  To visualize an entire simulation, not just a single time step, it is
-  therefore simplest to just load this 	exttt{solution.pvd} file.
+  For more on visualization, see also Section~
ef{sec:viz}.
 
-  For more on visualization, see Section~
ef{sec:viz}.
-
 \item 	extit{A statistics file:} The 	exttt{output/statistics} file contains
   statistics collected during each time step, both from within the simulator
   (e.g., the current time for a time step, the time step length, etc.) as well