[Dart-dev] DART/branches Revision: 10902

[dart at ucar.edu]

thoar at ucar.edu
2017-01-13 16:09:05 -0700 (Fri, 13 Jan 2017)
294
reintegrating the rma_fixed_filenames branch.
old DART-format files are NO LONGER SUPPORTED.
Please reference README_rma_updates.txt for more details.

Many features are not working ... single_file I/O
closest_member_tool, advancing models within filter ...
The namelists have changed _a_lot_




Index: DART/branches/rma_trunk
===================================================================
--- DART/branches/rma_trunk	2017-01-13 23:01:55 UTC (rev 10901)
+++ DART/branches/rma_trunk	2017-01-13 23:09:05 UTC (rev 10902)

Property changes on: DART/branches/rma_trunk
___________________________________________________________________
Modified: svn:mergeinfo
## -10,6 +10,7 ##
 /DART/branches/rma_cice:10655-10858
 /DART/branches/rma_clm:8911-9132
 /DART/branches/rma_diag:9629-9743
+/DART/branches/rma_fixed_filenames:10708-10901
 /DART/branches/rma_kinds_to_state_structure:8958-9437
 /DART/branches/rma_kinds_to_state_strucutre:8909-8957
 /DART/branches/rma_model_mod_check:8965-9178
Copied: DART/branches/rma_trunk/README_rma_updates.txt (from rev 10901, DART/branches/rma_fixed_filenames/README_rma_updates.txt)
===================================================================
--- DART/branches/rma_trunk/README_rma_updates.txt	                        (rev 0)
+++ DART/branches/rma_trunk/README_rma_updates.txt	2017-01-13 23:09:05 UTC (rev 10902)
@@ -0,0 +1,146 @@
+# DART software - Copyright 2004 - 2013 UCAR. This open source software is
+# provided by UCAR, "as is", without charge, subject to all terms of use at
+# http://www.image.ucar.edu/DAReS/DART/DART_download
+#
+# DART $Id$
+
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++ Jan 13th 2017 :: rma_fixed_filenames merge changes                         +
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+Specific namelist changes include:
+
+1. ) Earlier versions of the RMA branch code supported both direct NetCDF 
+     reads/writes and the original binary/ascii DART format restart files.  
+     As of the next update DART format files are no longer supported.  All 
+     I/O is NetCDF only.  If your model does not use NetCDF you will still 
+     need a model_to_dart and dart_to_model converter; otherwise all DART 
+     programs read the model's NetCDF files directly.  The namelist options 
+     related to selecting direct netcdf I/O have been removed.
+
+2. ) Diagnostic and state space data (such as inflation, mean and sd 
+     information) that were previously stored in {Prior,Posterior}_Diag.nc 
+     are now broken up into multiple files and have fixed filenames. This 
+     decreases the IO time for diagnostic output and reduces the number of 
+     namelist options.
+
+3. ) There is no longer support for observation space inflation 
+     (i.e. inf_flavor = 1).  Contact us at dart at ucar.edu if you have an 
+     interest in using this option.
+
+------------------------------------------------------------------------------
+Changes to the filter_nml are :
+------------------------------------------------------------------------------
+* restart_in_file_name      -- has been replaced with input_restart_file_list.
+                               The namelist must contain one or more file names, 
+                               each of which is a textfile containing a list of N 
+                               NetCDF restart files, one per line for each ensemble member.
+                               For models with multiple domains (e.g. nested WRF or 
+                               CLM) you must specify a listfile for each domain.
+
+* restart_out_file_name      -- has been replaced with output_restart_file_list.
+                                Same format as input_restart_file_list.
+
+* inf_in_file_name           -- REMOVED, now have fixed names of the form 
+                                input_{prior,posterior}inf_{mean,sd}.nc
+
+* inf_out_file_name          -- REMOVED, now have fixed names of the form 
+                                output_{prior,posterior}inf_{mean,sd}.nc.
+
+* inf_diag_filename          -- REMOVED
+
+* inf_output_restart         -- REMOVED, inflation restarts will be written 
+                                out if inflation is turned on
+
+* output_inflation           -- REMOVED, inflation diagnostic files will be written 
+                                if inflation is turned on
+
+* stages_to_write            -- There is more control over what state data 
+                                to write.  Options are at stages : 
+                                'input', 'preassim', postassim', 'output'.  
+                                Stages preassim and postassim will output 
+                                state data originally contained within the 
+                                copies of Prior_Diag.nc and Posterior_Diag.nc.
+                                See rma_doc/rma.html for details on the 
+                                filename conventions. For example, running 
+                                filter with prior inflation enabled with 
+                                stage 'preassim' enabled will produce files 
+                                with names:
+                                   preassim_member_####.nc
+                                   preassim_{mean,sd}.nc
+                                   preassim_priorinf_{mean,sd}.nc
+
+* write_all_stages_at_end    -- important for large models - all output file 
+                                I/O is deferred until the end of filter, but 
+                                will use more memory to store the data.  More
+                                detailed info is in rma_doc/rma.html
+
+* output_restart_mean        -- renamed output_mean
+
+* output_restart             -- renamed output_restarts