/[MITgcm]/MITgcm/doc/tag-index
ViewVC logotype

Diff of /MITgcm/doc/tag-index

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.97 by adcroft, Tue Nov 5 19:17:20 2002 UTC revision 1.894 by jmc, Fri Oct 19 20:34:20 2007 UTC
# Line 1  Line 1 
1  $Header$  $Header$
2    $Name$
3    
4      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
5      ==============================      ==============================
6    
7    o pkg/kpp: add "_d 0" to real constant (if missing);
8      update output of exp: natl_box (10.digits); vermix (std, 7.digits)
9      and lab_sea, 3.FW (only 6,4,6 digits match) & AD (8.digits).
10    o prepare for "clever pickup" implementation: add new header file "RESTART.h"
11      for internal parameters related to restart process (formerly from PARAMS.h)
12      and add startAB parameter to argument list of S/R ADAMS_BASHFORTH2.
13    o more standard interface to {PKG}_WRITE_PICKUP with pickup suffix passed
14      as argument. (only atm2d & obcs write_pickup have not yet been updated)
15    o pkg/monitor:
16      - use GLOBAL_SUM_TILE instead of _GLOBAL_SUM
17      - fix mon_stats_rs (statistics over the full domain, even where field is zero)
18      - account for deep Atmosphere factor and density factor (anelastic)
19    o added open boundary conditions capability for seaice HEFF and AREA
20    o pkg/shelfice: add option for convservative form of Hellmer&Olbers (1989)
21      thermodynamics
22      - requires a little reorganization, which affects the testreport results
23        of isomip.htd (only 7 digits of cg2d agree) => update/modify experiment,
24        so that now the conservative form is tested
25      - add a few comments
26    o add missing cvs Header: or Name: in eesupp/*, pkg/* & verification/code*
27    o add a little bit of code to gad_os7mp_adv_?.F to help vectorization
28    o add new diagnostics to seaice: advective, diffusive fluxes (only for
29      multidim-advection, for scheme 2 they are not filled) and transports,
30      thermodynamic growth rates
31    o change units of EmPmR (inside the code) from m/s to kg/m2/s (mass flux) but
32      leave input file unchanged. Affects results @ truncation level (cg2d match)
33      and update output of experiments: lab_sea(6), global_ocean.90x40x15(10),
34      global_ocean.cs32x15(11x3,10), natl_box(11), tutorial_global_oce_latlon(11)
35      + adjoint results: global_ocean_ebm(11) and lab_sea (12).
36      Next: will retire convertEmP2rUnit (simply using mass2rUnit instead).
37    
38    checkpoint59h
39    o pkg/exf:
40      - improve vectorization by moving if-statement out of loops in
41        exf_mapfields, exf_radiation
42      - exf_bulkformulae.F: introduce 2D fields and vectorize code
43    o pkg/kpp: added the salt plume scheme (ALLOW_SALT_PLUME) to KPP package
44    o testreport:
45      - allow to test for Qnet & SeaIce monitor output; clean-up ALLOW_BULK_OFFLINE
46        monitor & update offline_exf_seaice exp. output.
47      - AD testing: pass/FAIL according to Grad. output accuracy (instead of Cost)
48    o pkg/seaice:
49      - bug fix in the evp solver: boundary conditions were affected be
50        masking of zMax/zMin (changes results)
51      - minor bug fix in boundary conditions in seaice_calc_strainrates
52        (changes results for no_slip)
53      - seaice_lsr.F: make interpolation of eta dependent on boundaries
54      - replace hardcoded lower limit for zeta (zMin) by runtime parameter
55      - add a test to lab_sea, that tests the Hibler and Bryan (1987) ocean
56        stress formulation and no-slip boundary conditions
57    o pkg/ptracers: Temporary fix for PTRACERS_useGMRedi & PTRACERS_useKPP
58      in gad_calc_rhs.F ; add few safety stops in initialisation phase.
59    o pkg/seaice: a first HSALT time stepping equation has been checked in
60    o pkg/seaice: replaced maskW with seaiceMaskU and maskS with seaiceMaskV
61      in seaice_lsr.F; this solves the pkg/seaice-pkg/obcs problem
62      without requiring DO-IF statements
63    o pkg/thsice:
64      use continuous power-law function for partition of energy between lateral
65      melting/freezing and thinning/thickening ; old code using step function
66      still available with #undef THSICE_FRACEN_POWERLAW
67      update output of exp: aim.5l_cs.thSI, global_ocean.cs32x15.icedyn & .thsice
68    o testreport: change AD testing : check against results/output_adm.txt
69      using same scripts as for forward test.
70    
71    checkpoint59g
72    o adjoint testing: in preparation for changing testreport:
73      - output format: cost and grad written on separated lines
74      - ad output results in directory "results" (instead of "results_ad")
75    o pkg/seaice: adding ice salinity HSALT as a prognostic variable
76    o pkg/seaice: changes for using pkg/seaice with pkg/obcs
77    o pkg/ecco: allow user defined cost function contributions
78    o testreport:
79      Allow to choose (per experiment) the list of tested output variables
80       and the main variable (used to issue a pass/FAIL ) ;
81      - for now, done by adding the specific list in file: [exp]/input/tr_checklist
82      - default is unchanged: >cg2d< , (T,S,U,V,5 tracers)_[min,max,mean,StD] ;
83      Also modify printing of summary:
84       a) ">" NN "<" indicates the "main" variable (used for pass/FAIL)
85       b) echo the list of tested variables in the individual summary.txt of
86          each experiment.
87    o new S/R GLOBAL_SUM_TILE to compute global sum independently of number of
88      threads and number of processes (with #define GLOBAL_SUM_SEND_RECV)
89      (but still depend on the tile decompostion of the domain).
90    o pkg/seaice: change a discretization detail to make the B-grid code
91      "more symmetric". This change is likely to remove all "ridges/leads" that
92      where quasi-aligned with the grid in B-grid solutions. It may also be
93      the solution to the stress coupling issues with the B-grid.
94    o each tested exp: add a "run" directory with a standard ".cvsignore" file ;
95      remove .cvsignore from input dir. (since testreport no longer run here).
96    o pkg/thsice:
97     - cleaning: move common block out of "THSICE_2DYN.h" (removed) to "THSICE_VARS.h"
98     - fix reshaping of sea-ice just after advection:
99       melt all the ice only if ice-volume is too small.
100     - re-visit lateral/thinning repartition of melting (modifs from May 04, 2007):
101       prevent lateral melting if sea-ice fraction is too close to iceMaskMin ;
102     and update experiment global_ocean.cs32x15.icedyn (+start from pickup files).
103    o external_forcing_surf : extend the use of salt_EvPrRn & temp_EvPrRn (fresh-water
104      tracer content) to linFS or no RealFreshWaterFlux ; default remains unchanged.
105    o define mass2rUnit & rUnit2mass as units conversion factor, used for surface
106      forcing. mass2rUnit: from mass per unit area [kg/m2] to r-coordinate unit
107      (z-coord: =1/rhoConst ; p-coord: =gravity) ; rUnit2mass is just the reverse;
108      and remove horiVertRatio (& recip_horiVertRatio). Affects truncation error
109      of exp. global_oce_in_p: 10 16 16 14 16 13 16 16 16 13 13 13 16 13 13 12 16
110      -> update output.txt
111    o pkg/cd_code: add brackets in multiple terms sum (S/R CD_CODE_SCHEME):
112     this affects truncation error: -> update output.txt of exp:
113      global_ocean.90x40x15 (fw&adm), lab_sea (fw&adm) & lab_sea.lsr,
114      ideal_2D_oce, isomip.htd, natl_box, tutorial_global_oce_latlon.
115    
116    checkpoint59f
117    o pkg/autodiff: zero_adj resets an ajoint variable to zero (in adjoint mode)
118    o pkg/ctrl: ctrl_bound  forces parameter corrections to stay in
119      a bounded range (in forward mode)
120    o pkg/ecco, ctrl, autodiff and mom_common:
121     internal parameter controls, completements of implementations
122    o add few EXCH S/R (UV_BGRID, UV_DGRID, SM) for B & D-Grid velocity & 2nd Moment Sxy.
123    o use UV_BGRID exch for dxV,dyU: for now, only with pkg/exch2 & forward ;
124      (not seem any difference in testing results).
125    o pkg/cd_code: use the right EXCH calls (for CS-grid); but problem remains
126       at face corners.
127    o pkg/generic_advdiff:
128     - in GAD.h, define as parameters (iMinAdvR,iMaxAdvR,jMinAdvR,jMaxAdvR)
129      loop range indices for computing vertical advection tendency
130      and do the calculation in the interior only (no overlap) ;
131      for now, only implemented for SOM advection (to save CPU time).
132     - add argument "withSigns" to S/R FILL_CS_CORNER_TR_RL (needed for SOM_xy moment)
133    o exch2 adjoint
134      First set of changes:
135      - add exch2 hand-written adjoint templates
136      - exch2 hand-written no longer use TAF-flag 'nownew_arg'
137        This will require cleanup in pkg/autodiff/*.F
138        (changed routines currently kept separate in verif. code/)
139      - Comment all relevant #ifndef ALLOW_AUTODIFF_TAMC
140        that used to hide exch2 or cubed-sphere specific code
141        (commented via 'cph-exch2')
142    o pkg/seaice
143      - Close southern and western boundaries for UICE/VICE when useOBCS=.TRUE.
144    o pkg/bulk_force: fix loading into Qsw of Short-Wave flux; and update
145       output of global_ocean.cs32x15.thsice .
146    
147    checkpoint59e
148    o exch2: new S/R that only use the cube-tracer (center-position) exchange:
149      for B-grid vector (not yet tested) and C-grid vector (<- only used
150      when option W2_USE_R1_ONLY in W2_OPTIONS.h is defined).
151    o starting implementation of Duffy et al. (GRL 1999) salt plume scheme
152      (#ifdef ALLOW_SALT_PLUME)
153    o gather_2d/scatter_2d: removed halo regions
154    o gmredi: add option (GM_taper_scheme='fm07') for Ferrari & McWilliams 2007
155      scheme and the corresponding test case (under front_relax dir). For now,
156      only available with Skew-flux form and not yet tested in realistic set-up.
157      adjoint: store directives updated, but gradient checks deteriorated,
158      so maybe GM/Redi adjoint is now broken.
159    o seaice adjoint
160      * add AREA, HEFF, HSNOW as control variable
161        (should not change lab_sea results)
162      * CTRL_OPTIONS.h needs new flag: CTRL_SET_OLD_MAXCVARS_40
163    o pkg/seaice:
164      * added computation of saltFlux in seaice_growth;
165        For time being, sea ice salinity is assumed constant
166        contribution of snow flooding to freshening of sea ice is neglected.
167        SEAICE_salinity is set in SEAICE_PARM01 of data.seaice and it
168        defaults to 0.0 in order to maintain backward compatibility.
169        Typical values for SEAICE_salinity are 4 to 10 g/kg.
170      * replaced dRf(1) with dRf(kSurface)*hFacC(kSurface) in seaice_growth.F
171      * added SEAICE_availHeatFrac, which specifies fraction of surface level
172        heat content used to melt or grow ice
173      * commented out cap of HICE: it helps keep ice thinner
174      * reintroduced cap of HEFF via MAX_HEFF and SEAICE_CAP_HEFF option
175      * applied OBCS T/S mask to HEFFM sea ice mask
176    
177    checkpoint59d
178    o standard name: {PKG}_DIAGNOSTICS_STATE to fill diagnostics array
179     for {PKG} state variables, and called from DO_STATEVARS_DIAGS.
180     (keep {PKG}_DIAGNOSTICS_FILL for non-state variables diagnostics)
181    o pkg/gmredi (gmredi_readparms.F): add some missing "_d 0"
182     and change default value of parameter "GM_Small_Number";
183     update output of exp: lab_sea (x2), cfc_example, global_ocean.90x40x15,
184       global_ocean.cs32x15 (x4), global_ocean_ebm, global_with_exf,  
185       tutorial_global_oce_biogeo, tutorial_global_oce_latlon
186    o pkg/ecco: cost function when applying pkg/smooth to controls
187    o pkg/ctrl: add forcingPrecond run time parameter
188    o pkg/seaice:
189     - replace ZMIN=4.e8 with ZMIN=0. in dynsolver.F as in C-grid code
190     - fix bug in metric terms of u-equation in LSR solver (implicit part),
191       changes verification/lab_sea
192     - rearrange implicit part of u-equation in LSR solver to make it easier to
193       read, understand, and debug. This causes changes at the truncation level.
194     - fix (serious) bug in the boundary conditions (sign error in the implicit
195       part) of the LSR solver. Changes all LSR results.
196     - fixed problem with HSNOW initialization to avoid thick snow when AREA
197       is initilized with small values - does not change lab_sea results.
198     - added HsnowFile initialization capability
199    o pkg/smooth: addition to model/src and pkg/ctrl so allow
200     initialization of pkg/smooth and application to control vector
201    o pkg/seaice: fix another bug in the LSR no-slip boundary conditons
202    o dependencies: pkg/profiles requires pkg/cal
203    o pkg/profiles:
204     - added option ALLOW_PROFILES_GENERICGRID
205         -> pkg/profiles can thus be used with any grid (e.g. cs32x15) assuming
206         that interpolation information (grid points and coefficients) is provided
207         within the netcdf input files.
208         -> sample matlab scripts can be found in MITgcm_contrib/gael
209         that allow you to prepare netcdf input files.
210     - also modified: cleaner include statements, cleaner error print statements,
211       cleaner stops when error, and more tests of the netcdf input files consistency.
212    o additional test (in global_ocean.cs32x15) using seaice+thsice pkgs.
213    o pkg/seaice:
214     - move seaice-diagnostics from seaice_do_diags to do_statevars_diags; this
215       requires a new routine: seaice_diagnostics_fill.F
216     - make sure that seaice does not move if not forced (pressure replacement
217       method, Hibler and Ip, 1995), changes results
218     - and new damping criterion for EVP solver according to Hunke, JCP, 2001
219     - SEAICE_evpDampC = > 0. turns it on (615. is the recommended value).
220       It is turned off by default (=-1.), because it changes the results.
221     - make it possible to read AREA from a file, too.
222    
223    checkpoint59c
224    o add S/R and diagnostics for oceanic mixed-layer depth
225    o move GMRedi call after all vertical mixing schemes (including KPP)
226    o pkg/thsice:
227     - ensure iceMask > iceMaskMin : this problem appeared after May-04 modifs
228      (melt only laterally if thin ice): update output of global_ocean.cs32x15.thsice
229    o pkg/obcs:
230     - bug fix for balance code
231    o pkg/seaice:
232      - allow values of SEAICE_elasticParm > 1
233      - add new parameter SEAICE_evpTauRelax as an alternative
234        to SEAICE_elasticParm
235      - make lsr boundary conditions free slip (by default), changes result
236      - add code for no slip boundary conditions for lsr
237      - set minimum of zeta to zero (and not 4e8) (changes results)
238      - add a cap on AREA after advecting AREA if seaice_growth is not called
239    o change calculation of Visbeck K:
240      - no longer depend on tapering scheme; instead, compute slope (limited
241        by GM_maxSlope). this is equivalent to what was comuted before with
242        clipping or linear tappering.
243      - fix vertical averaging (wrong by 1/2 level)
244      - leave the old version (but will not be maintained) within
245        #ifdef OLD_VISBECK_CALC / #endif
246      - update output of exp. ideal_2D_oce
247    o change error catch in calc_r_star to improve vectorization
248    o exf runoff and seaice: remove ALLOW_SEAICE from exf pkg files and
249      add #define ALLOW_RUNOFF in SEAICE_OPTIONS.h (when not using exf).
250    o adjoint:
251      Re-organized adjoint checkpointing according to Matt Mazloff
252      (but with modifs/completions/cleanups)
253      Storing is now bundled into large arrays to optimized I/O
254      (and second step in cleanup of the_main_loop)
255    
256    checkpoint59b
257    o coupler (pkg/atm_ocn_coupler, pkg/ocn_compon_interf, pkg/atm2d):
258      - export/import (between ocean & coupler) fields needed for ocean DIC.
259    o pkg/seaice:
260      - get rid of three more exchanges seaice_calc_viscosities (required
261        different loop boundaries in seaice_lsr and seaice_ocean_stress)
262      - bug fix in seaice_ocean_stress (update of lab_sea required)
263      - reduce loop boundaries to necessary minimum also in seaice_evp
264      - go back to the old way of computing deltaC/Z as the adjoint likes that
265        better
266    o Refresh of tutorial_global_oce_latlon (includes changing salinity-like
267      passive tracer to an Age Tracer) + update output.txt
268    o pkg/exf:
269      - implement A-grid / C-grid selection for wind-stress input files.
270      - clean-up exf_wind.F (remove us, use wspeed instead ; add wStress)
271      for now, in exf_bulk_largeyeager04.F only :
272      - change implementation for case where windspeed + 2. components wind-stress
273        are read-in. AND use rhoConstFresh to convert evap.
274    o pkg/seaice:
275      - use correct EXCH_UV for wind-forcing (on A-grid).
276      - change SEAICE_OPTIONS.h to limit the number of option combinations (regarding
277        SEAICE_EXTERNAL_FORCING & SEAICE_EXTERNAL_FLUXES); add corresponding stops.
278    o pkg/exf:
279      - default EXF options are now set in EXF_OPTIONS.h (ifndef ALLOW_AUTODIFF_TAMC)
280      EXF_INTERPOLATION:
281      - merge global_with_exf/code version of exf_interp_read.F
282        to the main code ;
283      - Add new option: EXF_INTERP_USE_DYNALLOC to use Dynamical Allocation when
284        reading the file ; Important: This options needs to be defined to recover
285        previous code.
286        otherwise, use fixed size array to read in (size=exf_interp_bufferSize).
287      - no longer loose real*8 precision along the way when using exf_iprec=64.
288    o pkg/seaice: rearrangement of common blocks (really needs more cleaning up)
289      - change discretisation of evp-solver in order to avoid another exchange
290        (changes lab_sea) and clean up a little
291      - replace SQRT(MAX(deltaC,SEAICE_EPS)) by MAX(SQRT(deltaC),SEAICE_EPS)
292        help the adjoint (this also changes the results slightly)
293      - add a few "_d 0" where they had been missing in seaice_evp.F
294      - cleaning up: remove unused seaice_calc_rhs.F
295    o pkg/exf: some cleaning-up:
296      - change various "constants" into runtime parameters
297      - cleaned-up Large&Yeager04 routine which should eventually
298        replace exf_bulkformulae.F (changed names of S/R and CPP)
299        and merged various ALLOW_ATM_WIND options
300     only used with thsice pkg (in thsice_get_exf.F):
301      - implement fixed turbulent transfert Coeff over ice (as in Large&Yeager04)
302        which are used when useStabilityFct_overIce=TRUE (= the default)
303      - change default values of ice & snow emissivity and scale downward LW
304        by ice & snow emissivity.
305    o pkg/thsice:
306     fix few little problems, in thsice_calc_thickn.F:
307      - growth vertically (and not laterally) if iceFrac == iceMaskMax
308      - melt only laterally if hIce < hThinIce (as the comments say)
309      and in thsice_extend.F:
310      - allow to form ice even when iceFrac == iceMaskMax (by increasing thickness)
311      - start to form ice as soon as the minimum ice-volume is reachable.
312     update output of test-exp: aim.5l_cs(thSI), global_ocean.cs32x15(thsice),
313      and cpl_aim+ocn
314    o pkg/kpp
315     - move computation of surface related input fields to KPP into a new
316       subroutine kpp_forcing_surf.F
317     - remove wrong (within bi,bj loops) EXCH calls.
318     - little cleaning (add argument myThid in last position, cvs header ...)
319     - for now, fix conservation problem by exchanging KPPviscAz (may not
320       be the best fix)
321    o pkg/seaice
322     - check for inconsistent evp parameter/cpp-flag combination
323     - remove leftover errIO flat for obsolete name list error handling
324    o OpenAD
325     - changed verification/OpenAD to full baroclinic setup (including GM/Redi)
326    
327    checkpoint59a
328    o pkg/seaice: some parameter clarifications and a little bit of clean up
329    o pkg/thsice: rename run-time parameters:
330       himin       -> hIceMin
331       himin0      -> hThinIce
332       hihig       -> hThickIce
333       i0          -> i0swFrac
334       transCoef   -> bMeltCoef
335       frac_energy -> fracMelting
336      add new parameters: hNewIceMax, fracFreezing, dhSnowLin
337       with default values (for now) that do not change the results.
338      remove old version of thsice vars advection in pkg/seaice.
339    o in FFIELDS.h:
340      - replace #ifndef ALLOW_EXF  by #ifndef EXCLUDE_FFIELDS_LOAD
341      - make pLoad & sIceLoad always available (but still only used if
342         ATMOSPHERIC_LOADING is #define).
343    o pkg/kpp: replaced _KPP_RL with _RL
344    o bug fixes for vertical diffusivity computations when both KPP and
345        3D diffusivity arrays are used; pkg/kpp/kpp_calc_diff_s & _t.F
346        are no longer updating the vertical diffusivity array
347        (passed as argument) but are (re-) setting those arrays.
348    o pkg/seaice: fix bug in evp solver, while doing that
349      - change (improve?) discretization of stress computations for both
350        cgrid-lsr and evp solver
351      - add a new routine to compute strain rates
352      - the above changes lab_sea results
353      - add no slip conditions for evp solver (off by default), lsr-version
354        may follow
355      - fix exchange for shear at Z-points (does not change lab_sea)
356      - retire SEAICEuseEVP, instead turn on EVP by setting SEAICE_deltaTevp
357        (to force the user to pick a time step since there is not "safe" way
358        of choosing it)
359      - add principal stress diagnostics
360      - rearrange fields for evp a little to avoid having to call a: too many
361        exchanges and b: exchanges for stress trensor components which we do
362        not have.
363      - modify Hibler+Bryan (1987) stress coupling so that it reuses information
364        of evp, complete rewrite for lsr case (latter is does not yet work
365        in all cases)
366    o pkg/kpp: add code to have mixing in shelf ice caverns
367      - add myThid to all kpp routines (long overdue)
368    
369    checkpoint59
370    o pkg/exf:
371      - fix wind-stress location: defined on A-grid (if ALLOW_ATM_WIND &
372        ALLOW_BULKFORMULAE or USE_EXF_INTERPOLATION), otherwise, defined on C-grid
373      - move exf header files from lower_case.h to UPPER_CASE.h ;
374        add missing cvs Header & Name
375      - add adjoint routines and flow dirs for newly used exch_uv_agrid routines
376      - add namelist param. selectStressGridPosition, exf_monFreq
377      - retire many _CLIM routines, and remove data.exf_clim
378        + params moved to data.exf
379        + climsst, climsss now handled by exf_set_gen, i.e.
380          climss?period=0 refers to constant field,
381          climss?period=-12 to monthly forcing
382      - split up namelists in data.exf
383    o pkg/seaice:
384      - remove seaice_exch and seaice_exch_uv
385      - remove superfluous exchange of theta
386      - add myThid to seaice_budget_ocean/ice
387      - add new interface for atmospheric wind forcing (C-grid only)
388        + new routine
389        + two new field (taux, tauy for stress over ice)
390        + removed one global field (DAIRN) for C-grid case only
391    o pkg/thsise
392      - 2nd set of modifs for thsice adjoint in conjunction with exf
393    o enable runtime flag useEXF (useCAL is set to .T. if useEXF=.T.)
394    
395    checkpoint58y_post
396    o Added capability for latitudinal dependence of Bryan and Lewis, 1979
397      vertical diffusivity, similar to that in MOM4; turned on using
398      #define ALLOW_BL79_LAT_VARY in CPP_OPTIONS.h and specified using
399      diffKrBL79*, diffKrBLEQ*, and BL79LatVary in runtime data file.
400    o Added capability for 3D specification of background vertical diffusion
401      coefficient.  This is done by (i) #define ALLOW_3D_DIFFKR
402      in CPP_OPTIONS.h and (ii) specifying file diffKrFile in runtime
403      "data" file that contains the 3D vertical diffusivity coefficients.
404    o ice dynamics (pkg/seaice) with thsice thermodynamics:
405      - add code within pkg thsice to advect & diffuse sea-ice fields
406      similar to (and will replace) what has been added in  seaice_advdiff.F,
407      but: - conserving Mass, Heat & Salt.
408           - better when using non-linear advection scheme (not yet fully tested)
409           - can also be used in atmospheric set-up (for now, only the diffusion).
410    
411    checkpoint58x_post
412    o IO option for global-file compact format:
413      - add options when generating topology (utils/exch2/matlab-topology-generator)
414      - add I/O capability (pkg/mdsio).
415      - adapt utils/matlab/rdmds.m to read this format.
416      for now long-line format not yet supported by pkg/mdsio (& exch2).
417    o shelfice: add a few diagnostics
418    
419    checkpoint58w_post
420    o p-coord. non-hydrostatic using reference profile for w <-> omega conversion:
421      rVel2wUnit & wUnit2rVel are computed from reference profile Tref,Sref
422      (and replace horiVertRatio in NH code).
423      Update output of exp.: tutorial_global_oce_in_p (useNHMTerms !)
424                         and tutorial_plume_on_slope (sensitive to truncation)
425    o seaice: if ALLOW_ATM_WIND is undefined use wind stress
426      directly to drive seaice model (C-grid only)
427    o exf: when input wind-stress (#undef ALLOW_ATM_WIND):
428     - reintroduce computation of wind from stress,
429     - compute tau (in exf_bulkformulae.F) from windstress averaged to
430       mass points to avoid tau = 0
431     - fix serious bug: (1/3) in Fortran is not the same as (1./3.)
432    o rdmnc.m: make it work with "global" files created with gluemnc
433    o rdmnc.m : some improvements in dealing with singleton dimension
434      (tested on all testreport mnc output files).
435    o genmake2: disable pkg/profiles if netcdf test fails.
436    o cpl_aim+ocn exp.: use consistent rhoConstFresh in Atm & Ocn; update output.
437    o move call to cal_readparms up to make calendar parameters/variable available
438      to all packages
439    
440    checkpoint58v_post
441    o change EOS (from POLY3 to JMD95P) in global_ocean.90x45x15 to get
442      useDynP_inEos_Zc tested.
443    o pkg/exf: changes to properly interpolate/mask/scale initial fields
444    o utils/matlab/cs_grid/read_cs: routines to speed up reading of CS510 fields
445      and portions thereof.  See read_cs.txt for description and examples.
446    o utils/matlab/cs_grid/bk_line: to compute transport through passages,
447      add a script (grt_circ_bkl.m) to generate broken-line between 2 points,
448      following the great-circle arc between those 2 points.
449    o trap un-initialized variable with pathscale compiler on weddell.mit.edu
450      (thanks to Constantinos): fix few problems and get (almost) all exp to pass.
451    o 2nd-Order Moment Advection Scheme (Prather, 1986): first check-in
452     - enable by setting #define GAD_ALLOW_SOM_ADVECT (in GAD_OPTIONS.h)
453     - used without limiter (AdvScheme=80) or with Prather limiter (AdvScheme=81)
454     - still needs work (not working with some options ; efficiency to improve)
455       and serious testing.
456     - use this scheme for temperature & salinity in 2 advection test exp.:
457       advect_xy & advect_xz, respectively.
458    
459    checkpoint58u_post
460    o new test-exp: fizhi-cs-32x32x40 (40 levels) to replace the 10 levels.
461    o move call to INI_FORCING from PACKAGES_INIT_VARIABLES to INITIALISE_VARIA.
462    o testreport: add option "-skipdir" to skip some test.
463    o exf: when input wind-stress (#undef ALLOW_ATM_WIND), by-pass turbulent
464      momentum calculation.
465    o gad_advection: fix vertAdvecScheme (if different from advectionScheme)
466    o some cleaning: usePickupBeforeC35 no longer supported ; remove this option.
467      remove checkpoint.F and the_correction_step.F (no longer used);
468      do the k loop inside CYCLE_TRACER (supposed to be more efficient).
469    o add option (linFSConserveTr) to correct for tracer source/sink due to
470      Linear Free surface
471    o pkg/seaice: fix a bug in the flooding algorithm: turn off the snow machine
472    o pkg/thsice: fix reading mnc-pickups
473    
474    checkpoint58t_post
475    o pkg/diagnostics: fix multi-threaded output (when singleCpuIO=F)
476    o pkg/mdsio:
477     - clean-up mdsio_readfield.F & mdsio_writefield_new.F and
478       move to new files: mdsio_read_field.F (S/R MDS_READ_FIELD) &
479       mdsio_write_field.F (S/R MDS_WRITE_FIELD);
480     - fix multi-threaded singleCpuIO option in MDS_WRITE_FIELD
481     - collect old S/R  in one file: mdsio_rw_field.F (now just a call to
482       either MDS_READ_FIELD or MDS_WRITE_FIELD )
483     - new S/R (to replace MDSWRITEMETA), which allows to write more
484       informations (variable names, time ...) to meta files.
485     - modify rdmds.m to give back the meta file content.
486    o pkg/diagnostics: change vertical interpolation to be safer, and more
487       flexible (define p-levels to interpolate to in data.diagnostics);
488      add argument to S/R DIAGNOSTICS_GET_POINTERS to catch the right
489       diagnostic pointer.
490    o pkg/seaice: more cleaning up of seaice_growth, added many comments
491    o pkg/exf: put runoff0 and runoff1 into the appropriate common block
492    o fix multi-category seaice:
493     - change cpp flag SEAICE_MULTILEVEL to more meaningful name:
494       SEAICE_MULTICATEGORY
495     - fix short wave heat flux
496    o pkg/seaice: change default (SEAICE_OPTIONS.h): use C-grid dynamics
497       and allow to use EVP solver. Change forward lab_sea: test both EVP
498       solver and LSR solver, and use C-grid dynamics (like lab_sea adjoint)
499    o Initial check-in of lab_sea adjoint
500      (very similar to natl_box_adjoint/code_seaice)
501      * used C-grid and EVP solver
502      * used KPP, GM/Redi
503      * uses inAdExact=.TRUE.
504      * gradient checks fail for both ADM and TLM
505        due to sensitive snow melt code in seaice_grwoth (look for "JZ")
506        f.d. gradients actually seem more problematic than ADM, TLM gradients;
507        issue is related to forward mismatch between g77 an ifort
508    o pkg/seaice: overhaul of thermodynamics
509     - growth.F and groatb.F are replaced by new routine seaice_growth.F
510     - budget.F is replaced by two new routines seaice_budget_ocean/ice.F
511     - move a few global fields out of SEAICE.h into seaice_growth.F and
512       make them 2D (FICE/QNETO/ ...)
513     - remove FO (it is the same as QNETO)
514     - introduce a few local fields to avoid modifying external fields such
515       as atemp, etc.
516    
517    checkpoint58s_post
518    o pkg/exf: moved exf_init_runoff.F to exf_init.F and exf_set_gen.F
519      changed exf_set_gen.F so that
520        genperiod=0 means input file is one time-constant field and
521        genperiod=-12 means input file contains 12 monthly means
522    o CG2D: use pre-computed solver main-diagonal (stored in common block);
523      this affects truncation error ; generate new output file for exp. which
524      fails: exp4(12d), fizhi-cs-aqualev20(12d), front_relax(10d),
525        global_ocean.90x40x15(10d), global_ocean.cs32x15(10d).thsice(11d).viscA4(10d),
526        ideal_2D_oce(10d), internal_wave(09d), isomip.htd(11d), matrix_example(07d),
527        MLAdjust(4x11d,12d), natl_box(11d), rotating_tank(12d),
528        tutorial_global_oce_in_p(10d), tutorial_plume_on_slope(11d),
529        vermix(12d).ggl90(12d).my82(11d).opps(12d).pp81(11d)
530    o start implementation of deep-atmosphere and anelastic formulation
531    o verification: remove 2nd copy of input files and use script "prepare_run"
532      to make a symbolic link to the 1rst copy (reduce downloaded size by ~81.M)
533    o mom_common/vecinv/fluxform: fix a few initialisation isssues
534    o profiles: fix for multithreaded case
535    
536    o diagnostics: rename few diags:
537      s/'PRESSURE'/'RCENTER '/g
538      s/'TICE    '/'oceFreez'/g
539      s/'TAUX    '/'oceTAUX '/g
540      s/'TAUY    '/'oceTAUY '/g
541      s/'SWFLUX  '/'oceQsw  '/g
542      s/DIFx/DFxE/g
543      s/DIFy/DFyE/g
544      and add few ocean-forcing diagnostics:
545      atmPload, sIceLoad, oceQnet, oceFWflx, oceSflux, surForcT & surForcS
546    o modifications to pkg/seaice/growth.F and budget.F, which change results of
547      lab_sea experiment: HSNOW was sometimes treated as effective and sometimes
548      as actual snow thickness.  It now refers everywhere to effective snow
549      thickness, meaning that for non-zero AREA, actual thickness is HEFF/AREA.
550    
551    checkpoint58r_post
552    o modifications to pkg/seaice/growth.F, which change results of
553      lab_sea experiment: fixes pertain to melting snow over open water, to
554      masking EVAP under sea ice, and to using the correct AREA variable for
555      computations of EVAP, PRECIP, HSNOW, and GHEFF
556    o add ability to read bathy, salt, and theta using MNC (off by def)
557    o add flooding algorithm and advection of HSNOW for pkg/seaice;
558      both are turned off by default and do no change any results
559    o seaice advection with pkg/thsice: a step toward the use of non-linear
560      advection scheme, but #ifdef or commented out for now (requires more EXCH).
561    o use standard version of PTRACERS_INI_VARIA in tutorial_tracer_adjsens
562      (identical results) and the standard version of EXTERNAL_FIELDS_LOAD
563      in natl_box (affects results @ truncation level: update output.txt)
564    o multi-threading and IO:
565      - replace some call to MDSIO S/R by the corresponding READ/WRITE_FLD S/R.
566      - remove most of BEGIN_MASTER/ END_MASTER around READ/WRITE_FLD S/R calls
567        (needed to work with SingleCpuIO): tested in all verif. exp.
568    o GAD: use simpler DST3 formulation as default (old version left within #ifdef)
569      affects the results (but none of the verification test uses this scheme).
570    o Adding some pkg/diagnostics capability to pkg/seaice
571      (will certainly be subject to changes)
572    o ctrl: adding new control variables:
573      lwflux, lwdown, evap, snowprecip, apressure, runoff
574    
575    checkpoint58q_post
576    o added CPP_EEOPTIONS.h flag DISABLE_MPI_READY_TO_RECEIVE.  Speeds up
577      1/6-deg Southern Ocean configuration by 8% on IBM Datastar and
578      high_res_cube configuration by 4% on Columbia.
579    o clean-up multi-threaded problems (reported by debugger tcheck on ACES);
580      add (in global_with_exf/code) a version of EXF_INTERP_READ without
581      dynamical allocation (seems to work in multi-threaded).
582    o new function "MASTER_CPU_IO" (=T if master thread & master CPU, if using
583      single CPU io) so that TAF does not have to see EESUPPORT.h
584    o pkg/seaice: implement sea-ice loading (when using RealFreshWaterFlux)
585    
586    checkpoint58p_post
587    o obcs: stop if obcs is used with useCDscheme = .true.
588    o shelfice:
589     - fix a sign error so that no slip at shelfice interface works
590     - remove stop for combination non-hydrostatic code and shelfice. That does
591       not mean, that the results are correct, but at least they are numerically
592       stable
593    o diagnoctics: modify UVELPHI and VVELPHI to include hfac (i.e. mass-weighted)
594    o added adjoint exch routined for all exch*3d* routines
595      and updated flow directives
596    
597    checkpoint58o_post
598    o replace calls to EXCH_Z & EXCH_UV_AGRID: use the new _3D_ version ;
599      remove old subroutines (_XY_ & _XYZ_); update the adjoint version.
600    o change controling S/R for writing pickup file (new S/R do_write_pickup)
601      and clean-up reading/writing of pickup files.
602    o fix local version of read/write pickup (NH part) in rotating_tank/code
603    o simplify EXCH interface:
604     - change _XYZ_ interface to _3D_ subroutine (with 3rd dim in argument list)
605     - not often used EXCH S/R (exch_z, exch_uv_agrid): keep only the _3D_ version
606    o added the regrid package
607    o shelfice:
608     - add a simple boundary layer scheme to reduce noise
609     - fix the indexing in shelfice_u/v_drag so that there will be actually drag
610    
611    checkpoint58n_post
612    o fix globalArea multi-threaded calculation: need to apply GLOBAL_SUM to
613       local variable (not in common block).
614    o lot of small changes for multi-threaded. Most tests (using OMP & ifort) pass.
615      - still problems with pkgs: mnc, exp2, dic, cal, exf (and probably more);
616      - still BEGIN_MASTER/END_MASTER to remove around READ/WRITE_FLD S/R calls
617        to work with SingleCpuIO.
618    o add "_d 0" to real constant of pkg/cfc subroutines ;
619       update exp. cfc_exemple & tutorial_cfc_offline output files.
620    o multi-threading and IO:
621      - all threads call READ_FLD S/R (needed if using SingleCpuIO):
622        (no BEGIN_MASTER/ END_MASTER around the call, but inside MDSIO S/R.
623      - barrier before and after reading.
624      - stop if other than master is calling MDS_WRITELOCAL (if #undef IO_THREAD_SAFE)
625      - avoid using MDS_WRITELOCAL for LAND pkg output.
626      - new S/R AIM_WRITE_PHYS (replaces AIM_WRITE_LOCAL) to write AIM physics
627        common-block variables ; Allows multi-threading with master-thread IO.
628    o change default MAX_NO_THREADS from 32 to 4 ;
629      and stop cleanly when MAX_NO_THREADS is too small.
630    o add S/R BAR_CHECK to check multi-threaded barrier synchronization
631    
632    checkpoint58m_post
633    o add a Non-Hydroatatic test (with 3-D Coriolis, NHMTerms, biharmonic Visc.
634       and side-drag) on CS-grid : global_ocean.cs32x15.viscA4
635    o make "tutorial_global_oce_latlon" from standard "global_ocean.90x40x15" exp.
636       keep global_ocean.90x40x15 (for AD testing) with former secondary test
637       (".qshyd") as the main test (mv output.qshyd.txt to output.txt)
638    o CVS modules: update MITgcm_verif_basic; remove MITgcm_verif_ocean & _verif_atmos;
639        add MITgcm_tutorials (= code + all the tutorials)
640    o ecco, option to compute cost for total ssh (mean+anom)
641    o consistent with addition of ptracer and ssh in pkg/profiles
642    o profiles: adding ptracer and ssh
643    o testreport: change multi-test output-file name
644      (from output.txt.{name} to output.{name}.txt)
645    o profiles: now ok for mutli-tiles case
646    o seaice: add 4 parameters for different advection schemes for area,
647      (effective) seaice thickness, enthalphy, and snow height. Their default
648      is the standard parameter SEAICEadvScheme
649    o calc_gw:
650     - add cosFacU in zonal viscous flux (harmonic.visc.).
651     - put back side-drag (call new S/R MOM_W_SIDEDRAG) and output.txt.
652       of tutorial_plume_on_slope.
653    o obcs_calc.F : fix index Pb in OBSeta & OBNeta (Thanks to Gianmaria).
654    o calc_gw: true flux-form, account for horizontal grid spacing.
655      update rotating_tank results, but not plume_on_slope (affected at
656      truncation level, 11 digits).
657    
658    checkpoint58l_post
659    o calc_gw:
660     - take bi,bj loops outside calc_gw to fix Pb with local array KappaRU,V
661     - remove side-drag for now (need to fix it); update plume_on_slope results.
662     - fix for partial-cell & non-uniform dz; update plume_on_slope results.
663    o commit code to make SST/SSS weights spatially variable
664      (based on either variable in-situ or variable initial T/S weights)
665    o pkg/ecco:
666      * commit code to relax deviations of xx_theta, xx_salt to 5*sigma,
667        now based on horizontally varying weights wthetaLev, wsaltLev
668      * cost_averagesflags now returns year indices in addition to day, month
669      * sflux balance is performed on annual basis
670        (sflxumm, sfluxmm2, bal_sfluxmm)
671      * for SSH anomaly, separate more cleanly contrib from T/P, ERS, GFO,
672        including separate counting and multipliers
673    o pkg/rbcs
674      * add all necessary infrastructure for pkg/rbcs levN adjoint checkpointing
675    
676    checkpoint58k_post
677    o testreport:
678     - always build in dir. "build" (if not there, mkdir build instead of building
679       & running in input)
680     - run in dir run (if it exists), in build otherwise.
681     - call prepare_run (if input/prepare_run exists)
682     - run multi-threaded test (with new option: "-mth") if file input/eedata.mth exists.
683    o pkg/exf modifications to interpolation and rotation routines for more
684       reasonable treatment of North Pole singularity: for tracers North Pole
685       value is set to northernmost zonal-mean value, for zonal velocity it is
686       set to zero, and for meridional velocity it is set to northernmost value.
687    o pkg/exf/exf_check_range.F
688     - add tile index to diagnostics and move stop statement to the very
689       end of the routine.
690    o pkg/diagnostics: (diagnostics_main_init.F)
691      define title of isomorphic variables according to the current config.
692    o pkg/thsice with pkg/seaice dynamics:
693    - fix domain of computation (interior only, required for exf) and do exchanges
694    - seaice-dynamics forcing: add atmospheric and seaice loading to SSH gradient
695    o towards a standard way of dealing with multi-threading in MONITOR
696      and ${PKG}_MONITOR (all except ptracers_monitor) subroutines.
697    o Pass variable viscosities (vertical and horizontal, e.g., KPP or Leith)
698       to W momentum equation in nonhydrostatic and quasihydrostatic runs.  
699    o make exf_monitor & seaice_monitor independant of the main (dynamics) monitor.
700    o pkg/seaice: fix SEAICEuseEVPpickup parameter (put it in a commom block)
701    o generic_advdiff: DST advection S/R : use local copy of velocity to compute CFL
702       (problems ? with gradient check in bottom_ctrl_5x5 adjoint test)
703    o tracer advection:
704     - clean-up and simplify calc_common_factors.F
705     - make a local copy of velocity and pass it (as u,v,r_Trans) to DST tracer
706       advection subroutine (but still not used within DST advection S/R)
707    o rename pkg aim_ocn_coupler to atm_ocn_coupler (later on, will be used without aim)
708    
709    checkpoint58j_post
710    o new driver S/R: LOAD_FIELDS_DRIVER to load external forcing fields
711      from file (collects calls previously in FORWARD_STEP)
712    o move call to SEAICE_MODEL from FORWARD_STEP to DO_OCEANIC_PHYS
713    o adjoint store dir. adjusted accordingly
714    o genmake2
715      replace target "ad_taf" by $(EXE_AD) ; add $(EXE_AD) to the make CLEAN list.
716    
717    checkpoint58i_post
718    o pkg/seaice: add parameter that allows to scale/turn off effect of seaice
719      on wind stress (SEAICEstressFactor defaults to 1.)
720    o Total number of Timers is finite (<=40): comment out 2 non-essential one
721      in the_main_loop.F to avoid Pb (e.g., when running fizhi test)
722    o vector_invariant: fix highOrderVorticity(=4.th.Order) advection
723      on CS-grid: no longer loosing mass.
724    o exf & curvilinear-grid: no longer modify longitude xC & xG.
725    o pkg/ggl90: fix sloppy output and fix a bug
726    o pkg/seaice: added SEAICEuseEVPpickup parameter
727      - Set to false in order to start EVP solver with
728        non-EVP pickup files when using SEAICEuseEVP
729      - fix sign error in diffusion in seaice_calc_rhs
730    
731    checkpoint58h_post
732    * Modifications for bottom topography control
733      o replace hFacC by _hFacC at various places
734      o replace ALLOW_HFACC_CONTROL by ALLOW_DEPTH_CONTROL
735      o add non-self-adjoint cg2d_nsa
736      o update autodiff support routines
737      o re-initialise hfac after ctrl_depth_ini
738      o works for 5x5 box, doesnt work for global_ocean.90x40x15
739    * Adding verification for 5x5 box (4-layer) bottom topography control
740    
741    checkpoint58g_post
742    o pkg/diagnostics: implement "periodic averaging diagnostics" (e.g.,
743       used for mean seasonal cycle, mean diurnal cycle); add an example
744       in verification/global_ocean.cs32x15/input.thsice/data.diagnostics
745    o pkg/ggl90:
746      - add parameter (minimum surface kinetic energy)
747      - fix bug (avoiding division by zero)
748    o couple pkg/thsice to pkg/seaice:
749      - modify advection in seaice to accomodate new scalar fields to be advected
750      - only muliDimAdection scheme work with seaice/thsice
751      - mapping of thsice-variables to seaice-variables, back and forth
752      - does not break the verification experiments, but does not give the
753        desired results either
754    o pkg/seaice
755      - make (default) second order advection a bit less confusing?
756    
757    checkpoint58f_post
758    o couple pkg/thsice and pkg/exf (as a preparation for coupling pkg/thsice
759      to pkg/seaice):
760      - new routines thsice_map_exf and thsice_get_exf provide the interface
761      - add an additional formal parameter to thsice_solve4temp
762    o pkg/exf:
763      - add new fields wspeed, snowprecip (to be able to couple to thsice)
764      - correct Stefan-Boltzmann constant
765      - new parameter for longwave surface emittance
766      - separate some stuff from exf_bulkformulae into new routines  
767        exf_radiation, exf_wind
768      - add new parameters and constants: longwave emissivity for ocean, ice
769        and snow, evaporation parameters over ice
770      - decouple wind/stress computation from ALLOW_BULKFORMULA: always compute
771        either wind from stress or stress from wind
772    o pkg/thSIce:
773    - split thsice_step_fwd.F in 2 S/R: thsice_step_temp.F & thsice_step_fwd.F
774    - put i,j loops inside S/R: THSICE_ALBEDO, THSICE_SOLVE4TEMP, THSICE_EXTEND
775       and THSICE_CALC_THICKN
776    - for now, call to THSICE_GET_BULKF remains inside i,j loops.
777    - add CPP option: ALLOW_DBUG_THSICE and header file THSICE_DEBUG.h
778      to make debugging easier.
779    - affects results (@ truncation level) of global_ocean.cs32x15.thsice: update output
780    o pkg/bulk_force:
781      - clean-up comments and parameters ;
782      - add new Bulk-Formulae from Large and Yeager, 2004, NCAR/TN-460+STR ;
783    o fix bug in aim+thsice albedo: snow & ice thickness arguments were switched;
784      generate new output for test-experiment: aim.5l_cs.thSI
785    o results_ad : rename "output.txt_adm" to "output_adm.txt" and change
786      testreport accordingly
787    
788    checkpoint58e_post
789    o SEAICE_CGRID adjoint done
790    o R_STAR adjoint implemented.
791      * Seems to just work (based on global_ocean.90x40x15/code_ad_nlfs/ )
792      * need to sort out init. of h0facc, etc.
793    o Make pkg/profile fully independent of ecco,cost, etc. stuff
794      to be able to use it in pure forward.
795    
796    checkpoint58d_post
797    o upgrade simple test-experiment to tutorial example:
798     step.1: duplicate the experiment and (step.2) will remove the old copy.
799      tutorial_barotropic_gyre      <- copy of exp0     (R1:barotropic_gyre_in_a_box)
800      tutorial_baroclinic_gyre      <- copy of exp1     (R1:baroclinic_gyre_on_a_sphere)
801      tutorial_global_oce_latlon    <- empty for now    (R1:global_ocean_circulation)
802      tutorial_global_oce_biogeo    <- copy of dic_example
803      tutorial_deep_convection      <- almost like exp5 (R1:nonhydrostatic_deep_convection)
804      tutorial_plume_on_slope       <- copy of plume_on_slope
805      tutorial_tracer_adjsens       <- copy of carbon   (R1:tracer_adjoint_sensitivity)
806      tutorial_global_oce_optim     <- empty for now (David ?)
807      tutorial_global_oce_in_p      <- copy of global_ocean_pressure
808     some tutorials (R1) were already checked-in under tutorial_examples in release1_branch
809    o correct a sign problem in cost_scat.F
810    o obcs and ptracers: fix boundary conditions for advections schemes
811      with larger stencil
812    o thsice adjoint: start
813    o mom_vecinv: add ISOTROPIC_COS_SCALING flags to mom_vi_hdissip for
814      completeness
815    o mom_fluxform: fixing the mutual use of ISOTROPIC_COS_SCALING
816      and COSINEMETH_III, add comments in default CPP_OPTIONS.h
817    o ptracers adjoint:
818      * avoid extensive recomputatations
819      * fix missing re-init. of gptr (missed by TAF)
820    o obcs: add a flag (OBCSprintDiags, defaults is true) that allows
821      me to turn off the excessive output to STDOUT that this package produces
822    o move NH metric terms & 3.D Coriolis S/R to pkg/mom_common
823      and add those terms in Vector-Invariant formulation.
824    o in ctrl pkg, if ALLOW_CAL, use monthly mean controls
825      if the control period (xx_hfluxperiod etc) is 0
826    o in profiles pkg, clean routines and fix details
827    o in ecco pkg, reading ssh data:
828      fix problem in case the model does not start at iter0=0
829    o fix mnc-pickup/restart for ptracers
830    o new package prifiles:
831      code to compute profile-based cost by Gael Forget
832      (modifs in ecco, ctrl, autodiff)
833    o Benign bug fix in initialization (spotted by M. Mazloff) of
834      ctrl_set_globfld_xz.F ctrl_set_globfld_yz.F
835    
836    checkpoint58c_post
837    o adjoint: finish NLFS adjoint and provide reference output in
838      verification/global_ocean.90x40x15/results_ad_nlfs
839    o seaice: add an EVP solver following Hunke and Dukowicz (1997) and the
840      documentation of CICE. Turn on by defining SEAICE_ALLOW_EVP in
841      SEAICE_OPTIONS.h and SEAICEuseEVP=.true. in data.seaice. Works only
842      with SEAICE_CGRID defined.
843    o move calendarDumps from "data" to "data.cal" and clean-up the code
844      with a simple call to pkg/cal S/R: CAL_TIME2WRITE
845    o add useEXF & useCAL flags (for now, set in hard-coded way)
846    o add S/R to compute NH-metrics terms & Coriolis f' in vertical momentum
847      (were missing in NH mode, and wrong in quasihydrostatic mode).
848      waiting for Chris updated version of calc_gw to add those CALLs.
849    o fix bug in quasihydrostatic S/R ;
850      add a test for this option: global_ocean.90x40x15.qshyd
851    o new S/R "SET_PARMS": set parameters that might depend on the use of some pkgs.
852      (called from INITIALISE_FIXED, after INI_PARMS & PACKAGES_READPARAMS)
853    o add on/off flag useOffLine for package OFFLINE
854    o seaice:
855      - modify advection so that it works also on the C-grid
856      - extend loop ranges in seaice_lsr and seaice_dynsolver; fixes
857        problem in multi-tile runs with C-grid
858      - add flags for clipping ice velocities and/or masking solver forcing
859      - fix drag (ocean on ice) formulation and a bug that caused noise in the
860        C-grid solver
861      - added a few comments to seaice_diffusion.F
862      - separate C-grid and B-grid versions more cleanly (UVM and seaiceMaskU/V
863        are now exclusive)
864      - add a new ocean-ice stress coupling method (Hibler and Bryan, 1987) which
865        required re-ordering the code a little:
866       + make DAIRN global variable (defined in SEAICE)
867       + move computation of the viscosities eta and zeta into a new separate
868         routine (because I need to recompute them in seaice_ocean_stress.F)
869    
870    checkpoint58b_post
871    o AIM+thSIce: fix sign of Short-Wave through the Ice ;
872      update output.txt of exp. aim.5l_cs.thSI
873    o various mnc cleanups and improvements:
874      + shrink lookup tables by factor of ~4
875      + better error reporting when running out of lookup space
876      + able to handle longer path/file names (up to 500 chars)
877    o adjoint:
878      - Another overhaul of store dirs. for NLFS to eliminate  "hidden" recomputations.
879      - TBD: "hidden" mom_vecinv recomp. in dynamics
880    o change forcing_In_AB to affects both T,S forcing and Momentum forcing
881     (allow to differentiate between forcing components using new integer flags:
882      momForcingOutAB=1/0 & tracForcingOutAB=1/0)
883     and add new flag to put Dissipation tendency out of Adams-Bashforth.
884    o ecco
885      - enable trend removal from SSH anomaly obs.
886    o adjoint
887      - a fix for PmEpR when #undef EXACT_CONSERV
888      - fix of "hidden" recomp. in thermodynamics (no TAF warnings)
889      - try to fix "hidden" recomp. in forward_step for NLFS
890        (NLFS seems broken sometimes after I checked it in)
891    o seaice:
892     - add c-grid version of the dynamic solver:
893       + three new routines that are the c-grid substitute lsr, dynsolver
894         and ostres
895       + put a few fields that were local to dynsolver into global common
896         blocks, so that I can move the computation of stresses etc into
897         seaice_lsr (saves coding but may break the adjoint).
898     - replace more hardwired parameters by runtime parameters
899     - add ice masks that mask the rhs of the implicit solvers where there
900       is no ice (commented out in seaice_dynsolver, because i am not sure
901       if this works properly), eventually this should replace the clipping
902       of ice velocities in seaice_dynsolver to +/-40cm/s.
903    o remove the BUILD_INFO.h include from CPP_EEOPTIONS.h and explicitly
904      include it only where its needed
905    o move balancing of fluxes before the call of external_forcing_surf
906    o seaice:
907      - correct units of turning angles (now they are really in degrees)
908      - move computation of GWATX/Y out of main routine into dynsolver
909      - initialize GWATX/Y in seaice_init
910    o Apply mask on Fresh-Water flux (needed for SSH forcing).
911      update output.txt of exp. global_ocean_ebm & cpl_aim+ocn (affects cg2d residual)
912    o seaice: add runtime flags for turning angles (default to zero)
913    o Adding runtime parameter to exf/, ctrl/, to remove on-the-fly global mean
914      and trend from exf forcing and ctrl control adjustments
915    o fix variable aliasing in gad_calc_rhs that cannot be handled by TAF
916      (since checkpoint57x_post)
917    o change the default rotation period to 86164.s = the Earth rotation
918    o 1rst implementation of Implicit IGW using the 3-D solver (use3Dsolver=T)
919      and based on a reference stratification. Tested within hs94.cs-32x32x5.
920    o seaice advection: add code for choosing between the default (2nd order
921      central differences) and multiDim advection schemes provided by
922      pkg/generic_advdiff
923    o seaice:
924      - removed all references to SEAICE_GRID.h fields from
925        dynsolver, advect, diffus, lsr, without changing the results of lab_sea
926        (cubed-sphere configuration will change a little)
927      - grid computations in seaice_init are obsolete now.
928      - cleaned up code a little so that is easier to read (hopefully).
929      - added new (better?) discretizations of default advection and diffusion
930        (turn on with SEAICEuseFluxForm)
931      - replace 1 in 3d global fields by kSurface in growth.F
932      
933    checkpoint58a_post
934    o seaice:
935      - bug fix in advect.F
936    o shelfice:
937      - separate shelfice load anomaly from pload (breaks with time
938        dependent forcing), => introduce constant field shelficeLoadAnomaly.
939        Its default is 0., but it may be computed more cleverly from (unknown)
940        t- and s-profiles (tRef, sRef) and actual EOS. For now this has to be
941        done offline. A good approximation of the pressure load anomaly is
942        necessary to avoid large initial adjustment processes underneath
943        deep-reaching shelfice.
944      - small fix in ISOMIP shelfice_thermodynamics
945      - add more sophisticated thermodynamics of Hellmer (1989), this is
946        now the default
947      - give a few constants more intuitive names
948    o add code to balance EmPmP and Qnet at the end of do_ocean_physics. Useful
949      if bulk formulae are used in long integration (especially EmPmR). Turn
950      on with balanceEmPmR = .true. or balanceQnet = .true. in data, PARM01
951      if balancePrintMean, the imbalance that is substracted is printed to
952      STDOUT.
953    o fix bug (typo) in obcs_apply_eta.F
954    o add a new package shelfice which enables us to model the circulation
955      underneath shelf-ice with draughts of hundreds of meters.
956     - works
957     - to do: + include improved thermodynamics
958              + check whether kSurfC (from model/inc/SURFACE.h) can be used
959                instead of new field kTopC
960              + can we use topoFile, Ro_surf and existing code in ini_depth.F
961                instead of new field R_shelfIce and new code in ini_depth.F
962                and ini_mask_etc.F?
963              + adjust vertical mixing schemes?
964    o seaice pkg:
965     - add a cpp-flag to include a simple formula for a salinity dependent
966       freezing point of sea water at the surface
967     - change the contents of SEAICE_TEST_ICE_STRESS_1 so that zonal and
968       meridional stresses are now different (and hopefully correct)
969    o AIM pkg: change threshold on large-scale condensation to conserve Heat.
970       update results of aim.5l_LatLon test ; fix title & units of AIM diagnostics
971       and  change 3 diagnostics names (OSR,OSRCLR,KM -> TSR,TSRCLR,DRAG)
972    o pkg/diagnostics: add options and parameters for regional-statistics
973       diagnostics ; define regions by reading a region-mask from a file
974       (might add other options later)
975    o pkg/bulk_force:
976     - add option and parameters to use AIM surface-flux formulae.
977     - Change loading part: S/R BULKF_FIELDS_LOAD only take care of bulkf_fields ;
978       others forcing fields (defined in PARM05, parameter file "data") are loaded
979       from S/R EXTERNAL_FIELDS_LOAD, as usually (with useBulkforce = T or F).
980     - initialise all bulkf_fields in bulkf_init.F ; do in-lining of exf_bulkcdn.F
981     - use the right EXCH call for uwind,vwind (to work on CS-grid).
982     - re-arrange header files (move parameters from BULKF.h to BULKF_PARAMS.h)
983       and parameters (note: calcWindStress replaces .NOT.readwindstress).
984     - cleaner interface with pkg/thSIce (new S/R THSICE_GET_PRECIP).
985    
986    checkpoint58
987    o add "--embed-source" option to genmake2 which, when the supporting
988      tools can be compiled (as determined by genmake2) will turn on the
989      embed_files package which then embeds the entire MITgcm source code
990      (*.[fFhc] + Makefile) used for the build within the executable
991      - requested by CNH but off by default
992      - adds a paltry <9MB to the mitgcmuv executable in most cases
993      - only writes the output when useEMBEDSRC in eedata is true
994    o clean up 3-dim. relaxation codes:
995      * Fix I/O inconsistency in pkg/rbcs: replace precFloat32 by readBinaryPrec
996      * Remove 3-dim. relaxation code from pkg/exf (now use only pkg/rbcs)
997      * Thanks to Tom Haine for testing!
998    
999    checkpoint57z_post
1000    o make CG3D solver compatible with Free-surface at k > 1 (p-coordinate):
1001      affects output (@ truncation level) of exp. plume_on_slope ; updated.
1002    o fix the pickup behavior for obcs in combination with ptracers
1003    o fix a bug in ptracers_external_fields_load
1004    o no AB-2 at the first iteration for Gw (consistent with Gu,Gv,Gt,Gs ...)
1005      affects results of NH experiments (but all our NH tests have Gw[it=1]==0 !!)
1006    o transfered surface NH pressure to eta field (if exactConserv).
1007    o gmredi: fix bugs in slope tapering ldd97 (depthZ had the wrong sign)
1008         and update lab_sea output.txt file.
1009    o completing 3-dim. relaxation code: additional term
1010         1/tau*( theta(i,j,k) - thetaStar(i,j,k) )
1011      in S/R EXTERNAL_FORCING_T (file external_forcing.F)
1012      * At compile time, in "EXF_OPTIONS.h" set
1013          #define  ALLOW_CLIMTEMP_RELAXATION
1014          #define  ALLOW_CLIMSALT_RELAXATION
1015      * At runtime in "data", under &PARM03 set (e.g., units in seconds)
1016          tauThetaClimRelax3Dim = 15552000.0,
1017          tauSaltClimRelax3Dim  = 15552000.0,
1018      * 3 cases:
1019          1) Use a constant-in-time 3-dim. field
1020          2) Provide 12 3-dim. fields corresponding to Jan., ... , Dec.
1021          3) Real-time relax. to time-evolving prescribed field
1022    o Adding Laplacian-type smoothness constraint on
1023      initial and boundary (forcing) controls (ic, bc)
1024      * enable at compile-time via
1025        ALLOW_SMOOTH_IC_COST_CONTRIBUTION, ALLOW_SMOOTH_BC_COST_CONTRIBUTION
1026      * enable at run-time via mult_smooth_ic = 1, mult_smooth_bc = 1
1027      * Absolute scale somewhat unclear so far
1028      * no area weighting was included since no other cost term does so far
1029    
1030    checkpoint57y_post
1031    First step for a NLFS adjoint
1032    o initially suppress rStar (new flag DISABLE_RSTAR_CODE)
1033    o new init. routines for calc_r_star, calc_surf_dr
1034    o still need to deal with ini_masks_etc
1035    o testreport seemed happy
1036    checkpoint57y_pre
1037    
1038    o obcs: always reset wVel & eta (to zero or prescribe it) at the OBs.
1039    o add new package rbcs (for relaxing ptracers at boundaries/depth/surface etc)
1040    o add new offset feature to offline pkg (plus minor cleanup)
1041    o cfc fixes for final year of integration
1042    o clean up GCHEM_OPTIONS.h/DIC_OPTIONS.h (all options should
1043      be in GCHEM_OPTIONS).
1044    
1045    checkpoint57x_post
1046    o fix testreport Pb in multiple test experiment.
1047    o cleanup our namelist syntax in verification:
1048      - make it more F95 standards compliant (some work still needed)
1049      - allows the vast majority of our tests to work with gfortran
1050    o Non-Hydrostatic:
1051     - put all NH variables (formerly in DYNVARS.h & GW.h) in NH_VARS.h
1052     - fix exchange calls for CS-grid using the new EXCH_S3D_RL.
1053    o Allow to apply AB on T,S rather than on AB(gT,gS):
1054     - implemented within #ifdef ALLOW_ADAMSBASHFORTH_3
1055     - use the same arrays (gtNm,gsNm) to hold tracer field at previous
1056       time-steps (if AB(T,S)) and tendencies (if AB(gT,gS)).
1057     - need a "clever" read_pickup to restart from the other AB formulation
1058    o move local commom bloc /GlobalLo/ (used for singleCpuIO) in EESUPPORT.h
1059    o remove some unused variables (reduces number of compiler warnings)
1060    o adjoint
1061      * Disable useVariableViscosity for adjoint for time being
1062        (there are a number of extensive recomputations)
1063      * Initialize certain variables needed for adjoint
1064    
1065    checkpoint57w_post
1066    o pkg/mdsio: use MAX_LEN_FNAM (instead of hard coded 80) for file-names
1067                 fix the singleCpuIO RS version of MDSWRITEFIELD
1068       and add a WARNING if using globalFiles=T with multi-processors.
1069    o write grid-file(s) in only one format (MDS or MNC): default=MNC (if
1070      using MNC); can force MDS output by setting writegrid_mnc=F in data.mnc
1071    o tracer advection scheme:
1072      add DST-2 (=Lax-Wendroff) & 1rst order upwind schemes (the way to get
1073       those 2 schemes before, changing GAD_FLUX_LIMITER.h + to recompile,
1074       was not very convenient).
1075      add implicit version for DST-3 & DST3_Flux_Limit vertical advection;  
1076       (further tests needed for the implicit DST & Flux-Limiter schemes).
1077    o PTRACERS: added namelist parameter PTRACERS_ref in analogy to tRef
1078      and sRef for convenience, handy, when you want to initialize
1079      ptracers in a large domain with a constant non-zero value. Also,
1080      untangle ptracers_init.F a little.
1081    
1082    checkpoint57v_post
1083    o change dome exp. to use variable viscosity in side-drag terms.
1084    o remove all the files from the cfc_offline test since they are now
1085      incorporated into tutorial_cfc_offline which has been producing
1086      identical results for a few days of testing
1087    o add new parameter: sideDragFactor to enable half-slip-side BC
1088      and change side-drag S/R to use viscosity from mom_calc_visc
1089      (can switch back by setting sideDragFactor=0.); affects results at
1090      truncation level; regenerate output for exp.: global_ocean.cs32x10(x3),
1091       global_ocean_ebm, global_ocean_pressure, matrix_example & MLAdjust(x5).
1092    o vorticity & strain are now computed without masking, to account for
1093      no-slip-side BC in variable viscosity calculation ; mask is applied
1094      anyway later on, before computing advection/coriolis terms.
1095    o modify exp4 to test new obcs support for reading from external files
1096      and for passive tracers
1097    o fix behavior of ptracers_monitor when monitor output is written to a
1098      netcdf-file; still not independent of monitor.F (writes in the same
1099      file).
1100    o change default value of tRef (put a uniform, meaningful value for ocean
1101      & atmos) and initialize sRef (was missing, as Martin mentioned).
1102    o Redefine viscC?Leith*.  Change the coefficients of Leith viscosity
1103      to be proportional to enstrophy dissipation length.  Thus,
1104       viscC?leith?_new=pi*(viscC?leith?_old)^(1/3)
1105      This is now consistent with Smagorinsky and with the manual.
1106    
1107    checkpoint57u_post
1108    o OBCS and PTRACERS: add open boundary support for passive tracers
1109      - either use homogenous (pseudo) v.Neumann conditions or prescribe
1110        OB-values from file; this is not different from the way theta and salinity
1111        are treated
1112      - however, Orlanski-radiation conditions are not supported, and the model
1113        will stop if you use pTracers and Orlanski at the same time.
1114      - beefed up the rountine obcs_external_fields_load: now only those open
1115        boundary values are overwritten with values from files for which there
1116        are really files, otherwise the OB-fields remain untouched. This makes
1117        it possible to use different OBs at different ends of the domain (as
1118        with EXF)
1119    o reduce number of exch calls in shap_filt (s2).
1120    o CS-grid: fix divergence contribution to Leith viscosity. Affects (@
1121      truncation level) 4/5 MLAdjust test results (11&12 digits match).
1122    
1123    checkpoint57t_post
1124    o test biharmonic viscosity + no-slip with exp: global_ocean.cs32x15.viscA4
1125    o finish adding brackets (coriolis S/R, vecinv) in multi-terms sum to get
1126      same truncation, independent of the face number: affects affects several
1127      test. exp.: Update global_ocean.cs32x15 (+.thsice) & MLAdjust (all 5).
1128    o fix bug in mom_v_sidedrag (biharmonic viscosity was counted 2 times);
1129      note that biharmonic viscosity + no-slip was not tested in any experiment.
1130    o fix bug in non-linear free-surf side-drag ; generate new output for
1131      global_ocean.cs32x15(+.thsice) & global_ocean_pressure.
1132    o make mnc honor the writeBinaryPrec flag for most kinds of output
1133    o eesupp: split EEPARAMS into EESIZE/EEPARAMS and add a vector global sum
1134    o minor change in averaging W (mom_vi_?_vertshear.F) that affects truncation
1135      error; update output from global_ocean.cs32x15(+.thsice) & MLAdjust (all 5).
1136    o add brackets in multi-terms sum to get same truncation, independent of
1137      the face number (manage to get exactly same value of gU,gV at the cs-edge)
1138      affects several test. exp. Update global_ocean.cs32x15 (+.thsice).
1139    o Clean, new version of mom_calc_visc.  Adds a new feature, viscAhRemax
1140      and viscA4Remax, which allow one to limit the minimum viscosity by specifying
1141      a maximum grid-scale Reynolds number.  Also, changes all length calculations
1142      in the case of grid anisotropy to geometric mean of dx**2 and dy**2.
1143      Suggested values of viscosity parameters found in mom_calc_visc.
1144      Many new viscosity diagnostics available.
1145    
1146    checkpoint57s_post
1147    o Add clearing-house for viscosity calculations, mom_calc_visc and
1148      correct numerous bugs in LeithD and Smagorinsky discretizations.  
1149      mom_calc_visc now allows for Smagorinsky, Leith and LeithD to be
1150      used simultaneously, and to be used in mom_vecinv and mom_fluxform.
1151      Mom_vecinv can be used with standard viscous calculation (mom_vi_hdissip.F)
1152      and with Strain-Tension viscous term calculation (mom_hdissip.F).  
1153      The Strain-Tension form is now called with useStrainTensonVisc=.true.
1154      ViscAhStrain and viscAhTension are now retired.
1155    o diagnostics "VISCAHD" & "VISCA4D" replace "VISCAH" & "VISCA4".
1156    o In response to JMC's bug report, genmake2 now ignores any soft-links
1157      that it finds in the *current* directory when searching for files.
1158      Soft-links found in any other source directories will still work as
1159      they did before.
1160    o add HAVE_SETRLSTK define and useSETRLSTK flag (eedata) which calls
1161      a C routine to unlimit the stack size
1162    o mnc-ify pkg/aim snapshot vars
1163    o mnc-ify pkg/land as requested by Daniel
1164    o various changes to mnc including:
1165      - all files use the new "BASENAME[[.ITER].{t|f}NUM].nc" format
1166      - output can now be grouped so that all files within a group
1167          change the ITER portion of their names in lock-step together
1168      - can now read ("global") PER-FACE (in addition to PER-TILE) files
1169          and works with both EXCH1 and EXCH2 (but needs more testing)
1170      - writing works for all verification test cases w/ g77 on Linux
1171    
1172    checkpoint57r_post
1173    o make MNC variable initialization happen earlier
1174    o add diagnostics for (almost) each term of the momentum Eq.
1175    o remove SST,SSS,UVEL_k2,VVEL_k2 diagnostics.
1176    o move pkg timeave out of pkg-groups "oceanic" & "atmospheric" (pkg/pkg_groups)
1177    o remove MINIMAL_TAVE_OUTPUT option ;
1178      add "dumpInitAndLast" to replace "nodumps" (and MINIMAL_TAVE_OUTPUT).
1179    o move some basic S/R (used elsewhere in the code) from pkg/mdsio to eesupp/src
1180      allows to compile without pkg/mdsio (& test successfully hs94.1x64x5)
1181    o add MNC output for adjoint of EXF (adexf), SEAICE (adseaice)
1182    o add time-dependent SST, SSS control
1183    o cost terms in ecco/ modularized (new cost_generic.F)
1184    o cost_averages routines are modularized (new cost_averagesgeneric.F)
1185    o new infrastructure for seaice model vs. obs misfits in seaice/
1186      * driver from the_main_loop.F is seaice_cost_driver.F
1187      * first term is AREA vs. SMR observation misfit (ALLOW_SEAICE_COST_SMR_AREA)
1188      * gradient check in Exp. 6a of natl_box_adjoint/
1189    o natl_box_adjoint input_seaice for Lab. Sea now available online via wget
1190      (see README file)
1191    
1192    checkpoint57q_post
1193    o fix initialisation Pb in calc_gw (get NANs in exp5 with g77)
1194    o fix annoying months-old bug in mnc/mdsio output for seaice pkg
1195      - bug was reported by Jean-Michel and Ian Fenty
1196    o fix initialization Pb in AIM-Ocean coupled model (aim_sice2aim.F)
1197      update exp. cpl_aim+ocn output.
1198    o Implement 4-level checkpointing: AUTODIFF_4_LEVEL_CHECKPOINT
1199      Needed for high-res. runs with large global files
1200      to be able to limit tapelev size
1201    o Changed some tests for adjoint:
1202      * carbon/ now tests AUTODIFF_2_LEVEL_CHECKPOINT
1203      * natl_box_adjoint/code_bulk/ tests AUTODIFF_4_LEVEL_CHECKPOINT
1204      * global_ocean.90x40x15/ back to default 3-level checkpointing
1205    o Modifications to enable scripted COMMON to MODULE conversion
1206      * verification/OpenAD/code/ has necessary scripts and description;
1207      * converts, compiles and runs successfully;
1208    
1209    checkpoint57p_post
1210    o reading of delXfile & delYfile moved from ini_parms.F to ini_grid.F
1211    o move ${PKG}_MNC_INIT from ${PKG}_READ_PARAMS to ${PKG}_INIT_FIXED
1212      (already the case for some pkgs, including recent MNC_init, e.g. thsice)
1213    o call CALC_GW from DYNAMICS (instead of from FORWARD_STEP)
1214    o Dissipation & phiHyd gradient are always added to gU,gV in timestep.F
1215      (was already the case for dissipation with mom_vecinv,
1216       and also the case for grad.PhiHyd when staggered-timeStep)
1217      This will allow to put dissipation out-off the AB time-stepping.
1218     Unfortunately, affects truncation error. Update output of exp. that "fails"
1219      (cg2d matching number) and leave the others for later: front_relax(10),
1220      global_ocean_pressure(10),ideal_2D_oce(10),internal_wave(9),lab_sea(12),
1221      matrix_example(7!),natl_box(12),plume_on_slope(11),vermix(12x3,11x2).
1222    
1223    checkpoint57o_post
1224    o fix MNC/MDSIO flags in PTRACERS so that (1) it works, and
1225      (2) its ready to be documented during the 20050801 DocFest
1226    o MNC-ify the gmredi package -- tested and works w/ and w/o mnc
1227      for ideal_2D_oce and lab_sea on linux_ia32_g77
1228    o set to #undef CTRL_SET_OLD_MAXCVARS_30
1229      in global1x1_tot/code_seaice_adj to access indices 32, 33
1230      (worth another tag)
1231    
1232    checkpoint57n_post
1233    o adding precip control xx_precip 32
1234    o adding swflux control xx_swflux 33
1235    o Replacing 10 forcing penalty cost routines by 1 generic.
1236    o Implementing partitioning in time-mean and variable adjustment
1237      for atmos. state.
1238    o Time-mean constant error is now read in data.ecco (instead of hard-coded)
1239    o in natl_box_adjoint:
1240      * updated exp 1 to 10
1241        (but does not have time-mean vs. variable split results yet)
1242    o updated global1x1/*_seaice_adj/
1243      to incorporate latest changes
1244    o enable useSingleCpuIO for mdsio vector routines
1245      (applies in particular to tapelev I/O)
1246    o removed inefficient K-loop in all active_file*control*.F
1247    
1248    checkpoint57m_post
1249    o re-arrange exp. adjustment.cs-32x32x1 (adjust_nlfs.cs-32x32x1 merge into)
1250      and advect_cs (use EXCH-2 and standard cs-32 grid files).
1251    o pkg/exch2: filling of face-corner halo regions is optional
1252      (ifdef W2_FILL_NULL_REGIONS) and is turned off by default.
1253    
1254    checkpoint57l_post
1255     tag before updating tutorials (pre-release-2)
1256    o add cos & sin of grid-direction orientation angle (curvilinear grid only,
1257       for output and interpolation of input fields onto model grid)
1258    o fix radius in mom_v_metric_cylinder.F (wrong by dy/2).
1259       Affects results of exp. rotating_tank ; update output.txt.
1260    o pkg/diagnostics: 2 new S/R to fill a diagnostics using a scaling factor
1261          and taking the square quantity and/or using a fraction-weight field.
1262    o fix aim_diagnostics_init.F mate numbers.
1263    o add mnc output capability to diagnostics/diagstat and update
1264      our cvsignore files for the ACSII output generated
1265    
1266    checkpoint57k_post
1267    o lab_sea now uses diagnostics package and provides a suite of
1268      new EXF diagnostics output.
1269    
1270    checkpoint57j_post
1271    o exf
1272      * bug fix in exf_bulkformulae for psimh (spotted by Eliyahu Biton):
1273        Bracket missing in eqn. for psimh (eqn. 7 of Large & Pond, 1982);
1274        terms -2*ATAN(x) + pi/2 were added to both stable and unstable case.
1275      * extended diagnostics output
1276        - now includes all EXF variables
1277        - hs, hl moved to common block
1278        - separate S/R for diagnostics, called after ctrl vector is added
1279        - name changed for EXFsw -> EXFswnet, EXFlw -> EXFlwnet
1280        - EXFqnet contains true Qnet (i.e. includes qsw)
1281      * updated verif. lab_sea, global_with_exf
1282      * Rearranging hflux (exf_mapfields -> exf_getforcing)
1283        to ensure that diagnostics sees a true EXFqnet
1284    o add matlab scripts for CS-grid vectors (in utils/cs_grid)
1285    o diagnostics pkg: change pointers so that 1 diagnostic can be used
1286      several times with different frequencies.
1287    o mnc-ify the thsice package as requested by Daniel Enderton
1288      - the monitor--MNC output needs work
1289      - many attributes need to be added (most are currently blank)
1290    o mnc-ify theaim_v23 package as requested by Daniel Enderton
1291      - many attributes need to be added (most are currently blank)
1292    o remove "groundAtK1" & "rkFac" (replaced by usingPCoords & -rkSign)
1293    o add Sadourny like discretization to the 4th.O vorticity advection scheme
1294    o fix bug in rStar code (calc_r_star.F) when used with topo/bathy.
1295      update output.txt from: aim.5l_cs (& .thSI), cpl_aim+ocn,
1296         fizhi-gridalt-hs and global_ocean.cs32x15 (& .thsice).
1297    o fix few little things to avoid floating error with -ftrapuv (ifort v9)
1298     (ini_spherical_polar_grid.F, calc_r_star.F, monitor/mon_surfcor.F)
1299    
1300    checkpoint57i_post
1301    o Diagnostics package was changed: diagnostic allocation is now deactivated
1302      by setting an empty file name in the namelist (used to be by setting 0 frequency)
1303    o momentum advection (VI form) options: activate 4th.O vorticity Coriolis ;
1304      add 1rst Order upwind vertical Shear.
1305    o add a quick fix for A/B checkpointing in OFFLINE mode
1306    o add IGNORE_TIME define and -ignore_time option to genmake2 as an
1307      end-run around the C/Fortran linking horror in eesup/src/timers.F
1308    o added pkg/runclock: allows user to terminate run based on wall clock
1309    o added non-hydrostatic scaling parameter: nh_am2
1310    o pkg/my82: futile attempt to make results compiler-independent by adding
1311      some "_d 0", etc. no effect.
1312    o for mnc output, fill the 'T' coordinate var with myTime and create a
1313      separate 'iter' variable for iteration count
1314    o pkg/diagnostics:
1315      add new capability: output of Global/Regional & per-level statistics ;
1316      tested against monitor output (including land & thSIce) on various exp.
1317    o make seaice-pkg I/O type flags (MNC/MDS) more standard.
1318    
1319    checkpoint57h_done
1320      tag after changing user customized files (DIAGNOSTICS_SIZE.h,
1321      data.diagnostics, data.gchem, data.ptracers) is done.
1322    
1323    o pkg/diagnostics: prepare for Global/Regional statistics.
1324      add 2nd namelist in data.diagnostics and update DIAGNOSTICS_SIZE.h
1325    o remove "baseTime" (no used) from arg. list of DIFF_BASE_MULTIPLE
1326      and rename it: DIFFERENT_MULTIPLE
1327    
1328    checkpoint57h_post
1329    o move tIter0 from data.gchem to PTRACERS_Iter0 in data.ptracers
1330    o pkg/diagnostics: change output frequency, now in seconds (instead
1331      of Nb of iterations). This requires to change data.diagnostics.
1332    checkpoint57h_pre
1333    
1334    o in mnc, let the user create the output dir if both mnc_outdir_date
1335      and mnc_outdir_num are false
1336    o add fflags() to pkg/diagnostics which allows one to specify, on a
1337      per-file basis, the file precision [default behavior is unchanged]
1338    o added diagnostics to pkg/kpp, including computation of mixed layer
1339      depth based on a temperature/density criterion
1340    o updated verification/natl_box to test the new pkg/kpp diagnostics
1341    o bugs fixed (with useAbsVorticity=T & with useJamartMomAdv=T)
1342    o test AB-3 code with 4th.Order advection scheme (advect_xy/input.ab3_c4)
1343    o fix mnc flags in pkg/seaice so that they are "owned" by seaice,
1344      not mnc -- this mistake was found by JMC and is now corrected
1345    
1346    checkpoint57g_post
1347    o add Adams-Bashforth 3rd Order time stepping:
1348      - default remains AB-2 (#undef ALLOW_ADAMSBASHFORTH_3)
1349      - not yet implemented with NH, CD_Scheme, pTracers, MNC_pickup ...
1350    checkpoint57g_pre
1351    
1352    o make lambda[Theta,Salt]ClimRelax spatially varying
1353      (default remains spatially uniform constant based on tau)
1354    o added new control variables
1355      * init. uVel, vVel, etanN
1356      * lambda[Theta,Salt]ClimRelax
1357    o separate masks used for ctrl_pack/unpack 'from write_grid' output
1358      (suggested by G. Forget)
1359    
1360    checkpoint57f_post
1361    o add parameter "baseTime" = model base time = time at iteration zero
1362      new function DIFF_BASE_MULTIPLE (replace DIFFERENT_MULTIPLE) to
1363      account for baseTime shift
1364    o move Coriolis arrays from PARAMS.h to GRID.h
1365    checkpoint57f_pre
1366    
1367    o mnc-ifying the seaice package
1368    o introduced an alternative length scale calculation for use in the limiting
1369      maximum viscosity (off by default, see mom_vi_hdissip.F for details)
1370    o S/R ptracers_calc_diff: argument list bug for CALL KPP_CALC_DIFF_S
1371    o added modified Leith scheme with viscosity proportional to grad(Hdiv)
1372      as well as grad(vort3).  Made it compatible with both approximate form
1373      for the cubed sphere and full form of these gradients.  Added flag
1374      useFullLeith to select between approximate and full form.  
1375    o add "d0" in getcon.F to reduce differences between compilers/platforms
1376      update output.txt of exp. fizhi-gridalt-hs
1377    o change port_rand funtion to allow to set the seed.
1378    o fix obscure MNC bug involving conversion between reals and integers
1379      - it caused no problems with certain (eg. gcc, ifc) compilers but the
1380        new version is now more standards-compliant
1381    o adjoint-related modifications
1382      * gad_dst3_adv_?: to be able to use advscheme=30 in adjoint
1383      * gad_calc_rhs: fool adjoint, revert to advscheme=30 in reverse when using 33
1384      * mom_vi_hdissip: to be able to use Leith scheme in adjoint
1385    
1386    checkpoint57e_post
1387    o Adding eddy stress controls a la Ferreira et al.
1388    checkpoint57e_pre (actually was tagged: eckpoint57e_pre)
1389    
1390    o fizhi pkg: fix AtoC and CtoA when called with same input & output array
1391      update output.txt of exp. fizhi-gridalt-hs
1392    o add more "Z" dimensions and associated coordinate vars to MNC
1393    o pkg/exf: added twoDigitYear capability for option useExfYearlyFields
1394    o parameter calendarDumps: when set, approximate months (30-31 days) and years
1395      (360-372 days) for parameters chkPtFreq, pChkPtFreq, taveFreq, SEAICE_taveFreq,
1396      KPP_taveFreq, and freq in pkg/diagnostics are converted to exact calendar
1397      months and years.  Requires pkg/cal.
1398    o diagnostics: add pickup functionality
1399      - off by default for backwards compatibility
1400      - current version only uses MDSIO -- MNC will be added
1401    o allow to use pkg diagnostics for LAND pkg output & Shapiro Tendencies.
1402    o pkg/shap_filt: fix for multi-tiles per face (CS-grid with EXCH2)
1403    
1404    checkpoint57d_post
1405    o pkg/thsice used in the ocean: fix tile Pb related to sIceLoad forcing
1406    o modify verification/ideal_2D_oce so that it tests the creation of mnc
1407      output from the diagnostics package
1408    o temporary fix in EXCH2_UV: add a 3rd call to fix the 24.tiles CS-grid set-up
1409    o make genmake2 more portable by using ".$FS" instead of ".f" for more
1410      of the test compilations (eg. IBM xlf on Mac OSX w/HFS filesys)
1411    o add coordinate variables to the MNC output from the diagnostics package
1412    o change MNC-flags default value: true when useMNC=TRUE
1413    o add a "readgrid_mnc" flag to MNC and give model/src/ini_curvilinear_grid.F
1414      the ability (off by default) to read the grid information using MNC
1415    o lab_sea: use LSR_ERROR=1.E-12 for testing ; update output.txt
1416    o diagnostics: fix a bug (sub-set of levels); keep full precision when averaging
1417    o do snap-shot diagnostics at the middle of the time-interval (instead of
1418      at the end).
1419    o update exp. aim.5l_cs (use default LAND_OPTIONS.h file) and add
1420      new test for AIM with thSIce + slab-ocean
1421    o cpl_aim+ocn test: update output (optfile & default GMREDI_OPTIONS.h)
1422    o move state variable diagnostics to the beginning of the time step ;
1423      (note: still needs some work specially for snap-shot diagnostics)
1424      duplicate & replace UVELVVEL diagnostics with UV_VEL_C & UV_VEL_Z
1425    
1426    checkpoint57c_post
1427    o Change testing option (-ieee) to get closer agreement between g77 & ifort
1428    o generate new output.txt files on faulks with g77 & the new -ieee option
1429    checkpoint57c_pre
1430    
1431    o add "_d 0" in freeze ; change some "FLOAT" to "DFLOAT" and went back (TAF);
1432      update output.txt of exp. global_ocean.90x40x15
1433    o fix in ini_eos.F (one "_d 0" was missing): now g77 & ifc give much closer
1434      results; update global_ocean_pressure & global_ocean.cs32x15 output.txt
1435    o add saltFlux(+File) forcing capability with periodicExternalForcing
1436    o allow to use pkg diagnostics for GM-Redi & ThSIce output
1437    o diagnostics_fill: fill in up to sNx+1 or sNy+1 (if U,V or Z pt) for mnc.
1438    o improvements for the MNC output from DIAGNOSTICS:
1439      - correct handling of the unlimitied dimension
1440      - all dims now have associated coordinate variables
1441      - variables located at U, V, and Corner ("Z") points are now written
1442        with the correct horzontal dimensions (eg. 'Xp1', 'Yp1') so that
1443        *all* data points are output
1444    o added seaice_summary.F and removed obsolete ALLOW_SEAICE's from pkg/seaice
1445    o added pkg/seaice/seaice_monitor.F
1446    o mdsio_readfield.F can now read files visible only to master MPI process.
1447    o pkg/seaice: some test code for ice-modified ocean stress
1448    o exf_getffields interpolation defaults to bilinear for all scalar forcing
1449      fields (remains bicubic for wind velocity and stress).  This avoids, e.g.,
1450      spurious negative numbers for precipitation and humidity.  Will cause
1451      some small numerical differences for integrations using pkg/exf/exf_interp.F.
1452    o pkg/ctrl/
1453      * Add ctrlvec diagnostics in pack/unpack for nondimensional I/O
1454        May be enabled via doPackDiag
1455      *  introduce z-scaling of
1456         + gradient (doZscalePack) and
1457         + control (doZscaleUnpack)
1458    o pkg/mdsio/
1459      * enable useSingleCpuIO for state estimation (ctrl_pack/unpack) mdsio_gl.F
1460      * N.B.: leave tiled I/O for tapelev (i.e. mds...vector)
1461    
1462    checkpoint57b_post
1463    o simplify options in diagnostics_fill arguments (remove weird combinations)
1464    o fix MNC coordinate variables so that they now contain per-face index
1465      values (instead of xC,xG,yC,yG values) when run with EXCH2 since, in
1466      general, EXCH2 grids are only aligned to a "local" coordinate system
1467    o test diagnostics pkg in dic_example (no output) and ideal_2D_oce (with ouput)
1468    o Implement instantaneous output within pkg diagnostics:
1469      setting a negative frequency in data.diagnostics produces
1470     "snap-shot" output (as opposed to time-average if freq > 0)
1471    o move out off EQUIVALENCE all diagnostics that fizhi does not use ;
1472      NOTE: change ptracer diagnostics name: use 2 characters to work with
1473            more than 9 tracers. Add also diagnostics of advect & diffus flux.
1474    o more CF compliance: convert all MNC 'iter' variables to 'T' so that it
1475      becomes the coordinate variable for the 'T' dimension
1476    o add CF-style coordinate variables to MNC
1477      - just a first cut:  numbers are meaningless on the cubesphere and
1478        missing along the T axis but otherwise it works!
1479    o add surface flux diagnostics: TAUX, TAUY, TFLUX, TRELAX, TICE, SFLUX, SRELAX
1480    o pkg/thSIce: read initial state from 6 files ; allow monitor to use MNC.
1481    o add diagnostics of advective & diffusive flux for T & S (pTracers coming soon)
1482      this is based directly on what the model compute, so that the content of
1483      each diagnostics might be affected by switching options (e.g., implicitDiffusion)
1484    o small changes for diagnostics (gad_biharm_?.F, arguments of S/R impldiff.F)
1485    o clean up build options files for SunOS, in particular
1486      - remove -traditional from xmakedepend
1487      - change -xarch=v9 to -xarch=native for f77
1488      - restore use of make (not gmake)
1489      - add CC=gcc if using g77
1490    o changes per discussion of AM, JMC, & EH3 today:
1491      - move redundant "grid" variables out of "state" -- in preparation of
1492        creating proper CF-style coordinate variables and in recognition
1493        that any/all grid variables can be easily copied (eg. w/NCO) from
1494        the grid files into any of the other NetCDF files
1495      - *always* output grid variables with MDSIO (this will eventually be
1496        changed)
1497      - output MNC grid file if useMNC is true
1498    o every instance of _END_MASTER() has been found and replaced with
1499      _END_MASTER( myThid ) in order to satisfy certain picky Sun
1500      preprocessors
1501    o re-arrange diagnostics pkg initialisation:
1502     - allow each package to extend the available diagnostics list
1503     - add some checking and fix small problems (multi-threaded, ...)
1504     - new S/R diagnostics_fill (replace fill_diagnostics):
1505       look through the short list of active diag. (instead of the long list)
1506       create function DIAGNOSTICS_IS_ON to tell if a diagnostics is active
1507    
1508    checkpoint57a_post
1509    o this set of changes restores TAMC compatibility
1510      tested for global_ocean.90x40x15 adjoint on trough
1511      (what a pain)
1512    
1513    checkpoint57a_pre
1514    o some modifs in tools/build_options for sunos
1515    o call ctrl_pack for ctrl at end for optimcycle=0
1516    
1517    checkpoint57
1518    o add horizontal bi-harmonic viscosity for vertical velocity
1519      - new parameter viscA4W (defaults to viscA4)
1520      - affects only non-hydrostatic code
1521      - to be done: no-slip lateral boundary conditions
1522    o switch back to "sflux = sflux - runoff" in exf_getforcing.F
1523    o implement Implicit Vertical advection for pTracers
1524    o depth convergence accelerator: replace deltaTtracer by dTtracerLev(k)
1525      (implemented also for implicit vertical diffusion & advection)
1526    o OBCS: extend application of tracer open boundary conditions
1527      to a strip beyond the boundary of width Olx/Oly
1528    o add call monitor to TAF set of required calls (flow directives)
1529      and include in natl_box_adjoint
1530    o untangle a few ifdefs related to cost, ctrl, autodiff
1531      untangel a few ALLOW_ECCO_OPTIMIZATION
1532    o Apply Cooper & Haines representative estimates also at sub-surface (k=Nr)
1533      (theta2, salt2 in ecco_cost_weights)
1534    
1535    checkpoint56c_post
1536    o OBCS as control variables
1537      - update ctrl_ad_diff.list, obcs_ad_diff.list
1538      - remove balance of obcs controls from default
1539      - fix index bug nobcs in ctrl_init
1540      - fix dummy fields filen in ctrl_pack
1541      - add dummy weights for obcs
1542    o lsopt: comment out fort.94 output
1543    o optim:
1544      - remove unnecessary header files
1545      - adjusted namelists
1546      - add xerbla.F to Makefile
1547    o exf:
1548      - multiple modifications of exf_check_range
1549      - unit change in exf_init_runoff from [m/year] to [m/s]
1550    o mdsio:
1551      - i/o-vector change debugLevel from debLevA to debLevB
1552    
1553    checkpoint56b_post
1554    o collect all ptracers output in an new routine (PTRACERS_OUTPUT) that
1555      is called from DO_THE_MODEL_IO
1556      - rename PTRACERS_STATV_WRITE to PTRACERS_WRITE_TIMEAVE
1557      - introduce new parameter PTRACERS_dumpFreq (defaults to dumpFreq)
1558      - clean up PTRACERS_WRITE_TIMEAVE a little
1559    o add another verification experiment that tests both the cfc-pkg and
1560      the gchem-pkg with GCHEM_SEPARATE_FORCING undefined, that is with
1561      reactive tendencies treated inline with regular timestepping
1562    o testreport previously did a lousy job of comparing small numbers, so
1563      we (Ed and Martin) changed the  way the cut-off of 1.e-12 is
1564      implemented in the little c-progam tmp_cmpnum.c which is embedded in
1565      testreport.
1566    o ptracers_monitor: bug fix for MPI
1567    
1568    checkpoint56a_post
1569    o GCHEM: finish reorganizating the package
1570      - forward_step calls GCHEM_CALC_TENDENDY, which computes gchemTendency
1571        (introduces another 3D-array for each passive tracer, but only if
1572        GCHEM_SEPARATE_FORCING is undefined. For GCHEM_SEPARATE_FORCING
1573        gchemTendency is not needed because the timestep is done separately)
1574      - gchemTendency is added to gPtr in GCHEM_ADD_TENDENCY
1575      - GCHEM is now---more or less cleanly---separate from PTRACERS
1576      - to bo done: handling of surfaceForcingPtr that is needed for KPP not
1577        so clear to me how that should be done in a general way.
1578    o CFC: improve formatting of output in CFC_ATMOS
1579    o PTRACERS:
1580      - rename GCHEM_MONITOR to PTRACERS_MONITOR and call it from MONITOR, so
1581        that ALL experiments with ptracers enable can be checked. This makes
1582        GCHEM_MONITOR obsolete.
1583      - include a runtime parameter PTRACERS_monitorFreq that defaults to
1584        monitorFreq
1585      - set default PTRACERS_write_mdsio to false if PTRACERS_write_mnc is true
1586    o add PTRACERS (PTR0[1-5]) to testreport output
1587    o exf_check_range:
1588      * default changed to .TRUE.
1589      * will check values for niter0 if debLevA, every timestep if debLevB
1590      * STOP in exf_check_range if 'out of range'
1591      * range chosen generous to allow for potential extema
1592      TBD: a version with stricter range
1593           permitted range would be runtime parameters
1594    o GMredi:
1595      - fix ldd97 slope limit ; extend valid domain of Psi-Bolus ;
1596      - change S/R GRAD_SIGMA to be valid in the overlap on CS-grid.
1597      - change the default GMREDI_OPTIONS.h: compile everything except Visbeck
1598    o GCHEM:
1599      - move call to GCHEM_FORCING_SEP, so that it is now called before
1600        the blocking exchanges to avoid computing halos in GCHEM_FORCING_SEP
1601      - introduced a useGCHEM runtime flag and applied it everywhere.
1602      - renamed PTRACERS_SEPARATE_FORCING to GCHEM_SEPARATE_FORCING;
1603        this flag is now only visible within GCHEM-pkg routines.
1604      - moved gchem_forcing_int temporarily into ptracers_forcing, this will
1605        be replaced by a 3D array that is computed before thermodynamics; for
1606        this, the tracer ID iTracer had to be included into the parameter list
1607        of ptracers_forcing
1608      - set up forward_step to call gchem_forcing, that will replace
1609        gchem_forcing_int in ptracers_forcing
1610      - cleaning up
1611    o small cleaning of exch2: remove files that are also in eesupp/src
1612    
1613    checkpoint56
1614    o AIM: read land-Fraction earlier (from ini-fixed) and monitor land at nIter0
1615    o mnc: cleanup "full" files--fixes out-of-memory problem
1616    o ECCO-GODAE
1617      * model/, pkg/, code/, input/ now complete w.r.t. ECCO-GODAE production setup
1618      * fully merged and updated from SIO code
1619        windstress sign change affects
1620        - exf_inscal_[u/v]stress
1621        - sign of xx_tau[u/v] adjustments
1622        - signs in cost_scat
1623      * ctrl_get_gen: avoid update of tau[u/v] for first few days
1624      * natl_box_adjoint updated and compressed
1625      * 2-level checkpoint switch added
1626        (tested in EXP. 1 of natl_box_adjoint)
1627      * new switch doInitXX to avoid init. of xx_... in optimcycle=0
1628    o SVD
1629      * first complete, non-hacked version for SVD calculations
1630      * all interfaces clean w.r.t to handling of xx_..., adxx_..., g_xx_...
1631        performed via direct access files admtlm_vector.it????
1632        (via ctrl_[un]pack)
1633      * optimcycle is used for ARPACK iteration counter
1634        (note: adxx_... is iterated, rather than xx_...; latter is constant!)
1635      * EV problem ok w.r.t. L2-norm in tangent space; need to check other norms
1636        and add linear transforms where necessary
1637      * controls are initial/final SST, SSS (can be extended; need to check
1638        ctrl_set_[un]pack_xyz.F according to ctrl_set_[un]pack_xy.F
1639    o mdsio: filename info to both stderr, stdout
1640    o exf: exf_inscal_runoff: separated default conversion [m/year] -> [m/sec]
1641      from sign change
1642    
1643    checkpoint55j_post
1644    o isolate dissipation tendency (allow to keep it out off AB) in V.I form.
1645      affects (truncation level) output.txt of global_ocean.cs32x15(&.thsice)
1646    o add consistent build directories and .cvsignore files to verification
1647    o added viscA4GridMin and viscA4GridMax for more control on biharmonic viscosity
1648    o make all subroutines 30 or less characters in length for certain older
1649      compilers to work (a thorough search only turns up two routines in
1650      pkg/ptracers)
1651    o allow (vecinv only) a different horiz. viscosity for Divergence and Vorticity;
1652      affects (truncation level) output.txt of global_ocean.cs32x15(&.thsice)
1653    
1654    checkpoint55i_post
1655    o change arrays for total vertical diffusivity (2.D if explicit,
1656      3.D if implicit) ; each ptracer uses its own background value.
1657    o added mnc/NetCDF output capability to ocn_compon_interf
1658      - added bits to verification/cpl_aim+ocn so that it can run on
1659        ITRDA and other clusters without the mpirun "-wd" option
1660    o fixed wayward endif in mom_fluxform.F that messed up cyclindrical
1661      configuration
1662    o give MNC the ability to create additional files rather than
1663      exceeding a specified file size limit "MNC_MAX_FILESIZE"
1664      - the default is just less than 2GB which is a practical limit
1665        on many systems
1666    o Compute the non-local term using either KPP vertical diffusivity (=default)
1667       or the total vertical diffusivity (when KPP_ghatUseTotalDiffus=T)
1668    
1669    checkpoint55h_post
1670    o add verification test "vermix"
1671    o remove all the *_ioinc flags and replace with the single global
1672      outputTypesInclusive flag
1673    o allow to set a vertical profile of vertical diffusivity for T & S
1674    o call PACKAGE_BOOT & PACKAGES_READPARMS just after INI_PARMS
1675    o useMNC moved from data.mnc to data.pkg
1676    
1677    checkpoint55g_post
1678    o Renaming carbon AD experiments to comply with testreport conventions
1679    o Updating adjoint of Held-Suarez hs94.1x64x5
1680    o Fixing directives for non-ECCO forward_step, after ECCO directives
1681      have been fixed to avoid recomp. of do_oceanic_phys
1682      Works well for global_ocean.90x40x15,
1683      but recomp. issue remains for carbon
1684    o Updating adjoint output for natl_box_adjoint after
1685      pkg/ecco has been modified (see taga c55d_post)
1686    
1687    checkpoint55f_post
1688    o rename to timeave_init_fixed
1689    
1690    checkpoint55e_post
1691    o some delicate re-shuffle of store directives to avoid one
1692      extra call of do_oceanic_physics
1693      affects ecco_the_main_loop.F, do_oceanic_physics.F
1694      checkpoint_lev1_directives.h
1695    o NB: this may break global_ocean adjoint temporarily,
1696      but it is clear how to fix it. Will do later, need this now.
1697    
1698    checkpoint55d_post
1699    o ECCO specific cost function terms (up-to-date with 1x1 runs)
1700    o ecco_cost_weights is modified to 1x1 runs
1701    o modifs to allow observations to be read in as
1702      single file or yearly files
1703    o enable to read exf forcing fields as either
1704      single file or yearly files (flag useExfYearlyFields)
1705    checkpoint55d_pre
1706    
1707    o switch between 2-level and 3-level checkpointing
1708    o add ability of MNC to write local and "partial" (eg. 2D slices where
1709      the full 3D field is never actually stored) arrays to NetCDF files
1710      with the correct (that is, the complete multi-dimensional) set of
1711      array indicies
1712      - used in mom_vecinv() to write the diagFreq output
1713      - tested (demonstrated) in verification/aim.5l_cs
1714    o further mnc-ification
1715      - add verification/lab_sea to the list with mnc setups
1716      - fix undefined mnc v-names in cd_code
1717      - add kpp to mnc output (both snapshot and timeave)
1718    o non-hydrostatic code
1719      - added horizontal viscosity parameter viscAhW for w, that replaces viscAh
1720        in calc_gw.F
1721      - defaults to viscAh
1722      - this is useful, when I want to use viscAh=0 (e.g., only biharmonic
1723        friction or Leith) in non-hydrostatic mode, as long as there is
1724        no biharmonic friction and/or Leigth or equivalent for vertical velocity.
1725    o pkg/cost
1726      extend simple cost functions to treat time mean quantities
1727      (T,U,V) via cost_accumulate_state from cost_tile
1728    o multidimAdvection on CS-grid: implement the full 3 pass ; overlap needs to
1729        be 2 times larger than the minimum size the advection scheme requires.
1730        now get a perfect conservation of salt in advect_cs test-exp (updated)
1731    o GGL90 (Gaspar's TKE mixed layer)
1732      - add horizontal diffusion of TKE, requires exchanges in
1733        do_fields_blocking_exchanges, horizontal diffusivity is zero by
1734        default. In OPA there is no horizontal diffusion of TKE but the
1735        mixing coefficients are computed from a horizontal average of TKE of
1736        6 points or so. I think that diffusion has a little more physical
1737        justification.
1738      - clean up ggl90_calc in the hope of reducing memory usage (this hope
1739        was in vain)
1740      - mask tke-variable in ggl90_init
1741    o fix mask Pb in multidimAdvection on CS-grid (still a small Pb with ipass)
1742    o fix biharmonic diffusion on CS-grid.
1743    o more obcs stuff
1744      - added obcs_external_fields_load as an alternative to the EXF-pkg option
1745        for reading boundary values. This routine is called from
1746        obcs_prescribe_read
1747      - updated obcs_check
1748      - changed sponge layer relaxation parameter units for days to seconds
1749      - turned off sponge layer by default
1750      - changed argument list of OBCS_CALC to myTime+deltaTclock
1751      - fixed about 35 bugs in obcs_external_fields_load
1752    
1753    checkpoint55c_post
1754    o obcs stuff
1755      - new runtime flags useOBCSprescribe, useOBCSbalance
1756      - re-arranged obcs_calc
1757      - moved exf_getobcs to obcs_prescibe_read
1758        obcs_prescibe_read is called after ORLANSKI stuff
1759        and independent of it (executable can contain all).
1760      - updated obcs_check
1761      - added exchanges for U,V,gU,gV for useOBCSprescribe=.TRUE.
1762        These may be necessary only if tangential velocities are
1763        prescribed at OB, not sure, needs testing.
1764    o make the MNC_CW_ADD_VATTR_* subroutines all take scalar arguments
1765      which simplifies the calls and passes the ifc check-bounds test
1766    
1767    checkpoint55b_post
1768    o add a 2D scalar, Z location, exchange_2 routine.
1769    o EXCH_UV for CS-grid: add one u,v in the corner-halo region, allows
1770      to compute vorticity on a wider stencil [e.g., vort3(0,1)&(1,0)]
1771      affects advect_cs results (for the wrong reason): update output.txt
1772    o use a more standard discretization for biharmonic viscosity ;
1773     (original version still available with #define MOM_VI_ORIGINAL_VISCA4 )
1774      affects results of dome set-up: update output.txt
1775    o fix gad_advection.F (CubedSphere part), back to version 1.23
1776    o fix bug in mom_vi_del2uv.F (CubedSphere part).
1777    
1778    checkpoint55a_post
1779    o merged code to
1780      * prescribe/read time-dependent open boundaries
1781        (works in conjunction with exf, cal)
1782      * sponge layer code for open boundaries
1783      * each boundary N/S/E/W now has its own CPP option
1784        (healthy for the adjoint)
1785    
1786    checkpoint55
1787    o up-to-date adjoint of previous breaks
1788      - natl_box_adjoint: problem for exp 12, 13: cost = 0. needs fix
1789      - global_ocean_ebm: adjoint still needs fix (TLM ok)
1790      - global_ocean.90x40x15: extended GMREDI_OPTIONS.h
1791      - carbon: * remove tr1-related adjoint verification
1792                * add ptracer as control variable
1793    o remove all tr1-related code (ALLOW_PASSIVE_TRACER)
1794      (adjoint stuff still has some tr1 'names', but all use ptracer arrays)
1795    
1796    checkpoint54f_post
1797    o in verification/carbin/ remove experiment related to
1798      ALLOW_PASSIVE_TRACER (array tr1 etc)
1799      code_ad/ input_ad/ results_ad
1800    
1801    o add two new packages
1802      - ggl90, TKE-model of Gaspar et al. (1990), Blanke+Delecluse (1993)
1803        + subject to optimization (memory)
1804      - opps, OPPS (ocean penetrative plume scheme) of Paluszkiewicz+Romea (1997)
1805        + subject to reordering (many GOTOs in the original code)
1806        + so far opps is called for every (i,j) point, and then operates in
1807          the vertical; one may want to reorder the scheme in order operate in
1808          horizontal slabs at the cost of (a lot of) memory, at least ten new 3D
1809          fields)
1810    o overhaul of IO so that we now have flags for MDSIO and/or MNC
1811      - all verification tests compile and run with linux_ia32_g77
1812      - defaults are compatible with current input files--nothing
1813        should change if you were not previously using MNC
1814      - MNC output has been added in numerous places (eg. timeave)
1815        but there are still a few writes not yet do-able with MNC
1816        (this is in progress)
1817      - flags now allow for either/or/both use of MDSIO and MNC and
1818        documentation will soon follow
1819      - numerous small formatting cleanups for ProTeX
1820    o add version info (via BUILD_INFO.h) to MNC and stdout
1821    
1822    checkpoint54e_post
1823    o add two new packages
1824      - pp81 (Packanowski and Philander, 1981), Richardson number and
1825        stratification dependent mixing
1826      - my82 (Mellor and Yamada, 1982) level 2 turbulence closure scheme
1827      - these scheme operate in a similar manner as KPP (without ghat, of
1828        course), however there is only one diffusivity that is used for both
1829        temperature and salinity (and passive tracers)ç
1830    o add offline package
1831    o add "verification/dic_example" which contains a dic-gchem-ptracer setup
1832      provided by Stephanie Dutkiewicz
1833    o genmake2: add ability to search for C compilers and cleanup test output
1834      - fixes recent SX-6 problems and should help with others (eg. HP-UX)
1835    
1836    checkpoint54d_post
1837    o data.diagnostics: if levels() is unspecified then ALL levels are diagnosed
1838    o bug fix in pkg/cal/cal_addtime.F for TheCalendar='model' day count is wrong,
1839      leading to additional shift by 5 days each year of integration
1840       (i.e. leading to considerable offset over the years)
1841    o update global_ocean.cs32x15/thsice: use z* + RealFW + staggerTimeStep
1842    o start with no AB and no initial filtering (staggerTimeStep):
1843      change the results of test-exp: hs94.128x64x5, hs94.1x64x5 & hs94.cs-32x32x5
1844    o move ocean specific S/R calls from forward_step.F to do_oceanic_phys.F
1845      (external loading & cpl import/export stay in forward_step.F)
1846    o update coupling interface to work with new staggerTimeStep
1847    o change MDSIO ptracers_pickup.
1848    o fix a bug in Flux deriv. vs Ts (pkg/aim_v23/phy_suflux_sice.F);
1849    o genmake2 fixes so netcdf now works on halem ("osf1_alpha_*")
1850    o bugs fixed in kpp_calc.F (ustarY) and external_forcing.F (Qsw & Partial-cell)
1851    
1852    checkpoint54c_post
1853    o replace surfaceTendency U,V,S,T,Tice,Ptr by surfaceForcing U,V,S,T,Tice,Ptr
1854      this affects (truncation error) output.txt of test-exp:
1855       global_ocean_ebm,_pressure,.cs32x15(&.thsice), lab_sea & natl_box
1856    o pkg/kpp: replace pMask by maskC to reduce memory size (one 3.D array)
1857    o change Qnet to always be the net heat flux, (+upward).
1858      affects (truncation error) output of natl_box exp.: updated
1859    o define the max number of passive tracers in PTRACERS_SIZE.h
1860    o start to test mnc routinely in exp0
1861    o add sea-ice loading (sIceLoad) as a new forcing field.
1862    
1863    checkpoint54b_post
1864    o add testreport "-j JOBS" option for parallel builds (tested and pretty
1865       impressive on Altix and Opteron systems)
1866    o diagnostics can now write NetCDF files through the mnc package
1867    o staggerTimeStep & NLFS: update pkg aim_v23 & thsice; update aim.5l_cs output
1868    o staggerTimeStep & multi-Dim-Advec: Exch(U,V) added
1869    o staggerTimeStep & NLFS: rescale T & S surface tendencies.
1870      affects (truncation error) output of lab_sea & natl_box exp.: updated
1871    o change pickup _cd & _ptracers (old pickup restart: usePickupBeforeC54=.T.)
1872    
1873    checkpoint54a_post
1874    o re-write staggerTimeStep: step fwd U,V and then T,S (reverse the order).
1875    o change pickup file (to restart from old pickup, set usePickupBeforeC54=.T.)
1876    o get a perfect restart when using RealFreshWaterFlux + NLFS (not finished)
1877    o update output of all exp. that use staggerTimeStep (except hs94.cs & 2D)
1878      + internal_wave (shift in writing cg2d_ini_res)
1879    checkpoint54a_pre
1880    
1881    o require forcing_In_AB=.FALSE. and remove surfaceTendencyTice from pkg/seaice
1882      - modified verification/lab_sea and natl_box_adjoint accordingly
1883    
1884    checkpoint54
1885    checkpoint53g_post
1886    o prepare splitting of thermodynamics: store convect.counter in common block
1887    o store d.etaH/dt (instead of Div.hV) in common ; affects (truncation error)
1888      output of: global_ocean.cs32x15, global_ocean_pressure & internal_wave
1889    o cnh's modifs to gad_advection.F for cube-sphere multi-dim advection
1890    o new parameter "nShapS": allow to treat differently S from T (nShapT)
1891    o separate Vert.Advec.Scheme from horizontal Advec.Scheme (T & S)
1892    o restore adjointability
1893    
1894    checkpoint53f_post
1895    o modifications that affect AIM experiment results (update output.txt):
1896      - no advection of S at top interface Nr (pkg/generic_advdiff)
1897      - air surf. temp: use lower value between T0 & T1 (phy_suflux_prep.F)
1898    o AIM pkg:
1899      - include stability function into surf.Flux derivative relative to Tsurf
1900      - calculate clear-sky radiation & surface temp. change (for diagnostics)
1901    
1902    checkpoint53e_post
1903    o merged cylindrical coord configuration
1904    o added rotating_tank experiment
1905    checkpoint53e_pre
1906    
1907    checkpoint53d_post
1908    o faulks upgraded: re-generate output.txt that have changed:
1909       global_ocean.cs32x15(.thsice), global_ocean_ebm, lab_sea, natl_box
1910    o Added Bryan and Lewis, 1979, vertical diffusivity profile
1911    o pkg/land: fix problem in land_impl_temp.F when Ts arround freezing.
1912    o added Sadourny discretization of Coriolis
1913      - moved some PARAMETERS from mom_*_coriolis.F to PARAMS.h
1914      - re-enabled use of omega3 (useAbsVorticity)
1915    o added Leith (Phys. Fluids, 1968, 10, 1409-1416) variable viscosity for
1916      vector-invariant equations
1917      - note: does *NOT* yet use same variable visc. for no-slip BC's.
1918    o recoded the lateral boundary conditions for non-hydrostatic w, this time
1919      hopefully without new bugs
1920      - still to do: biharmonic friction for non-hydrostatic w
1921    o bug fix for mom_*_sidedrag: rA -> rAs,rAw
1922    o regenerated output for global_ocean_ebm (using -ieee)
1923    o fix mom_common/mom_*_sidedrag.F to recover numeric output prior to creation
1924      of mom_common/
1925      - simple re-arrangement of instructions within computing loop
1926    checkpoint53d_pre
1927    
1928    checkpoint53c_post
1929    o new version of coupler for AIM+thSIce and Ocean models
1930     - new fields (SSS,h_MixLayer ...) are exchanged through the coupler
1931     - land: change Evaporation of snow
1932     - aim with thSIce: fix bug in snow-precip.
1933    o changes to calc_gw.F
1934     - bug fix for w^2 term near the bottom boundary
1935     - (hopefully) improve the lateral slip boundary condtions for use with
1936        partial/looped cells
1937      - because the bug fix changes two verification experiments anyway (exp5
1938        and plume on slope), change the lateral boundary condition from half slip
1939        to the value of no_slip_sides
1940    o ebm package wasnt quite up to the parallel task. Fixed that.
1941    o Adjoint of EBM package + verification
1942      * TLM OK
1943      * ADM not sufficient accuracy yet (needs further testing)
1944    
1945    checkpoint53b_post
1946    o Commiting new energy balance model to repository
1947      * package is pkg/ebm
1948      * verif. is verification/global_ocean_ebm
1949      * references are in ebm_driver.F
1950    C      * X. Wang, P. Stone and J. Marotzke, 1999:
1951    C        Global thermohaline circulation. Part I:
1952    C        Sensitivity to atmospheric moisture transport.
1953    C        J. Climate 12(1), 71-82
1954    C      * X. Wang, P. Stone and J. Marotzke, 1999:
1955    C        Global thermohaline circulation. Part II:
1956    C        Sensitivity with interactive transport.
1957    C        J. Climate 12(1), 83-91
1958    C      * M. Nakamura, P. Stone and J. Marotzke, 1994:
1959    C        Destabilization of the thermohaline circulation
1960    C        by atmospheric eddy transports.
1961    C        J. Climate 7(12), 1870-1882
1962    o Will need long integration testing.
1963    checkpoint53b_pre
1964    
1965    o created pkg/mom_common in preparation for variable viscosity code
1966    o renamed and split ini_mnc_io
1967    o pkg/land: only liquid water can diffuse or run-off
1968    o AIM using land: soil wetness availability account for snow
1969    o added printMapIncludesZeros to EEPARMS namelist
1970    
1971    checkpoint53a_post
1972    o restore TAMC compatiility for exf_constants.h
1973      (no usage of _d in .h)
1974    o Additional storing in KPP in an attempt to fix
1975      TAMC problem with adjoint of KPP code.
1976      (no success...)
1977      Identical code works fine with TAF.
1978    o Fixed verification/natl_box_adjoint experiments.
1979      Initial conditions for Experiments 4 and 5 are now
1980      set to "SEAICE_initialHEFF=0", which is more reasonable,
1981      and hence gives results closer to that of Experiment 2.
1982      Experiment 6 requires "SEAICE_initialHEFF=1" and is working once again.
1983    
1984    checkpoint53
1985    o stable checkpoint with up to date adjoint
1986      TLM tests only run for 1st grdchk at the moment. Its unclear if
1987      this is a code problem or a problem with resetting code for g_
1988      variables that is being autogenerated wrong.
1989      Otherwise:
1990       o code is testing well on Linux (P4 and AMD), SGI Alitix and Irix.
1991       o IBM and HPQ tests could not be run because NCAR (IBM) and NCCS (HPQ)
1992         are both still in chaos following their security messes.
1993    
1994    checkpoint52n_post
1995    o various build (mostly genmake2) changes including:
1996      - ability to build/run more easily within Cygwin and MacOS X
1997      - more complicated Makefiles with a stronger dependence on Gnu Make
1998    o pkg/seaice modifications
1999      - added SEAICE_deltaTtherm and SEAICE_deltaTdyn in order to reduce cost
2000        of pkg/seaice.  For time being, SEAICE_deltaTtherm = deltaTtracer
2001        and SEAICE_deltaTdyn must be integer multiple of SEAICE_deltaTtherm
2002      - changed proxy for geostrophic velocity and updated
2003        verification/lab_sea/results/* accordingly
2004      - removed ADI dynamic solver from pkg/seaice
2005      - replaced all occurrences of 1/CSTICE or 1/CSUICE
2006        they caused a segmentation fault under certain circumstances
2007      - removed unused field WATR
2008    o bug fix in exf-package:
2009      -  u/vwind are defined at tracer/pressure points. The values of u/vwindmask
2010         now reflect that.
2011    o small fixes in the cal-package:
2012      - set reference date to first of January for the 'model'-calendar
2013      - failing of cal_CheckDate in cal_FullDate now actually results in a
2014        warning
2015    o small modifications in exf-package to increase flexibility:
2016      - change climtempfreeze from a constant to a runtime parameter that
2017        is specified in data.exf_clim (default = -1.9)
2018      - introduce runtime parameter windstressmax (default = 2.0) that is
2019        specified in data.exf
2020    o fix in pkg/thsice:
2021      - update Evap (Tsf changes) to be consistent with Latent heat flux
2022      - maintain snow precipitation unchanged (even if Tsf >=0).
2023     both affect global_ocean.cs32x15/(.thsice) results ; update output.txt.thsice
2024    
2025    checkpoint52m_post
2026    o commented out call to cal_GetMonthsRec in swfrac.F and added some comments;
2027      this does not change any of the results, because myIter=0 in swfrac always
2028      lead to jwtype=2 (the default anyway), but the call makes little sense
2029      as a default
2030    o no SHORTWAVE HEATING lost at the bottom; affects lab_sea output; updated
2031    o re-work pkg/thsice interface with ocean & bulk_force pkg to allow
2032      atmospheric model (AIM) to use it ; add a "slab ocean" component.
2033    o pkg/aim_v23 : add interface to call thermodynamic sea-ice (thsice)
2034    o update global_ocean.cs32x15/output (.thsice) after changes in pkg/thsice
2035    o extending useSingleCpuIO option to work with new exch2 I/O format
2036      - old-style, missing-tile I/O is still accessible by defining CPP
2037        option MISSING_TILE_IO in pkg/mdsio/MDSIO_OPTIONS.h
2038    o monitor package can write to NetCDF files and/or STDOUT
2039    o fix re-definition bug in MNC_GRID_INIT_ALL()
2040    o doc/api_reference added
2041      - a framework for building an API Reference Manual using all
2042        the "protex" comments embedded in the code
2043      - see pkg/generic_advdiff, pkg/mnc for examples
2044    o MNC:
2045      - make myThid the last argument for all subroutines
2046      - new default for the grid files: NO halos
2047      - add useMNC and other run-time flags
2048      - separate per-file-group handling of the unlimited dimension
2049      - early initialization of MNC w/ flags read at the eeboot stage
2050        and lookup tables set in initialize_fixed
2051      - write all MNC output to a freshly-created directory
2052    o thermodynamics sea-ice (thsice) is now tested with testreport.
2053    o test exp. advect_cs: use the standard cs32 grid ; update output.
2054    o Added functionality to grdchk:
2055      pick global i,j,k position (or nearest wet) where to perform check.
2056    
2057    checkpoint52l_post
2058    o new land formulation:
2059      a) use ground enthalpy as prognostic variable to ensure exact
2060         energy conservation.
2061      b) account for water temperature and for latent heat of freezing
2062         in all processes (rain, run-off, ground storage)
2063      c) compute surface and ground temperature implicitly.
2064    o aim_v23 modification for new land model:
2065      a) Treat separately land / ocean / sea-ice surface fluxes
2066         to allow implicit computation of land & sea-ice surface temp.
2067      b) add snow precipitation.
2068    checkpoint52l_pre
2069    
2070    o fix problem (when 1 tile is empty) in min/max monitor.
2071    o fix bug in timeAve (u,vZetatave in common block)
2072    o no restoring terms under ice for pkg/seaice
2073    o moved SEAICE_DO_DIAGS to S/R do_the_model_io
2074    o bug fix for pkg/seaice pickups
2075    o change MNC call locations and add coordinate attributes
2076    o mask vorticity at the corner ; affects global_ocean.cs output
2077    o fix ini_curvilinear_grid ; test CS experiments with mpi
2078    o aim.5l_cs: modify sea-ice fraction input file ; update output
2079    o exf: Adding simple range check routine for exf fields after read
2080    
2081    checkpoint52k_post
2082    o removed top-level directory "diags"
2083      - we migrated these functions to pkg/timeave a long time ago
2084    o fixed bug introduced in pkg/monitor
2085    o accuracy ctrlprec = 32 insuffient for gradient checks using
2086      averaged fields (I/O via cost_averages)
2087      -> use ctrl.h in active_file*.F to control I/O precision.
2088    o paramter list of CALL ADTHE_MAIN_LOOP
2089    o added initial do_the_model_io to ecco
2090    o set all ...Freq to zero after cost_final
2091      taveFreq, dumpFreq, pChkptFreq
2092    o MAIN and ECCO differentiability restored
2093    
2094    checkpoint52j_post
2095    o fix nchklev in tamc.h for global_ocean...
2096    o Bringing flow and store directives up-to-date
2097    o Really weird thing!
2098      call do_the_model_io from the_main_loop with parameters
2099      starttime, niter0, instead of mytime, myiter, screws up the adjoint:
2100      TAF places a faulty re-call of initialise_varia
2101      after cost_final call which should not be there!
2102    checkpoint52j_pre
2103    
2104    o tweaked pkg/mdsio/mdsio_readfield.F to have more useful logic and
2105      error messages
2106    o fix errorMessageUnit problem. remove old version of mdsio from eesup/src
2107    o modified pkg/mdsio/mdsio_readfield.F -- commented out diskspace-eating
2108      debug output
2109    o modfied mdsio_writefield.F to handle non-global files under exch2
2110    o update AIM Cubed-Sphere exp (aim.5l_cs):
2111      use land, p*, and Franco.M forcing fields with fractional land-sea mask.
2112    o update AIM Equatorial Channel exp:
2113      use standard aim_v23 pkg and change the SST fields to be more realistic.
2114    o globalFile now works with exch2
2115    o merged mom_vi_calc_relvort3.F, mom_vi_del2uv.F and
2116      mon_vort3.F to make exch2 friendly with >1 tile per cube face
2117    o limit timeave output for hi-res integrations
2118    
2119    checkpoint52i_post
2120    o removed CPP_EEOPTIONS.h from verification/*/code
2121    o updated the tiling for global_ocean_pressure
2122    checkpoint52i_pre
2123    
2124    o update aim.5l_LatLon using the standard aim_v23 pkg (instead of
2125      the old pkg/aim).
2126    
2127    checkpoint52h_pre
2128    o shortened offending lines in exch2_send_rx?.template
2129    o modified W2_EXCH2_TOPOLOGY.h to reflect current topology generator
2130    o genmake2: add build & execute test for NetCDF code
2131    o modded aim.5l_cs and global_ocean.cs32x15 to use exch2, removed
2132      old grid files, moved CPP_EEMACROS.h to pkg/exch2
2133    o added useSingleCPUIO flag to monitor.F and mon_out.F
2134    o added temporary hack for sea-ice dynamics on the cube:
2135      metric terms are ignored and it is assumed that
2136      there is no sea-ice on cube faces 1, 2, 4, and 5.
2137    
2138    checkpoint52f_post
2139    o added exch2 cube routines to pkg/exch2
2140    o modified hs94.cs-32x32x5 to use it
2141    o added new grid files to hs94.cs-32x32x5
2142    checkpoint52f_pre
2143    
2144    checkpoint52e_post
2145    o first attempt to solve vertical advection (momemtum & T,S) Implicitly
2146      for now, only implemented with Lax-Wendroff (tracer) and VectInv (mom)
2147    o step.1 : rewrite (as in MultiDimAdvec) explicit tracer stepping (gad_calc_rhs.F)
2148      to work with implicit vertical advection and AB ;
2149    o Implic. vert. advect. implemented with flux-limiter, c2, u3 and c4 scheme.
2150    o update output (gad_calc_rhs.F changes affect truncation error) of exp:
2151     front_relax, global_ocean .cs32x15 & _pressure, internal_wave, lab_sea, natl_box
2152    checkpoint52e_pre
2153    
2154    o fix bug in impldiff when Nr=1 or Nr=2.
2155    o change the albedo in pkg/thsice (as GISS model); update output_thsice.txt
2156    o little changes (fftpack, aim/phy_suflux ...) to pass the "checkbounds" test.
2157    o fix deltaTfreesurf in update_cg2d.F (left from c45d_post): affects 2
2158      ocean exp. that use NLFS: global_ocean.cs32x15 & global_ocean_pressure
2159    o added exf_offset_atemp for Celsius to Kelvin conversion of atemp
2160    o eesupp/inc/EEPARAMS.h: MAX_NO_PROCS=1024
2161    o pkg/cal/cal_toseconds.F fix for long (>60 years) integrations
2162    
2163    checkpoint52d_post
2164    o re-tiled many expts to allow comparison in multi-processor mode
2165      - updated output accordingly
2166      - changed hs94.128x64x5 to use intial T from file rather than use the
2167        random number generator
2168    o add infrastructure in model routines for fizhi and gridalt packages
2169    o change global_ocean.cs32x15 because of Pb with GM on CS-grid.
2170    o changes to permit hi-res, cubed-sphere, configuration
2171      - added useSingleCpuIO capability to mdsio_readfield.F and exf_interp.F
2172      - added "#undef ALLOW_USE_MPI" support to eesupp/src/scatter_2d.F
2173      - added pkg/exf/exf_set_uv.F for on-the-fly interpolation and rotation
2174        of surface winds for the cube
2175      (A verification experiment, based on global_ocean.cs32x15, but with
2176       pkg/seaice turned on and with on-the-fly interpolation from the NCEP
2177       Gaussian grid is described in MITgcm_contrib/high_res_cube/README_ice,
2178       complete with example surface forcing files and matlab scripts to look
2179       at the output and compare it with that of global_ocean.cs32x15.)
2180    o packages pickup: $PKG_write_pickup called from packages_write_pickup ;
2181       but call to $PKG_read_pickup remains in $PKG_ini_vars: change CD_code
2182       to conform to the common rule.
2183    o check-in the first version of the coupler + interfaces for multi-components
2184       set-up (Chris's version, adapted to work on cubed-sphere grid); use MPI.
2185       - imply modification in eesupp (MPI_COMM_MODEL < MPI_COMM_WORLD).
2186       - atmosphere: use pkg aim_v23 ; no sea-ice for now.
2187       - ocean and atmos. share the same horizontal grid (no interpolation).
2188       - exchanges between component and coupler is done in forward_step
2189    o new verification experiment, cpl_aim+ocn:
2190       coupled ocean - AIM atmosphere on cs32 grid.
2191    
2192    checkpoint52d_pre
2193    o surface flux time-av diagnostic modified for NLFS & RealFreshWater
2194    o add call to AIM pendant S/R in external_forcing & external_fields_load.F
2195    
2196    checkpoint52c_post
2197    o Fixing OPTIONS files for use of exf:
2198      - ALLOW_ECCO not needed
2199      - ECCO_CPPOPTIONS.h should not be included from
2200        EXF_OPTIONS.h/CAL_OPTIONS.h, but from CPP_OPTIONS.h
2201        as has been the case in the past
2202      - All cal/exf related options are currently set in
2203        single header file. Should remain so until we
2204        agree on a consistent new policy.
2205    o Removed all CPP options for cal package.
2206      cal has no more CPP options.
2207    o modified STOREs in GAD_ADVECTION
2208    o corrected key comp. for passkey
2209    
2210    checkpoint52b_post
2211    o new version: "thsice" of thermodynamic sea-ice pkg:
2212     - only 1 call from "forward_step"; conserve energy, fresh-water & salt.
2213     - modify fluxes but do not change theta directly;
2214     - light cleaning of bulk_force pkg (still needed with thsice).
2215     - add forcing fields + data files in global_ocean.cs32x15/inp_thsice
2216       + output_thsice.txt to test thsice & bulk_force pkgs.
2217    o put back grid & coriolis monitor output.
2218    checkpoint52b_pre
2219    
2220    o call "do_the_model_io" at the beginning (=> dump initial state)
2221    o use rhoConstFresh to define convertEmP2rUnit (was done only in ocean-P)
2222    o sort out interplay between tamc.h and PTRACERS_OPTIONS.h
2223      (need info on NUMBER_OF_PTRACERS)
2224    o missing PTRACERS headers in some routines
2225    o default tamc.h in pkg/autodiff supposed to crash
2226      to ensure proper customization
2227    
2228    checkpoint52a_post
2229    o modifications to make FREEZE (_SURFACE) flux visible to pkg/kpp
2230      - moved surfaceTendencyTice from pkg/seaice to main code
2231      - subroutine FREEZE_SURFACE now limits only surface temperature
2232        and is called in FORWARD_STEP (if allowFreezing=.TRUE.)
2233        => new output.txt for global_ocean.cs32x15 & global_with_exf
2234      - keep the old version of FREEZE for backward compatibility;
2235        global_ocean.90x40x15 left unchanged using useOldFreezing=.TRUE.
2236      - corresponding modifs for TAF directives
2237    o added surface flux output variables to TIMEAVE_STATVARS
2238    o time-averaged output for pkg/ptracers
2239    o fix problem with ECCO-related divided adjoint
2240      snapshot file was missing some ad-variables,
2241      but no warning issued by TAF
2242    
2243    checkpoint52a_pre
2244    o some bug fixes for #undef REAL4_IS_SLOW
2245    
2246    checkpoint52 = ecco_c52_e35
2247    o after testing adjoints of checkpoint51u_post
2248    
2249    checkpoint51u_post
2250    o this is the post-merge tag of the ecco-branch
2251      (needs another clean checkout and re-testing)
2252    o various natl_box_adjoint configs and results
2253      but no input fields
2254    o obcs adjoint not yet merged!
2255    o adding ECCO global 1x1 and 2x2 degree configs
2256    o updated/extended some store directives for seaice
2257    o pkg/ecco now containes ecco-specific part of cost function
2258    o top level routines the_main_loop, forward_step
2259      supersede those in model/src/
2260      previous input data.cost now in data.ecco
2261      (new namelist ecco_cost_nml)
2262    o in ctrl/ cleaned some cross-dependencies and updated CPP options
2263    
2264    checkpoint51t_post
2265    o this is the pre-merge tag of the ecco-branch
2266    
2267    checkpoint51s_post
2268    o cleanup: removed various obsolete #define-s
2269    o pkg/grdchk
2270      - renamed 'ph-grd 3' to 'grad-res'
2271      - merged from ecco-branch
2272        (remaining bug fixes for obcs gradient checks)
2273      - additional high-precision output for testreport
2274        (grep for 'precision_grdchk_result')
2275    
2276    checkpoint51r_post
2277    o cleaned up or removed CPP_OPTIONS.h files
2278    o updated results for some of the tests to reflect the new
2279      optfiles (-ieee: -O0 instead of -O3)
2280    
2281    checkpoint51q_post
2282    o cd_code:
2283      - moved cd_scheme.F -> cd_code_scheme.F
2284      - separate read_checkpoint from cd_code_ini_vars.F
2285      - separated cd_code part from write_checkpoint
2286      - updated AD_SOURCE, generated .flow
2287      - added CD_CODE_VARS.h to the_main_loop
2288      - Moving cd_code specific store dir.s to pkg/cd_code
2289    o ctrl package totally restructured
2290      - pack/unpack now optional and decoupled from
2291        xx_/adxx_ I/O
2292      - ctrl_pack/unpack cleaned
2293        (new routines ctrl_init_ctrlvar.F, pkg/ctrl/ctrl_init_wet.F)
2294      - confined inclusion of AD_CONFIG.h to where necessary.
2295    o genmake2: changed AD dependencies from SRCFILES to AD_FILES
2296    
2297    checkpoint51p_post
2298    o create initial cd_code package
2299      - WARNING: the initialization of fields within packages
2300        is broken because INI_FIELDS (where READ_CHECKPOINT is
2301        called) is called *before* PACKAGES_INIT_VARIABLES.
2302        This seems to be backwards since
2303        1) its important to initially zero the entire field including
2304           the "halo" region
2305        2) zeroing needs to be done *before* reading pickup info
2306           and the pickup call might or might not happen in any
2307           particular run
2308      - this needs an overhaul for R2
2309    o cleanup verification/*/code/GMREDI_OPTIONS.h
2310    o cleanup testreport
2311    
2312    checkpoint51o_post
2313    o bringing AD-related verif's up to date with genmake2
2314      - carbon/
2315      - global_ocean.90x40x15/
2316      - hs.94.1x64x5/
2317      - (front_relax/ )
2318    o (more) consistent directory structure for AD-related verif.'s
2319    o cleaning ALLOW_GRADIENT_CHECK -> ALLOW_GRDCHK
2320    o cleaning some ALLOW_TANGENTLINEAR_RUN -> ALLOW_AUTODIFF
2321    o bug fix in find_alpha.F for MDJWF:
2322      - modif. to alpha = 1/D*( dN/dT - rho*dD/Dt) to account for
2323        change rho -> rho-rhoConst
2324      - replace call find_rho to find_rhonum
2325    o initialisation of rFlx extended to full array (required by TAF)
2326      and shifted to thermodynamics
2327    o removed PTRACERS.h in ptracers routine
2328    o added surfacetendencyPtr to S/R parameter list pracers_forcing
2329    o Correcting initialisations for fVerU, fVerV.
2330    o helping TAF to recognize dependency on kUp for
2331      fVerU, fVerV
2332    o Replacing delZ by delR in pkg/ctrl/
2333    checkpoint51o_pre
2334    
2335    o undid all of cp51 pending some cleanups and discussion
2336    o added the [#include "AD_CONFIG.h"] statement to all files that need
2337       it for adjoint/tl #defines
2338     o re-worked the build logic in genmake2 to support AD_CONFIG.h
2339     o removed tools/genmake since it no longer works
2340    
2341    checkpoint51n_post
2342    o modifications to make FREEZE flux visible to pkg/kpp
2343      - moved surfaceTendencyTice from pkg/seaice to main code
2344      - FREEZE & EXTERNAL_FORCING_SURF moved to FORWARD_STEP
2345      - subroutine FREEZE now limits only surface temperature
2346        (this means new output.txt for global_ocean.90x40x15,
2347         global_ocean.cs32x15, and global_with_exf)
2348    o added surface flux output variables to TIMEAVE_STATVARS
2349    
2350    checkpoint51n_pre
2351    o added "#undef ALLOW_USE_MPI" support to eesupp/src/gather_2d.F
2352    o added [#include "AD_CONFIG.h"] to all files that use the following
2353      defines:
2354      - ALLOW_ADJOINT_RUN
2355      - ALLOW_TANGENTLINEAR_RUN
2356      - ALLOW_ECCO_OPTIMIZATION
2357    
2358    checkpoint51m_post
2359    o incorporating changes to get TAMC/TAF working in genmake2
2360      - added new TAMC/TAF targets to the Makefile
2361      - various cleanups related to package handling
2362      - these changes should have no impact on the forward model
2363    
2364    checkpoint51l_post
2365    o changes to pkg/cal and pkg/exf that allow and speed-up long integrations
2366     - faster algorithm for cal_addtime.F
2367     - higher precision arithmetic, where needed
2368     - pkg/exf *startdate variables changed from calendar date to
2369       model integration time
2370    
2371    checkpoint51l_pre
2372    o add salt flux to forcing fields (used when salty sea-ice forms or melts)
2373    o enable to apply restoring on S & T only in a latitude band.
2374    o update output (external_forcing_surf modif. change truncation errors)
2375       global_ocean.cs32x15, global_ocean_pressure, lab_sea, natl_box
2376    
2377    checkpoint51k_post
2378    o change default to: useNHMTerms=.FALSE.
2379     - new output.txt for atmos. exp (NHMTerms were wrong but now turned off):
2380       adjustment.128x64x1, aim.5l_Eq_Ch, aim.5l_LatLon, hs94.128x64x5, hs94.1x64x5
2381     - new output.txt for idealized oceanic exp (NHMTerms are now turned off):
2382        exp1, ideal_2D_oce
2383     - change data file of oceanic exp (leave the results unchanged for now)
2384       exp2, global_ocean[90x40x15,pressure,with_exf], lab_sea, natl_box
2385    o set gravitySign automatically according to the vertical coordinate used
2386      (and change sign: back to "logical" value: +1 when R increases downward)
2387    o added an include barrier to the default CPP_OPTIONS.h and
2388      removed the #include "PACKAGES_CONFIG.h" from it
2389    o fix a bug in mom_fluxform (from chk51j_post)
2390    
2391    checkpoint51j_post
2392    o Added some AD-related initialisations in mom_vecinv/ mom_fluxform/
2393    o adjusted some flow directives (dynamics, thermodynamics)
2394    o added cubed-sphere case to test cost function
2395    o heckpoint_lev?_directives.h now include
2396      pkg-specific directives, whenever those are enabled.
2397    o Moving pkg-specific flow directives to corresponding pkg
2398      Moving pkg-specific differentiation list to corresponding pkg
2399      Moving pkg-specific checkpoint-lev storing to corresponding pkg
2400      ---> conventions are
2401           - pkg_ad.flow
2402           - pkg_ad_diff.list
2403           - pkg_ad_check_lev?_dir.h
2404    
2405    checkpoint51i_post
2406    o merge of the branch-genmake2
2407      - knowingly breaks the older genmake
2408      - automatic generation of all ALLOW_${PKG_NAME} defines
2409      - new testreport supersedes older testscript
2410    o large number of package inclusion and header cleanups
2411    checkpoint51i_pre
2412    
2413    o new output for adjoin of global ocean vector invariant
2414    o fix for checkpoint of thermodynamic seaice and bulk_force
2415    o Steph gchem various cleanups
2416    
2417    checkpoint 51h_pre
2418    o fixed some single quotes
2419    o modify gchem pkg to be more versatile
2420    o modifications to clean up dic pkg
2421    o add pkg/cfc
2422    
2423    checkpoint51g_post
2424    o provide links for ARPACK and ADM*TLM
2425    o start removing verification/vero/
2426    o update AD-related stuff
2427      (in particular some IF-statements in model/src/ routines)
2428    o adding to verification/global_ocean.90x40x15/ adjoint of
2429      vector invariant setup
2430    
2431    checkpoint51f_post
2432    o update advect_xz/output.txt (left from chekpoint50f_pre, ini_vel modif)
2433    o Mods and bug fixes to pkg/cal, pkg/exf, etc., needed for computation
2434      of tracer Green's fucntions for ocean inversion project.
2435    
2436    checkpoint51f_pre
2437    o Added on-the-fly spatial interpolation capability
2438        "USE_EXF_INTERPOLATION" to pkg/exf.
2439      - This is a temporary Cartesian-grid hack until
2440        the super-duper ESMF coupler becomes available.
2441      - See verification/global_with_exf/README for usage example.
2442      - Removed obsolete EXFwindOnBgrid and SEAICEwindOnCgrid
2443        flags and modified pkg/seaice accordingly.
2444    o Bug fix to pkg/ptracers, pkg/generic_advdiff/gad_calc_rhs.F,
2445        and pkg/kpp/kpp_transport_ptr.F for dealing with tracer
2446        non-local transport term.
2447    
2448    checkpoint51e_post
2449    o pkg/mom_vecinv:
2450      - changes related to hFac: use S/R from aim.5l_cs/code (coriolis & vort.advec)
2451      - add time-ave diagnostic of vorticity advection.
2452    o add diagnostic (instantaneous) of Shapiro Filter effect for T,S & UV.
2453    o atmospheric geopotential: - include water vapor effect;
2454                                - use p^kappa in p* scaling.
2455    o land pkg: read initial state from files.
2456    o AIM : add stratospheric drag in the upper level
2457    
2458    checkpoint51d_post
2459    o change function ILNBLNK (=> last non-blank char.) to return zero
2460      (instead of the string length) when the string. char is empty
2461    o fix bug in dxV,dyU definition of cubed-sphere grid (ini_curvilinear_grid)
2462    o modif's to restore TAMC compatibility
2463      - avoid "_d" constructs in PARAMETER declarations
2464      - avoid interrupting lines by comment lines
2465    o Use cluster local disks for purely local I/O
2466      vs. globally visible disks needed for ctrl stuff
2467      (merged from ecco-branch)
2468      - new active_file_loc... and mdsio_..._loc routines
2469      - affected packages: autodiff, ctrl, grdchk, mdsio
2470    
2471    checkpoint51c_post
2472    o introducing integer flag debugLevel
2473      - debLevZero: suppress all output
2474      - debLevA: standard
2475      - debLevB: equivalent to current debugMode=.TRUE.
2476    o introducing pathname variable mdsioLocalDir for mdsio
2477      that can be specified at runtime
2478      (relevant for cluster I/O to local disk)
2479    `
2480    >>>checkpoint51b_post
2481    adjoint of ptracers
2482    o disentangled ALLOW_PTRACERS using new ALLOW_GCHEM
2483    o extended state in checkpoint_lev?, etc.
2484    o alternative ctrl/cost with tr1 or ptracer
2485    o new comlev1_bibj_ptracers
2486    o new ptracers.flow
2487    o made ptracers_forcing same as external_forcing_s
2488    o added verification for adjoint with ptracers
2489      - adm. grdchk fail so far
2490      - tlm. grdchk OK
2491      - checked tapelev/comlev recomputations: OK
2492    <<<checkpoint51b_pre
2493    
2494    checkpoint51a_post
2495    o added code for biogeochemistry package
2496      - new pkgs: dic, gchem
2497      - new subroutine in ptracers
2498    o modify code for biogeo packages
2499      - in model/src and pkg/ptracers
2500    
2501    checkpoint51
2502    o merged improved packages from ecco-branch (ecco_c51_e34) to MAIN
2503      - autodiff, ctrl, exf, grdchk, seaice
2504      kept separate packages
2505      - cost, ecco, obcs
2506    o updating verification/internal_wave, verification/lab_sea
2507      (all verif's pass on faulks.lcs.mit.edu RH7.3, g77)
2508    
2509    checkpoint50i_post
2510    o Preparing next differentiable checkpoint and sync
2511      of MAIN vs. ecco-branch
2512      - 1st step: this one is differentiable
2513      - 2nd step: next(! not this) checkpoint will have updated packages
2514                  from ecco-branch)
2515    
2516    checkpoint50h_post
2517    o new package "land": provide surface BC for AIM.
2518    o pkg/ptracers: apply exchange to all tracers after reading a pickup.
2519    o AIM: use true log-P extrapolation for near surface temp (= as in
2520        F.Molteni paper) ; update aim.5l_cs output.
2521    o New variable in PARM03 for more flexible pickups
2522    o somewhat cleaned package initialisation sequence for
2523      ctrl/ cost/ ecco/ in packages_... routines
2524    
2525    checkpoint50g_post
2526    o merged with release1_p17 (pkg/seaice and verification/lab_sea)
2527      - added SEAICE_MULTILEVEL for 8-category sea-ice thermodynamics
2528      - LSR sea-ice dynamic solver moved to SouthWest B-grid location and
2529        made the default because of faster convergence than ADI
2530    
2531    checkpoint50f_post
2532    o exf totally restructured
2533      - replaced all exf_set_ routines by one generic exf_set_gen.F
2534        and made sure it's still differentiable
2535      - split exf_getffields.F into new exf_bulkformulae.F
2536      - exf_inscal_/exf_outscal_ suffixes consistent with field names
2537      - updated adjoint/makefile and relevant verif. accordingly
2538    
2539    checkpoint50f_pre
2540     o AIM: near surface temp evaluated from Pot.Temp: fixed for Part Cell ;
2541          + change Evap over land. (update aim.5l_cs output)
2542     o added missing .cvsignores and made uniform across expts
2543     o changed configuration of tidal_basin_2d expt
2544     o added pkg/debug functions for tracing code in fatal crashes
2545     o tidied pkg/monitor to use MONITOR_OPTIONS.h
2546     o new fn in pkg/monitor to stop model if solution grows too big
2547     o removed lots of single quotes from comments
2548    
2549    checkpoint50e_post
2550    o make KPP work with PTRACERS
2551     - fix gad_calc_rhs to call new routine kpp_transport_ptr, which is
2552       nearly a copy of kpp_transport_s
2553     - there is no analogue to SurfaceTendencyS, so I have to use
2554       gPtr(of the surface layer) instead
2555    o add a new platform SunFire+mpi (SunFire 15000) to genmake
2556    checkpoint50e_pre
2557    
2558    checkpoint50d_post
2559    o change kpp output from multiple-record state files to single-record state
2560      files analogous to write_state.F
2561    o reduce the output frequency of cg3d-related stuff to the monitor frequency,
2562      analogous to the cg2d-related output.
2563    o fix small problem with in ptracers_write_checkpoint.F: len(suff)=512,
2564      so that writing to internal file fn (with length 512) fails.
2565    checkpoint50d_pre
2566    
2567    checkpoint50c_post
2568    o fix problem in ini_procs.F when using MPI (was there since checkpoint48f)
2569    o add monitor diagnostic of vorticity (mon_vort3.F) and potential energy.
2570    o add time-average diagnostic of U*V and vertical diffusive flux for theta.
2571    o bug fixed in convective adjustment diagnostic (multi-tile set-up).
2572    o 4th Order Adv scheme: return to previous (c40pre7) masking near boundaries.
2573    
2574    checkpoint50c_pre
2575    Merging from release1_p13:
2576    o bug fix for pkg/seaice dynamic solver
2577    o Added SEAICE_initialHEFF to pkg/seaice
2578    
2579    checkpoint50b_post
2580    o store u*,v* in gU,V instead of in guNm1,gvNm1
2581    o in order to put the momForcing out of the Adams-Bashforth:
2582      move forcing & CD-scheme calls from mom_fluxform & mom_vecinv
2583      to timestep.F
2584    o new flag "useCDscheme" (default=F); replace guCD,gvCD by local arrays
2585    o re-generate output for highly sensitive test-exp:
2586       global_ocean_pressure, ideal_2D_oce, lab_sea, natl_box
2587    
2588    checkpoint50b_pre
2589    o restore the use of momAdvection & useCoriolis flags (mom_vecinv)
2590    o corrected CPP option mismatch in exf_Bulk... functions for case
2591      #define ALLOW_ATM_WIND && #undef ALLOW_ATM_TEMP
2592    
2593    checkpoint50a_post
2594    o Bug fix for merging between c50 and KPP.
2595      ikey was passed from thermodynamics to kpp_calc via
2596      common block rather than being recomputed in kpp_calc,
2597      in contradiction with new key itdkey.
2598      New key ikppkey created, and tamc.h headers updated.
2599    
2600    checkpoint50
2601    - 2nd step of merge with ecco-branch:
2602      merge changes in ecco-branch back into main trunk
2603    - bug fix in find_alpha
2604    - more storing in gmredi_calc_tensor.F, kpp_routines.F
2605    - avoid iterative loop in ini_pressure for ALLOW_AUTODIFF_TAMC
2606    - merged some sliced AD support routines
2607    
2608    checkpoint49
2609    merged from ecco-branch:
2610    o exf:
2611      - Enable initialisation of forcing fields to constant
2612        (runtime) values.
2613      - in exf_getffields.F
2614        Reduce i-/j-loop to interior domain, discarding overlaps.
2615        That also fixes wrong TAF-key computations for key_1, key_2
2616        with bulf formulae.
2617      - exf_init.F modify #ifdef for exf_init_evap
2618      - exf_getffieldrec.F, ctrl_getrec.F
2619        The following INT-usages are not safe:
2620          fldsecs  = int(fldsecs/fldperiod)*fldperiod
2621          fldcount = int(fldsecs/fldperiod) + 1
2622        and were modified.
2623    o autodiff: checkpoint_lev...
2624      - updated storing for bulk formulae (some arrays were missing)
2625      - added state for seaice package
2626      - synchronized with main branch
2627    o DIVA:
2628      Modif.s in
2629      - the_main_loop.F
2630      - the_model_main.F
2631      and added cost_final_restore.F cost_final_store.F
2632      o With these changes, it is possible to fully separate
2633        the first forward run to compute the cost function (mdthe_main_loop)
2634        and adjoint runs over individual DIVA intervals (adthe_main_loop)
2635        into separate model executions.
2636        This enables better tuning of DIVA to given queue sizes.
2637      o Loss of cost function value in consecutive DIVA runs is
2638        fixed by storing to 'costfinal' file.
2639      o Appropriate call of ctrl_unpack/_pack,grdchk_main at
2640        beginning/end of adjoint integration is accounted for.
2641      The current changes apply to TAF-1.4.26.
2642      TAF has one remaining bug, requiring one manual change
2643      (see MITgcm manual).
2644    o cal: synchronized between MAIN and ecco-branch
2645    
2646    checkpoint48i_post
2647    o Changes to restore differentiability of code w.r.t. previous tag
2648      (mostly adding new routines to make list and replacing
2649      pressure by totPhiHyd).
2650    o Updated and merged grdchk package
2651      - has both ADM and TLM checks
2652      - works for single- and multi-proc.
2653      - output cleaned
2654      - worked successfully for parallel DIVA
2655    o genmake:
2656      - Adding -platform=SP4
2657      - Modif. for DEC Alpha (many don't have makedepend; use mkdep instead).
2658    o Modif. for DIVA:
2659      ctrl_unpack should not be called in intermediate DIVA interval.
2660      (similar thing would apply for active files such as
2661      tbar, sbar, psbar, which should not be reinitialised;
2662      only relevant for ecco-branch)
2663    
2664    checkpoint48h_post
2665    o improve "ini_p_ground" when using finite difference form for calc_phi_hyd
2666    o Added net flux to downward flux conversion to pkg/exf/exf_getffields.F
2667    o Added SEAICE_initialHEFF to pkg/seaice
2668    o ecco_the_model_main.F: SEAICE_WRITE_PICKUP must precede WRITE_CHECKPOINT
2669    
2670    checkpoint48g_post
2671    --- EOS:
2672    o compute locally the pressure for use in EOS: UNESCO, JMD95P, MDJWF
2673      store total Potential in totPhyHyd for diagnostics & EOS.
2674    o fix restart and overlap Pb when using Z-coord and EOS funct. of P
2675    --- Pressure/geopotential gradient:
2676    o use Ro_surf & R_low instead of hFac in cal_phi_hyd:
2677    o NLFS + p-coord.: eta*Alpha' is not longer lagging 1.time-step behind
2678      ( changes results of global_ocean_pressure )
2679    o NLFS + z-coord.: add eta*Rho' contribution.
2680    o accurate phiHyd when using interface-W at the middle between 2 centers
2681     ( changes results of ideal_2D_oce )
2682    o includes r* 2nd term in potential gradient.
2683    
2684    checkpoint48f_post
2685    Merging from release1_p12:
2686    o Modifications for using pkg/exf with pkg/seaice
2687      - improved description of the various forcing configurations
2688      - added basic radiation bulk formulae to pkg/exf
2689      - units/sign fix for evap computation in exf_getffields.F
2690      - updated verification/global_with_exf/results/output.txt
2691    o Added pkg/sbo for computing IERS Special Bureau for the Oceans
2692      (SBO) core products, including oceanic mass, center-of-mass,
2693      angular, and bottom pressure (see pkg/sbo/README.sbo).
2694    o Lower bound for viscosity/diffusivity in pkg/kpp/kpp_routines.F
2695      to avoid negative values in shallow regions.
2696      - updated verification/natl_box/results/output.txt
2697      - updated verification/lab_sea/results/output.txt
2698    o MPI gather, scatter: eesupp/src/gather_2d.F and scatter_2d.F
2699    o Added useSingleCpuIO option (see PARAMS.h).
2700    o Updated useSingleCpuIO option in mdsio_writefield.F to
2701      work with multi-field files, e.g., for single-file pickup.
2702    o pkg/seaice:
2703      - bug fix in growth.F: QNET for no shortwave case
2704      - added HeffFile for specifying initial sea-ice thickness
2705      - changed SEAICE_EXTERNAL_FLUXES wind stress implementation
2706    o Added missing /* */ to CPP comments in pkg/seaice, pkg/exf,
2707      kpp_transport_t.F, forward_step.F, and the_main_loop.F
2708    o pkg/seaice:
2709      - adjoint-friendly modifications
2710      - added a SEAICE_WRITE_PICKUP at end of the_model_main.F
2711    
2712    checkpoint48e_post
2713    o New S/R for diagnostic of bottom pressure (phi0surf was missing in c48d_post)
2714    o dynamics: change definition of computational domain & adapt mom_fluxform
2715      accordingly ; when viscA4=0, allows to run the dynamics with Olx=Oly=2.
2716    o following exp works with Olx=Oly=2 (and pass through checkbounds option):
2717        adjust_nlfs.cs-32x32x1 adjustment.128x64x1 adjustment.cs-32x32x1
2718        exp0 exp1 exp2 exp4 exp5 hs94.cs-32x32x5 hs94.128x64x5 hs94.1x64x5
2719        global_ocean.90x40x15 global_with_exf global_ocean_pressure
2720        inverted_barometer solid-body.cs-32x32x1
2721      (high order AdvScheme and/or multiDimAd works with Olx=Oly=2 ? not sure)
2722    
2723    checkpoint48d_post
2724    o in preparation for r*:
2725     a) use pre-computed gradient of hydrostatic potential:
2726        changes in timestep.F & mom_cdscheme.F affects results of ideal_2D_oce
2727     b) move phi0surf from calc_phi_hyd to calc_grad_phi_hyd:
2728        => affects results of glob_oce_pressure (different truncation error)  
2729      update output.txt of ideal_2D_oce & global_ocean_pressure
2730    
2731    checkpoint48d_pre
2732    o in preparation for r*:
2733      new S/R (calc_grad_phi_hyd.F) to compute Hydrostatic potential gradient.
2734      pass the 2 comp. of the grad. as arguments to momentum S/R.
2735      but for the moment, only used if it does not change the results.
2736    o add finite volume form of calc_phi_hyd for buoyancyRelation OCEANIC & OCEANICP
2737    
2738    checkpoint48c_post
2739    Modifications in treatment of initial flux forcing controls
2740    to avoid extra storing of flux fields.
2741    
2742    checkpoint48c_pre
2743    o Added tidal_basin_2d experiment (currently 1D!)
2744    o can use r* Coordinate with OBC (but Orlanski Rad. BC not yet implemented)
2745    
2746    checkpoint48b_post
2747    o r* coordinate added in #ifdef NONLIN_FRSURF block.
2748     (modification to pressure gradient not yet implemented)
2749    o mom_fluxform: new S/R mom_calc_rtrans.F computes vertical transports
2750      (for U & V) that are used for vertical advection of momentum.
2751    
2752    checkpoint48a_post
2753    o In preparation for r*, use temp. array to compute vertical transport
2754       in flux-form momentum pkg. => change results of few test-exp.
2755      Update output of: exp4, exp5, front_relax, global_ocean_pressure,
2756                        lab_sea, natl_box & plume_on_slope
2757    
2758    checkpoint48
2759    o fix small bug that was causing lot of warning (TIMER_STOP 'UPDATE_CG2D')
2760    
2761    checkpoint47j_post
2762    o add new exp. (ideal_2D_oce) to test "exotic" parameters and options.
2763    o moved adexch from forward_step to addummy_in_stepping
2764    o added exch in ctrl_map_...
2765    o aveFreq.=0. at end of cost_final to avoid overwrite in
2766      reverse checkpointing loop
2767    o Yet more changes in gmredi:
2768      * adgmredi_calc_tensor
2769        avoiding all recomputation of gmredi_slope_limit
2770      * adgmredi_x/y/rtransport
2771        added flag for excessive storing to avoid recomp. of
2772        u/v/rtans, dTdx/y/z
2773        -> this is not really necessary and very memory-consuming
2774      * adgmredi_slope_psi:
2775        consistency with gmredi_slope_limit in treatment of GM_slopeSqCutoff
2776      * gmredi_slope_limit
2777        re-activated full calculation of taperfct for case 'ac02'
2778    o updating verification/ adjoints of carbon, global_ocean.90x40x15
2779    
2780    checkpoint47i_post
2781    o GM_EXCLUDE_() replace GM_TAPER_(): by default, all the code is compiled.
2782    o add GM_Small_Number & GM_slopeSqCutoff as run-time parameters (data.gmredi)
2783      default values = 1.D-12 & 1.D+48 (=> give same results as checkpoint47f_post)
2784    o cg2dTargetResWunit: define tolerance using deltaTmom (and not deltaTfreesurf)
2785    o gmredi: fix few bugs.
2786    
2787    checkpoint47h_post (duplicate tag for PH's c48 tag, in order to move c48)
2788    This will be a good checkpoint to plug into the ecco-branch.
2789    o few modif.'s to get latest version adjointed
2790      (mainly kick out code in ini_linear_phisurf)
2791    o modif's to run adjoint with exactConserv
2792    o case GM_BOLUS_ADVEC should be cleaned
2793      S/R gmredi_slope_psi should be cleaned
2794    o verification/carbon now has exactConserv=.TRUE.
2795    
2796    checkpoint47g_post
2797    o time-average AIM output: becomes independent from statvars time-average
2798      (can be used with #undef ALLOW_TIMEAVE) ; add new variables (e.g., RH)
2799    o After TAF bug fix:
2800      Tested adjoint of gmredi package.
2801      Tests were done with checkpoint47 rather than with latest
2802      checkpoint47f_post since the latter is broken for the adjoint
2803      verification/carbon/ contains both ADM and TLM gradient checks.
2804    Here they are, before they get changed/lost/stolen.
2805    Mostly modif.'s to fix numerical sensitivities.
2806    Gradient checks OK for
2807    - GM_taper_scheme:
2808      * clipping
2809      * ac02
2810      * linear
2811      * glw91
2812      * dm95
2813      * ldd97
2814    - GMREDI_OPTIONS:
2815      * GM_VISBECK_VARIABLE_K
2816      * GM_NON_UNITY_DIAGONAL
2817      * GM_EXTRA_DIAGONAL
2818      * GM_BOLUS_ADVEC
2819    in conjunction with data.gmredi parameters to be checked in
2820    in a few minutes under verification/carbon/code/
2821    
2822    checkpoint47f_post
2823    Merging from release1_p10:
2824    o modifications for using pkg/exf with pkg/seaice
2825      - pkg/seaice CPP options SEAICE_EXTERNAL_FORCING
2826        and SEAICE_EXTERNAL_FLUXES
2827      - pkg/exf CPP options EXF_READ_EVAP and
2828        EXF_NO_BULK_COMPUTATIONS
2829      - usage examples are Experiments 8 and 9 in
2830        verification/lab_sea/README
2831      - verification/lab_sea default experiment now uses
2832        pkg/gmredi, pkg/kpp, pkg/seaice, and pkg/exf
2833    
2834    checkpoint47e_post
2835    o created a tag prior to creating a branch
2836    
2837    checkpoint47d_post
2838    o fixed bug in the oceanic pressure coordinates code: vertical viscosity
2839      at the bottom boundary had an erroneous half slip boundary condition
2840    o added bottom drag and no slip boundary condition capabilities to
2841      oceanic pressure coordinates code
2842    o added new verification experiment global_ocean_pressure, this experiment is
2843      also described in the tutorial section of the manual
2844    checkpoint47d_pre
2845    
2846    checkpoint47c_post
2847    o Added a verification experiment for a global cubed-sphere ocean run
2848      -  verification/global_ocean.cubed32x32x30
2849      -  uses pkg/therm_seaice and pkg/bulk_forcing
2850    
2851    o allow to run AIM physics with SPEEDY input files (from Franco Molteni)
2852    o allow a more accurate definition of Ro_Surf (selectFindRoSurf=1)
2853      when using P-coordinate; only implemented for atmospheric config.
2854    o OCEANICP & realFreshWater: include P-E direct effect on wVel ;
2855      NOTES: requires option NONLIN_FRSURF to be "#define".
2856    o update advect_xz/results/output.txt (left from checkpoint44g_post)
2857    
2858    checkpoint47b_post
2859    Merging from release1_p9:
2860    o pkg/seaice
2861      - removed GOTO's and added taf directives
2862      - double precision constants to reduce the g77 (Linux)
2863        to F77 (SGI) differences reported in release1_p8
2864    o tools/genmake
2865      - added SGI options
2866    o verification/testscript
2867      - updated to that of checkpoint47a_post
2868    o verification/global_ocean.90x40x15/input/eedata
2869      - modified for SGI f77 compatibility
2870    o verification/lab_sea
2871      - added description of sea-ice model
2872      - added missing matlab routines
2873      - added test of thermodynamics parallelization
2874    
2875    checkpoint47a_post
2876    o new pkg: aim_v23
2877     = F. Molteni atmos.physics (SPEEDY, ver23) adapted to MITgcm.
2878       for now, keep the same surface forcing as before.
2879     - Part-Cell implemented into AIM; check that Heat & Water are conserved
2880     - aim.5l_cs: use new aim pkg (run 10yr & get better results than before)
2881     - aim.5l_LatLon & aim.5l_Equatorial_Channel are still using old aim pkg
2882    o add diagnostic of surface correction term in monitor output
2883    
2884    o bulk_force and therm_seaice
2885    - Two packages:  bulk_force (Bulk forcing)
2886      and therm_seaice (thermodynamic_seaice) - adopted from LANL CICE.v2.0.2
2887    - Earlier integration from Stephaine Dutkiewicz
2888      and Patrick Heimbach.
2889    - Two ifdef statements for compile time,
2890       ALLOW_THERM_SEAICE and ALLOW_BULK_FORCE
2891    
2892    checkpoint47
2893    differentiable version of checkpoint46n_post
2894    o bug fix in quasihydrostaticterms
2895    o * "clean" adjoint code (in terms of extensive recomputations)
2896        can now be obtained for all GMREDI options (i.e. for
2897        - GM_VISBECK_VARIABLE_K
2898        - GM_NON_UNITY_DIAGONAL
2899        - GM_EXTRA_DIAGONAL
2900        - GM_BOLUS_ADVEC )
2901      * However, wrong gradient check problem remains unsolved.
2902      * New CPP options have been introduced for different
2903        tapering schemes
2904    o external_fields_load now part of differentiation list
2905    o pressure needs multiple storing;
2906      would be nice to have store_pressure at beginning or
2907      end of forward_step, e.g. by having phiHyd global (5-dim.)
2908      (NB: pressure is needed for certain cases in find_rho,
2909      which is also invoked through convective_adjustment).
2910    o recomputations in find_rho for cases
2911     'JMD95'/'UNESCO' or 'MDJWF' are OK.
2912    o #define ATMOSPHERIC_LOADING should be differentiable
2913    o ini_forcing shifted to begining of initialise_varia
2914    o Incorporating QNVS line search routines into MITgcm
2915      (this is separate code, and therefore not under pkg)
2916      lsopt/, optim/
2917    o Updated verification/carbon/
2918      - #define GM_VISBECK_VARIABLE_K
2919      - GM_taper_scheme    = 'ldd97'    
2920    
2921    checkpoint46n_post
2922    Merging from release1_p8:
2923    o verification/natl_box:
2924      updating new external_fields_load routine
2925    o New package: pkg/seaice
2926      Sea ice model by D. Menemenlis (JPL) and Jinlun Zhang (Seattle).
2927      The sea-ice code is based on Hibler (1979-1980).
2928      Two sea-ice dynamic solvers, ADI and LSR, are included.
2929      In addition to computing prognostic sea-ice variables and diagnosing
2930      the forcing/external data fields that drive the ocean model,
2931      SEAICE_MODEL also sets theta to the freezing point under sea-ice.
2932      The implied surface heat flux is then stored in variable
2933      surfaceTendencyTice, which is needed by KPP package (kpp_calc.F and
2934      kpp_transport_t.F) to diagnose surface buoyancy fluxes and for the
2935      non-local transport term.  Because this call precedes model
2936      thermodynamics, temperature under sea-ice may not be "exactly" at
2937      the freezing point by the time theta is dumped or time-averaged.
2938      N.B.: fairly large differences in accuracy occur across
2939            different platforms/compilers; comparison between
2940            g77 (Linux) and F77 (SGI Origin 2000/MIPSpro)
2941            generated output gives:
2942       T           S           U           V
2943      C D M    c        m  s        m  s        m  s        m  s
2944      n p a R  g  m  m  e  .  m  m  e  .  m  m  e  .  m  m  e  .
2945      f n k u  2  i  a  a  d  i  a  a  d  i  a  a  d  i  a  a  d
2946      g d e n  d  n  x  n  .  n  x  n  .  n  x  n  .  n  x  n  .
2947    
2948      Y Y Y Y  5  5  7  7  7  8 10  9  6  6  6  6  7  5  7  5  7 FAIL  lab_sea
2949    o GAD:
2950      - generated new common blocks to account for call of
2951        same gad routines with differing traceridentities
2952        (needed to modify tracerIdentity indices in GAD.h)
2953      - generated separate common blocks for case useCubedSphereExchange
2954        (Department of Futurology)
2955      - parameter lists to gmredi_?transport: added tracerIdentity
2956      - added new key indices to tamc.h
2957    o external_fields_load:
2958      - added this routine to TAF list
2959      - needed to make some common blocks global and additional storing
2960        along the same lines as exf package (checkpoint_lev?_directives.h)
2961    o exf:
2962      updated external forcing package
2963      - bug fixes carried over from ecco-branch
2964        (missing OBCS_OPTIONS.h in two routines)
2965      - enable easy to use "no forcing".
2966      - added exf I/O for atmospheric loading
2967      - added exf I/O for runoff data
2968      - transfered scaling between exf <-> MITgcm to exf namelist
2969    o Adding new verification experiment global_with_exf.
2970      This verification experiment is almost identical to the
2971      global_ocean.90x40x15 experiment, except that it uses
2972      the exf (and cal) package instead of the
2973      external_fields_load routine (cf README file).
2974    
2975    checkpoint46m_post
2976    o modified testscript to return -- when there are no lines of "%MON" output
2977    o added new flag "quasiHydrostatic" for QH mode
2978      and new routine quasihydrostaticterms()
2979    o added 2*Omega*Cos(phi)*W to u equations (non-hydrostatic Coriolis term)
2980      New routine: mom_u_coriolis_nh()
2981    o fixed sign of non-hydrostatic metric terms in u and v equations.
2982      Depend on correct sign of gravitySign.
2983  o added work.pc* to .cvsignore in aim directories using ifc  o added work.pc* to .cvsignore in aim directories using ifc
2984  o introduced flag for controllin non-hydrostatic metric terms  o introduced flag for controllin non-hydrostatic metric terms
2985  o removed gravitySign from PARM04  o removed gravitySign from PARM04

Legend:
Removed from v.1.97  
changed lines
  Added in v.1.894

  ViewVC Help
Powered by ViewVC 1.1.22