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

Legend:
Removed from v.1.7  
changed lines
  Added in v.1.199

  ViewVC Help
Powered by ViewVC 1.1.22