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

Legend:
Removed from v.1.137  
changed lines
  Added in v.1.225

  ViewVC Help
Powered by ViewVC 1.1.22