[Dart-dev] DART/branches Revision: 12233

[dart at ucar.edu]

thoar at ucar.edu
2017-12-21 11:13:10 -0700 (Thu, 21 Dec 2017)
103
incremental step forward on documenting what happens with different inflation
options.  Not done yet.




Modified: DART/branches/enhanced_inflation/assimilation_code/modules/assimilation/filter_mod.html
===================================================================
--- DART/branches/enhanced_inflation/assimilation_code/modules/assimilation/filter_mod.html	2017-12-20 23:57:17 UTC (rev 12232)
+++ DART/branches/enhanced_inflation/assimilation_code/modules/assimilation/filter_mod.html	2017-12-21 18:13:10 UTC (rev 12233)
@@ -383,11 +383,11 @@
     <TD>Assimilation window seconds; defaults to model timestep size.
  </TD></TR>
 
-<TR><TD colspan=3>All variables named inf_* are arrays of length 2.<br />
+<TR><TD colspan=3>All variables named inf_* are arrays of length 2.
                   The first element controls the prior inflation, the second element 
                   controls the posterior inflation.
                   See <A href="../../programs/filter/filter.html#Inflation">filter.html</A>
-                  for a discussion of inflation and effective strategies for using it.
+                  for a discussion of inflation and effective strategies.
  </TD></TR>
 
 <TR><TD>inf_flavor</TD>
@@ -395,10 +395,10 @@
     <TD>Inflation flavor for [prior, posterior]
         <UL>
          <LI>0 = none</LI>
-         <LI>2 = spatially-varying state space</LI>
-         <LI>3 = spatially-fixed state space </LI>
+         <LI>2 = spatially-varying state-space (gaussian)</LI>
+         <LI>3 = spatially-fixed state-space  (gaussian)</LI>
          <LI>4 = Relaxation To Prior Spread (Posterior inflation only) </LI>
-         <LI>5 = enhanced state space </LI>
+         <LI>5 = enhanced spatially-varying state-space (inverse gamma)</LI>
         </UL>
         (See inf_sd_initial below for how to set the time evolution options.)
  </TD></TR>
@@ -428,26 +428,15 @@
     <TD>Initial value of inflation if not read from restart file. 
  </TD></TR>
 
-<TR><TD>inf_sd_initial</TD>
+
+<TR><TD>inf_lower_bound</TD>
     <TD>real(r8) dimension(2)</TD>
-    <TD>Initial value of inflation standard deviation if not read 
-        from restart file.  If ≤ 0, do not update the inflation
-        values, so they are time-constant.  If positive, the inflation
-        values will adapt through time, so they are time-varying.
+    <TD>Lower bound for inflation value.
  </TD></TR>
 
-<TR><TD>inf_sd_max_change</TD>
+<TR><TD>inf_upper_bound</TD>
     <TD>real(r8) dimension(2)</TD>
-    <TD>For inflation type 5 (enhanced inflation), controls the maximum
-        change of the inflation standard deviation when adapting for the
-        next assimilation cycle.  The value should be between 1.0 and 2.0.
-        1.0 prevents any changes, while 2.0 allows 100% change.
-        For the enhanced inflation option, if the standard deviation 
-        initial value is equal to the standard deviation
-        lower bound the standard deviation will not adapt in time.
-        See <A href="../../programs/filter/filter.html#Inflation">this section</A>
-        for a discussion of how the standard deviation
-        adapts based on different types of inflation.
+    <TD>Upper bound for inflation value.
  </TD></TR>
 
 <TR><TD>inf_damping</TD>
@@ -461,25 +450,35 @@
 unchanged.
  </TD></TR>
 
-<TR><TD>inf_lower_bound</TD>
+<TR><TD>inf_sd_initial</TD>
     <TD>real(r8) dimension(2)</TD>
-    <TD>Lower bound for inflation value.
+    <TD>Initial value of inflation standard deviation if not read 
+        from restart file.  If ≤ 0, do not update the inflation
+        values, so they are time-constant.  If positive, the inflation
+        values will adapt through time, so they are time-varying.
  </TD></TR>
 
-<TR><TD>inf_upper_bound</TD>
-    <TD>real(r8) dimension(2)</TD>
-    <TD>Upper bound for inflation value.
- </TD></TR>
-
 <TR><TD>inf_sd_lower_bound</TD>
     <TD>real(r8) dimension(2)</TD>
     <TD>Lower bound for inflation standard deviation. 
         If using a negative value for <em class=code>sd_initial</em> 
         this should also be negative to preserve the setting.
-        The inflation standard deviation is a non-increasing quantity,
-        so the sd value will eventually reach and keep this lower bound.
  </TD></TR>
  
+<TR><TD>inf_sd_max_change</TD>
+    <TD>real(r8) dimension(2)</TD>
+    <TD>For inflation type 5 (enhanced inflation), controls the maximum
+        change of the inflation standard deviation when adapting for the
+        next assimilation cycle.  The value should be between 1.0 and 2.0.
+        1.0 prevents any changes, while 2.0 allows 100% change.
+        For the enhanced inflation option, if the standard deviation 
+        initial value is equal to the standard deviation
+        lower bound the standard deviation will not adapt in time.