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

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

  ViewVC Help
Powered by ViewVC 1.1.22