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

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

  ViewVC Help
Powered by ViewVC 1.1.22