/[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.14 by cnh, Tue Sep 29 18:57:53 1998 UTC revision 1.346 by heimbach, Fri Sep 17 23:19:12 2004 UTC
# Line 3  $Header$ Line 3  $Header$
3      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
4      ==============================      ==============================
5    
6    checkpoint55
7    o up-to-date adjoint of previous breaks
8      - natl_box_adjoint: problem for exp 12, 13: cost = 0. needs fix
9      - global_ocean_ebm: adjoint still needs fix (TLM ok)
10      - global_ocean.90x40x15: extended GMREDI_OPTIONS.h
11      - carbon: * remove tr1-related adjoint verification
12                * add ptracer as control variable
13    o remove all tr1-related code (ALLOW_PASSIVE_TRACER)
14      (adjoint stuff still has some tr1 'names', but all use ptracer arrays)
15    
16    checkpoint54f_post
17    o in verification/carbin/ remove experiment related to
18      ALLOW_PASSIVE_TRACER (array tr1 etc)
19      code_ad/ input_ad/ results_ad
20    
21    o add two new packages
22      - ggl90, TKE-model of Gaspar et al. (1990), Blanke+Delecluse (1993)
23        + subject to optimization (memory)
24      - opps, OPPS (ocean penetrative plume scheme) of Paluszkiewicz+Romea (1997)
25        + subject to reordering (many GOTOs in the original code)
26        + so far opps is called for every (i,j) point, and then operates in
27          the vertical; one may want to reorder the scheme in order operate in
28          horizontal slabs at the cost of (a lot of) memory, at least ten new 3D
29          fields)
30    o overhaul of IO so that we now have flags for MDSIO and/or MNC
31      - all verification tests compile and run with linux_ia32_g77
32      - defaults are compatible with current input files--nothing
33        should change if you were not previously using MNC
34      - MNC output has been added in numerous places (eg. timeave)
35        but there are still a few writes not yet do-able with MNC
36        (this is in progress)
37      - flags now allow for either/or/both use of MDSIO and MNC and
38        documentation will soon follow
39      - numerous small formatting cleanups for ProTeX
40    o add version info (via BUILD_INFO.h) to MNC and stdout
41    
42    checkpoint54e_post
43    o add two new packages
44      - pp81 (Packanowski and Philander, 1981), Richardson number and
45        stratification dependent mixing
46      - my82 (Mellor and Yamada, 1982) level 2 turbulence closure scheme
47      - these scheme operate in a similar manner as KPP (without ghat, of
48        course), however there is only one diffusivity that is used for both
49        temperature and salinity (and passive tracers)ç
50    o add offline package
51    o add "verification/dic_example" which contains a dic-gchem-ptracer setup
52      provided by Stephanie Dutkiewicz
53    o genmake2: add ability to search for C compilers and cleanup test output
54      - fixes recent SX-6 problems and should help with others (eg. HP-UX)
55    
56    checkpoint54d_post
57    o data.diagnostics: if levels() is unspecified then ALL levels are diagnosed
58    o bug fix in pkg/cal/cal_addtime.F for TheCalendar='model' day count is wrong,
59      leading to additional shift by 5 days each year of integration
60       (i.e. leading to considerable offset over the years)
61    o update global_ocean.cs32x15/thsice: use z* + RealFW + staggerTimeStep
62    o start with no AB and no initial filtering (staggerTimeStep):
63      change the results of test-exp: hs94.128x64x5, hs94.1x64x5 & hs94.cs-32x32x5
64    o move ocean specific S/R calls from forward_step.F to do_oceanic_phys.F
65      (external loading & cpl import/export stay in forward_step.F)
66    o update coupling interface to work with new staggerTimeStep
67    o change MDSIO ptracers_pickup.
68    o fix a bug in Flux deriv. vs Ts (pkg/aim_v23/phy_suflux_sice.F);
69    o genmake2 fixes so netcdf now works on halem ("osf1_alpha_*")
70    o bugs fixed in kpp_calc.F (ustarY) and external_forcing.F (Qsw & Partial-cell)
71    
72    checkpoint54c_post
73    o replace surfaceTendency U,V,S,T,Tice,Ptr by surfaceForcing U,V,S,T,Tice,Ptr
74      this affects (truncation error) output.txt of test-exp:
75       global_ocean_ebm,_pressure,.cs32x15(&.thsice), lab_sea & natl_box
76    o pkg/kpp: replace pMask by maskC to reduce memory size (one 3.D array)
77    o change Qnet to always be the net heat flux, (+upward).
78      affects (truncation error) output of natl_box exp.: updated
79    o define the max number of passive tracers in PTRACERS_SIZE.h
80    o start to test mnc routinely in exp0
81    o add sea-ice loading (sIceLoad) as a new forcing field.
82    
83    checkpoint54b_post
84    o add testreport "-j JOBS" option for parallel builds (tested and pretty
85       impressive on Altix and Opteron systems)
86    o diagnostics can now write NetCDF files through the mnc package
87    o staggerTimeStep & NLFS: update pkg aim_v23 & thsice; update aim.5l_cs output
88    o staggerTimeStep & multi-Dim-Advec: Exch(U,V) added
89    o staggerTimeStep & NLFS: rescale T & S surface tendencies.
90      affects (truncation error) output of lab_sea & natl_box exp.: updated
91    o change pickup _cd & _ptracers (old pickup restart: usePickupBeforeC54=.T.)
92    
93    checkpoint54a_post
94    o re-write staggerTimeStep: step fwd U,V and then T,S (reverse the order).
95    o change pickup file (to restart from old pickup, set usePickupBeforeC54=.T.)
96    o get a perfect restart when using RealFreshWaterFlux + NLFS (not finished)
97    o update output of all exp. that use staggerTimeStep (except hs94.cs & 2D)
98      + internal_wave (shift in writing cg2d_ini_res)
99    checkpoint54a_pre
100    
101    o require forcing_In_AB=.FALSE. and remove surfaceTendencyTice from pkg/seaice
102      - modified verification/lab_sea and natl_box_adjoint accordingly
103    
104    checkpoint54
105    checkpoint53g_post
106    o prepare splitting of thermodynamics: store convect.counter in common block
107    o store d.etaH/dt (instead of Div.hV) in common ; affects (truncation error)
108      output of: global_ocean.cs32x15, global_ocean_pressure & internal_wave
109    o cnh's modifs to gad_advection.F for cube-sphere multi-dim advection
110    o new parameter "nShapS": allow to treat differently S from T (nShapT)
111    o separate Vert.Advec.Scheme from horizontal Advec.Scheme (T & S)
112    o restore adjointability
113    
114    checkpoint53f_post
115    o modifications that affect AIM experiment results (update output.txt):
116      - no advection of S at top interface Nr (pkg/generic_advdiff)
117      - air surf. temp: use lower value between T0 & T1 (phy_suflux_prep.F)
118    o AIM pkg:
119      - include stability function into surf.Flux derivative relative to Tsurf
120      - calculate clear-sky radiation & surface temp. change (for diagnostics)
121    
122    checkpoint53e_post
123    o merged cylindrical coord configuration
124    o added rotating_tank experiment
125    checkpoint53e_pre
126    
127    checkpoint53d_post
128    o faulks upgraded: re-generate output.txt that have changed:
129       global_ocean.cs32x15(.thsice), global_ocean_ebm, lab_sea, natl_box
130    o Added Bryan and Lewis, 1979, vertical diffusivity profile
131    o pkg/land: fix problem in land_impl_temp.F when Ts arround freezing.
132    o added Sadourny discretization of Coriolis
133      - moved some PARAMETERS from mom_*_coriolis.F to PARAMS.h
134      - re-enabled use of omega3 (useAbsVorticity)
135    o added Leith (Phys. Fluids, 1968, 10, 1409-1416) variable viscosity for
136      vector-invariant equations
137      - note: does *NOT* yet use same variable visc. for no-slip BC's.
138    o recoded the lateral boundary conditions for non-hydrostatic w, this time
139      hopefully without new bugs
140      - still to do: biharmonic friction for non-hydrostatic w
141    o bug fix for mom_*_sidedrag: rA -> rAs,rAw
142    o regenerated output for global_ocean_ebm (using -ieee)
143    o fix mom_common/mom_*_sidedrag.F to recover numeric output prior to creation
144      of mom_common/
145      - simple re-arrangement of instructions within computing loop
146    checkpoint53d_pre
147    
148    checkpoint53c_post
149    o new version of coupler for AIM+thSIce and Ocean models
150     - new fields (SSS,h_MixLayer ...) are exchanged through the coupler
151     - land: change Evaporation of snow
152     - aim with thSIce: fix bug in snow-precip.
153    o changes to calc_gw.F
154     - bug fix for w^2 term near the bottom boundary
155     - (hopefully) improve the lateral slip boundary condtions for use with
156        partial/looped cells
157      - because the bug fix changes two verification experiments anyway (exp5
158        and plume on slope), change the lateral boundary condition from half slip
159        to the value of no_slip_sides
160    o ebm package wasnt quite up to the parallel task. Fixed that.
161    o Adjoint of EBM package + verification
162      * TLM OK
163      * ADM not sufficient accuracy yet (needs further testing)
164    
165    checkpoint53b_post
166    o Commiting new energy balance model to repository
167      * package is pkg/ebm
168      * verif. is verification/global_ocean_ebm
169      * references are in ebm_driver.F
170    C      * X. Wang, P. Stone and J. Marotzke, 1999:
171    C        Global thermohaline circulation. Part I:
172    C        Sensitivity to atmospheric moisture transport.
173    C        J. Climate 12(1), 71-82
174    C      * X. Wang, P. Stone and J. Marotzke, 1999:
175    C        Global thermohaline circulation. Part II:
176    C        Sensitivity with interactive transport.
177    C        J. Climate 12(1), 83-91
178    C      * M. Nakamura, P. Stone and J. Marotzke, 1994:
179    C        Destabilization of the thermohaline circulation
180    C        by atmospheric eddy transports.
181    C        J. Climate 7(12), 1870-1882
182    o Will need long integration testing.
183    checkpoint53b_pre
184    
185    o created pkg/mom_common in preparation for variable viscosity code
186    o renamed and split ini_mnc_io
187    o pkg/land: only liquid water can diffuse or run-off
188    o AIM using land: soil wetness availability account for snow
189    o added printMapIncludesZeros to EEPARMS namelist
190    
191    checkpoint53a_post
192    o restore TAMC compatiility for exf_constants.h
193      (no usage of _d in .h)
194    o Additional storing in KPP in an attempt to fix
195      TAMC problem with adjoint of KPP code.
196      (no success...)
197      Identical code works fine with TAF.
198    o Fixed verification/natl_box_adjoint experiments.
199      Initial conditions for Experiments 4 and 5 are now
200      set to "SEAICE_initialHEFF=0", which is more reasonable,
201      and hence gives results closer to that of Experiment 2.
202      Experiment 6 requires "SEAICE_initialHEFF=1" and is working once again.
203    
204    checkpoint53
205    o stable checkpoint with up to date adjoint
206      TLM tests only run for 1st grdchk at the moment. Its unclear if
207      this is a code problem or a problem with resetting code for g_
208      variables that is being autogenerated wrong.
209      Otherwise:
210       o code is testing well on Linux (P4 and AMD), SGI Alitix and Irix.
211       o IBM and HPQ tests could not be run because NCAR (IBM) and NCCS (HPQ)
212         are both still in chaos following their security messes.
213    
214    checkpoint52n_post
215    o various build (mostly genmake2) changes including:
216      - ability to build/run more easily within Cygwin and MacOS X
217      - more complicated Makefiles with a stronger dependence on Gnu Make
218    o pkg/seaice modifications
219      - added SEAICE_deltaTtherm and SEAICE_deltaTdyn in order to reduce cost
220        of pkg/seaice.  For time being, SEAICE_deltaTtherm = deltaTtracer
221        and SEAICE_deltaTdyn must be integer multiple of SEAICE_deltaTtherm
222      - changed proxy for geostrophic velocity and updated
223        verification/lab_sea/results/* accordingly
224      - removed ADI dynamic solver from pkg/seaice
225      - replaced all occurrences of 1/CSTICE or 1/CSUICE
226        they caused a segmentation fault under certain circumstances
227      - removed unused field WATR
228    o bug fix in exf-package:
229      -  u/vwind are defined at tracer/pressure points. The values of u/vwindmask
230         now reflect that.
231    o small fixes in the cal-package:
232      - set reference date to first of January for the 'model'-calendar
233      - failing of cal_CheckDate in cal_FullDate now actually results in a
234        warning
235    o small modifications in exf-package to increase flexibility:
236      - change climtempfreeze from a constant to a runtime parameter that
237        is specified in data.exf_clim (default = -1.9)
238      - introduce runtime parameter windstressmax (default = 2.0) that is
239        specified in data.exf
240    o fix in pkg/thsice:
241      - update Evap (Tsf changes) to be consistent with Latent heat flux
242      - maintain snow precipitation unchanged (even if Tsf >=0).
243     both affect global_ocean.cs32x15/(.thsice) results ; update output.txt.thsice
244    
245    checkpoint52m_post
246    o commented out call to cal_GetMonthsRec in swfrac.F and added some comments;
247      this does not change any of the results, because myIter=0 in swfrac always
248      lead to jwtype=2 (the default anyway), but the call makes little sense
249      as a default
250    o no SHORTWAVE HEATING lost at the bottom; affects lab_sea output; updated
251    o re-work pkg/thsice interface with ocean & bulk_force pkg to allow
252      atmospheric model (AIM) to use it ; add a "slab ocean" component.
253    o pkg/aim_v23 : add interface to call thermodynamic sea-ice (thsice)
254    o update global_ocean.cs32x15/output (.thsice) after changes in pkg/thsice
255    o extending useSingleCpuIO option to work with new exch2 I/O format
256      - old-style, missing-tile I/O is still accessible by defining CPP
257        option MISSING_TILE_IO in pkg/mdsio/MDSIO_OPTIONS.h
258    o monitor package can write to NetCDF files and/or STDOUT
259    o fix re-definition bug in MNC_GRID_INIT_ALL()
260    o doc/api_reference added
261      - a framework for building an API Reference Manual using all
262        the "protex" comments embedded in the code
263      - see pkg/generic_advdiff, pkg/mnc for examples
264    o MNC:
265      - make myThid the last argument for all subroutines
266      - new default for the grid files: NO halos
267      - add useMNC and other run-time flags
268      - separate per-file-group handling of the unlimited dimension
269      - early initialization of MNC w/ flags read at the eeboot stage
270        and lookup tables set in initialize_fixed
271      - write all MNC output to a freshly-created directory
272    o thermodynamics sea-ice (thsice) is now tested with testreport.
273    o test exp. advect_cs: use the standard cs32 grid ; update output.
274    o Added functionality to grdchk:
275      pick global i,j,k position (or nearest wet) where to perform check.
276    
277    checkpoint52l_post
278    o new land formulation:
279      a) use ground enthalpy as prognostic variable to ensure exact
280         energy conservation.
281      b) account for water temperature and for latent heat of freezing
282         in all processes (rain, run-off, ground storage)
283      c) compute surface and ground temperature implicitly.
284    o aim_v23 modification for new land model:
285      a) Treat separately land / ocean / sea-ice surface fluxes
286         to allow implicit computation of land & sea-ice surface temp.
287      b) add snow precipitation.
288    checkpoint52l_pre
289    
290    o fix problem (when 1 tile is empty) in min/max monitor.
291    o fix bug in timeAve (u,vZetatave in common block)
292    o no restoring terms under ice for pkg/seaice
293    o moved SEAICE_DO_DIAGS to S/R do_the_model_io
294    o bug fix for pkg/seaice pickups
295    o change MNC call locations and add coordinate attributes
296    o mask vorticity at the corner ; affects global_ocean.cs output
297    o fix ini_curvilinear_grid ; test CS experiments with mpi
298    o aim.5l_cs: modify sea-ice fraction input file ; update output
299    o exf: Adding simple range check routine for exf fields after read
300    
301    checkpoint52k_post
302    o removed top-level directory "diags"
303      - we migrated these functions to pkg/timeave a long time ago
304    o fixed bug introduced in pkg/monitor
305    o accuracy ctrlprec = 32 insuffient for gradient checks using
306      averaged fields (I/O via cost_averages)
307      -> use ctrl.h in active_file*.F to control I/O precision.
308    o paramter list of CALL ADTHE_MAIN_LOOP
309    o added initial do_the_model_io to ecco
310    o set all ...Freq to zero after cost_final
311      taveFreq, dumpFreq, pChkptFreq
312    o MAIN and ECCO differentiability restored
313    
314    checkpoint52j_post
315    o fix nchklev in tamc.h for global_ocean...
316    o Bringing flow and store directives up-to-date
317    o Really weird thing!
318      call do_the_model_io from the_main_loop with parameters
319      starttime, niter0, instead of mytime, myiter, screws up the adjoint:
320      TAF places a faulty re-call of initialise_varia
321      after cost_final call which should not be there!
322    checkpoint52j_pre
323    
324    o tweaked pkg/mdsio/mdsio_readfield.F to have more useful logic and
325      error messages
326    o fix errorMessageUnit problem. remove old version of mdsio from eesup/src
327    o modified pkg/mdsio/mdsio_readfield.F -- commented out diskspace-eating
328      debug output
329    o modfied mdsio_writefield.F to handle non-global files under exch2
330    o update AIM Cubed-Sphere exp (aim.5l_cs):
331      use land, p*, and Franco.M forcing fields with fractional land-sea mask.
332    o update AIM Equatorial Channel exp:
333      use standard aim_v23 pkg and change the SST fields to be more realistic.
334    o globalFile now works with exch2
335    o merged mom_vi_calc_relvort3.F, mom_vi_del2uv.F and
336      mon_vort3.F to make exch2 friendly with >1 tile per cube face
337    o limit timeave output for hi-res integrations
338    
339    checkpoint52i_post
340    o removed CPP_EEOPTIONS.h from verification/*/code
341    o updated the tiling for global_ocean_pressure
342    checkpoint52i_pre
343    
344    o update aim.5l_LatLon using the standard aim_v23 pkg (instead of
345      the old pkg/aim).
346    
347    checkpoint52h_pre
348    o shortened offending lines in exch2_send_rx?.template
349    o modified W2_EXCH2_TOPOLOGY.h to reflect current topology generator
350    o genmake2: add build & execute test for NetCDF code
351    o modded aim.5l_cs and global_ocean.cs32x15 to use exch2, removed
352      old grid files, moved CPP_EEMACROS.h to pkg/exch2
353    o added useSingleCPUIO flag to monitor.F and mon_out.F
354    o added temporary hack for sea-ice dynamics on the cube:
355      metric terms are ignored and it is assumed that
356      there is no sea-ice on cube faces 1, 2, 4, and 5.
357    
358    checkpoint52f_post
359    o added exch2 cube routines to pkg/exch2
360    o modified hs94.cs-32x32x5 to use it
361    o added new grid files to hs94.cs-32x32x5
362    checkpoint52f_pre
363    
364    checkpoint52e_post
365    o first attempt to solve vertical advection (momemtum & T,S) Implicitly
366      for now, only implemented with Lax-Wendroff (tracer) and VectInv (mom)
367    o step.1 : rewrite (as in MultiDimAdvec) explicit tracer stepping (gad_calc_rhs.F)
368      to work with implicit vertical advection and AB ;
369    o Implic. vert. advect. implemented with flux-limiter, c2, u3 and c4 scheme.
370    o update output (gad_calc_rhs.F changes affect truncation error) of exp:
371     front_relax, global_ocean .cs32x15 & _pressure, internal_wave, lab_sea, natl_box
372    checkpoint52e_pre
373    
374    o fix bug in impldiff when Nr=1 or Nr=2.
375    o change the albedo in pkg/thsice (as GISS model); update output_thsice.txt
376    o little changes (fftpack, aim/phy_suflux ...) to pass the "checkbounds" test.
377    o fix deltaTfreesurf in update_cg2d.F (left from c45d_post): affects 2
378      ocean exp. that use NLFS: global_ocean.cs32x15 & global_ocean_pressure
379    o added exf_offset_atemp for Celsius to Kelvin conversion of atemp
380    o eesupp/inc/EEPARAMS.h: MAX_NO_PROCS=1024
381    o pkg/cal/cal_toseconds.F fix for long (>60 years) integrations
382    
383    checkpoint52d_post
384    o re-tiled many expts to allow comparison in multi-processor mode
385      - updated output accordingly
386      - changed hs94.128x64x5 to use intial T from file rather than use the
387        random number generator
388    o add infrastructure in model routines for fizhi and gridalt packages
389    o change global_ocean.cs32x15 because of Pb with GM on CS-grid.
390    o changes to permit hi-res, cubed-sphere, configuration
391      - added useSingleCpuIO capability to mdsio_readfield.F and exf_interp.F
392      - added "#undef ALLOW_USE_MPI" support to eesupp/src/scatter_2d.F
393      - added pkg/exf/exf_set_uv.F for on-the-fly interpolation and rotation
394        of surface winds for the cube
395      (A verification experiment, based on global_ocean.cs32x15, but with
396       pkg/seaice turned on and with on-the-fly interpolation from the NCEP
397       Gaussian grid is described in MITgcm_contrib/high_res_cube/README_ice,
398       complete with example surface forcing files and matlab scripts to look
399       at the output and compare it with that of global_ocean.cs32x15.)
400    o packages pickup: $PKG_write_pickup called from packages_write_pickup ;
401       but call to $PKG_read_pickup remains in $PKG_ini_vars: change CD_code
402       to conform to the common rule.
403    o check-in the first version of the coupler + interfaces for multi-components
404       set-up (Chris's version, adapted to work on cubed-sphere grid); use MPI.
405       - imply modification in eesupp (MPI_COMM_MODEL < MPI_COMM_WORLD).
406       - atmosphere: use pkg aim_v23 ; no sea-ice for now.
407       - ocean and atmos. share the same horizontal grid (no interpolation).
408       - exchanges between component and coupler is done in forward_step
409    o new verification experiment, cpl_aim+ocn:
410       coupled ocean - AIM atmosphere on cs32 grid.
411    
412    checkpoint52d_pre
413    o surface flux time-av diagnostic modified for NLFS & RealFreshWater
414    o add call to AIM pendant S/R in external_forcing & external_fields_load.F
415    
416    checkpoint52c_post
417    o Fixing OPTIONS files for use of exf:
418      - ALLOW_ECCO not needed
419      - ECCO_CPPOPTIONS.h should not be included from
420        EXF_OPTIONS.h/CAL_OPTIONS.h, but from CPP_OPTIONS.h
421        as has been the case in the past
422      - All cal/exf related options are currently set in
423        single header file. Should remain so until we
424        agree on a consistent new policy.
425    o Removed all CPP options for cal package.
426      cal has no more CPP options.
427    o modified STOREs in GAD_ADVECTION
428    o corrected key comp. for passkey
429    
430    checkpoint52b_post
431    o new version: "thsice" of thermodynamic sea-ice pkg:
432     - only 1 call from "forward_step"; conserve energy, fresh-water & salt.
433     - modify fluxes but do not change theta directly;
434     - light cleaning of bulk_force pkg (still needed with thsice).
435     - add forcing fields + data files in global_ocean.cs32x15/inp_thsice
436       + output_thsice.txt to test thsice & bulk_force pkgs.
437    o put back grid & coriolis monitor output.
438    checkpoint52b_pre
439    
440    o call "do_the_model_io" at the beginning (=> dump initial state)
441    o use rhoConstFresh to define convertEmP2rUnit (was done only in ocean-P)
442    o sort out interplay between tamc.h and PTRACERS_OPTIONS.h
443      (need info on NUMBER_OF_PTRACERS)
444    o missing PTRACERS headers in some routines
445    o default tamc.h in pkg/autodiff supposed to crash
446      to ensure proper customization
447    
448    checkpoint52a_post
449    o modifications to make FREEZE (_SURFACE) flux visible to pkg/kpp
450      - moved surfaceTendencyTice from pkg/seaice to main code
451      - subroutine FREEZE_SURFACE now limits only surface temperature
452        and is called in FORWARD_STEP (if allowFreezing=.TRUE.)
453        => new output.txt for global_ocean.cs32x15 & global_with_exf
454      - keep the old version of FREEZE for backward compatibility;
455        global_ocean.90x40x15 left unchanged using useOldFreezing=.TRUE.
456      - corresponding modifs for TAF directives
457    o added surface flux output variables to TIMEAVE_STATVARS
458    o time-averaged output for pkg/ptracers
459    o fix problem with ECCO-related divided adjoint
460      snapshot file was missing some ad-variables,
461      but no warning issued by TAF
462    
463    checkpoint52a_pre
464    o some bug fixes for #undef REAL4_IS_SLOW
465    
466    checkpoint52 = ecco_c52_e35
467    o after testing adjoints of checkpoint51u_post
468    
469    checkpoint51u_post
470    o this is the post-merge tag of the ecco-branch
471      (needs another clean checkout and re-testing)
472    o various natl_box_adjoint configs and results
473      but no input fields
474    o obcs adjoint not yet merged!
475    o adding ECCO global 1x1 and 2x2 degree configs
476    o updated/extended some store directives for seaice
477    o pkg/ecco now containes ecco-specific part of cost function
478    o top level routines the_main_loop, forward_step
479      supersede those in model/src/
480      previous input data.cost now in data.ecco
481      (new namelist ecco_cost_nml)
482    o in ctrl/ cleaned some cross-dependencies and updated CPP options
483    
484    checkpoint51t_post
485    o this is the pre-merge tag of the ecco-branch
486    
487    checkpoint51s_post
488    o cleanup: removed various obsolete #define-s
489    o pkg/grdchk
490      - renamed 'ph-grd 3' to 'grad-res'
491      - merged from ecco-branch
492        (remaining bug fixes for obcs gradient checks)
493      - additional high-precision output for testreport
494        (grep for 'precision_grdchk_result')
495    
496    checkpoint51r_post
497    o cleaned up or removed CPP_OPTIONS.h files
498    o updated results for some of the tests to reflect the new
499      optfiles (-ieee: -O0 instead of -O3)
500    
501    checkpoint51q_post
502    o cd_code:
503      - moved cd_scheme.F -> cd_code_scheme.F
504      - separate read_checkpoint from cd_code_ini_vars.F
505      - separated cd_code part from write_checkpoint
506      - updated AD_SOURCE, generated .flow
507      - added CD_CODE_VARS.h to the_main_loop
508      - Moving cd_code specific store dir.s to pkg/cd_code
509    o ctrl package totally restructured
510      - pack/unpack now optional and decoupled from
511        xx_/adxx_ I/O
512      - ctrl_pack/unpack cleaned
513        (new routines ctrl_init_ctrlvar.F, pkg/ctrl/ctrl_init_wet.F)
514      - confined inclusion of AD_CONFIG.h to where necessary.
515    o genmake2: changed AD dependencies from SRCFILES to AD_FILES
516    
517    checkpoint51p_post
518    o create initial cd_code package
519      - WARNING: the initialization of fields within packages
520        is broken because INI_FIELDS (where READ_CHECKPOINT is
521        called) is called *before* PACKAGES_INIT_VARIABLES.
522        This seems to be backwards since
523        1) its important to initially zero the entire field including
524           the "halo" region
525        2) zeroing needs to be done *before* reading pickup info
526           and the pickup call might or might not happen in any
527           particular run
528      - this needs an overhaul for R2
529    o cleanup verification/*/code/GMREDI_OPTIONS.h
530    o cleanup testreport
531    
532    checkpoint51o_post
533    o bringing AD-related verif's up to date with genmake2
534      - carbon/
535      - global_ocean.90x40x15/
536      - hs.94.1x64x5/
537      - (front_relax/ )
538    o (more) consistent directory structure for AD-related verif.'s
539    o cleaning ALLOW_GRADIENT_CHECK -> ALLOW_GRDCHK
540    o cleaning some ALLOW_TANGENTLINEAR_RUN -> ALLOW_AUTODIFF
541    o bug fix in find_alpha.F for MDJWF:
542      - modif. to alpha = 1/D*( dN/dT - rho*dD/Dt) to account for
543        change rho -> rho-rhoConst
544      - replace call find_rho to find_rhonum
545    o initialisation of rFlx extended to full array (required by TAF)
546      and shifted to thermodynamics
547    o removed PTRACERS.h in ptracers routine
548    o added surfacetendencyPtr to S/R parameter list pracers_forcing
549    o Correcting initialisations for fVerU, fVerV.
550    o helping TAF to recognize dependency on kUp for
551      fVerU, fVerV
552    o Replacing delZ by delR in pkg/ctrl/
553    checkpoint51o_pre
554    
555    o undid all of cp51 pending some cleanups and discussion
556    o added the [#include "AD_CONFIG.h"] statement to all files that need
557       it for adjoint/tl #defines
558     o re-worked the build logic in genmake2 to support AD_CONFIG.h
559     o removed tools/genmake since it no longer works
560    
561    checkpoint51n_post
562    o modifications to make FREEZE flux visible to pkg/kpp
563      - moved surfaceTendencyTice from pkg/seaice to main code
564      - FREEZE & EXTERNAL_FORCING_SURF moved to FORWARD_STEP
565      - subroutine FREEZE now limits only surface temperature
566        (this means new output.txt for global_ocean.90x40x15,
567         global_ocean.cs32x15, and global_with_exf)
568    o added surface flux output variables to TIMEAVE_STATVARS
569    
570    checkpoint51n_pre
571    o added "#undef ALLOW_USE_MPI" support to eesupp/src/gather_2d.F
572    o added [#include "AD_CONFIG.h"] to all files that use the following
573      defines:
574      - ALLOW_ADJOINT_RUN
575      - ALLOW_TANGENTLINEAR_RUN
576      - ALLOW_ECCO_OPTIMIZATION
577    
578    checkpoint51m_post
579    o incorporating changes to get TAMC/TAF working in genmake2
580      - added new TAMC/TAF targets to the Makefile
581      - various cleanups related to package handling
582      - these changes should have no impact on the forward model
583    
584    checkpoint51l_post
585    o changes to pkg/cal and pkg/exf that allow and speed-up long integrations
586     - faster algorithm for cal_addtime.F
587     - higher precision arithmetic, where needed
588     - pkg/exf *startdate variables changed from calendar date to
589       model integration time
590    
591    checkpoint51l_pre
592    o add salt flux to forcing fields (used when salty sea-ice forms or melts)
593    o enable to apply restoring on S & T only in a latitude band.
594    o update output (external_forcing_surf modif. change truncation errors)
595       global_ocean.cs32x15, global_ocean_pressure, lab_sea, natl_box
596    
597    checkpoint51k_post
598    o change default to: useNHMTerms=.FALSE.
599     - new output.txt for atmos. exp (NHMTerms were wrong but now turned off):
600       adjustment.128x64x1, aim.5l_Eq_Ch, aim.5l_LatLon, hs94.128x64x5, hs94.1x64x5
601     - new output.txt for idealized oceanic exp (NHMTerms are now turned off):
602        exp1, ideal_2D_oce
603     - change data file of oceanic exp (leave the results unchanged for now)
604       exp2, global_ocean[90x40x15,pressure,with_exf], lab_sea, natl_box
605    o set gravitySign automatically according to the vertical coordinate used
606      (and change sign: back to "logical" value: +1 when R increases downward)
607    o added an include barrier to the default CPP_OPTIONS.h and
608      removed the #include "PACKAGES_CONFIG.h" from it
609    o fix a bug in mom_fluxform (from chk51j_post)
610    
611    checkpoint51j_post
612    o Added some AD-related initialisations in mom_vecinv/ mom_fluxform/
613    o adjusted some flow directives (dynamics, thermodynamics)
614    o added cubed-sphere case to test cost function
615    o heckpoint_lev?_directives.h now include
616      pkg-specific directives, whenever those are enabled.
617    o Moving pkg-specific flow directives to corresponding pkg
618      Moving pkg-specific differentiation list to corresponding pkg
619      Moving pkg-specific checkpoint-lev storing to corresponding pkg
620      ---> conventions are
621           - pkg_ad.flow
622           - pkg_ad_diff.list
623           - pkg_ad_check_lev?_dir.h
624    
625    checkpoint51i_post
626    o merge of the branch-genmake2
627      - knowingly breaks the older genmake
628      - automatic generation of all ALLOW_${PKG_NAME} defines
629      - new testreport supersedes older testscript
630    o large number of package inclusion and header cleanups
631    checkpoint51i_pre
632    
633    o new output for adjoin of global ocean vector invariant
634    o fix for checkpoint of thermodynamic seaice and bulk_force
635    o Steph gchem various cleanups
636    
637    checkpoint 51h_pre
638    o fixed some single quotes
639    o modify gchem pkg to be more versatile
640    o modifications to clean up dic pkg
641    o add pkg/cfc
642    
643    checkpoint51g_post
644    o provide links for ARPACK and ADM*TLM
645    o start removing verification/vero/
646    o update AD-related stuff
647      (in particular some IF-statements in model/src/ routines)
648    o adding to verification/global_ocean.90x40x15/ adjoint of
649      vector invariant setup
650    
651    checkpoint51f_post
652    o update advect_xz/output.txt (left from chekpoint50f_pre, ini_vel modif)
653    o Mods and bug fixes to pkg/cal, pkg/exf, etc., needed for computation
654      of tracer Green's fucntions for ocean inversion project.
655    
656    checkpoint51f_pre
657    o Added on-the-fly spatial interpolation capability
658        "USE_EXF_INTERPOLATION" to pkg/exf.
659      - This is a temporary Cartesian-grid hack until
660        the super-duper ESMF coupler becomes available.
661      - See verification/global_with_exf/README for usage example.
662      - Removed obsolete EXFwindOnBgrid and SEAICEwindOnCgrid
663        flags and modified pkg/seaice accordingly.
664    o Bug fix to pkg/ptracers, pkg/generic_advdiff/gad_calc_rhs.F,
665        and pkg/kpp/kpp_transport_ptr.F for dealing with tracer
666        non-local transport term.
667    
668    checkpoint51e_post
669    o pkg/mom_vecinv:
670      - changes related to hFac: use S/R from aim.5l_cs/code (coriolis & vort.advec)
671      - add time-ave diagnostic of vorticity advection.
672    o add diagnostic (instantaneous) of Shapiro Filter effect for T,S & UV.
673    o atmospheric geopotential: - include water vapor effect;
674                                - use p^kappa in p* scaling.
675    o land pkg: read initial state from files.
676    o AIM : add stratospheric drag in the upper level
677    
678    checkpoint51d_post
679    o change function ILNBLNK (=> last non-blank char.) to return zero
680      (instead of the string length) when the string. char is empty
681    o fix bug in dxV,dyU definition of cubed-sphere grid (ini_curvilinear_grid)
682    o modif's to restore TAMC compatibility
683      - avoid "_d" constructs in PARAMETER declarations
684      - avoid interrupting lines by comment lines
685    o Use cluster local disks for purely local I/O
686      vs. globally visible disks needed for ctrl stuff
687      (merged from ecco-branch)
688      - new active_file_loc... and mdsio_..._loc routines
689      - affected packages: autodiff, ctrl, grdchk, mdsio
690    
691    checkpoint51c_post
692    o introducing integer flag debugLevel
693      - debLevZero: suppress all output
694      - debLevA: standard
695      - debLevB: equivalent to current debugMode=.TRUE.
696    o introducing pathname variable mdsioLocalDir for mdsio
697      that can be specified at runtime
698      (relevant for cluster I/O to local disk)
699    `
700    >>>checkpoint51b_post
701    adjoint of ptracers
702    o disentangled ALLOW_PTRACERS using new ALLOW_GCHEM
703    o extended state in checkpoint_lev?, etc.
704    o alternative ctrl/cost with tr1 or ptracer
705    o new comlev1_bibj_ptracers
706    o new ptracers.flow
707    o made ptracers_forcing same as external_forcing_s
708    o added verification for adjoint with ptracers
709      - adm. grdchk fail so far
710      - tlm. grdchk OK
711      - checked tapelev/comlev recomputations: OK
712    <<<checkpoint51b_pre
713    
714    checkpoint51a_post
715    o added code for biogeochemistry package
716      - new pkgs: dic, gchem
717      - new subroutine in ptracers
718    o modify code for biogeo packages
719      - in model/src and pkg/ptracers
720    
721    checkpoint51
722    o merged improved packages from ecco-branch (ecco_c51_e34) to MAIN
723      - autodiff, ctrl, exf, grdchk, seaice
724      kept separate packages
725      - cost, ecco, obcs
726    o updating verification/internal_wave, verification/lab_sea
727      (all verif's pass on faulks.lcs.mit.edu RH7.3, g77)
728    
729    checkpoint50i_post
730    o Preparing next differentiable checkpoint and sync
731      of MAIN vs. ecco-branch
732      - 1st step: this one is differentiable
733      - 2nd step: next(! not this) checkpoint will have updated packages
734                  from ecco-branch)
735    
736    checkpoint50h_post
737    o new package "land": provide surface BC for AIM.
738    o pkg/ptracers: apply exchange to all tracers after reading a pickup.
739    o AIM: use true log-P extrapolation for near surface temp (= as in
740        F.Molteni paper) ; update aim.5l_cs output.
741    o New variable in PARM03 for more flexible pickups
742    o somewhat cleaned package initialisation sequence for
743      ctrl/ cost/ ecco/ in packages_... routines
744    
745    checkpoint50g_post
746    o merged with release1_p17 (pkg/seaice and verification/lab_sea)
747      - added SEAICE_MULTILEVEL for 8-category sea-ice thermodynamics
748      - LSR sea-ice dynamic solver moved to SouthWest B-grid location and
749        made the default because of faster convergence than ADI
750    
751    checkpoint50f_post
752    o exf totally restructured
753      - replaced all exf_set_ routines by one generic exf_set_gen.F
754        and made sure it's still differentiable
755      - split exf_getffields.F into new exf_bulkformulae.F
756      - exf_inscal_/exf_outscal_ suffixes consistent with field names
757      - updated adjoint/makefile and relevant verif. accordingly
758    
759    checkpoint50f_pre
760     o AIM: near surface temp evaluated from Pot.Temp: fixed for Part Cell ;
761          + change Evap over land. (update aim.5l_cs output)
762     o added missing .cvsignores and made uniform across expts
763     o changed configuration of tidal_basin_2d expt
764     o added pkg/debug functions for tracing code in fatal crashes
765     o tidied pkg/monitor to use MONITOR_OPTIONS.h
766     o new fn in pkg/monitor to stop model if solution grows too big
767     o removed lots of single quotes from comments
768    
769    checkpoint50e_post
770    o make KPP work with PTRACERS
771     - fix gad_calc_rhs to call new routine kpp_transport_ptr, which is
772       nearly a copy of kpp_transport_s
773     - there is no analogue to SurfaceTendencyS, so I have to use
774       gPtr(of the surface layer) instead
775    o add a new platform SunFire+mpi (SunFire 15000) to genmake
776    checkpoint50e_pre
777    
778    checkpoint50d_post
779    o change kpp output from multiple-record state files to single-record state
780      files analogous to write_state.F
781    o reduce the output frequency of cg3d-related stuff to the monitor frequency,
782      analogous to the cg2d-related output.
783    o fix small problem with in ptracers_write_checkpoint.F: len(suff)=512,
784      so that writing to internal file fn (with length 512) fails.
785    checkpoint50d_pre
786    
787    checkpoint50c_post
788    o fix problem in ini_procs.F when using MPI (was there since checkpoint48f)
789    o add monitor diagnostic of vorticity (mon_vort3.F) and potential energy.
790    o add time-average diagnostic of U*V and vertical diffusive flux for theta.
791    o bug fixed in convective adjustment diagnostic (multi-tile set-up).
792    o 4th Order Adv scheme: return to previous (c40pre7) masking near boundaries.
793    
794    checkpoint50c_pre
795    Merging from release1_p13:
796    o bug fix for pkg/seaice dynamic solver
797    o Added SEAICE_initialHEFF to pkg/seaice
798    
799    checkpoint50b_post
800    o store u*,v* in gU,V instead of in guNm1,gvNm1
801    o in order to put the momForcing out of the Adams-Bashforth:
802      move forcing & CD-scheme calls from mom_fluxform & mom_vecinv
803      to timestep.F
804    o new flag "useCDscheme" (default=F); replace guCD,gvCD by local arrays
805    o re-generate output for highly sensitive test-exp:
806       global_ocean_pressure, ideal_2D_oce, lab_sea, natl_box
807    
808    checkpoint50b_pre
809    o restore the use of momAdvection & useCoriolis flags (mom_vecinv)
810    o corrected CPP option mismatch in exf_Bulk... functions for case
811      #define ALLOW_ATM_WIND && #undef ALLOW_ATM_TEMP
812    
813    checkpoint50a_post
814    o Bug fix for merging between c50 and KPP.
815      ikey was passed from thermodynamics to kpp_calc via
816      common block rather than being recomputed in kpp_calc,
817      in contradiction with new key itdkey.
818      New key ikppkey created, and tamc.h headers updated.
819    
820    checkpoint50
821    - 2nd step of merge with ecco-branch:
822      merge changes in ecco-branch back into main trunk
823    - bug fix in find_alpha
824    - more storing in gmredi_calc_tensor.F, kpp_routines.F
825    - avoid iterative loop in ini_pressure for ALLOW_AUTODIFF_TAMC
826    - merged some sliced AD support routines
827    
828    checkpoint49
829    merged from ecco-branch:
830    o exf:
831      - Enable initialisation of forcing fields to constant
832        (runtime) values.
833      - in exf_getffields.F
834        Reduce i-/j-loop to interior domain, discarding overlaps.
835        That also fixes wrong TAF-key computations for key_1, key_2
836        with bulf formulae.
837      - exf_init.F modify #ifdef for exf_init_evap
838      - exf_getffieldrec.F, ctrl_getrec.F
839        The following INT-usages are not safe:
840          fldsecs  = int(fldsecs/fldperiod)*fldperiod
841          fldcount = int(fldsecs/fldperiod) + 1
842        and were modified.
843    o autodiff: checkpoint_lev...
844      - updated storing for bulk formulae (some arrays were missing)
845      - added state for seaice package
846      - synchronized with main branch
847    o DIVA:
848      Modif.s in
849      - the_main_loop.F
850      - the_model_main.F
851      and added cost_final_restore.F cost_final_store.F
852      o With these changes, it is possible to fully separate
853        the first forward run to compute the cost function (mdthe_main_loop)
854        and adjoint runs over individual DIVA intervals (adthe_main_loop)
855        into separate model executions.
856        This enables better tuning of DIVA to given queue sizes.
857      o Loss of cost function value in consecutive DIVA runs is
858        fixed by storing to 'costfinal' file.
859      o Appropriate call of ctrl_unpack/_pack,grdchk_main at
860        beginning/end of adjoint integration is accounted for.
861      The current changes apply to TAF-1.4.26.
862      TAF has one remaining bug, requiring one manual change
863      (see MITgcm manual).
864    o cal: synchronized between MAIN and ecco-branch
865    
866    checkpoint48i_post
867    o Changes to restore differentiability of code w.r.t. previous tag
868      (mostly adding new routines to make list and replacing
869      pressure by totPhiHyd).
870    o Updated and merged grdchk package
871      - has both ADM and TLM checks
872      - works for single- and multi-proc.
873      - output cleaned
874      - worked successfully for parallel DIVA
875    o genmake:
876      - Adding -platform=SP4
877      - Modif. for DEC Alpha (many don't have makedepend; use mkdep instead).
878    o Modif. for DIVA:
879      ctrl_unpack should not be called in intermediate DIVA interval.
880      (similar thing would apply for active files such as
881      tbar, sbar, psbar, which should not be reinitialised;
882      only relevant for ecco-branch)
883    
884    checkpoint48h_post
885    o improve "ini_p_ground" when using finite difference form for calc_phi_hyd
886    o Added net flux to downward flux conversion to pkg/exf/exf_getffields.F
887    o Added SEAICE_initialHEFF to pkg/seaice
888    o ecco_the_model_main.F: SEAICE_WRITE_PICKUP must precede WRITE_CHECKPOINT
889    
890    checkpoint48g_post
891    --- EOS:
892    o compute locally the pressure for use in EOS: UNESCO, JMD95P, MDJWF
893      store total Potential in totPhyHyd for diagnostics & EOS.
894    o fix restart and overlap Pb when using Z-coord and EOS funct. of P
895    --- Pressure/geopotential gradient:
896    o use Ro_surf & R_low instead of hFac in cal_phi_hyd:
897    o NLFS + p-coord.: eta*Alpha' is not longer lagging 1.time-step behind
898      ( changes results of global_ocean_pressure )
899    o NLFS + z-coord.: add eta*Rho' contribution.
900    o accurate phiHyd when using interface-W at the middle between 2 centers
901     ( changes results of ideal_2D_oce )
902    o includes r* 2nd term in potential gradient.
903    
904    checkpoint48f_post
905    Merging from release1_p12:
906    o Modifications for using pkg/exf with pkg/seaice
907      - improved description of the various forcing configurations
908      - added basic radiation bulk formulae to pkg/exf
909      - units/sign fix for evap computation in exf_getffields.F
910      - updated verification/global_with_exf/results/output.txt
911    o Added pkg/sbo for computing IERS Special Bureau for the Oceans
912      (SBO) core products, including oceanic mass, center-of-mass,
913      angular, and bottom pressure (see pkg/sbo/README.sbo).
914    o Lower bound for viscosity/diffusivity in pkg/kpp/kpp_routines.F
915      to avoid negative values in shallow regions.
916      - updated verification/natl_box/results/output.txt
917      - updated verification/lab_sea/results/output.txt
918    o MPI gather, scatter: eesupp/src/gather_2d.F and scatter_2d.F
919    o Added useSingleCpuIO option (see PARAMS.h).
920    o Updated useSingleCpuIO option in mdsio_writefield.F to
921      work with multi-field files, e.g., for single-file pickup.
922    o pkg/seaice:
923      - bug fix in growth.F: QNET for no shortwave case
924      - added HeffFile for specifying initial sea-ice thickness
925      - changed SEAICE_EXTERNAL_FLUXES wind stress implementation
926    o Added missing /* */ to CPP comments in pkg/seaice, pkg/exf,
927      kpp_transport_t.F, forward_step.F, and the_main_loop.F
928    o pkg/seaice:
929      - adjoint-friendly modifications
930      - added a SEAICE_WRITE_PICKUP at end of the_model_main.F
931    
932    checkpoint48e_post
933    o New S/R for diagnostic of bottom pressure (phi0surf was missing in c48d_post)
934    o dynamics: change definition of computational domain & adapt mom_fluxform
935      accordingly ; when viscA4=0, allows to run the dynamics with Olx=Oly=2.
936    o following exp works with Olx=Oly=2 (and pass through checkbounds option):
937        adjust_nlfs.cs-32x32x1 adjustment.128x64x1 adjustment.cs-32x32x1
938        exp0 exp1 exp2 exp4 exp5 hs94.cs-32x32x5 hs94.128x64x5 hs94.1x64x5
939        global_ocean.90x40x15 global_with_exf global_ocean_pressure
940        inverted_barometer solid-body.cs-32x32x1
941      (high order AdvScheme and/or multiDimAd works with Olx=Oly=2 ? not sure)
942    
943    checkpoint48d_post
944    o in preparation for r*:
945     a) use pre-computed gradient of hydrostatic potential:
946        changes in timestep.F & mom_cdscheme.F affects results of ideal_2D_oce
947     b) move phi0surf from calc_phi_hyd to calc_grad_phi_hyd:
948        => affects results of glob_oce_pressure (different truncation error)  
949      update output.txt of ideal_2D_oce & global_ocean_pressure
950    
951    checkpoint48d_pre
952    o in preparation for r*:
953      new S/R (calc_grad_phi_hyd.F) to compute Hydrostatic potential gradient.
954      pass the 2 comp. of the grad. as arguments to momentum S/R.
955      but for the moment, only used if it does not change the results.
956    o add finite volume form of calc_phi_hyd for buoyancyRelation OCEANIC & OCEANICP
957    
958    checkpoint48c_post
959    Modifications in treatment of initial flux forcing controls
960    to avoid extra storing of flux fields.
961    
962    checkpoint48c_pre
963    o Added tidal_basin_2d experiment (currently 1D!)
964    o can use r* Coordinate with OBC (but Orlanski Rad. BC not yet implemented)
965    
966    checkpoint48b_post
967    o r* coordinate added in #ifdef NONLIN_FRSURF block.
968     (modification to pressure gradient not yet implemented)
969    o mom_fluxform: new S/R mom_calc_rtrans.F computes vertical transports
970      (for U & V) that are used for vertical advection of momentum.
971    
972    checkpoint48a_post
973    o In preparation for r*, use temp. array to compute vertical transport
974       in flux-form momentum pkg. => change results of few test-exp.
975      Update output of: exp4, exp5, front_relax, global_ocean_pressure,
976                        lab_sea, natl_box & plume_on_slope
977    
978    checkpoint48
979    o fix small bug that was causing lot of warning (TIMER_STOP 'UPDATE_CG2D')
980    
981    checkpoint47j_post
982    o add new exp. (ideal_2D_oce) to test "exotic" parameters and options.
983    o moved adexch from forward_step to addummy_in_stepping
984    o added exch in ctrl_map_...
985    o aveFreq.=0. at end of cost_final to avoid overwrite in
986      reverse checkpointing loop
987    o Yet more changes in gmredi:
988      * adgmredi_calc_tensor
989        avoiding all recomputation of gmredi_slope_limit
990      * adgmredi_x/y/rtransport
991        added flag for excessive storing to avoid recomp. of
992        u/v/rtans, dTdx/y/z
993        -> this is not really necessary and very memory-consuming
994      * adgmredi_slope_psi:
995        consistency with gmredi_slope_limit in treatment of GM_slopeSqCutoff
996      * gmredi_slope_limit
997        re-activated full calculation of taperfct for case 'ac02'
998    o updating verification/ adjoints of carbon, global_ocean.90x40x15
999    
1000    checkpoint47i_post
1001    o GM_EXCLUDE_() replace GM_TAPER_(): by default, all the code is compiled.
1002    o add GM_Small_Number & GM_slopeSqCutoff as run-time parameters (data.gmredi)
1003      default values = 1.D-12 & 1.D+48 (=> give same results as checkpoint47f_post)
1004    o cg2dTargetResWunit: define tolerance using deltaTmom (and not deltaTfreesurf)
1005    o gmredi: fix few bugs.
1006    
1007    checkpoint47h_post (duplicate tag for PH's c48 tag, in order to move c48)
1008    This will be a good checkpoint to plug into the ecco-branch.
1009    o few modif.'s to get latest version adjointed
1010      (mainly kick out code in ini_linear_phisurf)
1011    o modif's to run adjoint with exactConserv
1012    o case GM_BOLUS_ADVEC should be cleaned
1013      S/R gmredi_slope_psi should be cleaned
1014    o verification/carbon now has exactConserv=.TRUE.
1015    
1016    checkpoint47g_post
1017    o time-average AIM output: becomes independent from statvars time-average
1018      (can be used with #undef ALLOW_TIMEAVE) ; add new variables (e.g., RH)
1019    o After TAF bug fix:
1020      Tested adjoint of gmredi package.
1021      Tests were done with checkpoint47 rather than with latest
1022      checkpoint47f_post since the latter is broken for the adjoint
1023      verification/carbon/ contains both ADM and TLM gradient checks.
1024    Here they are, before they get changed/lost/stolen.
1025    Mostly modif.'s to fix numerical sensitivities.
1026    Gradient checks OK for
1027    - GM_taper_scheme:
1028      * clipping
1029      * ac02
1030      * linear
1031      * glw91
1032      * dm95
1033      * ldd97
1034    - GMREDI_OPTIONS:
1035      * GM_VISBECK_VARIABLE_K
1036      * GM_NON_UNITY_DIAGONAL
1037      * GM_EXTRA_DIAGONAL
1038      * GM_BOLUS_ADVEC
1039    in conjunction with data.gmredi parameters to be checked in
1040    in a few minutes under verification/carbon/code/
1041    
1042    checkpoint47f_post
1043    Merging from release1_p10:
1044    o modifications for using pkg/exf with pkg/seaice
1045      - pkg/seaice CPP options SEAICE_EXTERNAL_FORCING
1046        and SEAICE_EXTERNAL_FLUXES
1047      - pkg/exf CPP options EXF_READ_EVAP and
1048        EXF_NO_BULK_COMPUTATIONS
1049      - usage examples are Experiments 8 and 9 in
1050        verification/lab_sea/README
1051      - verification/lab_sea default experiment now uses
1052        pkg/gmredi, pkg/kpp, pkg/seaice, and pkg/exf
1053    
1054    checkpoint47e_post
1055    o created a tag prior to creating a branch
1056    
1057    checkpoint47d_post
1058    o fixed bug in the oceanic pressure coordinates code: vertical viscosity
1059      at the bottom boundary had an erroneous half slip boundary condition
1060    o added bottom drag and no slip boundary condition capabilities to
1061      oceanic pressure coordinates code
1062    o added new verification experiment global_ocean_pressure, this experiment is
1063      also described in the tutorial section of the manual
1064    checkpoint47d_pre
1065    
1066    checkpoint47c_post
1067    o Added a verification experiment for a global cubed-sphere ocean run
1068      -  verification/global_ocean.cubed32x32x30
1069      -  uses pkg/therm_seaice and pkg/bulk_forcing
1070    
1071    o allow to run AIM physics with SPEEDY input files (from Franco Molteni)
1072    o allow a more accurate definition of Ro_Surf (selectFindRoSurf=1)
1073      when using P-coordinate; only implemented for atmospheric config.
1074    o OCEANICP & realFreshWater: include P-E direct effect on wVel ;
1075      NOTES: requires option NONLIN_FRSURF to be "#define".
1076    o update advect_xz/results/output.txt (left from checkpoint44g_post)
1077    
1078    checkpoint47b_post
1079    Merging from release1_p9:
1080    o pkg/seaice
1081      - removed GOTO's and added taf directives
1082      - double precision constants to reduce the g77 (Linux)
1083        to F77 (SGI) differences reported in release1_p8
1084    o tools/genmake
1085      - added SGI options
1086    o verification/testscript
1087      - updated to that of checkpoint47a_post
1088    o verification/global_ocean.90x40x15/input/eedata
1089      - modified for SGI f77 compatibility
1090    o verification/lab_sea
1091      - added description of sea-ice model
1092      - added missing matlab routines
1093      - added test of thermodynamics parallelization
1094    
1095    checkpoint47a_post
1096    o new pkg: aim_v23
1097     = F. Molteni atmos.physics (SPEEDY, ver23) adapted to MITgcm.
1098       for now, keep the same surface forcing as before.
1099     - Part-Cell implemented into AIM; check that Heat & Water are conserved
1100     - aim.5l_cs: use new aim pkg (run 10yr & get better results than before)
1101     - aim.5l_LatLon & aim.5l_Equatorial_Channel are still using old aim pkg
1102    o add diagnostic of surface correction term in monitor output
1103    
1104    o bulk_force and therm_seaice
1105    - Two packages:  bulk_force (Bulk forcing)
1106      and therm_seaice (thermodynamic_seaice) - adopted from LANL CICE.v2.0.2
1107    - Earlier integration from Stephaine Dutkiewicz
1108      and Patrick Heimbach.
1109    - Two ifdef statements for compile time,
1110       ALLOW_THERM_SEAICE and ALLOW_BULK_FORCE
1111    
1112    checkpoint47
1113    differentiable version of checkpoint46n_post
1114    o bug fix in quasihydrostaticterms
1115    o * "clean" adjoint code (in terms of extensive recomputations)
1116        can now be obtained for all GMREDI options (i.e. for
1117        - GM_VISBECK_VARIABLE_K
1118        - GM_NON_UNITY_DIAGONAL
1119        - GM_EXTRA_DIAGONAL
1120        - GM_BOLUS_ADVEC )
1121      * However, wrong gradient check problem remains unsolved.
1122      * New CPP options have been introduced for different
1123        tapering schemes
1124    o external_fields_load now part of differentiation list
1125    o pressure needs multiple storing;
1126      would be nice to have store_pressure at beginning or
1127      end of forward_step, e.g. by having phiHyd global (5-dim.)
1128      (NB: pressure is needed for certain cases in find_rho,
1129      which is also invoked through convective_adjustment).
1130    o recomputations in find_rho for cases
1131     'JMD95'/'UNESCO' or 'MDJWF' are OK.
1132    o #define ATMOSPHERIC_LOADING should be differentiable
1133    o ini_forcing shifted to begining of initialise_varia
1134    o Incorporating QNVS line search routines into MITgcm
1135      (this is separate code, and therefore not under pkg)
1136      lsopt/, optim/
1137    o Updated verification/carbon/
1138      - #define GM_VISBECK_VARIABLE_K
1139      - GM_taper_scheme    = 'ldd97'    
1140    
1141    checkpoint46n_post
1142    Merging from release1_p8:
1143    o verification/natl_box:
1144      updating new external_fields_load routine
1145    o New package: pkg/seaice
1146      Sea ice model by D. Menemenlis (JPL) and Jinlun Zhang (Seattle).
1147      The sea-ice code is based on Hibler (1979-1980).
1148      Two sea-ice dynamic solvers, ADI and LSR, are included.
1149      In addition to computing prognostic sea-ice variables and diagnosing
1150      the forcing/external data fields that drive the ocean model,
1151      SEAICE_MODEL also sets theta to the freezing point under sea-ice.
1152      The implied surface heat flux is then stored in variable
1153      surfaceTendencyTice, which is needed by KPP package (kpp_calc.F and
1154      kpp_transport_t.F) to diagnose surface buoyancy fluxes and for the
1155      non-local transport term.  Because this call precedes model
1156      thermodynamics, temperature under sea-ice may not be "exactly" at
1157      the freezing point by the time theta is dumped or time-averaged.
1158      N.B.: fairly large differences in accuracy occur across
1159            different platforms/compilers; comparison between
1160            g77 (Linux) and F77 (SGI Origin 2000/MIPSpro)
1161            generated output gives:
1162       T           S           U           V
1163      C D M    c        m  s        m  s        m  s        m  s
1164      n p a R  g  m  m  e  .  m  m  e  .  m  m  e  .  m  m  e  .
1165      f n k u  2  i  a  a  d  i  a  a  d  i  a  a  d  i  a  a  d
1166      g d e n  d  n  x  n  .  n  x  n  .  n  x  n  .  n  x  n  .
1167    
1168      Y Y Y Y  5  5  7  7  7  8 10  9  6  6  6  6  7  5  7  5  7 FAIL  lab_sea
1169    o GAD:
1170      - generated new common blocks to account for call of
1171        same gad routines with differing traceridentities
1172        (needed to modify tracerIdentity indices in GAD.h)
1173      - generated separate common blocks for case useCubedSphereExchange
1174        (Department of Futurology)
1175      - parameter lists to gmredi_?transport: added tracerIdentity
1176      - added new key indices to tamc.h
1177    o external_fields_load:
1178      - added this routine to TAF list
1179      - needed to make some common blocks global and additional storing
1180        along the same lines as exf package (checkpoint_lev?_directives.h)
1181    o exf:
1182      updated external forcing package
1183      - bug fixes carried over from ecco-branch
1184        (missing OBCS_OPTIONS.h in two routines)
1185      - enable easy to use "no forcing".
1186      - added exf I/O for atmospheric loading
1187      - added exf I/O for runoff data
1188      - transfered scaling between exf <-> MITgcm to exf namelist
1189    o Adding new verification experiment global_with_exf.
1190      This verification experiment is almost identical to the
1191      global_ocean.90x40x15 experiment, except that it uses
1192      the exf (and cal) package instead of the
1193      external_fields_load routine (cf README file).
1194    
1195    checkpoint46m_post
1196    o modified testscript to return -- when there are no lines of "%MON" output
1197    o added new flag "quasiHydrostatic" for QH mode
1198      and new routine quasihydrostaticterms()
1199    o added 2*Omega*Cos(phi)*W to u equations (non-hydrostatic Coriolis term)
1200      New routine: mom_u_coriolis_nh()
1201    o fixed sign of non-hydrostatic metric terms in u and v equations.
1202      Depend on correct sign of gravitySign.
1203    o added work.pc* to .cvsignore in aim directories using ifc
1204    o introduced flag for controllin non-hydrostatic metric terms
1205    o removed gravitySign from PARM04
1206    o switched to g77/ifc from pgf77 in aim experiments
1207    
1208    checkpoint46l_post
1209    o made convective adjustment work with pressure coordinates:
1210     - changed the direction of k-loop in convective_adjustment.F for the
1211       case of pressure coordinates (OCEANICP,ATMOSPHERIC buoyancyRelation)
1212     - adjusted the reference pressure k-index in convective_adjustment.F
1213     - adjusted the convection condition in convect.F (in analogy to
1214       calc_ivdc.F)
1215     - convective_adjustment no longer computes anything on the halos
1216     - removed the warnings about negative salinity from find_rho.F and
1217       find_alpha.F; instead the new routine look_for_neg_salinity, called
1218       at the beginning of find_rho, find_alpha, and find_beta, does a
1219       check of the entire slice, if CPP-option
1220       CHECK_SALINITY_FOR_NEGATIVE_VALUES is defined
1221    checkpoint46l_pre
1222    
1223    checkpoint46k_post
1224    o fixed the verification/global_ocean.90x40x15 experiment:
1225     - new bathymetry (the world according to A., JMC, and M.)
1226     - new initial fields and forcing fields (*.bin files)
1227     - new POLY3.COEFFS (for the next release one should switch to a full
1228       equation of state: JMD95P or MDJWF)
1229     - fixed several errors and redundancies in the data file
1230     - experiment uses looped cells
1231     - added matlab directory with diagnostic scripts for plotting of output
1232    
1233    o S/R aim_initialise.F replace S/R aim_init from file aim_do_inphys.F:
1234     - read AIM physics parameters from a file (data.aimphys)
1235     - set defaults values = F.Molteni paper (Clim.Dyn., 2002)
1236    
1237    checkpoint46j_post
1238    o split calc_exact_eta in 2 S/R : integr_continuity & update_etaH
1239    o move wVel computation at the end of the time step, in S/R integr_continuity
1240    o create specific S/R to exchange T,S before DYNAMICS (for stagger time step)
1241    o update timeave pkg for wVel diagnostic.
1242    checkpoint46j_pre
1243    
1244    checkpoint46i_post
1245    o Clean up AIM package (and keep the results unchanged):
1246      include CPP_OPTION and use IMPLICT NONE in all routines ;
1247      declare all the variables _RL ; use _d 0 for all numerical constants.
1248      use ifdef ALLOW_AIM everywhere. And now AIM can be used with g77 !
1249    
1250    checkpoint46h_post
1251    o cleaned up the use of rhoNil and rhoConst.
1252      - rhoNil should only appear in the LINEAR equation of state, everywhere
1253        else rhoNil is replaced by rhoConst, e.g. find_rho computes rho-rhoConst
1254        and the dynamical equations are all divided by rhoConst
1255    o introduced new parameter rhoConstFresh, a reference density of fresh
1256      water, to remove the fresh water flux's dependence on rhoNil. The default
1257      value is 999.8 kg/m^3
1258    o cleanup up external_forcing.F and external_forcing_surf.F
1259      - can now be used by both OCEANIC and OCEANICP
1260    checkpoint46h_pre
1261    
1262     Added code to convert surface volume flux (fresh water) into
1263     a mass flux when using P coordinates in the ocean (OCEANICP).
1264     Note: It assumes you have set rho0=rhoConst=density of fresh water.
1265    
1266    checkpoint46g_post
1267    o Include a new diagnostic variable phiHydLow for the ocean model
1268      - in z-coordinates, it is the bottom pressure anomaly
1269      - in p-coordinates, it is the sea surface elevation
1270      - in both cases, these variable have global drift, reflecting the mass
1271        drift in z-coordinates and the volume drift in p-coordinates
1272      - included time averaging for phiHydLow, be aware of the drift!
1273    o depth-dependent computation of Bo_surf for pressure coordinates
1274      in the ocean (buoyancyRelation='OCEANICP')
1275      - requires a new routine (FIND_RHO_SCALAR) to compute density with only
1276        Theta, Salinity, and Pressure in the parameter list. This routine is
1277        presently contained in find_rho.F. This routine does not give the
1278        correct density for 'POLY3', which would be a z-dependent reference
1279        density.
1280    o cleaned up find_rho
1281      - removed obsolete 'eqn' from the parameter list.
1282    o added two new verification experiments: gop and goz
1283      (4x4 degree global ocean, 15 layers in pressure and height coordinates)
1284    checkpoint46g_pre
1285    
1286    checkpoint46f_post
1287    o Enable tangent linear (forward mode) gradient checks:
1288      - extended active file handling to g_... files
1289      - added TANGENT_SIMULATION to theSimulationMode
1290      - extended grdchk package accordingly
1291    o added tangent linear setup in verification/carbon/code_ftl
1292    o added adjoint setup in verification/front_relax/code_ad
1293    
1294    checkpoint46e_post
1295    o Added new equation of state -> MDJWF
1296      - EOS of McDougall et al., 2002, JAOT, submitted
1297      - caveat: the equation of state is only valid for a smaller (more
1298        realistic?) range of values than JMD95P/Z and UNESCO
1299      - added masks to the calculation of pressure in store_pressure
1300      - added more check values for density in check_eos (ini_eos.F), some of
1301        the old check values are out of the range of the MDJWF-eos, so don't
1302        expect perfect matches for those
1303    checkpoint46e_pre
1304    
1305    checkpoint46d_post
1306    o fixed store_pressure to work with both buoyancy relation = 'OCEANIC' and
1307      'OCEANICP', also initialised field pressure correctly in ini_eos in the
1308      case of pressure coordinates. eosType='JMD95Z' in
1309      combination with buoyancyRelation='OCEANICP' now causes an error.
1310    o Changed p = pressure(i,j,k,bi,bj)  to  p = pressure(i,j,kRef,bi,bj)
1311      in find_alpha/beta.
1312    checkpoint46d_pre
1313    
1314    o Changed p = pressure(i,j,k,bi,bj)  to  p = pressure(i,j,kRef,bi,bj)
1315      so that JMD95Z and JMD95P give approptiate static stability in find_rho.
1316    
1317    checkpoint46c_post
1318    o Changes necessary for ocean in p-coordinates
1319     -  Added new buoyancy relation = 'OCEANICP'
1320     -  Added new parameters = gravitySign (this used to be contained inside
1321        the factor dRdZ which I added when we first switched to R coordinates).
1322     X GM/Redi is not compatible (yet)
1323     X bottom drag and no-slip need to be debugged.
1324    checkpoint46c_pre
1325    
1326    checkpoint46b_post
1327    o Added new equation of state -> JMD95Z and JMD95P
1328      - EOS of Jackett and McDougall, 1995, JAOT
1329      - moved all EOS parameters into EOS.h
1330      - new routines ini_eos.F, store_pressure.F
1331    o Added UNESCO EOS, but not recommended because it requires
1332      in-situ temperature (see JMD95)
1333    o Modified formatting for knudsen2.f in utils/knudsen2 and added
1334      unesco.f to be used with POLY3
1335    checkpoint46b_pre
1336    
1337    checkpoint46a_post
1338    o Added (atmospheric) pressure loading
1339      - new field in FFIELDS.h, etc...
1340      - new cpp flag ATMOSPHERIC_LOADING
1341    o Changed hFacC to _hFacC in calc_phi_hyd.F
1342    o Added SHORTWAVE_HEATING to some files for consistency
1343    checkpoint46a_pre
1344    
1345    checkpoint46
1346    further merges from release1_p5
1347    o new ctrl package
1348      - adopted from ECCO environment to enable optimization
1349      - added Eliassen Palm fluxes to controls
1350    o added Eliassen Palm flux controls to gradient check package
1351    o cost package
1352      - Compatible with new ctrl package
1353      - added Eliassen Palm cost hooks
1354      - modif's of existing cost functions
1355    o Adjoint-related bug fixes in kpp:
1356      - kpp_calc: sore of kpphbl avoids recomputation/call to S/R kppmix
1357      - kpp_routines: store of Rib avoids partial recomputation bug of TAF.
1358    o autodiff package
1359      - flow directives:
1360        + new for S/R do_the_model_io
1361        + enhanced for S/R checkpoint
1362        + new gmredi.flow
1363      - Introduced CPP option ALLOW_AUTODIFF_MONITOR to
1364        disable adcommon.h/g_common.h by default.
1365      - fixed problem for adjoint of global_max
1366    o modified verification/carbon/
1367    o New setup for adjoint of global_ocean
1368    o added hooks for Eliassen Palm fluxes (dynamics.F, ini_fields.F)
1369    o cleaned TAF keys iikey, idkey (dynamics.F, thermodynamics.F)
1370    o incorporated hooks for sponge layer code (external_forcing.F)
1371    
1372    checkpoint45d_post
1373    o import 2 fixes from release1_p5 (CG2D.h & packages_readparms.F)
1374    o use recip_dx*,recip_dy* instead of /dx*,/dy* in orlanski_E,W,N,S
1375      (affects plume_on_slope "cg2d" output)
1376    o add new parameter deltaTfreesurf for free-surface time stepping
1377    o exchange gT,gS when using staggerTimeStep & GM & Oly<4
1378    o NONLIN_FRSURF: rescale gNm1 to get a better conservation with A-B
1379    o change phiMin in exp1 (to agree with documentation)
1380    o add new flags:
1381     - T,S forcing inside/outside Adams-Bashforth
1382     - turn off temp,salt advection and/or forcing
1383     - for each tracer, define internal flag for multiDimAdvection & A-B
1384    o monitor: change definition of KE to check conservation of Energy
1385    
1386    checkpoint45c_post
1387    o Removed f90 comments ("!")
1388    o Modified initialisations to enable exf package for MITgcm
1389      (without invoking ECCO_PACKAGE).
1390    o modifications to gradient check package (Martin Losch)
1391      - enable centered differences
1392      - modified format of standard output
1393    
1394    checkpoint45b_post
1395    o cleaned exchange calls in cg2d
1396    o Included CPP option ALLOW_AUTODIFF_MONITOR in forward_step
1397    o included CPP option SINGLE_LAYER_MODE in thermodynamics
1398      to configure barotropic setup (Martin Losch)
1399    o moved some initialisations within bi,bj loop in dynamics
1400      (TAF flow dependency)
1401    o in initialise_varia, moved call packages_init_variables
1402      before convective_adjustment_init
1403      (corresponding adjustment of TAF tape initialisation).
1404    o in calc_diffusivity/calc_viscosity extended domain to full overlap.
1405    
1406    checkpoint45a_post
1407    o compute Rho over the whole domain (extend iMin,jMin indices)
1408    o specific exchange for X-slice domain (case Ny=1)
1409    o argument futureIter of S/R obcs_calc missing in exp4 & internal_wave /code
1410    o solve_for_pressure : set cg2d_x to zero where OBCS are applied
1411    
1412    checkpoint44h_post = checkpoint45
1413    o Fix to restore differentiability:
1414      place at which packages_init_variables is called in
1415      initialise_varia is crucial for reverse control flow.
1416    o modifications in GMRedi to enable stable adjoint
1417      (corresponding modif's in thermodynamics, dynamics)
1418    o added missing hook for sponge layer code in external_forcing
1419    o modified test cost functions
1420    o storing in gad_advection (plus removal of write(0,*)!
1421    o missing headers TR1.h added in convective_adjustment routines
1422    o errorMessageUnit set non-equal zero in eeboot
1423      (conflict on some platforms, e.g. IBM SP3)
1424    o modified carbon verif.
1425    
1426    checkpoint44h_pre
1427    o vertical grid option: allow to put the Interface at the middle between
1428      2 cell-centers ; replace delZ in pkg/kpp by drF.
1429    o GM Advective form: Tracers are advected using the residual transport (=
1430      Euler+GM-bolus); set param GM_AdvSeparate=T to return to previous form.
1431    
1432    checkpoint44g_post
1433    o fix surface correction term in multiDimAdvection (affects plume_on_slope
1434      results) ; ifdef missing in thermodynamics.F
1435    
1436    checkpoint44f_pre,checkpoint44f_post
1437    o added PTRACERS package
1438      This allows an arbitrary number of passive tracers to be integrated
1439      forward simultaneously with the dynamicaly model.
1440      + Implemented so far:
1441        - basic forward algorithm (time-stepping, advection, diffusion, convection)
1442        - I/O and checkpointing
1443        - GM/Redi  *but*  using the GM/Redi coefficient of Salt
1444      + Not implemented so far:
1445        - KPP
1446        - OBCS
1447      + No specific example supplied (yet) but global_ocean.90x40x15 has the
1448        necessary data.ptracer file. Simply use -enable=ptracers and uncomment
1449        line in data.pkg.
1450      + This package is disabled by default since it increases storage.
1451    
1452    
1453    o testscript: added -cleanup option
1454    o Shap_filt: a) new shap_filt S/R to use no-slip BC with S2 filter
1455                 b) enable to filter 2D fields.
1456    
1457    checkpoint44e_pre,post
1458    o re-wrote convective adjustment to use pre-calculated weights
1459      Affects: model/src/convective_adjustment.F, convective_adjustment_ini.F
1460      Adds:    model/src/convective_weights.F, convectively_mixtracer.F
1461      Original calls to convect() still in place.
1462    
1463    chkpt44d_pre,post
1464    o added missing EXCLUDE_MONITOR flags
1465    o changed "e" to "_d" in gmredi_slope_limit, gmredi_slope_psi
1466      (incompatible typ in MIN/MAX expressions caused problems
1467      on IBM SP3)
1468    o in genmake added variable MAKEDEPEND
1469      plus resetting for case SunOS
1470    o added timer_stats.c routine for IBM SP3
1471    o removed variables in dynamics
1472    !!! I forgot to create tag chkpt44d_pre !!!
1473    !!! But chkpt44d_pre = chkpt44c_post    !!!
1474    
1475    o real fresh water flux implemented with non-linear free-surface.
1476    
1477    chkpt44c_pre,post
1478    o few fix (mask in shap_s2, EmPmR in external_field_load,
1479      USE_NATURAL_BCS in solve_for_P);
1480    o add arguments myIter & myTime to S/R obcs_calc & solve_for_P
1481    
1482    checkpoint44b_pre/_post
1483    o merge of relevant stuff from the ecco-branch:
1484      - genmake: removed $S64 overwrite for case SunOS
1485      - pkg/exf: update and corrections for field swapping and obcs
1486      - pkg/ecco: parameter lists for the_model_main, the_main_loop
1487                  harmonized between ECCO and MITgcm
1488      - pkg/autodiff: added flow directives for obcs, mdsio_gl_slice
1489                      updated checkpointing_lev... lists for obcs
1490      - model/src: minor changes in forward_step, plot_field
1491                   added directive for divided adjoint in the_main_loop
1492      - pkg/mdsio: added mdsio_gl_slice
1493    
1494    o check parameters & config (chkpt44a_pre,post)
1495    o OBC and NonLin_FrSurf.
1496    
1497    checkpoint44
1498    o fix bug in mom_vi_del2uv
1499    o select when filters are applied ; add options to zonal_filter (data.zonfilt)
1500    o gmredi: fix Pb in the adiabatic form ; add options (.e.g. Bolus advection)
1501    o update AIM experiments (NCEP input files)
1502    o improve and extend diagnostics (Monitor, TimeAve with NonLin-FrSurf)
1503    o added some stuff for AD
1504    
1505    checkpoint43
1506    o added two new advection tests
1507    o added global 4x4 degree ocean test
1508    o added test of H&S94 with free surface on cube
1509    o some final mods for gradient check, adjoint,...
1510    
1511    checkpoint42
1512      Fixed AD-related problems:
1513    o Store directives up-to-date with re-arranged Adams-Bashforth
1514      (mainly thermodynamics.F)
1515    o New store directives for multi-dim. advection schemes
1516      * new CPP flag ALLOW_MULTI_DIM_ADVECTION
1517      * new common block and key passkey
1518      (mainly gad_advection.F)
1519    o Modified store directives for split of dynamics/thermodynamics
1520      for the case ALLOW_KPP
1521    o Cleaned argument list for timestep_tracer.F
1522    
1523    checkpoint41
1524    o re-formatted/added comments in prologues of key subroutines
1525      to work with protex
1526    
1527    checkpoint40
1528    o moved calc_gs, calc_gt and calc_tr1 back to model/src
1529    o added FLT (floats) package from Arne along with demo. experiment
1530    o re-arranged Adams-Bashforth scheme for tracers to allow easier
1531      implementation of forward-in-time forcing terms
1532    o more mods for non-linear free-surface including new variable
1533    o modified multi-dim method to work on cube
1534    o bug fix in KPP (from DM)
1535    
1536    checkpoint40pre9
1537    o added DST advection schemes
1538    o fix MPI bug on SGI's
1539    o modifications for non-linear free-surface
1540    o fixed conditionals for fixed flow/passive tracer only mode
1541    o added tension/strain form of stress tensor
1542    o changes to commenting of arguments for TAF/TAMC
1543    o added/updated many matlab scripts
1544    o added multi-dimensional advection method for tracers
1545      
1546    checkpoint40pre8
1547    o new package rw/
1548      Added method for dumping intermediate local arrays:
1549      mdsio_writetile - same as mdsio_writefield except works from inside
1550                        bi,bj loop
1551      mdsio_writelocal - same as mdsio_writetile except works for local
1552                         arrays
1553      write_local_r? - higher-level wrapper for mdsio_writelocal
1554      Controlled by diagFreq. Defaults to zero (ie. no dumps)
1555      Example given at end of mom_vecinv.F that dumps some local arrays.
1556    o replaced calc_mom_rhs.F by mom_fluxform.F/mom_vecinc.F to
1557      control flux-form versus vector invariant code.
1558      Switch is runtime flag vectorInvariantMomentum (defaults to false)
1559      or genmake -DISABLE ...
1560    o TAMC-related update to cope with mom_fluxform.F/mom_vecinc.F
1561      (additional storing is now needed for case vecinv;
1562      currently nothing implemented to switch this storing off
1563      in case fluxform is used since no CPP flag available).
1564    
1565    checkpoint40pre7
1566    o bug fix in dynamics.F
1567      calc_viscosity called before k=1,Nr loop.
1568    o added some #ifdef's ALLOW_PASSIVE_TRACER
1569    o cleaned initialisations in ctrl_map_ini
1570      related to TAF
1571    
1572    checkpoint40pre6
1573    o split dynamics into thermodynamics & dynamics
1574    o corresponding split of calc_diffusivity into
1575      calc_diffusivity, calc_viscosity
1576      (kpp_calc_diff, kpp_calc_visc).
1577    o Added diffkr, kapgm to control variables
1578    o bug fix in gmredi_slope_limit for ldd97
1579    
1580    checkpoint40pre5
1581    o proper initialization of Adams-Bashforth time stepping
1582      + uses forward step for very first step of model (iter=0)
1583    o re-generated *all* output since almost all output is modified by this
1584      change (sorry but we've been putting this one off for about 2 years)
1585      + natl_box, aim.5l_Equatorial_Channel and aim.5l_zon-ave were
1586        *not* regenerated since they are already out of date and I don't
1587        want to create the impression that they are suddenly working.
1588    o removed KAP stuff for DEC's
1589    o modified/added many .cvsignore files in */code and */input
1590    o added new expt "solid-body.cs-32x32x1"
1591      + this uses an alternative form of ini_curvilinear_grid.F which
1592        is not necessarily any better than the current one...
1593    
1594    checkpoint40pre4
1595    o added re-initialisations of utrans,vtrans,rtrans in
1596      calc_common_factors which are crucial for TAF.
1597    o extended iMin,jMin range for calc_common_factors,
1598      calc_diffusivity
1599    o added option ALLOW_PASSIVE_TRACER
1600    o a few minor updates and fixes
1601    
1602    checkpoint40pre3
1603    o created calc_gtr1.F for gad package
1604    o split the_main_loop and re-introduced forward_step
1605    o some recomputations of nIter0 for TAMC
1606    
1607    checkpoint40pre2
1608    o Updated to latest branch of AJA, JMC
1609    o Added gradient check package
1610    o Added routines for passive tracer handling
1611    o Added carbon sequestration sensitivity experiment
1612    
1613    checkpoint39
1614     o Modifications and fixes to support TAMC
1615       (mainly missing or wrong directives)
1616     o Corrected common blocks when fooling TAMC to produce adjoint I/O
1617       in addummy_in_stepping
1618     o Updated verification/vero/ (bug fixes in code/, correct pickups in input/)
1619     o Enabled "sliced" (xz-,yz-) exchanges, needed for obcs.
1620     o Included following packages:
1621       cal: calendar
1622       exf: external forcing
1623       ecco: essential routines to control use of cal, exf
1624             (NB: this is not the full ECCO environment)
1625     o disabled some packages by default in genmake
1626    
1627    checkpoint38
1628     o see notes_c37_adj.txt
1629     o corrected wrong layer index in external_forcing_t
1630     o replaced the_main_loop/forward_step by the_main_loop
1631     o removed forceoutput from write_state
1632       (replaced criteria for initial/final state)
1633     o added runtime flag for pre-C35 pickups: usePickupBeforeC35
1634    
1635    checkpoint37
1636     o mdsio.F routine split and packaged in pkg/mdsio
1637       (mdsio.F and mdsio_gl.F still exist in eesupp/src but are not
1638        used unless genmake -disable=mdsio)
1639     o allow a more precise surface-geopotential gradient for the atmosphere
1640       taking into account the change in space of Alpha (=1/rho) at the surface.
1641     o variable "etaN" (replace cg2d_x) is the surface R-anomaly [r unit]
1642       (ocean: sea surface height [m] / atmos: surface pressure anomaly [Pa])
1643     o Change units: Phi_Hydrostatic (=phiHyd), Phi_Surface(=cg2d_x) and
1644       Phi_NonHydrostatic (=cg3d_x), all have now the dimension of a potential
1645       [m2/s2] (pressure/rhoConst in the ocean ; Geo-Potential in the atmosphere).
1646     o Time-Average diagnostics defined as a pseudo package "timeave".
1647     o pickup files : old pickup (before c35) did not work with new code (c35
1648       and after) unless activating 2 commented lines in initialise-varia.
1649     o Non-Hydrostatic pickup file Pb fixed.
1650     o bug with Rigid-lid version (since c35) fixed.  
1651    
1652    checkpoint36
1653     o implement Crank-Nickelson barotropic time-stepping
1654     o recover Time-Average diagnostics
1655     o fix Pb in checkpoint (PR#19)
1656     o AIM become a standard package ; clean unused CPP_kees
1657    
1658    checkpoint35
1659     o subtantial rewrite of dynamics.f
1660     o allows staggered time-stepping
1661     o packaged obcs, aim (Atmospheric Physics), zonal_filt, shap_filt
1662     o added bottom drag (linear + quadratic)
1663    
1664    checkpoint34
1665     o Modified exchange routines for correct reverse simulation.
1666     o Added verification output to comply with bug fix in impldiff.F
1667       as of c33 (exp2, natl_box).
1668     o Corrected store directives in dynamics.F
1669     o Corrected array boundaries in impldiff.F
1670     o Corrected array dimensions in gmredi.
1671       Added temporary scalars to avoid storage by TAMC (gmredi, kpp).
1672     o Added routine GLOBAL_SUM_INT to global_sum.F
1673     o Added mdsio_gl.F for ECCO purposes.
1674    
1675    checkpoint33
1676     o Fixed bug in lower BC in impldiff.F
1677     o Fixed confusion about units of forcing arrays in FFIELDS.h
1678       namely Fu,Fv,Qnet,Qsw,EmPmR:
1679       - Removed verification/natl_box/code/external_fields_scale.F
1680         (did not differ from that in model/src)
1681       - Changed units of fu,fv,Qnet,Qsw,EmPmR back to proper units
1682         (see FFIELDS.h for description)
1683       - Scale fu,fv,Qnet,Qsw,EmPmR when used in external_forcing_surf.F,
1684         kpp_calc.F and kpp_transport_t.F
1685       - Removed model/src/external_fields_scale.F and calls to it
1686       - verification/natl_box uses flux data with "atmospheric" sign so
1687         a special version of external_fields_load.F is used to
1688         change the data as it's read in. This way, the arrays
1689         have the right units and signs at all times tha a user could
1690         possibly use them.
1691     o Corrected genmake to delete a temporary file during configuration
1692    
1693    checkpoint32
1694     o Scaling of forcing fields moved from external_forcing.F to
1695       external_fields_scale.F, called directly after loading fields.
1696     o Surface relaxation terms added to surface tendency fields in
1697       extra subroutine.
1698     o impldiff.F changed to avoid storing by TAMC of huge intermediate
1699       fields.
1700     o Changes in GMRedi to comply with packaging structure.
1701     o Modifications and bug fixes in KPP package.
1702     o Verification experiment for KPP added (verification/nat_box/)
1703    
1704    checkpoint31
1705     o Packages interface brought in line with defined standard
1706       -> new routines packages_...F
1707       -> changes in initialise_fixed.F, initialise_varia.F
1708       -> enables initialisation interface for ECCO package
1709     o Rescaling of external forcing fields immediately after read
1710       (removed from external_forcing.F)
1711       -> new: surface_fields_scale.F
1712       -> affects ini_foorcing.F, external_fields_load.F
1713     o Computation of surface tendencies before tendency updates.
1714       -> new: external_forcing_surf.F
1715     o Change of variable names useGMRedi, useKPP, useECCO
1716     o Further changes in dynamics.F, impldiff.F for TAMC
1717     o Tested for experiments 0, 2, 4.
1718       - not yet tested for GMRedi.
1719       - not yet tested for KPP.
1720    
1721    checkpoint30
1722     o Updates for OBCs
1723     o New experiment for test OBCs (internal_wave)
1724     o New output.txt in verification/exp4/results/
1725     o Updates for KPP: calculation of viscosity corrected, new variables
1726       kpp_dumpFreq and kpp_taveFreq
1727     o CPP'd calls to system routines for TARGET_CRAY_VECTOR (P.H.)
1728       and entry for T90 in genmake
1729    
1730    checkpoint29
1731     o packaged KPP and GM/Redi
1732    
1733    checkpoint28
1734     o Corrected initialization of hFacMin for difference vertical coordinates
1735     o Modified calculation of partial cell thickness to more robust algorithm
1736     o config_summary.F: replaced write_1D_... by write_0D_...
1737       read_write.F: added subroutines write_0D_...
1738     o routines calc_common_factors, calc_gs, calc_gt, calc_phi_hyd, find_rho:
1739       included some initialisations required for TAMC.
1740     o routine calc_isoslopes: modified sqrt computation to make it
1741       differentiable for zero argument.
1742     o routines dynamics, impldiff:
1743       included store directives and tape key computations required for TAMC.
1744     o ALL TAMC related changes are between ifdef ALLOW_AUTODIFF_TAMC
1745    
1746    checkpoint27
1747     o fixed calc_isoslopes() to so that cancellation of terms in tensor
1748       formulation works properly with variable resolution.
1749     o restructured the calling tree between the_model_main() and dynamics()
1750     o split initialise() into initialise_fixed() and initialise_varia()
1751     o introduced initialization file pSurfInitFile for free surface (cg2d_x)
1752       in new routine ini_psurf()
1753    
1754    checkpoint26
1755     o moved some #ifdef in optional routines to encompass everything
1756       except the argument declarations. This was using up some memory.
1757     o fixed macros like _ADT to work with both versions of Linux cpp
1758     o cleaned up some unused and uninitialized variables
1759       (helps when debugging with strict compile options)
1760     o split up CPP_EEOPTIONS.h into options and macros
1761       (macros are now in eesupp/inc/CPP_EEMACROS.h)
1762     o patch for 2 processor JAM mode
1763    
1764    checkpoint25
1765     o updates for OBCs and NH
1766     o dramatically reduced memory usage
1767     o added "JAM" routines for use on Artic network
1768     o parameterization of convection by implicit vertical diffusion
1769     o added a diagnostic of convective index
1770     o moved call to calc_divg_hat() from dynamics() to solve_for_pressure()
1771       (this is was partly for OBCs and NH but also in anticipation of
1772        an explicit free-surface option)
1773     o initial state input files for U and V
1774    
1775    checkpoint24
1776     o Removed some spurious "REAL"s
1777     o Updated KPP to latest version from JPL
1778     o Added a COS(latitude) in horizontal viscosity
1779    
1780    checkpoint23
1781     o Added del^4 diffusion for salt and temperature
1782     o Multiple minor fixes (implicit none's, arguments to global_sum, etc.)
1783    
1784    checkpoint22
1785     o Made many small changes: implicit none, format(i5), etc...
1786     o Introduced KPP mixing scheme (compiles and runs but *not* tested)
1787    
1788    checkpoint21
1789     o Introduced new I/O package that supports direct-access records (mdsio.F)
1790     o Split-up mid-level I/O routines
1791     o Updated input data for experiments 0,1,2,4 and 5
1792     o Finally removed the genmake.* scripts (everyone seems happy with genmake)
1793    
1794    checkpoint20
1795     o Tidied up open-boundaries some more
1796     o Added non-hydrostatic code
1797     o Fixed some input data
1798     o Modified MPI start-up to work in "coupled" context.
1799    
1800    checkpoint19
1801     o Tidied up directory structure for verification experiments.
1802     o Added new code for open boundaries.
1803     o Corrected advective terms near boundaries.
1804     o Added CPP flag for "old UV" geometry and corrected spherical geometry.
1805     o Implemented free-slip/no-slip BCs and del^4 dissipation.
1806     o Split default parameters out of ini_parms.F into set_defaults.F.
1807    
1808    checkpoint18
1809     o Further changes for optional code generation with
1810       CPP - ugh!
1811    
1812    checkpoint17
1813     o Beginning to incorporating modularity
1814       for supporting atmos. and ocean configs.
1815     o Small changes for TAMC complinace
1816     o New ultra simple test case. Barotropic box
1817       configuration "exp0".
1818    
1819    checkpoint16
1820     o Minor changes to exchange routines to support
1821       accumulation in reverse mode. Adjoint of an
1822       assignment is an addition.
1823     o Changes to support compilation by TAMC (LR(1)
1824       syntax) and by g77 under Linux ( 72 character
1825       limit ).
1826    
1827  checkpoint15  checkpoint15
1828   Rewrote exchange routines to allow   Rewrote exchange routines to allow
1829   o General tile <-> tile connectivity.   o General tile <-> tile connectivity.

Legend:
Removed from v.1.14  
changed lines
  Added in v.1.346

  ViewVC Help
Powered by ViewVC 1.1.22