--- manual/s_outp_pkgs/text/mnc.tex	2005/08/06 16:28:14	1.3
+++ manual/s_outp_pkgs/text/mnc.tex	2006/04/04 20:51:10	1.6
@@ -1,7 +1,7 @@
-% $Header: /home/ubuntu/mnt/e9_copy/manual/s_outp_pkgs/text/mnc.tex,v 1.3 2005/08/06 16:28:14 edhill Exp $
+% $Header: /home/ubuntu/mnt/e9_copy/manual/s_outp_pkgs/text/mnc.tex,v 1.6 2006/04/04 20:51:10 molod Exp $
 % $Name:  $
 
-\section{NetCDF I/O Integration: MNC}
+\section{NetCDF I/O: MNC}
 \label{sec:pkg:mnc}
 \begin{rawhtml}
 <!-- CMIREDIR:package_mnc: -->
@@ -127,26 +127,28 @@
       output directory name \\
       \ \ \texttt{mnc\_outdir\_date}  &  L  & \texttt{.FALSE.}  &  
       embed date in the outdir name  \\
-      \ \ \texttt{mnc\_outdir\_num}  &  L  & \texttt{.FALSE.}  &  
+      \ \ \texttt{mnc\_outdir\_num}  &  L  & \texttt{.TRUE.}  &  
       optional  \\
-      \texttt{pickup\_write\_mnc}  &  L  & \texttt{.FALSE.}  &  
+      \texttt{pickup\_write\_mnc}  &  L  & \texttt{.TRUE.}  &  
       use MNC to write pickup files  \\
-      \texttt{pickup\_read\_mnc}  &  L  & \texttt{.FALSE.}  &  
+      \texttt{pickup\_read\_mnc}  &  L  & \texttt{.TRUE.}  &  
       use MNC to read pickup files  \\
       \texttt{mnc\_use\_indir}  &  L  & \texttt{.FALSE.}  &  
       use a directory (path) for input  \\
       \ \ \texttt{mnc\_indir\_str}  &  S  & \texttt{''}  &  
       input directory (or path) name  \\
-      \texttt{snapshot\_mnc}  &  L  & \texttt{.FALSE.}  &  
+      \texttt{snapshot\_mnc}  &  L  & \texttt{.TRUE.}  &  
       write \texttt{snapshot} output w/MNC  \\
-      \texttt{monitor\_mnc}  &  L  & \texttt{.FALSE.}  &  
+      \texttt{monitor\_mnc}  &  L  & \texttt{.TRUE.}  &  
       write \texttt{monitor} output w/MNC  \\
-      \texttt{timeave\_mnc}  &  L  & \texttt{.FALSE.}  &  
+      \texttt{timeave\_mnc}  &  L  & \texttt{.TRUE.}  &  
       write \texttt{timeave} output w/MNC  \\
-      \texttt{autodiff\_mnc}  &  L  & \texttt{.FALSE.}  &  
+      \texttt{autodiff\_mnc}  &  L  & \texttt{.TRUE.}  &  
       write \texttt{autodiff} output w/MNC  \\
       \texttt{mnc\_max\_fsize}  &  R  & 2.1e+09  &  
-      max allowable file size  \\
+      max allowable file size (<2GB)  \\
+      \texttt{mnc\_filefreq}  &  R  &  -1  &  
+      frequency of new file creation (seconds)  \\
       \texttt{readgrid\_mnc}  &  L  &  \texttt{.FALSE.}  &  
       read grid quantities using MNC  \\
       \texttt{mnc\_echo\_gvtypes}  &  L  & \texttt{.FALSE.}  &  
@@ -202,6 +204,13 @@
 \end{verbatim}
 \begin{rawhtml} </A> \end{rawhtml}
 
+Another way users can force the splitting of MNC files along the time
+dimension is the \texttt{mnc\_filefreq} option.  With it, files that
+contain variables with a temporal dimension can be split at regular
+intervals based solely upon the model time (specified in seconds).
+For some problems, this can be much more convenient than splitting
+based upon file size.
+
 Additional MNC--related parameters may be contained within each
 package.  Please see the individual packages for descriptions of their
 use of MNC.
@@ -215,21 +224,32 @@
 convention (v1.0) and any conformance issues will be fixed over time.
 The patterns used for file names are:
 \begin{center}
-\texttt{BASENAME.nIter0.tileNum.seqNum.nc}
+  {\footnotesize
+    \begin{tabular}[htb]{l}
+      \texttt{BASENAME.tileNum.nc}  \\
+      \texttt{BASENAME.nIter.faceNum.nc}  \\
+      \texttt{BASENAME.nIter.tileNum.nc}
+    \end{tabular}
+  }
 \end{center}
-and an example is:
+and examples are:
 \begin{center}
-\texttt{grid.0000000000.000001.0000.nc}
+  {\footnotesize
+    \begin{tabular}[htb]{l}
+      \texttt{grid.t001.nc}, \texttt{grid.t002.nc}  \\
+      \texttt{state.0000000000.t001.nc},
+      \texttt{surfDiag.0000036000.t001.nc}  \\
+      \texttt{input.0000072000.f001.nc}
+    \end{tabular}
+  }
 \end{center}
 where \texttt{BASENAME} is the name selected to represent a set of
-variables written together, \texttt{nIter0} is the starting iteration
+variables written together, \texttt{nIter} is the current iteration
 number as specified in the main \texttt{data} namelist input file and
-written in a zero-filled 10-digit format, \texttt{tileNum} is the
-six-digit zero-filled tile number, \texttt{seqnum} is a four-digit
-zero-filled sequence number used when maximum allowable files sizes
-are too small to contain all of the output for a particular type
-within one run (new files are created with sequential numbers as files
-reach the maximum file size limit), and \texttt{.nc} is the file
+written in a zero-filled 10-digit format, \texttt{tileNum} is a
+three-or-more-digit zero-filled and ``\texttt{t}''--prefixed tile
+number, \texttt{faceNum} is a three-or-more-digit zero-filled and
+``\texttt{f}''--prefixed face number, and \texttt{.nc} is the file
 suffix specified by the current netCDF ``CF'' conventions.
 
 Some example \texttt{BASENAME} values are:
