/[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.204 by heimbach, Thu Nov 6 22:52:11 2003 UTC
# Line 3  $Header$ Line 3  $Header$
3      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
4      ==============================      ==============================
5    
6    checkpoint51u_post
7    o this is the post-merge tag of the ecco-branch
8      (needs another clean checkout and re-testing)
9    o various natl_box_adjoint configs and results
10      but no input fields
11    o obcs adjoint not yet merged!
12    o adding ECCO global 1x1 and 2x2 degree configs
13    o updated/extended some store directives for seaice
14    o pkg/ecco now containes ecco-specific part of cost function
15    o top level routines the_main_loop, forward_step
16      supersede those in model/src/
17      previous input data.cost now in data.ecco
18      (new namelist ecco_cost_nml)
19    o in ctrl/ cleaned some cross-dependencies and updated CPP options
20    
21    checkpoint51t_post
22    o this is the pre-merge tag of the ecco-branch
23    
24    checkpoint51s_post
25    o cleanup: removed various obsolete #define-s
26    o pkg/grdchk
27      - renamed 'ph-grd 3' to 'grad-res'
28      - merged from ecco-branch
29        (remaining bug fixes for obcs gradient checks)
30      - additional high-precision output for testreport
31        (grep for 'precision_grdchk_result')
32    
33    checkpoint51r_post
34    o cleaned up or removed CPP_OPTIONS.h files
35    o updated results for some of the tests to reflect the new
36      optfiles (-ieee: -O0 instead of -O3)
37    
38    checkpoint51q_post
39    o cd_code:
40      - moved cd_scheme.F -> cd_code_scheme.F
41      - separate read_checkpoint from cd_code_ini_vars.F
42      - separated cd_code part from write_checkpoint
43      - updated AD_SOURCE, generated .flow
44      - added CD_CODE_VARS.h to the_main_loop
45      - Moving cd_code specific store dir.s to pkg/cd_code
46    o ctrl package totally restructured
47      - pack/unpack now optional and decoupled from
48        xx_/adxx_ I/O
49      - ctrl_pack/unpack cleaned
50        (new routines ctrl_init_ctrlvar.F, pkg/ctrl/ctrl_init_wet.F)
51      - confined inclusion of AD_CONFIG.h to where necessary.
52    o genmake2: changed AD dependencies from SRCFILES to AD_FILES
53    
54    checkpoint51p_post
55    o create initial cd_code package
56      - WARNING: the initialization of fields within packages
57        is broken because INI_FIELDS (where READ_CHECKPOINT is
58        called) is called *before* PACKAGES_INIT_VARIABLES.
59        This seems to be backwards since
60        1) its important to initially zero the entire field including
61           the "halo" region
62        2) zeroing needs to be done *before* reading pickup info
63           and the pickup call might or might not happen in any
64           particular run
65      - this needs an overhaul for R2
66    o cleanup verification/*/code/GMREDI_OPTIONS.h
67    o cleanup testreport
68    
69    checkpoint51o_post
70    o bringing AD-related verif's up to date with genmake2
71      - carbon/
72      - global_ocean.90x40x15/
73      - hs.94.1x64x5/
74      - (front_relax/ )
75    o (more) consistent directory structure for AD-related verif.'s
76    o cleaning ALLOW_GRADIENT_CHECK -> ALLOW_GRDCHK
77    o cleaning some ALLOW_TANGENTLINEAR_RUN -> ALLOW_AUTODIFF
78    o bug fix in find_alpha.F for MDJWF:
79      - modif. to alpha = 1/D*( dN/dT - rho*dD/Dt) to account for
80        change rho -> rho-rhoConst
81      - replace call find_rho to find_rhonum
82    o initialisation of rFlx extended to full array (required by TAF)
83      and shifted to thermodynamics
84    o removed PTRACERS.h in ptracers routine
85    o added surfacetendencyPtr to S/R parameter list pracers_forcing
86    o Correcting initialisations for fVerU, fVerV.
87    o helping TAF to recognize dependency on kUp for
88      fVerU, fVerV
89    o Replacing delZ by delR in pkg/ctrl/
90    checkpoint51o_pre
91    
92    o undid all of cp51 pending some cleanups and discussion
93    o added the [#include "AD_CONFIG.h"] statement to all files that need
94       it for adjoint/tl #defines
95     o re-worked the build logic in genmake2 to support AD_CONFIG.h
96     o removed tools/genmake since it no longer works
97    
98    checkpoint51n_post
99    o modifications to make FREEZE flux visible to pkg/kpp
100      - moved surfaceTendencyTice from pkg/seaice to main code
101      - FREEZE & EXTERNAL_FORCING_SURF moved to FORWARD_STEP
102      - subroutine FREEZE now limits only surface temperature
103        (this means new output.txt for global_ocean.90x40x15,
104         global_ocean.cs32x15, and global_with_exf)
105    o added surface flux output variables to TIMEAVE_STATVARS
106    
107    checkpoint51n_pre
108    o added "#undef ALLOW_USE_MPI" support to eesupp/src/gather_2d.F
109    o added [#include "AD_CONFIG.h"] to all files that use the following
110      defines:
111      - ALLOW_ADJOINT_RUN
112      - ALLOW_TANGENTLINEAR_RUN
113      - ALLOW_ECCO_OPTIMIZATION
114    
115    checkpoint51m_post
116    o incorporating changes to get TAMC/TAF working in genmake2
117      - added new TAMC/TAF targets to the Makefile
118      - various cleanups related to package handling
119      - these changes should have no impact on the forward model
120    
121    checkpoint51l_post
122    o changes to pkg/cal and pkg/exf that allow and speed-up long integrations
123     - faster algorithm for cal_addtime.F
124     - higher precision arithmetic, where needed
125     - pkg/exf *startdate variables changed from calendar date to
126       model integration time
127    
128    checkpoint51l_pre
129    o add salt flux to forcing fields (used when salty sea-ice forms or melts)
130    o enable to apply restoring on S & T only in a latitude band.
131    o update output (external_forcing_surf modif. change truncation errors)
132       global_ocean.cs32x15, global_ocean_pressure, lab_sea, natl_box
133    
134    checkpoint51k_post
135    o change default to: useNHMTerms=.FALSE.
136     - new output.txt for atmos. exp (NHMTerms were wrong but now turned off):
137       adjustment.128x64x1, aim.5l_Eq_Ch, aim.5l_LatLon, hs94.128x64x5, hs94.1x64x5
138     - new output.txt for idealized oceanic exp (NHMTerms are now turned off):
139        exp1, ideal_2D_oce
140     - change data file of oceanic exp (leave the results unchanged for now)
141       exp2, global_ocean[90x40x15,pressure,with_exf], lab_sea, natl_box
142    o set gravitySign automatically according to the vertical coordinate used
143      (and change sign: back to "logical" value: +1 when R increases downward)
144    o added an include barrier to the default CPP_OPTIONS.h and
145      removed the #include "PACKAGES_CONFIG.h" from it
146    o fix a bug in mom_fluxform (from chk51j_post)
147    
148    checkpoint51j_post
149    o Added some AD-related initialisations in mom_vecinv/ mom_fluxform/
150    o adjusted some flow directives (dynamics, thermodynamics)
151    o added cubed-sphere case to test cost function
152    o heckpoint_lev?_directives.h now include
153      pkg-specific directives, whenever those are enabled.
154    o Moving pkg-specific flow directives to corresponding pkg
155      Moving pkg-specific differentiation list to corresponding pkg
156      Moving pkg-specific checkpoint-lev storing to corresponding pkg
157      ---> conventions are
158           - pkg_ad.flow
159           - pkg_ad_diff.list
160           - pkg_ad_check_lev?_dir.h
161    
162    checkpoint51i_post
163    o merge of the branch-genmake2
164      - knowingly breaks the older genmake
165      - automatic generation of all ALLOW_${PKG_NAME} defines
166      - new testreport supersedes older testscript
167    o large number of package inclusion and header cleanups
168    checkpoint51i_pre
169    
170    o new output for adjoin of global ocean vector invariant
171    o fix for checkpoint of thermodynamic seaice and bulk_force
172    o Steph gchem various cleanups
173    
174    checkpoint 51h_pre
175    o fixed some single quotes
176    o modify gchem pkg to be more versatile
177    o modifications to clean up dic pkg
178    o add pkg/cfc
179    
180    checkpoint51g_post
181    o provide links for ARPACK and ADM*TLM
182    o start removing verification/vero/
183    o update AD-related stuff
184      (in particular some IF-statements in model/src/ routines)
185    o adding to verification/global_ocean.90x40x15/ adjoint of
186      vector invariant setup
187    
188    checkpoint51f_post
189    o update advect_xz/output.txt (left from chekpoint50f_pre, ini_vel modif)
190    o Mods and bug fixes to pkg/cal, pkg/exf, etc., needed for computation
191      of tracer Green's fucntions for ocean inversion project.
192    
193    checkpoint51f_pre
194    o Added on-the-fly spatial interpolation capability
195        "USE_EXF_INTERPOLATION" to pkg/exf.
196      - This is a temporary Cartesian-grid hack until
197        the super-duper ESMF coupler becomes available.
198      - See verification/global_with_exf/README for usage example.
199      - Removed obsolete EXFwindOnBgrid and SEAICEwindOnCgrid
200        flags and modified pkg/seaice accordingly.
201    o Bug fix to pkg/ptracers, pkg/generic_advdiff/gad_calc_rhs.F,
202        and pkg/kpp/kpp_transport_ptr.F for dealing with tracer
203        non-local transport term.
204    
205    checkpoint51e_post
206    o pkg/mom_vecinv:
207      - changes related to hFac: use S/R from aim.5l_cs/code (coriolis & vort.advec)
208      - add time-ave diagnostic of vorticity advection.
209    o add diagnostic (instantaneous) of Shapiro Filter effect for T,S & UV.
210    o atmospheric geopotential: - include water vapor effect;
211                                - use p^kappa in p* scaling.
212    o land pkg: read initial state from files.
213    o AIM : add stratospheric drag in the upper level
214    
215    checkpoint51d_post
216    o change function ILNBLNK (=> last non-blank char.) to return zero
217      (instead of the string length) when the string. char is empty
218    o fix bug in dxV,dyU definition of cubed-sphere grid (ini_curvilinear_grid)
219    o modif's to restore TAMC compatibility
220      - avoid "_d" constructs in PARAMETER declarations
221      - avoid interrupting lines by comment lines
222    o Use cluster local disks for purely local I/O
223      vs. globally visible disks needed for ctrl stuff
224      (merged from ecco-branch)
225      - new active_file_loc... and mdsio_..._loc routines
226      - affected packages: autodiff, ctrl, grdchk, mdsio
227    
228    checkpoint51c_post
229    o introducing integer flag debugLevel
230      - debLevZero: suppress all output
231      - debLevA: standard
232      - debLevB: equivalent to current debugMode=.TRUE.
233    o introducing pathname variable mdsioLocalDir for mdsio
234      that can be specified at runtime
235      (relevant for cluster I/O to local disk)
236    `
237    >>>checkpoint51b_post
238    adjoint of ptracers
239    o disentangled ALLOW_PTRACERS using new ALLOW_GCHEM
240    o extended state in checkpoint_lev?, etc.
241    o alternative ctrl/cost with tr1 or ptracer
242    o new comlev1_bibj_ptracers
243    o new ptracers.flow
244    o made ptracers_forcing same as external_forcing_s
245    o added verification for adjoint with ptracers
246      - adm. grdchk fail so far
247      - tlm. grdchk OK
248      - checked tapelev/comlev recomputations: OK
249    <<<checkpoint51b_pre
250    
251    checkpoint51a_post
252    o added code for biogeochemistry package
253      - new pkgs: dic, gchem
254      - new subroutine in ptracers
255    o modify code for biogeo packages
256      - in model/src and pkg/ptracers
257    
258    checkpoint51
259    o merged improved packages from ecco-branch (ecco_c51_e34) to MAIN
260      - autodiff, ctrl, exf, grdchk, seaice
261      kept separate packages
262      - cost, ecco, obcs
263    o updating verification/internal_wave, verification/lab_sea
264      (all verif's pass on faulks.lcs.mit.edu RH7.3, g77)
265    
266    checkpoint50i_post
267    o Preparing next differentiable checkpoint and sync
268      of MAIN vs. ecco-branch
269      - 1st step: this one is differentiable
270      - 2nd step: next(! not this) checkpoint will have updated packages
271                  from ecco-branch)
272    
273    checkpoint50h_post
274    o new package "land": provide surface BC for AIM.
275    o pkg/ptracers: apply exchange to all tracers after reading a pickup.
276    o AIM: use true log-P extrapolation for near surface temp (= as in
277        F.Molteni paper) ; update aim.5l_cs output.
278    o New variable in PARM03 for more flexible pickups
279    o somewhat cleaned package initialisation sequence for
280      ctrl/ cost/ ecco/ in packages_... routines
281    
282    checkpoint50g_post
283    o merged with release1_p17 (pkg/seaice and verification/lab_sea)
284      - added SEAICE_MULTILEVEL for 8-category sea-ice thermodynamics
285      - LSR sea-ice dynamic solver moved to SouthWest B-grid location and
286        made the default because of faster convergence than ADI
287    
288    checkpoint50f_post
289    o exf totally restructured
290      - replaced all exf_set_ routines by one generic exf_set_gen.F
291        and made sure it's still differentiable
292      - split exf_getffields.F into new exf_bulkformulae.F
293      - exf_inscal_/exf_outscal_ suffixes consistent with field names
294      - updated adjoint/makefile and relevant verif. accordingly
295    
296    checkpoint50f_pre
297     o AIM: near surface temp evaluated from Pot.Temp: fixed for Part Cell ;
298          + change Evap over land. (update aim.5l_cs output)
299     o added missing .cvsignores and made uniform across expts
300     o changed configuration of tidal_basin_2d expt
301     o added pkg/debug functions for tracing code in fatal crashes
302     o tidied pkg/monitor to use MONITOR_OPTIONS.h
303     o new fn in pkg/monitor to stop model if solution grows too big
304     o removed lots of single quotes from comments
305    
306    checkpoint50e_post
307    o make KPP work with PTRACERS
308     - fix gad_calc_rhs to call new routine kpp_transport_ptr, which is
309       nearly a copy of kpp_transport_s
310     - there is no analogue to SurfaceTendencyS, so I have to use
311       gPtr(of the surface layer) instead
312    o add a new platform SunFire+mpi (SunFire 15000) to genmake
313    checkpoint50e_pre
314    
315    checkpoint50d_post
316    o change kpp output from multiple-record state files to single-record state
317      files analogous to write_state.F
318    o reduce the output frequency of cg3d-related stuff to the monitor frequency,
319      analogous to the cg2d-related output.
320    o fix small problem with in ptracers_write_checkpoint.F: len(suff)=512,
321      so that writing to internal file fn (with length 512) fails.
322    checkpoint50d_pre
323    
324    checkpoint50c_post
325    o fix problem in ini_procs.F when using MPI (was there since checkpoint48f)
326    o add monitor diagnostic of vorticity (mon_vort3.F) and potential energy.
327    o add time-average diagnostic of U*V and vertical diffusive flux for theta.
328    o bug fixed in convective adjustment diagnostic (multi-tile set-up).
329    o 4th Order Adv scheme: return to previous (c40pre7) masking near boundaries.
330    
331    checkpoint50c_pre
332    Merging from release1_p13:
333    o bug fix for pkg/seaice dynamic solver
334    o Added SEAICE_initialHEFF to pkg/seaice
335    
336    checkpoint50b_post
337    o store u*,v* in gU,V instead of in guNm1,gvNm1
338    o in order to put the momForcing out of the Adams-Bashforth:
339      move forcing & CD-scheme calls from mom_fluxform & mom_vecinv
340      to timestep.F
341    o new flag "useCDscheme" (default=F); replace guCD,gvCD by local arrays
342    o re-generate output for highly sensitive test-exp:
343       global_ocean_pressure, ideal_2D_oce, lab_sea, natl_box
344    
345    checkpoint50b_pre
346    o restore the use of momAdvection & useCoriolis flags (mom_vecinv)
347    o corrected CPP option mismatch in exf_Bulk... functions for case
348      #define ALLOW_ATM_WIND && #undef ALLOW_ATM_TEMP
349    
350    checkpoint50a_post
351    o Bug fix for merging between c50 and KPP.
352      ikey was passed from thermodynamics to kpp_calc via
353      common block rather than being recomputed in kpp_calc,
354      in contradiction with new key itdkey.
355      New key ikppkey created, and tamc.h headers updated.
356    
357    checkpoint50
358    - 2nd step of merge with ecco-branch:
359      merge changes in ecco-branch back into main trunk
360    - bug fix in find_alpha
361    - more storing in gmredi_calc_tensor.F, kpp_routines.F
362    - avoid iterative loop in ini_pressure for ALLOW_AUTODIFF_TAMC
363    - merged some sliced AD support routines
364    
365    checkpoint49
366    merged from ecco-branch:
367    o exf:
368      - Enable initialisation of forcing fields to constant
369        (runtime) values.
370      - in exf_getffields.F
371        Reduce i-/j-loop to interior domain, discarding overlaps.
372        That also fixes wrong TAF-key computations for key_1, key_2
373        with bulf formulae.
374      - exf_init.F modify #ifdef for exf_init_evap
375      - exf_getffieldrec.F, ctrl_getrec.F
376        The following INT-usages are not safe:
377          fldsecs  = int(fldsecs/fldperiod)*fldperiod
378          fldcount = int(fldsecs/fldperiod) + 1
379        and were modified.
380    o autodiff: checkpoint_lev...
381      - updated storing for bulk formulae (some arrays were missing)
382      - added state for seaice package
383      - synchronized with main branch
384    o DIVA:
385      Modif.s in
386      - the_main_loop.F
387      - the_model_main.F
388      and added cost_final_restore.F cost_final_store.F
389      o With these changes, it is possible to fully separate
390        the first forward run to compute the cost function (mdthe_main_loop)
391        and adjoint runs over individual DIVA intervals (adthe_main_loop)
392        into separate model executions.
393        This enables better tuning of DIVA to given queue sizes.
394      o Loss of cost function value in consecutive DIVA runs is
395        fixed by storing to 'costfinal' file.
396      o Appropriate call of ctrl_unpack/_pack,grdchk_main at
397        beginning/end of adjoint integration is accounted for.
398      The current changes apply to TAF-1.4.26.
399      TAF has one remaining bug, requiring one manual change
400      (see MITgcm manual).
401    o cal: synchronized between MAIN and ecco-branch
402    
403    checkpoint48i_post
404    o Changes to restore differentiability of code w.r.t. previous tag
405      (mostly adding new routines to make list and replacing
406      pressure by totPhiHyd).
407    o Updated and merged grdchk package
408      - has both ADM and TLM checks
409      - works for single- and multi-proc.
410      - output cleaned
411      - worked successfully for parallel DIVA
412    o genmake:
413      - Adding -platform=SP4
414      - Modif. for DEC Alpha (many don't have makedepend; use mkdep instead).
415    o Modif. for DIVA:
416      ctrl_unpack should not be called in intermediate DIVA interval.
417      (similar thing would apply for active files such as
418      tbar, sbar, psbar, which should not be reinitialised;
419      only relevant for ecco-branch)
420    
421    checkpoint48h_post
422    o improve "ini_p_ground" when using finite difference form for calc_phi_hyd
423    o Added net flux to downward flux conversion to pkg/exf/exf_getffields.F
424    o Added SEAICE_initialHEFF to pkg/seaice
425    o ecco_the_model_main.F: SEAICE_WRITE_PICKUP must precede WRITE_CHECKPOINT
426    
427    checkpoint48g_post
428    --- EOS:
429    o compute locally the pressure for use in EOS: UNESCO, JMD95P, MDJWF
430      store total Potential in totPhyHyd for diagnostics & EOS.
431    o fix restart and overlap Pb when using Z-coord and EOS funct. of P
432    --- Pressure/geopotential gradient:
433    o use Ro_surf & R_low instead of hFac in cal_phi_hyd:
434    o NLFS + p-coord.: eta*Alpha' is not longer lagging 1.time-step behind
435      ( changes results of global_ocean_pressure )
436    o NLFS + z-coord.: add eta*Rho' contribution.
437    o accurate phiHyd when using interface-W at the middle between 2 centers
438     ( changes results of ideal_2D_oce )
439    o includes r* 2nd term in potential gradient.
440    
441    checkpoint48f_post
442    Merging from release1_p12:
443    o Modifications for using pkg/exf with pkg/seaice
444      - improved description of the various forcing configurations
445      - added basic radiation bulk formulae to pkg/exf
446      - units/sign fix for evap computation in exf_getffields.F
447      - updated verification/global_with_exf/results/output.txt
448    o Added pkg/sbo for computing IERS Special Bureau for the Oceans
449      (SBO) core products, including oceanic mass, center-of-mass,
450      angular, and bottom pressure (see pkg/sbo/README.sbo).
451    o Lower bound for viscosity/diffusivity in pkg/kpp/kpp_routines.F
452      to avoid negative values in shallow regions.
453      - updated verification/natl_box/results/output.txt
454      - updated verification/lab_sea/results/output.txt
455    o MPI gather, scatter: eesupp/src/gather_2d.F and scatter_2d.F
456    o Added useSingleCpuIO option (see PARAMS.h).
457    o Updated useSingleCpuIO option in mdsio_writefield.F to
458      work with multi-field files, e.g., for single-file pickup.
459    o pkg/seaice:
460      - bug fix in growth.F: QNET for no shortwave case
461      - added HeffFile for specifying initial sea-ice thickness
462      - changed SEAICE_EXTERNAL_FLUXES wind stress implementation
463    o Added missing /* */ to CPP comments in pkg/seaice, pkg/exf,
464      kpp_transport_t.F, forward_step.F, and the_main_loop.F
465    o pkg/seaice:
466      - adjoint-friendly modifications
467      - added a SEAICE_WRITE_PICKUP at end of the_model_main.F
468    
469    checkpoint48e_post
470    o New S/R for diagnostic of bottom pressure (phi0surf was missing in c48d_post)
471    o dynamics: change definition of computational domain & adapt mom_fluxform
472      accordingly ; when viscA4=0, allows to run the dynamics with Olx=Oly=2.
473    o following exp works with Olx=Oly=2 (and pass through checkbounds option):
474        adjust_nlfs.cs-32x32x1 adjustment.128x64x1 adjustment.cs-32x32x1
475        exp0 exp1 exp2 exp4 exp5 hs94.cs-32x32x5 hs94.128x64x5 hs94.1x64x5
476        global_ocean.90x40x15 global_with_exf global_ocean_pressure
477        inverted_barometer solid-body.cs-32x32x1
478      (high order AdvScheme and/or multiDimAd works with Olx=Oly=2 ? not sure)
479    
480    checkpoint48d_post
481    o in preparation for r*:
482     a) use pre-computed gradient of hydrostatic potential:
483        changes in timestep.F & mom_cdscheme.F affects results of ideal_2D_oce
484     b) move phi0surf from calc_phi_hyd to calc_grad_phi_hyd:
485        => affects results of glob_oce_pressure (different truncation error)  
486      update output.txt of ideal_2D_oce & global_ocean_pressure
487    
488    checkpoint48d_pre
489    o in preparation for r*:
490      new S/R (calc_grad_phi_hyd.F) to compute Hydrostatic potential gradient.
491      pass the 2 comp. of the grad. as arguments to momentum S/R.
492      but for the moment, only used if it does not change the results.
493    o add finite volume form of calc_phi_hyd for buoyancyRelation OCEANIC & OCEANICP
494    
495  checkpoint48c_post  checkpoint48c_post
496  Modifications in treatment of initial flux forcing controls  Modifications in treatment of initial flux forcing controls
497  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.204

  ViewVC Help
Powered by ViewVC 1.1.22