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

Legend:
Removed from v.1.13  
changed lines
  Added in v.1.226

  ViewVC Help
Powered by ViewVC 1.1.22