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

Legend:
Removed from v.1.360  
changed lines
  Added in v.1.490

  ViewVC Help
Powered by ViewVC 1.1.22