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

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

  ViewVC Help
Powered by ViewVC 1.1.22