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

Legend:
Removed from v.1.141  
changed lines
  Added in v.1.214

  ViewVC Help
Powered by ViewVC 1.1.22