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

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

  ViewVC Help
Powered by ViewVC 1.1.22