/[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.128 by heimbach, Thu Feb 6 22:43:09 2003 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  checkpoint48c_post
447  Modifications in treatment of initial flux forcing controls  Modifications in treatment of initial flux forcing controls
448  to avoid extra storing of flux fields.  to avoid extra storing of flux fields.

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

  ViewVC Help
Powered by ViewVC 1.1.22