/[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.363 by edhill, Thu Oct 7 19:31:14 2004 UTC revision 1.505 by edhill, Fri Jun 24 04:36:53 2005 UTC
# Line 1  Line 1 
1  $Header$  $Header$
2    $Name$
3    
4      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
5      ==============================      ==============================
6    
7    o mnc-ify the thsice package as requested by Daniel Enderton
8      - the monitor--MNC output needs work
9      - many attributes need to be added (most are currently blank)
10    o mnc-ify theaim_v23 package as requested by Daniel Enderton
11      - many attributes need to be added (most are currently blank)
12    o remove "groundAtK1" & "rkFac" (replaced by usingPCoords & -rkSign)
13    o add Sadourny like discretization to the 4th.O vorticity advection scheme
14    o fix bug in rStar code (calc_r_star.F) when used with topo/bathy.
15      update output.txt from: aim.5l_cs (& .thSI), cpl_aim+ocn,
16         fizhi-gridalt-hs and global_ocean.cs32x15 (& .thsice).
17    o fix few little things to avoid floating error with -ftrapuv (ifort v9)
18     (ini_spherical_polar_grid.F, calc_r_star.F, monitor/mon_surfcor.F)
19    
20    checkpoint57i_post
21    o Diagnostics package was changed: diagnostic allocation is now deactivated
22      by setting an empty file name in the namelist (used to be by setting 0 frequency)
23    o momentum advection (VI form) options: activate 4th.O vorticity Coriolis ;
24      add 1rst Order upwind vertical Shear.
25    o add a quick fix for A/B checkpointing in OFFLINE mode
26    o add IGNORE_TIME define and -ignore_time option to genmake2 as an
27      end-run around the C/Fortran linking horror in eesup/src/timers.F
28    o added pkg/runclock: allows user to terminate run based on wall clock
29    o added non-hydrostatic scaling parameter: nh_am2
30    o pkg/my82: futile attempt to make results compiler-independent by adding
31      some "_d 0", etc. no effect.
32    o for mnc output, fill the 'T' coordinate var with myTime and create a
33      separate 'iter' variable for iteration count
34    o pkg/diagnostics:
35      add new capability: output of Global/Regional & per-level statistics ;
36      tested against monitor output (including land & thSIce) on various exp.
37    o make seaice-pkg I/O type flags (MNC/MDS) more standard.
38    
39    checkpoint57h_done
40      tag after changing user customized files (DIAGNOSTICS_SIZE.h,
41      data.diagnostics, data.gchem, data.ptracers) is done.
42    
43    o pkg/diagnostics: prepare for Global/Regional statistics.
44      add 2nd namelist in data.diagnostics and update DIAGNOSTICS_SIZE.h
45    o remove "baseTime" (no used) from arg. list of DIFF_BASE_MULTIPLE
46      and rename it: DIFFERENT_MULTIPLE
47    
48    checkpoint57h_post
49    o move tIter0 from data.gchem to PTRACERS_Iter0 in data.ptracers
50    o pkg/diagnostics: change output frequency, now in seconds (instead
51      of Nb of iterations). This requires to change data.diagnostics.
52    checkpoint57h_pre
53    
54    o in mnc, let the user create the output dir if both mnc_outdir_date
55      and mnc_outdir_num are false
56    o add fflags() to pkg/diagnostics which allows one to specify, on a
57      per-file basis, the file precision [default behavior is unchanged]
58    o added diagnostics to pkg/kpp, including computation of mixed layer
59      depth based on a temperature/density criterion
60    o updated verification/natl_box to test the new pkg/kpp diagnostics
61    o bugs fixed (with useAbsVorticity=T & with useJamartMomAdv=T)
62    o test AB-3 code with 4th.Order advection scheme (advect_xy/input.ab3_c4)
63    o fix mnc flags in pkg/seaice so that they are "owned" by seaice,
64      not mnc -- this mistake was found by JMC and is now corrected
65    
66    checkpoint57g_post
67    o add Adams-Bashforth 3rd Order time stepping:
68      - default remains AB-2 (#undef ALLOW_ADAMSBASHFORTH_3)
69      - not yet implemented with NH, CD_Scheme, pTracers, MNC_pickup ...
70    checkpoint57g_pre
71    
72    o make lambda[Theta,Salt]ClimRelax spatially varying
73      (default remains spatially uniform constant based on tau)
74    o added new control variables
75      * init. uVel, vVel, etanN
76      * lambda[Theta,Salt]ClimRelax
77    o separate masks used for ctrl_pack/unpack 'from write_grid' output
78      (suggested by G. Forget)
79    
80    checkpoint57f_post
81    o add parameter "baseTime" = model base time = time at iteration zero
82      new function DIFF_BASE_MULTIPLE (replace DIFFERENT_MULTIPLE) to
83      account for baseTime shift
84    o move Coriolis arrays from PARAMS.h to GRID.h
85    checkpoint57f_pre
86    
87    o mnc-ifying the seaice package
88    o introduced an alternative length scale calculation for use in the limiting
89      maximum viscosity (off by default, see mom_vi_hdissip.F for details)
90    o S/R ptracers_calc_diff: argument list bug for CALL KPP_CALC_DIFF_S
91    o added modified Leith scheme with viscosity proportional to grad(Hdiv)
92      as well as grad(vort3).  Made it compatible with both approximate form
93      for the cubed sphere and full form of these gradients.  Added flag
94      useFullLeith to select between approximate and full form.  
95    o add "d0" in getcon.F to reduce differences between compilers/platforms
96      update output.txt of exp. fizhi-gridalt-hs
97    o change port_rand funtion to allow to set the seed.
98    o fix obscure MNC bug involving conversion between reals and integers
99      - it caused no problems with certain (eg. gcc, ifc) compilers but the
100        new version is now more standards-compliant
101    o adjoint-related modifications
102      * gad_dst3_adv_?: to be able to use advscheme=30 in adjoint
103      * gad_calc_rhs: fool adjoint, revert to advscheme=30 in reverse when using 33
104      * mom_vi_hdissip: to be able to use Leith scheme in adjoint
105    
106    checkpoint57e_post
107    o Adding eddy stress controls a la Ferreira et al.
108    checkpoint57e_pre (actually was tagged: eckpoint57e_pre)
109    
110    o fizhi pkg: fix AtoC and CtoA when called with same input & output array
111      update output.txt of exp. fizhi-gridalt-hs
112    o add more "Z" dimensions and associated coordinate vars to MNC
113    o pkg/exf: added twoDigitYear capability for option useExfYearlyFields
114    o parameter calendarDumps: when set, approximate months (30-31 days) and years
115      (360-372 days) for parameters chkPtFreq, pChkPtFreq, taveFreq, SEAICE_taveFreq,
116      KPP_taveFreq, and freq in pkg/diagnostics are converted to exact calendar
117      months and years.  Requires pkg/cal.
118    o diagnostics: add pickup functionality
119      - off by default for backwards compatibility
120      - current version only uses MDSIO -- MNC will be added
121    o allow to use pkg diagnostics for LAND pkg output & Shapiro Tendencies.
122    o pkg/shap_filt: fix for multi-tiles per face (CS-grid with EXCH2)
123    
124    checkpoint57d_post
125    o pkg/thsice used in the ocean: fix tile Pb related to sIceLoad forcing
126    o modify verification/ideal_2D_oce so that it tests the creation of mnc
127      output from the diagnostics package
128    o temporary fix in EXCH2_UV: add a 3rd call to fix the 24.tiles CS-grid set-up
129    o make genmake2 more portable by using ".$FS" instead of ".f" for more
130      of the test compilations (eg. IBM xlf on Mac OSX w/HFS filesys)
131    o add coordinate variables to the MNC output from the diagnostics package
132    o change MNC-flags default value: true when useMNC=TRUE
133    o add a "readgrid_mnc" flag to MNC and give model/src/ini_curvilinear_grid.F
134      the ability (off by default) to read the grid information using MNC
135    o lab_sea: use LSR_ERROR=1.E-12 for testing ; update output.txt
136    o diagnostics: fix a bug (sub-set of levels); keep full precision when averaging
137    o do snap-shot diagnostics at the middle of the time-interval (instead of
138      at the end).
139    o update exp. aim.5l_cs (use default LAND_OPTIONS.h file) and add
140      new test for AIM with thSIce + slab-ocean
141    o cpl_aim+ocn test: update output (optfile & default GMREDI_OPTIONS.h)
142    o move state variable diagnostics to the beginning of the time step ;
143      (note: still needs some work specially for snap-shot diagnostics)
144      duplicate & replace UVELVVEL diagnostics with UV_VEL_C & UV_VEL_Z
145    
146    checkpoint57c_post
147    o Change testing option (-ieee) to get closer agreement between g77 & ifort
148    o generate new output.txt files on faulks with g77 & the new -ieee option
149    checkpoint57c_pre
150    
151    o add "_d 0" in freeze ; change some "FLOAT" to "DFLOAT" and went back (TAF);
152      update output.txt of exp. global_ocean.90x40x15
153    o fix in ini_eos.F (one "_d 0" was missing): now g77 & ifc give much closer
154      results; update global_ocean_pressure & global_ocean.cs32x15 output.txt
155    o add saltFlux(+File) forcing capability with periodicExternalForcing
156    o allow to use pkg diagnostics for GM-Redi & ThSIce output
157    o diagnostics_fill: fill in up to sNx+1 or sNy+1 (if U,V or Z pt) for mnc.
158    o improvements for the MNC output from DIAGNOSTICS:
159      - correct handling of the unlimitied dimension
160      - all dims now have associated coordinate variables
161      - variables located at U, V, and Corner ("Z") points are now written
162        with the correct horzontal dimensions (eg. 'Xp1', 'Yp1') so that
163        *all* data points are output
164    o added seaice_summary.F and removed obsolete ALLOW_SEAICE's from pkg/seaice
165    o added pkg/seaice/seaice_monitor.F
166    o mdsio_readfield.F can now read files visible only to master MPI process.
167    o pkg/seaice: some test code for ice-modified ocean stress
168    o exf_getffields interpolation defaults to bilinear for all scalar forcing
169      fields (remains bicubic for wind velocity and stress).  This avoids, e.g.,
170      spurious negative numbers for precipitation and humidity.  Will cause
171      some small numerical differences for integrations using pkg/exf/exf_interp.F.
172    o pkg/ctrl/
173      * Add ctrlvec diagnostics in pack/unpack for nondimensional I/O
174        May be enabled via doPackDiag
175      *  introduce z-scaling of
176         + gradient (doZscalePack) and
177         + control (doZscaleUnpack)
178    o pkg/mdsio/
179      * enable useSingleCpuIO for state estimation (ctrl_pack/unpack) mdsio_gl.F
180      * N.B.: leave tiled I/O for tapelev (i.e. mds...vector)
181    
182    checkpoint57b_post
183    o simplify options in diagnostics_fill arguments (remove weird combinations)
184    o fix MNC coordinate variables so that they now contain per-face index
185      values (instead of xC,xG,yC,yG values) when run with EXCH2 since, in
186      general, EXCH2 grids are only aligned to a "local" coordinate system
187    o test diagnostics pkg in dic_example (no output) and ideal_2D_oce (with ouput)
188    o Implement instantaneous output within pkg diagnostics:
189      setting a negative frequency in data.diagnostics produces
190     "snap-shot" output (as opposed to time-average if freq > 0)
191    o move out off EQUIVALENCE all diagnostics that fizhi does not use ;
192      NOTE: change ptracer diagnostics name: use 2 characters to work with
193            more than 9 tracers. Add also diagnostics of advect & diffus flux.
194    o more CF compliance: convert all MNC 'iter' variables to 'T' so that it
195      becomes the coordinate variable for the 'T' dimension
196    o add CF-style coordinate variables to MNC
197      - just a first cut:  numbers are meaningless on the cubesphere and
198        missing along the T axis but otherwise it works!
199    o add surface flux diagnostics: TAUX, TAUY, TFLUX, TRELAX, TICE, SFLUX, SRELAX
200    o pkg/thSIce: read initial state from 6 files ; allow monitor to use MNC.
201    o add diagnostics of advective & diffusive flux for T & S (pTracers coming soon)
202      this is based directly on what the model compute, so that the content of
203      each diagnostics might be affected by switching options (e.g., implicitDiffusion)
204    o small changes for diagnostics (gad_biharm_?.F, arguments of S/R impldiff.F)
205    o clean up build options files for SunOS, in particular
206      - remove -traditional from xmakedepend
207      - change -xarch=v9 to -xarch=native for f77
208      - restore use of make (not gmake)
209      - add CC=gcc if using g77
210    o changes per discussion of AM, JMC, & EH3 today:
211      - move redundant "grid" variables out of "state" -- in preparation of
212        creating proper CF-style coordinate variables and in recognition
213        that any/all grid variables can be easily copied (eg. w/NCO) from
214        the grid files into any of the other NetCDF files
215      - *always* output grid variables with MDSIO (this will eventually be
216        changed)
217      - output MNC grid file if useMNC is true
218    o every instance of _END_MASTER() has been found and replaced with
219      _END_MASTER( myThid ) in order to satisfy certain picky Sun
220      preprocessors
221    o re-arrange diagnostics pkg initialisation:
222     - allow each package to extend the available diagnostics list
223     - add some checking and fix small problems (multi-threaded, ...)
224     - new S/R diagnostics_fill (replace fill_diagnostics):
225       look through the short list of active diag. (instead of the long list)
226       create function DIAGNOSTICS_IS_ON to tell if a diagnostics is active
227    
228    checkpoint57a_post
229    o this set of changes restores TAMC compatibility
230      tested for global_ocean.90x40x15 adjoint on trough
231      (what a pain)
232    
233    checkpoint57a_pre
234    o some modifs in tools/build_options for sunos
235    o call ctrl_pack for ctrl at end for optimcycle=0
236    
237    checkpoint57
238    o add horizontal bi-harmonic viscosity for vertical velocity
239      - new parameter viscA4W (defaults to viscA4)
240      - affects only non-hydrostatic code
241      - to be done: no-slip lateral boundary conditions
242    o switch back to "sflux = sflux - runoff" in exf_getforcing.F
243    o implement Implicit Vertical advection for pTracers
244    o depth convergence accelerator: replace deltaTtracer by dTtracerLev(k)
245      (implemented also for implicit vertical diffusion & advection)
246    o OBCS: extend application of tracer open boundary conditions
247      to a strip beyond the boundary of width Olx/Oly
248    o add call monitor to TAF set of required calls (flow directives)
249      and include in natl_box_adjoint
250    o untangle a few ifdefs related to cost, ctrl, autodiff
251      untangel a few ALLOW_ECCO_OPTIMIZATION
252    o Apply Cooper & Haines representative estimates also at sub-surface (k=Nr)
253      (theta2, salt2 in ecco_cost_weights)
254    
255    checkpoint56c_post
256    o OBCS as control variables
257      - update ctrl_ad_diff.list, obcs_ad_diff.list
258      - remove balance of obcs controls from default
259      - fix index bug nobcs in ctrl_init
260      - fix dummy fields filen in ctrl_pack
261      - add dummy weights for obcs
262    o lsopt: comment out fort.94 output
263    o optim:
264      - remove unnecessary header files
265      - adjusted namelists
266      - add xerbla.F to Makefile
267    o exf:
268      - multiple modifications of exf_check_range
269      - unit change in exf_init_runoff from [m/year] to [m/s]
270    o mdsio:
271      - i/o-vector change debugLevel from debLevA to debLevB
272    
273    checkpoint56b_post
274    o collect all ptracers output in an new routine (PTRACERS_OUTPUT) that
275      is called from DO_THE_MODEL_IO
276      - rename PTRACERS_STATV_WRITE to PTRACERS_WRITE_TIMEAVE
277      - introduce new parameter PTRACERS_dumpFreq (defaults to dumpFreq)
278      - clean up PTRACERS_WRITE_TIMEAVE a little
279    o add another verification experiment that tests both the cfc-pkg and
280      the gchem-pkg with GCHEM_SEPARATE_FORCING undefined, that is with
281      reactive tendencies treated inline with regular timestepping
282    o testreport previously did a lousy job of comparing small numbers, so
283      we (Ed and Martin) changed the  way the cut-off of 1.e-12 is
284      implemented in the little c-progam tmp_cmpnum.c which is embedded in
285      testreport.
286    o ptracers_monitor: bug fix for MPI
287    
288    checkpoint56a_post
289    o GCHEM: finish reorganizating the package
290      - forward_step calls GCHEM_CALC_TENDENDY, which computes gchemTendency
291        (introduces another 3D-array for each passive tracer, but only if
292        GCHEM_SEPARATE_FORCING is undefined. For GCHEM_SEPARATE_FORCING
293        gchemTendency is not needed because the timestep is done separately)
294      - gchemTendency is added to gPtr in GCHEM_ADD_TENDENCY
295      - GCHEM is now---more or less cleanly---separate from PTRACERS
296      - to bo done: handling of surfaceForcingPtr that is needed for KPP not
297        so clear to me how that should be done in a general way.
298    o CFC: improve formatting of output in CFC_ATMOS
299    o PTRACERS:
300      - rename GCHEM_MONITOR to PTRACERS_MONITOR and call it from MONITOR, so
301        that ALL experiments with ptracers enable can be checked. This makes
302        GCHEM_MONITOR obsolete.
303      - include a runtime parameter PTRACERS_monitorFreq that defaults to
304        monitorFreq
305      - set default PTRACERS_write_mdsio to false if PTRACERS_write_mnc is true
306    o add PTRACERS (PTR0[1-5]) to testreport output
307    o exf_check_range:
308      * default changed to .TRUE.
309      * will check values for niter0 if debLevA, every timestep if debLevB
310      * STOP in exf_check_range if 'out of range'
311      * range chosen generous to allow for potential extema
312      TBD: a version with stricter range
313           permitted range would be runtime parameters
314    o GMredi:
315      - fix ldd97 slope limit ; extend valid domain of Psi-Bolus ;
316      - change S/R GRAD_SIGMA to be valid in the overlap on CS-grid.
317      - change the default GMREDI_OPTIONS.h: compile everything except Visbeck
318    o GCHEM:
319      - move call to GCHEM_FORCING_SEP, so that it is now called before
320        the blocking exchanges to avoid computing halos in GCHEM_FORCING_SEP
321      - introduced a useGCHEM runtime flag and applied it everywhere.
322      - renamed PTRACERS_SEPARATE_FORCING to GCHEM_SEPARATE_FORCING;
323        this flag is now only visible within GCHEM-pkg routines.
324      - moved gchem_forcing_int temporarily into ptracers_forcing, this will
325        be replaced by a 3D array that is computed before thermodynamics; for
326        this, the tracer ID iTracer had to be included into the parameter list
327        of ptracers_forcing
328      - set up forward_step to call gchem_forcing, that will replace
329        gchem_forcing_int in ptracers_forcing
330      - cleaning up
331    o small cleaning of exch2: remove files that are also in eesupp/src
332    
333    checkpoint56
334    o AIM: read land-Fraction earlier (from ini-fixed) and monitor land at nIter0
335    o mnc: cleanup "full" files--fixes out-of-memory problem
336    o ECCO-GODAE
337      * model/, pkg/, code/, input/ now complete w.r.t. ECCO-GODAE production setup
338      * fully merged and updated from SIO code
339        windstress sign change affects
340        - exf_inscal_[u/v]stress
341        - sign of xx_tau[u/v] adjustments
342        - signs in cost_scat
343      * ctrl_get_gen: avoid update of tau[u/v] for first few days
344      * natl_box_adjoint updated and compressed
345      * 2-level checkpoint switch added
346        (tested in EXP. 1 of natl_box_adjoint)
347      * new switch doInitXX to avoid init. of xx_... in optimcycle=0
348    o SVD
349      * first complete, non-hacked version for SVD calculations
350      * all interfaces clean w.r.t to handling of xx_..., adxx_..., g_xx_...
351        performed via direct access files admtlm_vector.it????
352        (via ctrl_[un]pack)
353      * optimcycle is used for ARPACK iteration counter
354        (note: adxx_... is iterated, rather than xx_...; latter is constant!)
355      * EV problem ok w.r.t. L2-norm in tangent space; need to check other norms
356        and add linear transforms where necessary
357      * controls are initial/final SST, SSS (can be extended; need to check
358        ctrl_set_[un]pack_xyz.F according to ctrl_set_[un]pack_xy.F
359    o mdsio: filename info to both stderr, stdout
360    o exf: exf_inscal_runoff: separated default conversion [m/year] -> [m/sec]
361      from sign change
362    
363    checkpoint55j_post
364    o isolate dissipation tendency (allow to keep it out off AB) in V.I form.
365      affects (truncation level) output.txt of global_ocean.cs32x15(&.thsice)
366    o add consistent build directories and .cvsignore files to verification
367    o added viscA4GridMin and viscA4GridMax for more control on biharmonic viscosity
368    o make all subroutines 30 or less characters in length for certain older
369      compilers to work (a thorough search only turns up two routines in
370      pkg/ptracers)
371    o allow (vecinv only) a different horiz. viscosity for Divergence and Vorticity;
372      affects (truncation level) output.txt of global_ocean.cs32x15(&.thsice)
373    
374    checkpoint55i_post
375    o change arrays for total vertical diffusivity (2.D if explicit,
376      3.D if implicit) ; each ptracer uses its own background value.
377    o added mnc/NetCDF output capability to ocn_compon_interf
378      - added bits to verification/cpl_aim+ocn so that it can run on
379        ITRDA and other clusters without the mpirun "-wd" option
380    o fixed wayward endif in mom_fluxform.F that messed up cyclindrical
381      configuration
382    o give MNC the ability to create additional files rather than
383      exceeding a specified file size limit "MNC_MAX_FILESIZE"
384      - the default is just less than 2GB which is a practical limit
385        on many systems
386    o Compute the non-local term using either KPP vertical diffusivity (=default)
387       or the total vertical diffusivity (when KPP_ghatUseTotalDiffus=T)
388    
389    checkpoint55h_post
390    o add verification test "vermix"
391    o remove all the *_ioinc flags and replace with the single global
392      outputTypesInclusive flag
393    o allow to set a vertical profile of vertical diffusivity for T & S
394    o call PACKAGE_BOOT & PACKAGES_READPARMS just after INI_PARMS
395    o useMNC moved from data.mnc to data.pkg
396    
397    checkpoint55g_post
398    o Renaming carbon AD experiments to comply with testreport conventions
399    o Updating adjoint of Held-Suarez hs94.1x64x5
400    o Fixing directives for non-ECCO forward_step, after ECCO directives
401      have been fixed to avoid recomp. of do_oceanic_phys
402      Works well for global_ocean.90x40x15,
403      but recomp. issue remains for carbon
404    o Updating adjoint output for natl_box_adjoint after
405      pkg/ecco has been modified (see taga c55d_post)
406    
407    checkpoint55f_post
408    o rename to timeave_init_fixed
409    
410    checkpoint55e_post
411    o some delicate re-shuffle of store directives to avoid one
412      extra call of do_oceanic_physics
413      affects ecco_the_main_loop.F, do_oceanic_physics.F
414      checkpoint_lev1_directives.h
415    o NB: this may break global_ocean adjoint temporarily,
416      but it is clear how to fix it. Will do later, need this now.
417    
418    checkpoint55d_post
419    o ECCO specific cost function terms (up-to-date with 1x1 runs)
420    o ecco_cost_weights is modified to 1x1 runs
421    o modifs to allow observations to be read in as
422      single file or yearly files
423    o enable to read exf forcing fields as either
424      single file or yearly files (flag useExfYearlyFields)
425    checkpoint55d_pre
426    
427    o switch between 2-level and 3-level checkpointing
428    o add ability of MNC to write local and "partial" (eg. 2D slices where
429      the full 3D field is never actually stored) arrays to NetCDF files
430      with the correct (that is, the complete multi-dimensional) set of
431      array indicies
432      - used in mom_vecinv() to write the diagFreq output
433      - tested (demonstrated) in verification/aim.5l_cs
434  o further mnc-ification  o further mnc-ification
435    - add verification/lab_sea to the list with mnc setups    - add verification/lab_sea to the list with mnc setups
436    - fix undefined mnc v-names in cd_code    - fix undefined mnc v-names in cd_code

Legend:
Removed from v.1.363  
changed lines
  Added in v.1.505

  ViewVC Help
Powered by ViewVC 1.1.22