[Dart-dev] DART/branches Revision: 12680

[dart at ucar.edu]

nancy at ucar.edu
2018-06-18 14:27:29 -0600 (Mon, 18 Jun 2018)
306
minor wordsmithing for the cam-fv version.

added some words at the top of the se version
to say we support it but only in the classic release
with version 1.2.1 of cesm.

i left the rest of the contents of the se file; 
they look like kevin's internal development notes 
but might be of interest anyway.




Modified: DART/branches/rma_trunk/models/cam-fv/doc/README_cam-fv
===================================================================
--- DART/branches/rma_trunk/models/cam-fv/doc/README_cam-fv	2018-06-18 19:58:17 UTC (rev 12679)
+++ DART/branches/rma_trunk/models/cam-fv/doc/README_cam-fv	2018-06-18 20:27:29 UTC (rev 12680)
@@ -1,33 +1,37 @@
-We recommend that, before using the cam-fv interface,
+We recommend that before using the DART CAM-FV interface
 you become familiar with DART by working through 
-the core parts of the tutorial or getting instruction 
+the core parts of the DART tutorial or getting instruction 
 from someone knowledgable about DART.
 
-The scripts which set up CAM and/or assimilations are in
-shell_scripts/cesm2_0 (as of 2018-6). 
-Work through setup_hybrid, which will guide you 
+The scripts which set up CAM and CAM-DART assimilations 
+are in the models/cam-fv/shell_scripts/cesm2_0 directory.
+Work through setup_hybrid first, which will guide you 
 through setting up the multi-instance CAM-FV environment 
 which DART requires.
+
 That script includes instructions for activating the 
-assimilation using DART_config.template.
-Do check the output of the forecasts and assimilations 
-carefully, to catch errors earlier in the development process.
-We highly recommend using observation space diagnostics.
+assimilation using the DART_config script.
+Check the output of the forecasts and assimilations 
+carefully to catch errors early in the development process.
+We highly recommend using observation space diagnostics
+to evaluate your results.
 
-Once you are comfortable with those procedures,
-you may find it more efficient to use setup_advanced,
-which combines the setup of CAM and the activation of
-the assimilation.  It also provides more advanced mechanisms
+Once you are comfortable with these procedures you may 
+find it more efficient to use the setup_advanced script, 
+which combines the setup of CAM and the activation of the
+assimilation.  It also provides more advanced mechanisms
 for setting up the best assimilation for your research.
 
-The CESM environment, which DART requires, is now included
-in CESM's "pre-beta" tests.  So you should be able to use
-any beta, or higher, release of CESM (after 2.0) with DART.
-We recommend that you set up a new shell_scripts/cesm#_#
-directory, modeled on the cesm2_0, in order to maximize
-the clarity in the scripting environment. 
-If you discover that CESM is not playing well with DART,
+The CESM environment which DART requires is now included
+in CESM's testing process.  So you should be able to use
+any new releases or any betas after CESM 2.0 with DART.
+For releases or betas other than CESM 2.0 we recommend
+setting up a new models/cam-fv/shell_scripts/cesm#_#
+directory, modeled on the cesm2_0 directory, to minimize
+problems with changing CESM requirements.
+
+If you discover that CESM is not playing well with DART
 and you have tried the simple fixes (increasing nodes/member,
-decreasing ensemble size, removing your SourceMods, ...)
-please contact us.
+decreasing ensemble size, removing your SourceMods, etc)
+please contact us at dart at ucar.edu.
 

Modified: DART/branches/rma_trunk/models/cam-fv/doc/README_cam-se
===================================================================
--- DART/branches/rma_trunk/models/cam-fv/doc/README_cam-se	2018-06-18 19:58:17 UTC (rev 12679)
+++ DART/branches/rma_trunk/models/cam-fv/doc/README_cam-se	2018-06-18 20:27:29 UTC (rev 12680)
@@ -1,3 +1,15 @@
+Status of the CAM-SE CESM/DART assimilation:
+
+DART supports assimilation using the CAM-SE model
+in the DART Classic release.  The scripting supports
+CESM release 1.2.1 and some support for release 1.5.
+
+Contact us at dart at ucar.edu for more information.
+
+
+
+Notes from the model developer:
+
 Tasks from 2017-8-activities:
 
         CESM2 uses ne0 for var res CAM-SE assim setup.
@@ -21,11 +33,8 @@
 
 The last committed model_mod which handles CAM-SE is
    Working Copy Root Path: /glade/u/home/raeder/DART/Trunk
-   URL: https://subversion.ucar.edu/DAReS/DART/trunk/models/cam
    Relative URL: ^/DART/trunk/models/cam
-   Repository Root: https://subversion.ucar.edu/DAReS
-   Repository UUID: acad1b26-7d42-44b9-9cec-aac8293558f5
-So it's not RMAized or Manhattanized.
+It's not RMAized or Manhattanized.
 Now that the cam-fv has been rewritten (2017-10) this model_mod
 will only be useful as a source of subroutines and how to use them.
 The subroutines will probably need to be updated for RMA.