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

Legend:
Removed from v.1.8  
changed lines
  Added in v.1.321

  ViewVC Help
Powered by ViewVC 1.1.22