--- MITgcm/doc/tag-index	2014/04/23 12:42:19	1.1980
+++ MITgcm/doc/tag-index	2014/05/30 17:19:57	1.2004
@@ -1,17 +1,124 @@
-$Header: /home/ubuntu/mnt/e9_copy/MITgcm/doc/tag-index,v 1.1980 2014/04/23 12:42:19 mlosch Exp $
+$Header: /home/ubuntu/mnt/e9_copy/MITgcm/doc/tag-index,v 1.2004 2014/05/30 17:19:57 jmc Exp $
 $Name:  $
 
     Notes on tags used in MITgcmUV
     ==============================
 
+o pkg/sbo:
+  - update from Katherine Quinn: evaluate mass directly from density and SSH
+    (budget using Finite Volume method) instead of from bottom pressure.
+  - allow testreport to collect few selected SBO output ; tested in exp.
+    global_ocean.90x40x15 (after updating the results, to include SBO output).
+  - fix some multi-threading issues (in output part).
+o model/src & most packages:
+  - always call {PKG}_READPARMS even if corresponding use{PKG}=F;
+  - in {PKG}_READPARMS, in case use{PKG}=F: add a call to new S/R
+    PACKAGES_UNUSED_MSG to print a weak warning when parameter file
+    "data.{pkg}" exist ; and leave the S/R (return) just after.
+  - more standard LAND pkg interface (land_init_fixed.F, land_check.F).
+    + call LAND_READPARMS from packages_readparms.F
+o pkg/seaice:
+  - remove code that resets useThSice in S/R seaice_readparms and
+    replace by a warning in S/R seaice_check
+  - remove parameter MULTDIM, replace with nITD and runtime
+    parameter SEAICE_multDim (still hard-wired to nITD if
+    SEAICE_ITD is defined)
+
+checkpoint64x (2014/05/24)
+o verification/lab_sea:
+  - update adjoint and TLM output following changes to pkg/salt_plume
+  - un-do the update after putting back local recip_Cp in few places.
+o pkg/salt_plume: modifications by An Nguyen:
+  - add capability to do brine rejection (salt-plume) as function of
+    volume+tracers (instead of only salinity tracer).
+  - conserve volume by exchanging volume from each kLev to above to
+    accommodate in-coming brine volume
+  - store surface and klev exchanged fraction + volume in 4 new 3-d arrays
+  - switch KPP surf buoyancy due to brine forcing to 3-d
+    (3 more 3-d arrays, 2 for SPforcing[T,S], 1 for boplume)
+  - add salt_plume_volfrac, salt_plume_apply, salt_plume_tendency_apply_t
+  - unrelatedly, also add ad-hoc capability to vary salt_plume scheme
+    in East/West Arctic.
+o pkg/sbo:
+  - incorporate modifications from Katherine Quinn to enable the use of sbo
+    pkg in ECCO-v4 set-up ; remove SBO-TimeAve output ; add monitor-like
+    output for future testreport verification (unfinished).
+o pkg/atm_phys:
+  - change diagnostics (AtPh_Trf & AtPh_Qrf) of DARGAN_BETTSMILLER S/R:
+    skip the reseting of t_ref & q_ref to initial t & q ; this preserve the
+    output of S/R CAPECALCNEW (Parcel temp & q) for diagnostics.
+o pkg/seaice
+  seaice_calc_ice_strength.F: modify expression to avoid divisions
+    (affects truncation)
+  seaice_do_ridging.F: clean up the insectarium
+  - fix a bug that was compensated by areaScaling (-> remove areaScaling code)
+  - added SEAICEsnowFracRidge to redistributed snow (2nd bug)
+  - set closing/openingRate to zero where no extra iteration is need (3rd bug)
+  - add some debugging information and error messages (warnings)
+o model/src: modifications relatd to atmosphere p*:
+  - Switch to more accurate p* coordinate slope term (calc_grad_phi_hyd.F)
+  - With p* or Sigma-P, use constant reference Pot.Temp (thetaConst) instead
+    of vertical profile tRef in geopotential background and anomaly.
+  - Acount for true p* correction in theta <-> T conversion in pkg/aim_v23
+    and pkg/atm_phys.
+  - Update FWD output of experiments: aim.5l_cs (x2), fizhi-cs-32x32x40,
+    fizhi-cs-aqualev20, fizhi-gridalt-hs, tutorial_held_suarez_cs, cpl_aim+ocn.
+o pkg/seaice: fix a bug in seaice_prepare_ridging.F, forgot a sqrt
+o pkg/ptracers: compute ptracer source/sink due to linear free surface.
+    not used right now, but can be used in BGC packages to fix conservation.
+o pkg/dic, pkg/gchem: move tracer_meanarea to gchem, so it can be used by
+    other packages too.
+o pkg/seaice/seaice_calc_ice_strength.F: replace SEAICE_rhoSnow by
+    SEAICE_rhoIce in the Rothrock (1975)-type strength calculations (bug fix)
+o model/src:
+  - since we have several heat capacity (even in model/src), define "recip_Cp"
+    as local variable (no longer in common block) to avoid any confusion.
+  - add thetaConst in PARAMS.h (to be used with pStar or sigma-P coords).
+o pkg/exf:
+  - from Jeff Scott: add option (#define EXF_CALC_ATMRHO) to calculate local
+    air density as function of air Temp, Humidity and atm pressure.
+
+checkpoint64w (2014/05/02)
+o verification:
+  - update output_adm.txt files for experiment global_ocean.cs32x15 (seaice &
+    seaice_dynmix) and lab_sea (primary test & noseaicedyn): moving/changing
+    code from seaice_growth.F & seaice_advdiff.F to new ridging routines
+    seaice_reg_ridge.F seaice_do_ridging.F affects AD gradient
+    (down to 8-7 matching digits for global_ocean and 5-6 for lab_sea).
+o model/src: for atmosphere in p* coords:
+  - store factor rStarFacC**atm_kappa (= pStarFacK) in common block
+  - implement more accurate p* coordinate slope term (in calc_grad_phi_hyd.F),
+    but not yet activated.
+o pkg/seaice: fix restart problem for ITD with new ice strength parameterisation:
+  - move computation of opnWtrFrac = 1-AREA to before computing ice strength
+  - this changes the results (but not for any verification experiment, because
+    none tests this), but avoids having an extra field in the restart files
+o pkg/seaice: remove global variable TICE (not needed)
+  - replace by TICES or local variable where necessary (cost_seaice_test,
+    seaice_diagnostics_state)
+  - move copying TICE to TICES from seaice_check_pickup to seaice_read_pickup
+  - use specific read/write routines for reading and writing individual leves
+    of a multilevel field
+o pkg/ctrl & model/inc:
+  - move additional anomaly fields of control vars (related to options:
+     ALLOW_KAPGM_CONTROL, ALLOW_KAPREDI_CONTROL and ALLOW_BOTTOMDRAG_CONTROL)
+    from DYNVARS.h into new header file: CTRL_FIELDS.h
+o pkg/seaice: some small modifications to the ridging code
+  - make fw2ObyRidge a global variable and add the freshwater flux to
+    seaice_growth
+  - pass actual thickness from seaice_prepare_ridging, so that it is
+    computed only in one place and compute it in the same way as in
+    seaice_growth
+  - initialise more fields in seaice_do_ridging that where cause floating
+    point exceptions over land
 o pkg/seaice: preparations for ridging code and first real ridging code
-  - move most of "PART 1" of S/R seaice_growth into a new and separate 
+  - move most of "PART 1" of S/R seaice_growth into a new and separate
     S/R seaice_reg_ridge that will both regularize the state variable after
     advection call the actual ridging routine;
-  - requires to make 5 fields global fields: d_HEFFbyNEG,d_HSNWbyNEG, 
+  - requires to make 5 fields global fields: d_HEFFbyNEG,d_HSNWbyNEG,
     d_AREAbyRLX,d_HEFFbyRLX,saltFluxAdjust;
   - remove ridging code from seaice_advdiff
-  - clean up remaining part 1 of seaice_growth in an attempt to make it 
+  - clean up remaining part 1 of seaice_growth in an attempt to make it
     more readable (this is probably subjective)
   - call seaice_itd_redist once in the initialisation phase to have the initial
     conditions in the correct category