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

Legend:
Removed from v.1.9  
changed lines
  Added in v.1.234

  ViewVC Help
Powered by ViewVC 1.1.22