[Dart-dev] DART/branches Revision: 10877

[dart at ucar.edu]

hendric at ucar.edu
2017-01-13 13:44:04 -0700 (Fri, 13 Jan 2017)
116
adding a text file that will contain an evolving update for
new branch merges and namelists and programs effected.




Added: DART/branches/rma_fixed_filenames/README_rma_updates.txt
===================================================================
--- DART/branches/rma_fixed_filenames/README_rma_updates.txt	                        (rev 0)
+++ DART/branches/rma_fixed_filenames/README_rma_updates.txt	2017-01-13 20:44:04 UTC (rev 10877)
@@ -0,0 +1,121 @@
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
++ 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 which is a 
+                               text file which contains a list of NetCDF input restart 
+                               files.  For multiple domains such as WRF you can specify 
+                               files for each domain. This is the same for 
+                               restart_out_file_name.
+
+* restart_out_file_name      -- has been replaced with output_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 files written only if inf_flavor > 1.
+
+* 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
+
+* direct_netcdf_{read,write} -- REMOVED, always true
+
+* restart_list_file          -- renamed input_restart_file_list
+
+* single_restart_file_in     -- renamed single_file_in
+
+* single_restart_file_out    -- renamed single_file_out
+
+* add_domain_extension       -- REMOVED
+
+* use_restart_list           -- REMOVED
+
+* overwrite_state_input      -- REMOVED, equivalent functionality can be set with
+                                single_restart_file_in = single_restart_file_out
+
+-----------------------------------------------------------------------------------------
+Changes to the perfect_model_obs_nml are :
+-----------------------------------------------------------------------------------------
+* restart_in_filename        -- renamed restart_in_file_names takes a NetCDF file. For 
+                                multiple domains you can specify a list.
+
+* direct_netcdf_{read,write} -- REMOVED, always true
+
+-----------------------------------------------------------------------------------------
+Changes to the state_space_diag_nml are :
+-----------------------------------------------------------------------------------------
+* single_file               -- REMOVED, diagnostic files are now controlled