[Dart-dev] [4402] DART/trunk/models/POP/README: LANL/POP and CESM/POP ready

[nancy at ucar.edu]

Revision: 4402
Author:   thoar
Date:     2010-06-30 14:30:13 -0600 (Wed, 30 Jun 2010)
Log Message:
-----------
LANL/POP and CESM/POP ready

Modified Paths:
--------------
    DART/trunk/models/POP/README

-------------- next part --------------
Modified: DART/trunk/models/POP/README
===================================================================
--- DART/trunk/models/POP/README	2010-06-30 16:19:13 UTC (rev 4401)
+++ DART/trunk/models/POP/README	2010-06-30 20:30:13 UTC (rev 4402)
@@ -4,12 +4,46 @@
 #
 # DART $Id$
 
-This is a development trunk.
-This is a work in progress and may not even work ... AT ALL.
-Do not use at your own risk ... DO NOT USE!!!
+30 June 2010 - TJH
 
-When this model is supported, this file will reflect that.
+The POP interface to DART is available for general use. There are two
+fundamentally different POP models, however; the LANL version and the
+CCSM/CESM version. The CESM/POP was tested and run in production on 
+NCAR's bluefire computer from IBM.  The LANL/POP 2_0_1 version of POP ...  
+STILL CANNOT BE USED for assimilation until the POP code is modified 
+to do a forward euler timestep for the assimilation case.  
 
+Essentially, there are two wildly different modes of running POP
+and DART.
+
+1) CESM/POP is invoked by inserting a few lines into the run script
+   generated by CESM and DART is simply used to assimilate at a single
+   timestep. DART is started and stopped at every assimilation time
+   and is NOT responsible for advancing the model at all. The observation
+   sequence files must be chopped up into 'daylong' chunks since the
+   flux coupler stops the models at midnight - this is the assimilation time. 
+   The CESM Interactive Ensemble facility is used to manage the ensembles.
+
+2) LANL/POP is invoked the same way as any other high-order model. DART is
+   invoked and POP is started/stopped multiple times. Given the wide
+   range of input files and modes for running POP - the scripts will surely
+   have to be modified to accomodate these different usage patterns.
+   This interface was tested with the LANL/POP 2_0_1 version of POP ... 
+   but STILL CANNOT BE USED for assimilation until the POP code is modified 
+   to do a forward euler timestep for the assimilation case.  
+
+   This compiles and runs on coral (SLES10) with the 
+   ifort (IFORT) 10.1 20090203 compiler with the following flags:
+   FFLAGS = -O0 -fpe0 -vec-report0 -assume byterecl 
+   Coral is an Intel-based machine - so all binary files were little-endian.
+   I like to append a ".le" suffix on those files.
+
+   It was checked in the gx3v5 configuration.
+
+   For coral with the openmpi framework, it is necessary to
+   specify input.nml:&mpi_utilities_nml:reverse_task_layout = .true., 
+   For bluefire ... it must be .false. (the default).
+
 Tim
 
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -27,7 +61,10 @@
 
 nancy
 
- ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+#----------------------------------------------------------------------
+# Everything below here is just notes from the development process.
+# It is highly unlikely it will mean anything to anyone but Tim H.
+#----------------------------------------------------------------------
 
 Tim : Tue Jul 21 17:45:52 MDT 2009