[Dart-dev] DART/branches Revision: 11311

[dart at ucar.edu]

raeder at ucar.edu
2017-03-14 14:40:11 -0600 (Tue, 14 Mar 2017)
374
First commit of doc/setup_guidelines.html, which is a broad stroke description 
of the procedure for setting up a CESM+DART  assimilation from scratch.
It references other docs for more details.  It uses cam-fv as an example.
It's all text for now.  Formatting would like some improvement.

Also commit updated README with corrected terminology and a bit more information.




Modified: DART/branches/rma_trunk/models/CESM/README
===================================================================
--- DART/branches/rma_trunk/models/CESM/README	2017-03-14 20:30:00 UTC (rev 11310)
+++ DART/branches/rma_trunk/models/CESM/README	2017-03-14 20:40:11 UTC (rev 11311)
@@ -12,19 +12,32 @@
 model_mod codes.
 
 Mon Nov  9 13:44:50 MST 2015
+Modified/updated 
+Mar 10 2017
+> > > See ./doc/setup_guidelines.html for much more information. < < < 
 
 We have adopted some terminology to help us keep things straight.
 1) CESM already uses the term 'fully-coupled', so we use that in
-   reference to CESM components only.
-2) We use the term 'single-component, fully-coupled' to denote the
+   reference to CESM components only.  It means that CESM has
+   an active atmosphere and ocean, ignoring other components.  
+   In CESM an active atmosphere almost always implies 
+   an active land, but that is not necessary for it 
+   to be called 'fully coupled', and, by itself, is not 'fully coupled'.
+2) We use the term 'single-component' to denote the
+   situation in which the assimilations are performed for
+   ONE active model component. Atmospheric obs directly impact 
+   the atmosphere, OR land obs directly impact the land, etc..
+   Any impact from the atmosphere to the land
+   happens through interaction with the CESM coupler.
+3) We use the term 'multi-component' to denote the
    situation in which the assimilations are performed separately for
-   any/all active model components. Atmospheric obs directly impact 
-   the atmosphere, ocean obs directly impact the ocean, land obs 
-   directly impact the land - any impact from the atmosphere to the ocean
+   more than one active model component. Atmospheric obs directly impact 
+   the atmosphere AND ocean obs directly impact the ocean, etc..
+   Any impact from the atmosphere to the ocean
    happens through interaction with the CESM coupler.
-3) 'cross-component, fully-coupled' is used to specify the case
+4) 'cross-component' is used to specify the case
    when observations of one component can directly impact any/all of
-   the other components without going through the coupler.
+   the other active components without going through the coupler.
 
 Prior to 9 Nov 2015, models/CESM  had programs that were an attempt to
 achieve the cross-component, fully-coupled data assimilation. Since
@@ -31,18 +44,15 @@
 this is being implemented with the Remote Memory Access (RMA) strategy
 that is not consistent with the current SVN trunk, the files that allow
 that usage pattern are being removed from the SVN trunk.
+However, there are scripts in ./shell_scripts which enable 
+the 'multi-component' assimilation mode, which does not require
+a models/CESM/model_mod.f90, since it uses a separate filter for
+each component (cam-fv, pop, ...).
 
-Only the single-component, fully-coupled assimilation pattern will 
-be supported in the SVN trunk.
-
 The models/CESM/work directory has nothing of use in it, since there 
 are no programs to interact with a cross-component DART state vector
 (a DART state that consists of atmosphere and/or ocean and/or land).
 
-The models/CESM/shell_scripts directory DOES have the scripts that 
-illustrate how to set up and run a single-component, fully-coupled 
-assimilation.
-
 # <next few lines under version control, do not edit>
 # $URL$
 # $Revision$

Added: DART/branches/rma_trunk/models/CESM/doc/setup_guidelines.html
===================================================================
--- DART/branches/rma_trunk/models/CESM/doc/setup_guidelines.html	                        (rev 0)
+++ DART/branches/rma_trunk/models/CESM/doc/setup_guidelines.html	2017-03-14 20:40:11 UTC (rev 11311)
@@ -0,0 +1,559 @@
+
+<!-- Classes of style to apply to text below
+   <div class="top">[<a href="#">top</a>]</div><hr />
+   </div>
+   <em class=file>input.nml</em>.
+   <div class=namelist>
+   </div>
+   <TR><TD><em class=call>use model_mod, only : </em></TD>
+   <A HREF="#Namelist"> <em class=code>&amp;model_nml</em> </A>
+   <div class=indent1>
+   </div>
+-->
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+          "http://www.w3.org/TR/html4/strict.dtd">
+<HTML>
+<HEAD>
+<TITLE>CESM+DART setup </TITLE>
+<link rel="stylesheet" type="text/css" href="../../doc/html/doc.css" />
+<link href="../../../doc/images/dart.ico" rel="shortcut icon" />
+</HEAD>
+<BODY>
+<A NAME="TOP"></A>
+
+<H1>CESM+DART setup </H1>
+
+<table border=0 summary="" cellpadding=5>
+<tr>
+    <td valign=middle>