/[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.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    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  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  o Changes to restore differentiability of code w.r.t. previous tag
485    (mostly adding new routines to make list and replacing    (mostly adding new routines to make list and replacing
486    pressure by totPhiHyd).    pressure by totPhiHyd).

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

  ViewVC Help
Powered by ViewVC 1.1.22