[Dart-dev] DART/branches Revision: 11311
dart at ucar.edu
dart at ucar.edu
Tue Mar 14 14:40:14 MDT 2017
raeder at ucar.edu
2017-03-14 14:40:11 -0600 (Tue, 14 Mar 2017)
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.
--- 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 @@
Mon Nov 9 13:44:50 MST 2015
+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
# <next few lines under version control, do not edit>
--- 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 />
+ <em class=file>input.nml</em>.
+ <div class=namelist>
+ <TR><TD><em class=call>use model_mod, only : </em></TD>
+ <A HREF="#Namelist"> <em class=code>&model_nml</em> </A>
+ <div class=indent1>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+<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" />
+<H1>CESM+DART setup </H1>
+<table border=0 summary="" cellpadding=5>
+ <td valign=middle>
More information about the Dart-dev