Add mechanism to select output by coordinate time.

git-svn-id: http://svn.cactuscode.org/arrangements/CactusBase/IOUtil/trunk@199 b32723a9-ab3a-4a60-88e2-2e5d99d7c17a

2 files changed, 30 insertions, 5 deletions

diff --git a/doc/documentation.tex b/doc/documentation.tex
index 262387d..72a50c1 100644
--- a/doc/documentation.tex
+++ b/doc/documentation.tex
@@ -158,10 +158,21 @@ control output.
     defaults to the current working directory). Individual methods have
     parameters which can direct their output to a different directory.
 
+  \item{\tt IO::out\_criterion}\\
+    The criterion that decides when to output.  The default is to
+    output every so many iterations (see {\tt IO::out\_every}).
+
   \item{\tt IO::out\_every}\\
-    How often, in terms of iterations, each of the Cactus I/O methods will write
-    output. Again, individual methods can set there own parameter to override
+    How often, in terms of iterations, each of the Cactus I/O methods
+    will write
+    output. Again, individual methods can set their own parameters to override
     this. The default is to never write output.
+
+  \item{\tt IO::out\_dt}\\
+    How often, in terms of simulation time, each of the Cactus I/O
+    methods will write output.  Again, individual methods can set
+    their own parameters to override this.  The default is to never
+    write output.
 \end{itemize}
 
 
@@ -321,11 +332,13 @@ computational grid}
 
 The standard I/O thorns in Cactus make use of a consistent set of filenames
 and extensions, which identify the variables and data format used in the file.
-The filenames are listed in Table~\ref{filename_table}.
+The filenames are listed in the following table.
+%The filenames are listed in Table~\ref{filename_table},
 %and the extensions in Table~\ref{filename_extensions_table}
 
 \begin{table}[htb]
 \begin{center}
+\label{filename_table}
 \begin{tabular}{|l|l|}
   \hline
   {\bf I/O method}   & {\bf Filename for output of variable {\tt var}}\\
@@ -343,7 +356,6 @@ The filenames are listed in Table~\ref{filename_table}.
   \hline
 \end{tabular}
 \caption{Filenames used by standard I/O thorns}
-\label{filename_table}
 \end{center}
 \end{table}
 
diff --git a/param.ccl b/param.ccl
index f086862..a34d94d 100644
--- a/param.ccl
+++ b/param.ccl
@@ -12,17 +12,30 @@ restricted:
 ####################
 STRING out_dir "Default output directory" STEERABLE = RECOVER
 {
-  .+ :: "A valid directory name"
+  ".+" :: "A valid directory name"
 } "."
 
 ########################
 # How often to do output
 ########################
+KEYWORD out_criterion "Criterion to select output intervals"
+{
+  "never"     :: "Never output"
+  "iteration" :: "Output every so many iterations"
+  "time"      :: "Output every that much coordinate time"
+} "iteration"
 INT out_every "How often to do output by default" STEERABLE = ALWAYS
 {
    1:* :: "Every so many iterations"
   -1:0 :: "Disable output"
 } -1
+REAL out_dt "How often to do output by default" STEERABLE = ALWAYS
+{
+  (0:* :: "In intervals of that much coordinate time"
+   0   :: "As often as possible"
+  -1   :: "Disable output"
+  -2   :: "Disable output"
+} -2
 
 ################
 # various things