--- MITgcm/doc/tag-index	2010/09/11 21:39:13	1.1295
+++ MITgcm/doc/tag-index	2010/10/12 16:03:58	1.1310
@@ -1,9 +1,92 @@
-$Header: /home/ubuntu/mnt/e9_copy/MITgcm/doc/tag-index,v 1.1295 2010/09/11 21:39:13 jmc Exp $
+$Header: /home/ubuntu/mnt/e9_copy/MITgcm/doc/tag-index,v 1.1310 2010/10/12 16:03:58 mlosch Exp $
 $Name:  $
 
     Notes on tags used in MITgcmUV
     ==============================
 
+o pkg/thsice:
+   - change a few routines for better vectorization: thsice_albedo.F,
+     thsice_step_temp.F, and in thsice_calc_thickn.F. Results are
+     not affected, but in particular the latter routine has changed
+     dramatically (not necessarily easier to read now).
+   - re-arrange calculation in THSICE_SOLVE4TEMP: move outside of i,j loops
+   iteration loop and call to S/R THSICE_GET_BULKF & THSICE_GET_EXF.
+o verification/lab_sea:
+  - overhaul of the forward model experiments. The main motivation
+    for this revision is that lab_sea has proven quite fragile (when 
+    changing the sea-ice code, and switching platforms) to a point
+    when failures were very hard to attribute to specific code problems.
+  - the suspected reason for this fragility is noise amplification by evp so, 
+    to start with, we decided to replace evp with lsr in the main experiment.
+  - the input.lsr experiment thus became obsolete and was removed.
+  - it was replaced with the input.fd experiment that uses an 
+    analytical "free drift" solution as the ice velocity field.
+  - Taken together, input (lsr), input.fd (free drift) and input.hb87 (evp)
+    will hopefully allow us to discriminate problems due to dynamic solvers
+    from problems due to the thermodynamic code. input.salt_plume (lsr) allows
+    us to test additional options, along with the salt plume package.
+  - Finally a pickup was generated (at the end of a one year run) to 
+    make the tests more representative of an actual model run. Previously
+    the tests starting point was a 1m thickness of ice everywhere.
+o pkg/seaice: 
+  - introducing S\R seaice_freedrift.F that compute the
+    analytical solution to an approximate ice momentum 
+    equation (i.e. the simple stress/coriolis balance).
+  - define SEAICE_ALLOW_FREEDRIFT to trigger the computation
+    of the free drift velocity field, and enable its use. 
+    To actually use the free drift solution as the model ice 
+    velocity field set SEAICEuseFREEDRIFT to .TRUE. in data.seaice. 
+o move "useOASIS" from PARAMS.h to EEPARAMS.h and read it from "eedata"
+
+checkpoint62l (2010/10/04)
+o pkg/seaice:
+  -fix the USE_ORIGINAL_SBI version (for variable freezing point);
+  -use "celsius2K" in SEAICE_VARIABLE_FREEZING_POINT and in new
+   version (with USE_ORIGINAL_SBI undef);
+o add hooks for new packages OASIS, the package will follow
+  (hooks exclude the seaice pkg for now)
+o pkg/autodiff: ALLOW_AUTODIFF_WHTAPEIO
+  Option to use mdsio_read_whalos.F/mdsio_write_whalos.F,
+  rather than mdsio_readvector.F/mdsio_writevector.F, within
+  adread_adwrite.F to read/write adjoint-related tapes to disk.
+o eesupp and pkg/mdsio: ALLOW_WHIO
+  Option to write/read 2D fields to files including tiles halos.
+  The main purpose is for adjoint related "tape I/O".
+  The secondary purpose is for debugging phases.
+  A word on those rather specifically intended purposes.
+  The code was meant to be stripped down to the bare minimum.
+  Typically, there is a unique and basic mapping to the global
+  buffer (tile by tile, then proc by proc, then level by level), and
+  byteswaps and meta-files are omitted. Indeed the (*_WH*) code is not
+  meant to generate user friendly outputs of various shapes and forms.
+  Rather it is intended, for the knowledgeabale developers,
+  to be largely independent of the many mdsio options, to allow
+  outputs of tiles+halos in debugging phases and in adjoint runs,
+  and to allow some flexibility in tuning (adoint) I/O depending on each
+  file system behavior. With regard to tuning, most of the potential knobs
+  (to leave files open, to allocate the I/O indep. of usesinglecpuio,
+  to specify directories, to specify the typical size of I/O calls, etc.)
+  are not yet included, and will be added if they prove useful.
+o pkg/seaice:
+   fix uninitialised arrays in USE_ORIGINAL_SBI version of seaice_solve4temp.F
+o pkg/seaice:
+   new S/R seaice_solve4temp.F: this is the merged version of Ian Fenty
+   code (seaice_budget_ice_if.F) which enable to recover old standard
+   code (seaice_budget_ice.F) when option USE_ORIGINAL_SBI is defined.
+   temporary: add "#define USE_ORIGINAL_SBI" at the top of seaice_solve4temp.F.
+o model/src (rStar):
+   use simple average (not area weighted) of rStarFac at U,V point when using
+   vectorInvariant and selectKEscheme=1,3 (consistent with mom. vertical advection)
+   update output of exp. fizhi-cs-32x32x40 and fizhi-cs-aqualev20.
+
+checkpoint62k (2010/09/17)
+o adjoint
+   * changed verification/global_ocean.cs32x15 ; adjoint now tests
+     Adams-Bashforth 3 + NLFS + RSTAR
+   * some more modifs required for ECCO-GODAE v4
+o pkg/seaice
+   add SEAICE_AGE_VOL option to use volume instead of area for
+   integrating SEAICE_AGE
 o model/src:
    first check-in of sigma & hybrid-sigma coordinate code ; also includes
    non-linear free-surface parts ; but pressure-gradient not yet coded.