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

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

  ViewVC Help
Powered by ViewVC 1.1.22