[Dart-dev] DART/branches Revision: 12583

[dart at ucar.edu]

nancy at ucar.edu
2018-05-10 16:30:08 -0600 (Thu, 10 May 2018)
193
update the docs to be more correct (way less wrong?).
these may still need modifications if i don't understand
exactly how the new tool works.

also add the missing .nml file.   thanks kevin.




Modified: DART/branches/recam/assimilation_code/programs/fill_inflation_restart/fill_inflation_restart.html
===================================================================
--- DART/branches/recam/assimilation_code/programs/fill_inflation_restart/fill_inflation_restart.html	2018-05-10 22:24:35 UTC (rev 12582)
+++ DART/branches/recam/assimilation_code/programs/fill_inflation_restart/fill_inflation_restart.html	2018-05-10 22:30:08 UTC (rev 12583)
@@ -36,28 +36,17 @@
 <H2>Overview</H2>
 
 <P>
-This program is now OBSOLETE since DART inflation files are now in
-NetCDF format.  Use one of the standard NCO utilities like "<em class=program>ncap2</em>"
- on a copy of another restart file to set the initial inflation mean, and another
-for the initial inflation standard deviation.  Inflation mean and sd values
-look exactly like restart values, arranged by variable type like T, U, V, etc.
+Utility program to create inflation restart files with constant values.
+Useful for a multi-step assimilation, so the values
+<em class=code>inf_initial_from_restart</em> and
+<em class=code>inf_sd_initial_from_restart</em> items in the &filter_nml
+namelist can be .TRUE. from the beginning.
 </P>
 <P>
-Depending on your version of the NCO utilities, you can 
-use <em class=program>ncap2</em> to set the T,U and V inf values using one of two syntaxes:
+This program uses the information from the model_mod code to determine
+the variables in the state vector.  It must be compiled with the
+right model's model_mod.
 </P>
-<PRE>
-  ncap2 -s 'T=1.0;U=1.0;V=1.0' wrfinput_d01 input_priorinf_mean.nc
-  ncap2 -s 'T=0.6;U=0.6;V=0.6' wrfinput_d01 input_priorinf_sd.nc
-  -or-
-  ncap2 -s 'T(:,:,:)=1.0;U(:,:,:)=1.0;V(:,:,:)=1.0' wrfinput_d01 input_priorinf_mean.nc
-  ncap2 -s 'T(:,:,:)=0.6;U(:,:,:)=0.6;V(:,:,:)=0.6' wrfinput_d01 input_priorinf_sd.nc
-</PRE>
-<P>
-Some versions of the NCO utilities change the full 3D arrays into a 
-single scalar.  If that's your result (check your output with <tt>ncdump -h</tt>)
-use the alternate syntax or a more recent version of the NCO tools.
-</P>
 
 
 <!--==================================================================-->
@@ -68,17 +57,113 @@
 <div class="top">[<a href="#">top</a>]</div><hr />
 <H2>NAMELIST</H2>
 <P>
-none
+This namelist is read from the file <em class=file>input.nml</em>.
+Namelists start with an ampersand
+'&' and terminate with a slash '/'.
+Character strings that contain a '/' must be
+enclosed in quotes to prevent them from
+prematurely terminating the namelist.
 </P>
 
+<div class=namelist>
+<pre>
+&fill_inflation_restart_nml
+ prior_inf_mean = -88888.0
+ prior_inf_sd = -88888.0
+ post_inf_mean = -88888.0
+ post_inf_sd = -88888.0
+ write_prior_inf = .false.
+ write_post_inf = .false.
+ input_state_files = 'null'
+ single_file = .false.
+ verbose = .false.
+</pre>
+</div>
+
+<br />
+<br />
+
+<div>
+<TABLE border=0 cellpadding=10 width=100% summary='namelist description'>
+<THEAD align=left>
+<TR><TH> Item </TH>
+    <TH> Type </TH>
+    <TH> Description </TH> </TR>
+</THEAD>
+
+<TBODY valign=top>
+<TR><TD>prior_inf_mean</TD>
+    <TD>real(r8)</TD>
+    <TD>Prior inflation mean.
+ </TD></TR>
+
+<TR><TD>prior_inf_sd</TD>
+    <TD>real(r8)</TD>
+    <TD>Prior inflation standard deviation.
+ </TD></TR>
+
+<TR><TD>post_inf_mean</TD>
+    <TD>real(r8)</TD>
+    <TD>Posterior inflation mean.
+ </TD></TR>
+
+<TR><TD>post_inf_sd</TD>
+    <TD>real(r8)</TD>
+    <TD>Posterior inflation standard deviation.
+ </TD></TR>
+