[Dart-dev] DART/branches Revision: 12934

[dart at ucar.edu]

nancy at ucar.edu
2018-11-26 15:04:14 -0700 (Mon, 26 Nov 2018)
43
add the corresponding html and nml pages.




Modified: DART/branches/recam/assimilation_code/programs/closest_member_tool/closest_member_tool.html
===================================================================
--- DART/branches/recam/assimilation_code/programs/closest_member_tool/closest_member_tool.html	2018-11-26 22:01:58 UTC (rev 12933)
+++ DART/branches/recam/assimilation_code/programs/closest_member_tool/closest_member_tool.html	2018-11-26 22:04:14 UTC (rev 12934)
@@ -37,19 +37,18 @@
 
 <P>
 Utility program to compare the ensemble mean to a group of ensemble
-member restart files.  The program prints out a sorted order of which
+member restart files, which can now be run in parallel.  
+The program prints out a sorted order of which
 members are 'closest' to the mean, where the method used to determine 
 'close' is selectable by namelist option.  It also creates a file with
 a single number or character string in it, for ease in scripting, which
 identifies the closest member.
 </P><P>
-The ensemble mean is optionally written out from filter by setting a namelist
-option in the <a href="../filter/filter.html#Namelist">filter namelist</a>
-to output the ensemble mean in restart file format at the end of a run.
+The ensemble mean is computed from the input ensemble.
 The difference is computed point by point across the ensemble members.
 There is an option to restrict the computation to just a subset of the
-entire state vector by listing one or more generic kinds.
-In this case, only state vector items matching one of these kinds
+entire state vector by listing one or more generic quantities.
+In this case, only state vector items matching one of these quantities
 will contribute to the total difference value.
 </P><P>
 Available methods are:
@@ -86,8 +85,8 @@
 members to run a free model forecast forward in time after
 the assimilation is finished.  Each member is an equally likely
 representation of the model state.  Using the ensemble mean
-is not usually a good choice since the mean may not have
-self-consistent structures in the data.
+may not be the best since the mean may not have
+self-consistent fine-scale structures in the data.
 </P><P>
 In addition to printing out data about all members to both
 the console and to the dart log file, this program creates
@@ -102,16 +101,12 @@
 member data and convert it to the model input format for a 
 free forecast, for example.
 </P>
-<P>
-Namelist interface
-<A HREF="#Namelist"><em class=code>&closest_member_tool_nml</em> </A>
-is read from file <em class=file>input.nml</em>.
-</P>
 
 <!--==================================================================-->
 <!--=================== DESCRIPTION OF A NAMELIST ====================-->
 <!--==================================================================-->
 
+<P></P>
 <A NAME="Namelist"></A>
 <div class="top">[<a href="#">top</a>]</div><hr />
 <H2>NAMELIST</H2>
@@ -127,20 +122,17 @@
 <div class=namelist>
 <pre>
 &closest_member_tool_nml
-   input_restart_file_list   = 'null'
-   mean_restart_file_list    = 'null'
-   output_file_name          = 'closest_restart'
-   ens_size                  = 20
-   single_restart_file_in    = .false.
-   difference_method         = 4
-   use_only_kinds            = ''
+   input_restart_files     = ''
+   input_restart_file_list = ''      
+   output_file_name        = 'closest_restart'
+   ens_size                = 1
+   difference_method       = 4      
+   use_only_qtys           = ''
+   single_restart_file_in  = .false.      
   /
 </pre>
 </div>
 
-<br />
-<br />
-
 <div>
 <TABLE border=0 cellpadding=10 width=100% summary='namelist description'>
 <THEAD align=left>
@@ -151,28 +143,19 @@
 
 <TBODY valign=top>
 
-<TR><TD>input_restart_file_list</TD>
-    <TD>character(len=256),dimension(500)</TD>
-<TD>an array of filenames each containing a list DART restart data.
-<!-- @>todo  If 'single_restart_file_in' is
-.true., this is the exact filename.  If 'single_restart_file_in' is .false.
-this is the base name and '.NNNN' will be appended to each name before being opened. -->
+<TR><TD>input_restart_files</TD>
+    <TD>character(len=256),dimension(ens_size x num_domains)</TD>
+<TD>An array of filenames each containing a list DART restart data.
 </TD></TR>