/[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.322 by jmc, Tue Jul 6 02:44:27 2004 UTC revision 1.562 by mlosch, Mon Oct 10 05:55:52 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 OBCS and PTRACERS: add open boundary support for passive tracers
8      - either use homogenous (pseudo) v.Neumann conditions or prescribe
9        OB-values from file; this is not different from the way theta and salinity
10        are treated
11      - however, Orlanski-radiation conditions are not supported, and the model
12        will stop if you use pTracers and Orlanski at the same time.
13      - beefed up the rountine obcs_external_fields_load: now only those open
14        boundary values are overwritten with values from files for which there
15        are really files, otherwise the OB-fields remain untouched. This makes
16        it possible to use different OBs at different ends of the domain (as
17        with EXF)
18    o reduce number of exch calls in shap_filt (s2).
19    o CS-grid: fix divergence contribution to Leith viscosity. Affects (@
20      truncation level) 4/5 MLAdjust test results (11&12 digits match).
21    
22    checkpoint57t_post
23    o test biharmonic viscosity + no-slip with exp: global_ocean.cs32x15.viscA4
24    o finish adding brackets (coriolis S/R, vecinv) in multi-terms sum to get
25      same truncation, independent of the face number: affects affects several
26      test. exp.: Update global_ocean.cs32x15 (+.thsice) & MLAdjust (all 5).
27    o fix bug in mom_v_sidedrag (biharmonic viscosity was counted 2 times);
28      note that biharmonic viscosity + no-slip was not tested in any experiment.
29    o fix bug in non-linear free-surf side-drag ; generate new output for
30      global_ocean.cs32x15(+.thsice) & global_ocean_pressure.
31    o make mnc honor the writeBinaryPrec flag for most kinds of output
32    o eesupp: split EEPARAMS into EESIZE/EEPARAMS and add a vector global sum
33    o minor change in averaging W (mom_vi_?_vertshear.F) that affects truncation
34      error; update output from global_ocean.cs32x15(+.thsice) & MLAdjust (all 5).
35    o add brackets in multi-terms sum to get same truncation, independent of
36      the face number (manage to get exactly same value of gU,gV at the cs-edge)
37      affects several test. exp. Update global_ocean.cs32x15 (+.thsice).
38    o Clean, new version of mom_calc_visc.  Adds a new feature, viscAhRemax
39      and viscA4Remax, which allow one to limit the minimum viscosity by specifying
40      a maximum grid-scale Reynolds number.  Also, changes all length calculations
41      in the case of grid anisotropy to geometric mean of dx**2 and dy**2.
42      Suggested values of viscosity parameters found in mom_calc_visc.
43      Many new viscosity diagnostics available.
44    
45    checkpoint57s_post
46    o Add clearing-house for viscosity calculations, mom_calc_visc and
47      correct numerous bugs in LeithD and Smagorinsky discretizations.  
48      mom_calc_visc now allows for Smagorinsky, Leith and LeithD to be
49      used simultaneously, and to be used in mom_vecinv and mom_fluxform.
50      Mom_vecinv can be used with standard viscous calculation (mom_vi_hdissip.F)
51      and with Strain-Tension viscous term calculation (mom_hdissip.F).  
52      The Strain-Tension form is now called with useStrainTensonVisc=.true.
53      ViscAhStrain and viscAhTension are now retired.
54    o diagnostics "VISCAHD" & "VISCA4D" replace "VISCAH" & "VISCA4".
55    o In response to JMC's bug report, genmake2 now ignores any soft-links
56      that it finds in the *current* directory when searching for files.
57      Soft-links found in any other source directories will still work as
58      they did before.
59    o add HAVE_SETRLSTK define and useSETRLSTK flag (eedata) which calls
60      a C routine to unlimit the stack size
61    o mnc-ify pkg/aim snapshot vars
62    o mnc-ify pkg/land as requested by Daniel
63    o various changes to mnc including:
64      - all files use the new "BASENAME[[.ITER].{t|f}NUM].nc" format
65      - output can now be grouped so that all files within a group
66          change the ITER portion of their names in lock-step together
67      - can now read ("global") PER-FACE (in addition to PER-TILE) files
68          and works with both EXCH1 and EXCH2 (but needs more testing)
69      - writing works for all verification test cases w/ g77 on Linux
70    
71    checkpoint57r_post
72    o make MNC variable initialization happen earlier
73    o add diagnostics for (almost) each term of the momentum Eq.
74    o remove SST,SSS,UVEL_k2,VVEL_k2 diagnostics.
75    o move pkg timeave out of pkg-groups "oceanic" & "atmospheric" (pkg/pkg_groups)
76    o remove MINIMAL_TAVE_OUTPUT option ;
77      add "dumpInitAndLast" to replace "nodumps" (and MINIMAL_TAVE_OUTPUT).
78    o move some basic S/R (used elsewhere in the code) from pkg/mdsio to eesupp/src
79      allows to compile without pkg/mdsio (& test successfully hs94.1x64x5)
80    o add MNC output for adjoint of EXF (adexf), SEAICE (adseaice)
81    o add time-dependent SST, SSS control
82    o cost terms in ecco/ modularized (new cost_generic.F)
83    o cost_averages routines are modularized (new cost_averagesgeneric.F)
84    o new infrastructure for seaice model vs. obs misfits in seaice/
85      * driver from the_main_loop.F is seaice_cost_driver.F
86      * first term is AREA vs. SMR observation misfit (ALLOW_SEAICE_COST_SMR_AREA)
87      * gradient check in Exp. 6a of natl_box_adjoint/
88    o natl_box_adjoint input_seaice for Lab. Sea now available online via wget
89      (see README file)
90    
91    checkpoint57q_post
92    o fix initialisation Pb in calc_gw (get NANs in exp5 with g77)
93    o fix annoying months-old bug in mnc/mdsio output for seaice pkg
94      - bug was reported by Jean-Michel and Ian Fenty
95    o fix initialization Pb in AIM-Ocean coupled model (aim_sice2aim.F)
96      update exp. cpl_aim+ocn output.
97    o Implement 4-level checkpointing: AUTODIFF_4_LEVEL_CHECKPOINT
98      Needed for high-res. runs with large global files
99      to be able to limit tapelev size
100    o Changed some tests for adjoint:
101      * carbon/ now tests AUTODIFF_2_LEVEL_CHECKPOINT
102      * natl_box_adjoint/code_bulk/ tests AUTODIFF_4_LEVEL_CHECKPOINT
103      * global_ocean.90x40x15/ back to default 3-level checkpointing
104    o Modifications to enable scripted COMMON to MODULE conversion
105      * verification/OpenAD/code/ has necessary scripts and description;
106      * converts, compiles and runs successfully;
107    
108    checkpoint57p_post
109    o reading of delXfile & delYfile moved from ini_parms.F to ini_grid.F
110    o move ${PKG}_MNC_INIT from ${PKG}_READ_PARAMS to ${PKG}_INIT_FIXED
111      (already the case for some pkgs, including recent MNC_init, e.g. thsice)
112    o call CALC_GW from DYNAMICS (instead of from FORWARD_STEP)
113    o Dissipation & phiHyd gradient are always added to gU,gV in timestep.F
114      (was already the case for dissipation with mom_vecinv,
115       and also the case for grad.PhiHyd when staggered-timeStep)
116      This will allow to put dissipation out-off the AB time-stepping.
117     Unfortunately, affects truncation error. Update output of exp. that "fails"
118      (cg2d matching number) and leave the others for later: front_relax(10),
119      global_ocean_pressure(10),ideal_2D_oce(10),internal_wave(9),lab_sea(12),
120      matrix_example(7!),natl_box(12),plume_on_slope(11),vermix(12x3,11x2).
121    
122    checkpoint57o_post
123    o fix MNC/MDSIO flags in PTRACERS so that (1) it works, and
124      (2) its ready to be documented during the 20050801 DocFest
125    o MNC-ify the gmredi package -- tested and works w/ and w/o mnc
126      for ideal_2D_oce and lab_sea on linux_ia32_g77
127    o set to #undef CTRL_SET_OLD_MAXCVARS_30
128      in global1x1_tot/code_seaice_adj to access indices 32, 33
129      (worth another tag)
130    
131    checkpoint57n_post
132    o adding precip control xx_precip 32
133    o adding swflux control xx_swflux 33
134    o Replacing 10 forcing penalty cost routines by 1 generic.
135    o Implementing partitioning in time-mean and variable adjustment
136      for atmos. state.
137    o Time-mean constant error is now read in data.ecco (instead of hard-coded)
138    o in natl_box_adjoint:
139      * updated exp 1 to 10
140        (but does not have time-mean vs. variable split results yet)
141    o updated global1x1/*_seaice_adj/
142      to incorporate latest changes
143    o enable useSingleCpuIO for mdsio vector routines
144      (applies in particular to tapelev I/O)
145    o removed inefficient K-loop in all active_file*control*.F
146    
147    checkpoint57m_post
148    o re-arrange exp. adjustment.cs-32x32x1 (adjust_nlfs.cs-32x32x1 merge into)
149      and advect_cs (use EXCH-2 and standard cs-32 grid files).
150    o pkg/exch2: filling of face-corner halo regions is optional
151      (ifdef W2_FILL_NULL_REGIONS) and is turned off by default.
152    
153    checkpoint57l_post
154     tag before updating tutorials (pre-release-2)
155    o add cos & sin of grid-direction orientation angle (curvilinear grid only,
156       for output and interpolation of input fields onto model grid)
157    o fix radius in mom_v_metric_cylinder.F (wrong by dy/2).
158       Affects results of exp. rotating_tank ; update output.txt.
159    o pkg/diagnostics: 2 new S/R to fill a diagnostics using a scaling factor
160          and taking the square quantity and/or using a fraction-weight field.
161    o fix aim_diagnostics_init.F mate numbers.
162    o add mnc output capability to diagnostics/diagstat and update
163      our cvsignore files for the ACSII output generated
164    
165    checkpoint57k_post
166    o lab_sea now uses diagnostics package and provides a suite of
167      new EXF diagnostics output.
168    
169    checkpoint57j_post
170    o exf
171      * bug fix in exf_bulkformulae for psimh (spotted by Eliyahu Biton):
172        Bracket missing in eqn. for psimh (eqn. 7 of Large & Pond, 1982);
173        terms -2*ATAN(x) + pi/2 were added to both stable and unstable case.
174      * extended diagnostics output
175        - now includes all EXF variables
176        - hs, hl moved to common block
177        - separate S/R for diagnostics, called after ctrl vector is added
178        - name changed for EXFsw -> EXFswnet, EXFlw -> EXFlwnet
179        - EXFqnet contains true Qnet (i.e. includes qsw)
180      * updated verif. lab_sea, global_with_exf
181      * Rearranging hflux (exf_mapfields -> exf_getforcing)
182        to ensure that diagnostics sees a true EXFqnet
183    o add matlab scripts for CS-grid vectors (in utils/cs_grid)
184    o diagnostics pkg: change pointers so that 1 diagnostic can be used
185      several times with different frequencies.
186    o mnc-ify the thsice package as requested by Daniel Enderton
187      - the monitor--MNC output needs work
188      - many attributes need to be added (most are currently blank)
189    o mnc-ify theaim_v23 package as requested by Daniel Enderton
190      - many attributes need to be added (most are currently blank)
191    o remove "groundAtK1" & "rkFac" (replaced by usingPCoords & -rkSign)
192    o add Sadourny like discretization to the 4th.O vorticity advection scheme
193    o fix bug in rStar code (calc_r_star.F) when used with topo/bathy.
194      update output.txt from: aim.5l_cs (& .thSI), cpl_aim+ocn,
195         fizhi-gridalt-hs and global_ocean.cs32x15 (& .thsice).
196    o fix few little things to avoid floating error with -ftrapuv (ifort v9)
197     (ini_spherical_polar_grid.F, calc_r_star.F, monitor/mon_surfcor.F)
198    
199    checkpoint57i_post
200    o Diagnostics package was changed: diagnostic allocation is now deactivated
201      by setting an empty file name in the namelist (used to be by setting 0 frequency)
202    o momentum advection (VI form) options: activate 4th.O vorticity Coriolis ;
203      add 1rst Order upwind vertical Shear.
204    o add a quick fix for A/B checkpointing in OFFLINE mode
205    o add IGNORE_TIME define and -ignore_time option to genmake2 as an
206      end-run around the C/Fortran linking horror in eesup/src/timers.F
207    o added pkg/runclock: allows user to terminate run based on wall clock
208    o added non-hydrostatic scaling parameter: nh_am2
209    o pkg/my82: futile attempt to make results compiler-independent by adding
210      some "_d 0", etc. no effect.
211    o for mnc output, fill the 'T' coordinate var with myTime and create a
212      separate 'iter' variable for iteration count
213    o pkg/diagnostics:
214      add new capability: output of Global/Regional & per-level statistics ;
215      tested against monitor output (including land & thSIce) on various exp.
216    o make seaice-pkg I/O type flags (MNC/MDS) more standard.
217    
218    checkpoint57h_done
219      tag after changing user customized files (DIAGNOSTICS_SIZE.h,
220      data.diagnostics, data.gchem, data.ptracers) is done.
221    
222    o pkg/diagnostics: prepare for Global/Regional statistics.
223      add 2nd namelist in data.diagnostics and update DIAGNOSTICS_SIZE.h
224    o remove "baseTime" (no used) from arg. list of DIFF_BASE_MULTIPLE
225      and rename it: DIFFERENT_MULTIPLE
226    
227    checkpoint57h_post
228    o move tIter0 from data.gchem to PTRACERS_Iter0 in data.ptracers
229    o pkg/diagnostics: change output frequency, now in seconds (instead
230      of Nb of iterations). This requires to change data.diagnostics.
231    checkpoint57h_pre
232    
233    o in mnc, let the user create the output dir if both mnc_outdir_date
234      and mnc_outdir_num are false
235    o add fflags() to pkg/diagnostics which allows one to specify, on a
236      per-file basis, the file precision [default behavior is unchanged]
237    o added diagnostics to pkg/kpp, including computation of mixed layer
238      depth based on a temperature/density criterion
239    o updated verification/natl_box to test the new pkg/kpp diagnostics
240    o bugs fixed (with useAbsVorticity=T & with useJamartMomAdv=T)
241    o test AB-3 code with 4th.Order advection scheme (advect_xy/input.ab3_c4)
242    o fix mnc flags in pkg/seaice so that they are "owned" by seaice,
243      not mnc -- this mistake was found by JMC and is now corrected
244    
245    checkpoint57g_post
246    o add Adams-Bashforth 3rd Order time stepping:
247      - default remains AB-2 (#undef ALLOW_ADAMSBASHFORTH_3)
248      - not yet implemented with NH, CD_Scheme, pTracers, MNC_pickup ...
249    checkpoint57g_pre
250    
251    o make lambda[Theta,Salt]ClimRelax spatially varying
252      (default remains spatially uniform constant based on tau)
253    o added new control variables
254      * init. uVel, vVel, etanN
255      * lambda[Theta,Salt]ClimRelax
256    o separate masks used for ctrl_pack/unpack 'from write_grid' output
257      (suggested by G. Forget)
258    
259    checkpoint57f_post
260    o add parameter "baseTime" = model base time = time at iteration zero
261      new function DIFF_BASE_MULTIPLE (replace DIFFERENT_MULTIPLE) to
262      account for baseTime shift
263    o move Coriolis arrays from PARAMS.h to GRID.h
264    checkpoint57f_pre
265    
266    o mnc-ifying the seaice package
267    o introduced an alternative length scale calculation for use in the limiting
268      maximum viscosity (off by default, see mom_vi_hdissip.F for details)
269    o S/R ptracers_calc_diff: argument list bug for CALL KPP_CALC_DIFF_S
270    o added modified Leith scheme with viscosity proportional to grad(Hdiv)
271      as well as grad(vort3).  Made it compatible with both approximate form
272      for the cubed sphere and full form of these gradients.  Added flag
273      useFullLeith to select between approximate and full form.  
274    o add "d0" in getcon.F to reduce differences between compilers/platforms
275      update output.txt of exp. fizhi-gridalt-hs
276    o change port_rand funtion to allow to set the seed.
277    o fix obscure MNC bug involving conversion between reals and integers
278      - it caused no problems with certain (eg. gcc, ifc) compilers but the
279        new version is now more standards-compliant
280    o adjoint-related modifications
281      * gad_dst3_adv_?: to be able to use advscheme=30 in adjoint
282      * gad_calc_rhs: fool adjoint, revert to advscheme=30 in reverse when using 33
283      * mom_vi_hdissip: to be able to use Leith scheme in adjoint
284    
285    checkpoint57e_post
286    o Adding eddy stress controls a la Ferreira et al.
287    checkpoint57e_pre (actually was tagged: eckpoint57e_pre)
288    
289    o fizhi pkg: fix AtoC and CtoA when called with same input & output array
290      update output.txt of exp. fizhi-gridalt-hs
291    o add more "Z" dimensions and associated coordinate vars to MNC
292    o pkg/exf: added twoDigitYear capability for option useExfYearlyFields
293    o parameter calendarDumps: when set, approximate months (30-31 days) and years
294      (360-372 days) for parameters chkPtFreq, pChkPtFreq, taveFreq, SEAICE_taveFreq,
295      KPP_taveFreq, and freq in pkg/diagnostics are converted to exact calendar
296      months and years.  Requires pkg/cal.
297    o diagnostics: add pickup functionality
298      - off by default for backwards compatibility
299      - current version only uses MDSIO -- MNC will be added
300    o allow to use pkg diagnostics for LAND pkg output & Shapiro Tendencies.
301    o pkg/shap_filt: fix for multi-tiles per face (CS-grid with EXCH2)
302    
303    checkpoint57d_post
304    o pkg/thsice used in the ocean: fix tile Pb related to sIceLoad forcing
305    o modify verification/ideal_2D_oce so that it tests the creation of mnc
306      output from the diagnostics package
307    o temporary fix in EXCH2_UV: add a 3rd call to fix the 24.tiles CS-grid set-up
308    o make genmake2 more portable by using ".$FS" instead of ".f" for more
309      of the test compilations (eg. IBM xlf on Mac OSX w/HFS filesys)
310    o add coordinate variables to the MNC output from the diagnostics package
311    o change MNC-flags default value: true when useMNC=TRUE
312    o add a "readgrid_mnc" flag to MNC and give model/src/ini_curvilinear_grid.F
313      the ability (off by default) to read the grid information using MNC
314    o lab_sea: use LSR_ERROR=1.E-12 for testing ; update output.txt
315    o diagnostics: fix a bug (sub-set of levels); keep full precision when averaging
316    o do snap-shot diagnostics at the middle of the time-interval (instead of
317      at the end).
318    o update exp. aim.5l_cs (use default LAND_OPTIONS.h file) and add
319      new test for AIM with thSIce + slab-ocean
320    o cpl_aim+ocn test: update output (optfile & default GMREDI_OPTIONS.h)
321    o move state variable diagnostics to the beginning of the time step ;
322      (note: still needs some work specially for snap-shot diagnostics)
323      duplicate & replace UVELVVEL diagnostics with UV_VEL_C & UV_VEL_Z
324    
325    checkpoint57c_post
326    o Change testing option (-ieee) to get closer agreement between g77 & ifort
327    o generate new output.txt files on faulks with g77 & the new -ieee option
328    checkpoint57c_pre
329    
330    o add "_d 0" in freeze ; change some "FLOAT" to "DFLOAT" and went back (TAF);
331      update output.txt of exp. global_ocean.90x40x15
332    o fix in ini_eos.F (one "_d 0" was missing): now g77 & ifc give much closer
333      results; update global_ocean_pressure & global_ocean.cs32x15 output.txt
334    o add saltFlux(+File) forcing capability with periodicExternalForcing
335    o allow to use pkg diagnostics for GM-Redi & ThSIce output
336    o diagnostics_fill: fill in up to sNx+1 or sNy+1 (if U,V or Z pt) for mnc.
337    o improvements for the MNC output from DIAGNOSTICS:
338      - correct handling of the unlimitied dimension
339      - all dims now have associated coordinate variables
340      - variables located at U, V, and Corner ("Z") points are now written
341        with the correct horzontal dimensions (eg. 'Xp1', 'Yp1') so that
342        *all* data points are output
343    o added seaice_summary.F and removed obsolete ALLOW_SEAICE's from pkg/seaice
344    o added pkg/seaice/seaice_monitor.F
345    o mdsio_readfield.F can now read files visible only to master MPI process.
346    o pkg/seaice: some test code for ice-modified ocean stress
347    o exf_getffields interpolation defaults to bilinear for all scalar forcing
348      fields (remains bicubic for wind velocity and stress).  This avoids, e.g.,
349      spurious negative numbers for precipitation and humidity.  Will cause
350      some small numerical differences for integrations using pkg/exf/exf_interp.F.
351    o pkg/ctrl/
352      * Add ctrlvec diagnostics in pack/unpack for nondimensional I/O
353        May be enabled via doPackDiag
354      *  introduce z-scaling of
355         + gradient (doZscalePack) and
356         + control (doZscaleUnpack)
357    o pkg/mdsio/
358      * enable useSingleCpuIO for state estimation (ctrl_pack/unpack) mdsio_gl.F
359      * N.B.: leave tiled I/O for tapelev (i.e. mds...vector)
360    
361    checkpoint57b_post
362    o simplify options in diagnostics_fill arguments (remove weird combinations)
363    o fix MNC coordinate variables so that they now contain per-face index
364      values (instead of xC,xG,yC,yG values) when run with EXCH2 since, in
365      general, EXCH2 grids are only aligned to a "local" coordinate system
366    o test diagnostics pkg in dic_example (no output) and ideal_2D_oce (with ouput)
367    o Implement instantaneous output within pkg diagnostics:
368      setting a negative frequency in data.diagnostics produces
369     "snap-shot" output (as opposed to time-average if freq > 0)
370    o move out off EQUIVALENCE all diagnostics that fizhi does not use ;
371      NOTE: change ptracer diagnostics name: use 2 characters to work with
372            more than 9 tracers. Add also diagnostics of advect & diffus flux.
373    o more CF compliance: convert all MNC 'iter' variables to 'T' so that it
374      becomes the coordinate variable for the 'T' dimension
375    o add CF-style coordinate variables to MNC
376      - just a first cut:  numbers are meaningless on the cubesphere and
377        missing along the T axis but otherwise it works!
378    o add surface flux diagnostics: TAUX, TAUY, TFLUX, TRELAX, TICE, SFLUX, SRELAX
379    o pkg/thSIce: read initial state from 6 files ; allow monitor to use MNC.
380    o add diagnostics of advective & diffusive flux for T & S (pTracers coming soon)
381      this is based directly on what the model compute, so that the content of
382      each diagnostics might be affected by switching options (e.g., implicitDiffusion)
383    o small changes for diagnostics (gad_biharm_?.F, arguments of S/R impldiff.F)
384    o clean up build options files for SunOS, in particular
385      - remove -traditional from xmakedepend
386      - change -xarch=v9 to -xarch=native for f77
387      - restore use of make (not gmake)
388      - add CC=gcc if using g77
389    o changes per discussion of AM, JMC, & EH3 today:
390      - move redundant "grid" variables out of "state" -- in preparation of
391        creating proper CF-style coordinate variables and in recognition
392        that any/all grid variables can be easily copied (eg. w/NCO) from
393        the grid files into any of the other NetCDF files
394      - *always* output grid variables with MDSIO (this will eventually be
395        changed)
396      - output MNC grid file if useMNC is true
397    o every instance of _END_MASTER() has been found and replaced with
398      _END_MASTER( myThid ) in order to satisfy certain picky Sun
399      preprocessors
400    o re-arrange diagnostics pkg initialisation:
401     - allow each package to extend the available diagnostics list
402     - add some checking and fix small problems (multi-threaded, ...)
403     - new S/R diagnostics_fill (replace fill_diagnostics):
404       look through the short list of active diag. (instead of the long list)
405       create function DIAGNOSTICS_IS_ON to tell if a diagnostics is active
406    
407    checkpoint57a_post
408    o this set of changes restores TAMC compatibility
409      tested for global_ocean.90x40x15 adjoint on trough
410      (what a pain)
411    
412    checkpoint57a_pre
413    o some modifs in tools/build_options for sunos
414    o call ctrl_pack for ctrl at end for optimcycle=0
415    
416    checkpoint57
417    o add horizontal bi-harmonic viscosity for vertical velocity
418      - new parameter viscA4W (defaults to viscA4)
419      - affects only non-hydrostatic code
420      - to be done: no-slip lateral boundary conditions
421    o switch back to "sflux = sflux - runoff" in exf_getforcing.F
422    o implement Implicit Vertical advection for pTracers
423    o depth convergence accelerator: replace deltaTtracer by dTtracerLev(k)
424      (implemented also for implicit vertical diffusion & advection)
425    o OBCS: extend application of tracer open boundary conditions
426      to a strip beyond the boundary of width Olx/Oly
427    o add call monitor to TAF set of required calls (flow directives)
428      and include in natl_box_adjoint
429    o untangle a few ifdefs related to cost, ctrl, autodiff
430      untangel a few ALLOW_ECCO_OPTIMIZATION
431    o Apply Cooper & Haines representative estimates also at sub-surface (k=Nr)
432      (theta2, salt2 in ecco_cost_weights)
433    
434    checkpoint56c_post
435    o OBCS as control variables
436      - update ctrl_ad_diff.list, obcs_ad_diff.list
437      - remove balance of obcs controls from default
438      - fix index bug nobcs in ctrl_init
439      - fix dummy fields filen in ctrl_pack
440      - add dummy weights for obcs
441    o lsopt: comment out fort.94 output
442    o optim:
443      - remove unnecessary header files
444      - adjusted namelists
445      - add xerbla.F to Makefile
446    o exf:
447      - multiple modifications of exf_check_range
448      - unit change in exf_init_runoff from [m/year] to [m/s]
449    o mdsio:
450      - i/o-vector change debugLevel from debLevA to debLevB
451    
452    checkpoint56b_post
453    o collect all ptracers output in an new routine (PTRACERS_OUTPUT) that
454      is called from DO_THE_MODEL_IO
455      - rename PTRACERS_STATV_WRITE to PTRACERS_WRITE_TIMEAVE
456      - introduce new parameter PTRACERS_dumpFreq (defaults to dumpFreq)
457      - clean up PTRACERS_WRITE_TIMEAVE a little
458    o add another verification experiment that tests both the cfc-pkg and
459      the gchem-pkg with GCHEM_SEPARATE_FORCING undefined, that is with
460      reactive tendencies treated inline with regular timestepping
461    o testreport previously did a lousy job of comparing small numbers, so
462      we (Ed and Martin) changed the  way the cut-off of 1.e-12 is
463      implemented in the little c-progam tmp_cmpnum.c which is embedded in
464      testreport.
465    o ptracers_monitor: bug fix for MPI
466    
467    checkpoint56a_post
468    o GCHEM: finish reorganizating the package
469      - forward_step calls GCHEM_CALC_TENDENDY, which computes gchemTendency
470        (introduces another 3D-array for each passive tracer, but only if
471        GCHEM_SEPARATE_FORCING is undefined. For GCHEM_SEPARATE_FORCING
472        gchemTendency is not needed because the timestep is done separately)
473      - gchemTendency is added to gPtr in GCHEM_ADD_TENDENCY
474      - GCHEM is now---more or less cleanly---separate from PTRACERS
475      - to bo done: handling of surfaceForcingPtr that is needed for KPP not
476        so clear to me how that should be done in a general way.
477    o CFC: improve formatting of output in CFC_ATMOS
478    o PTRACERS:
479      - rename GCHEM_MONITOR to PTRACERS_MONITOR and call it from MONITOR, so
480        that ALL experiments with ptracers enable can be checked. This makes
481        GCHEM_MONITOR obsolete.
482      - include a runtime parameter PTRACERS_monitorFreq that defaults to
483        monitorFreq
484      - set default PTRACERS_write_mdsio to false if PTRACERS_write_mnc is true
485    o add PTRACERS (PTR0[1-5]) to testreport output
486    o exf_check_range:
487      * default changed to .TRUE.
488      * will check values for niter0 if debLevA, every timestep if debLevB
489      * STOP in exf_check_range if 'out of range'
490      * range chosen generous to allow for potential extema
491      TBD: a version with stricter range
492           permitted range would be runtime parameters
493    o GMredi:
494      - fix ldd97 slope limit ; extend valid domain of Psi-Bolus ;
495      - change S/R GRAD_SIGMA to be valid in the overlap on CS-grid.
496      - change the default GMREDI_OPTIONS.h: compile everything except Visbeck
497    o GCHEM:
498      - move call to GCHEM_FORCING_SEP, so that it is now called before
499        the blocking exchanges to avoid computing halos in GCHEM_FORCING_SEP
500      - introduced a useGCHEM runtime flag and applied it everywhere.
501      - renamed PTRACERS_SEPARATE_FORCING to GCHEM_SEPARATE_FORCING;
502        this flag is now only visible within GCHEM-pkg routines.
503      - moved gchem_forcing_int temporarily into ptracers_forcing, this will
504        be replaced by a 3D array that is computed before thermodynamics; for
505        this, the tracer ID iTracer had to be included into the parameter list
506        of ptracers_forcing
507      - set up forward_step to call gchem_forcing, that will replace
508        gchem_forcing_int in ptracers_forcing
509      - cleaning up
510    o small cleaning of exch2: remove files that are also in eesupp/src
511    
512    checkpoint56
513    o AIM: read land-Fraction earlier (from ini-fixed) and monitor land at nIter0
514    o mnc: cleanup "full" files--fixes out-of-memory problem
515    o ECCO-GODAE
516      * model/, pkg/, code/, input/ now complete w.r.t. ECCO-GODAE production setup
517      * fully merged and updated from SIO code
518        windstress sign change affects
519        - exf_inscal_[u/v]stress
520        - sign of xx_tau[u/v] adjustments
521        - signs in cost_scat
522      * ctrl_get_gen: avoid update of tau[u/v] for first few days
523      * natl_box_adjoint updated and compressed
524      * 2-level checkpoint switch added
525        (tested in EXP. 1 of natl_box_adjoint)
526      * new switch doInitXX to avoid init. of xx_... in optimcycle=0
527    o SVD
528      * first complete, non-hacked version for SVD calculations
529      * all interfaces clean w.r.t to handling of xx_..., adxx_..., g_xx_...
530        performed via direct access files admtlm_vector.it????
531        (via ctrl_[un]pack)
532      * optimcycle is used for ARPACK iteration counter
533        (note: adxx_... is iterated, rather than xx_...; latter is constant!)
534      * EV problem ok w.r.t. L2-norm in tangent space; need to check other norms
535        and add linear transforms where necessary
536      * controls are initial/final SST, SSS (can be extended; need to check
537        ctrl_set_[un]pack_xyz.F according to ctrl_set_[un]pack_xy.F
538    o mdsio: filename info to both stderr, stdout
539    o exf: exf_inscal_runoff: separated default conversion [m/year] -> [m/sec]
540      from sign change
541    
542    checkpoint55j_post
543    o isolate dissipation tendency (allow to keep it out off AB) in V.I form.
544      affects (truncation level) output.txt of global_ocean.cs32x15(&.thsice)
545    o add consistent build directories and .cvsignore files to verification
546    o added viscA4GridMin and viscA4GridMax for more control on biharmonic viscosity
547    o make all subroutines 30 or less characters in length for certain older
548      compilers to work (a thorough search only turns up two routines in
549      pkg/ptracers)
550    o allow (vecinv only) a different horiz. viscosity for Divergence and Vorticity;
551      affects (truncation level) output.txt of global_ocean.cs32x15(&.thsice)
552    
553    checkpoint55i_post
554    o change arrays for total vertical diffusivity (2.D if explicit,
555      3.D if implicit) ; each ptracer uses its own background value.
556    o added mnc/NetCDF output capability to ocn_compon_interf
557      - added bits to verification/cpl_aim+ocn so that it can run on
558        ITRDA and other clusters without the mpirun "-wd" option
559    o fixed wayward endif in mom_fluxform.F that messed up cyclindrical
560      configuration
561    o give MNC the ability to create additional files rather than
562      exceeding a specified file size limit "MNC_MAX_FILESIZE"
563      - the default is just less than 2GB which is a practical limit
564        on many systems
565    o Compute the non-local term using either KPP vertical diffusivity (=default)
566       or the total vertical diffusivity (when KPP_ghatUseTotalDiffus=T)
567    
568    checkpoint55h_post
569    o add verification test "vermix"
570    o remove all the *_ioinc flags and replace with the single global
571      outputTypesInclusive flag
572    o allow to set a vertical profile of vertical diffusivity for T & S
573    o call PACKAGE_BOOT & PACKAGES_READPARMS just after INI_PARMS
574    o useMNC moved from data.mnc to data.pkg
575    
576    checkpoint55g_post
577    o Renaming carbon AD experiments to comply with testreport conventions
578    o Updating adjoint of Held-Suarez hs94.1x64x5
579    o Fixing directives for non-ECCO forward_step, after ECCO directives
580      have been fixed to avoid recomp. of do_oceanic_phys
581      Works well for global_ocean.90x40x15,
582      but recomp. issue remains for carbon
583    o Updating adjoint output for natl_box_adjoint after
584      pkg/ecco has been modified (see taga c55d_post)
585    
586    checkpoint55f_post
587    o rename to timeave_init_fixed
588    
589    checkpoint55e_post
590    o some delicate re-shuffle of store directives to avoid one
591      extra call of do_oceanic_physics
592      affects ecco_the_main_loop.F, do_oceanic_physics.F
593      checkpoint_lev1_directives.h
594    o NB: this may break global_ocean adjoint temporarily,
595      but it is clear how to fix it. Will do later, need this now.
596    
597    checkpoint55d_post
598    o ECCO specific cost function terms (up-to-date with 1x1 runs)
599    o ecco_cost_weights is modified to 1x1 runs
600    o modifs to allow observations to be read in as
601      single file or yearly files
602    o enable to read exf forcing fields as either
603      single file or yearly files (flag useExfYearlyFields)
604    checkpoint55d_pre
605    
606    o switch between 2-level and 3-level checkpointing
607    o add ability of MNC to write local and "partial" (eg. 2D slices where
608      the full 3D field is never actually stored) arrays to NetCDF files
609      with the correct (that is, the complete multi-dimensional) set of
610      array indicies
611      - used in mom_vecinv() to write the diagFreq output
612      - tested (demonstrated) in verification/aim.5l_cs
613    o further mnc-ification
614      - add verification/lab_sea to the list with mnc setups
615      - fix undefined mnc v-names in cd_code
616      - add kpp to mnc output (both snapshot and timeave)
617    o non-hydrostatic code
618      - added horizontal viscosity parameter viscAhW for w, that replaces viscAh
619        in calc_gw.F
620      - defaults to viscAh
621      - this is useful, when I want to use viscAh=0 (e.g., only biharmonic
622        friction or Leith) in non-hydrostatic mode, as long as there is
623        no biharmonic friction and/or Leigth or equivalent for vertical velocity.
624    o pkg/cost
625      extend simple cost functions to treat time mean quantities
626      (T,U,V) via cost_accumulate_state from cost_tile
627    o multidimAdvection on CS-grid: implement the full 3 pass ; overlap needs to
628        be 2 times larger than the minimum size the advection scheme requires.
629        now get a perfect conservation of salt in advect_cs test-exp (updated)
630    o GGL90 (Gaspar's TKE mixed layer)
631      - add horizontal diffusion of TKE, requires exchanges in
632        do_fields_blocking_exchanges, horizontal diffusivity is zero by
633        default. In OPA there is no horizontal diffusion of TKE but the
634        mixing coefficients are computed from a horizontal average of TKE of
635        6 points or so. I think that diffusion has a little more physical
636        justification.
637      - clean up ggl90_calc in the hope of reducing memory usage (this hope
638        was in vain)
639      - mask tke-variable in ggl90_init
640    o fix mask Pb in multidimAdvection on CS-grid (still a small Pb with ipass)
641    o fix biharmonic diffusion on CS-grid.
642    o more obcs stuff
643      - added obcs_external_fields_load as an alternative to the EXF-pkg option
644        for reading boundary values. This routine is called from
645        obcs_prescribe_read
646      - updated obcs_check
647      - changed sponge layer relaxation parameter units for days to seconds
648      - turned off sponge layer by default
649      - changed argument list of OBCS_CALC to myTime+deltaTclock
650      - fixed about 35 bugs in obcs_external_fields_load
651    
652    checkpoint55c_post
653    o obcs stuff
654      - new runtime flags useOBCSprescribe, useOBCSbalance
655      - re-arranged obcs_calc
656      - moved exf_getobcs to obcs_prescibe_read
657        obcs_prescibe_read is called after ORLANSKI stuff
658        and independent of it (executable can contain all).
659      - updated obcs_check
660      - added exchanges for U,V,gU,gV for useOBCSprescribe=.TRUE.
661        These may be necessary only if tangential velocities are
662        prescribed at OB, not sure, needs testing.
663    o make the MNC_CW_ADD_VATTR_* subroutines all take scalar arguments
664      which simplifies the calls and passes the ifc check-bounds test
665    
666    checkpoint55b_post
667    o add a 2D scalar, Z location, exchange_2 routine.
668    o EXCH_UV for CS-grid: add one u,v in the corner-halo region, allows
669      to compute vorticity on a wider stencil [e.g., vort3(0,1)&(1,0)]
670      affects advect_cs results (for the wrong reason): update output.txt
671    o use a more standard discretization for biharmonic viscosity ;
672     (original version still available with #define MOM_VI_ORIGINAL_VISCA4 )
673      affects results of dome set-up: update output.txt
674    o fix gad_advection.F (CubedSphere part), back to version 1.23
675    o fix bug in mom_vi_del2uv.F (CubedSphere part).
676    
677    checkpoint55a_post
678    o merged code to
679      * prescribe/read time-dependent open boundaries
680        (works in conjunction with exf, cal)
681      * sponge layer code for open boundaries
682      * each boundary N/S/E/W now has its own CPP option
683        (healthy for the adjoint)
684    
685    checkpoint55
686    o up-to-date adjoint of previous breaks
687      - natl_box_adjoint: problem for exp 12, 13: cost = 0. needs fix
688      - global_ocean_ebm: adjoint still needs fix (TLM ok)
689      - global_ocean.90x40x15: extended GMREDI_OPTIONS.h
690      - carbon: * remove tr1-related adjoint verification
691                * add ptracer as control variable
692    o remove all tr1-related code (ALLOW_PASSIVE_TRACER)
693      (adjoint stuff still has some tr1 'names', but all use ptracer arrays)
694    
695    checkpoint54f_post
696    o in verification/carbin/ remove experiment related to
697      ALLOW_PASSIVE_TRACER (array tr1 etc)
698      code_ad/ input_ad/ results_ad
699    
700    o add two new packages
701      - ggl90, TKE-model of Gaspar et al. (1990), Blanke+Delecluse (1993)
702        + subject to optimization (memory)
703      - opps, OPPS (ocean penetrative plume scheme) of Paluszkiewicz+Romea (1997)
704        + subject to reordering (many GOTOs in the original code)
705        + so far opps is called for every (i,j) point, and then operates in
706          the vertical; one may want to reorder the scheme in order operate in
707          horizontal slabs at the cost of (a lot of) memory, at least ten new 3D
708          fields)
709    o overhaul of IO so that we now have flags for MDSIO and/or MNC
710      - all verification tests compile and run with linux_ia32_g77
711      - defaults are compatible with current input files--nothing
712        should change if you were not previously using MNC
713      - MNC output has been added in numerous places (eg. timeave)
714        but there are still a few writes not yet do-able with MNC
715        (this is in progress)
716      - flags now allow for either/or/both use of MDSIO and MNC and
717        documentation will soon follow
718      - numerous small formatting cleanups for ProTeX
719    o add version info (via BUILD_INFO.h) to MNC and stdout
720    
721    checkpoint54e_post
722    o add two new packages
723      - pp81 (Packanowski and Philander, 1981), Richardson number and
724        stratification dependent mixing
725      - my82 (Mellor and Yamada, 1982) level 2 turbulence closure scheme
726      - these scheme operate in a similar manner as KPP (without ghat, of
727        course), however there is only one diffusivity that is used for both
728        temperature and salinity (and passive tracers)ç
729    o add offline package
730    o add "verification/dic_example" which contains a dic-gchem-ptracer setup
731      provided by Stephanie Dutkiewicz
732    o genmake2: add ability to search for C compilers and cleanup test output
733      - fixes recent SX-6 problems and should help with others (eg. HP-UX)
734    
735    checkpoint54d_post
736    o data.diagnostics: if levels() is unspecified then ALL levels are diagnosed
737    o bug fix in pkg/cal/cal_addtime.F for TheCalendar='model' day count is wrong,
738      leading to additional shift by 5 days each year of integration
739       (i.e. leading to considerable offset over the years)
740    o update global_ocean.cs32x15/thsice: use z* + RealFW + staggerTimeStep
741    o start with no AB and no initial filtering (staggerTimeStep):
742      change the results of test-exp: hs94.128x64x5, hs94.1x64x5 & hs94.cs-32x32x5
743    o move ocean specific S/R calls from forward_step.F to do_oceanic_phys.F
744      (external loading & cpl import/export stay in forward_step.F)
745    o update coupling interface to work with new staggerTimeStep
746    o change MDSIO ptracers_pickup.
747    o fix a bug in Flux deriv. vs Ts (pkg/aim_v23/phy_suflux_sice.F);
748    o genmake2 fixes so netcdf now works on halem ("osf1_alpha_*")
749    o bugs fixed in kpp_calc.F (ustarY) and external_forcing.F (Qsw & Partial-cell)
750    
751    checkpoint54c_post
752    o replace surfaceTendency U,V,S,T,Tice,Ptr by surfaceForcing U,V,S,T,Tice,Ptr
753      this affects (truncation error) output.txt of test-exp:
754       global_ocean_ebm,_pressure,.cs32x15(&.thsice), lab_sea & natl_box
755    o pkg/kpp: replace pMask by maskC to reduce memory size (one 3.D array)
756    o change Qnet to always be the net heat flux, (+upward).
757      affects (truncation error) output of natl_box exp.: updated
758    o define the max number of passive tracers in PTRACERS_SIZE.h
759    o start to test mnc routinely in exp0
760    o add sea-ice loading (sIceLoad) as a new forcing field.
761    
762    checkpoint54b_post
763    o add testreport "-j JOBS" option for parallel builds (tested and pretty
764       impressive on Altix and Opteron systems)
765    o diagnostics can now write NetCDF files through the mnc package
766    o staggerTimeStep & NLFS: update pkg aim_v23 & thsice; update aim.5l_cs output
767    o staggerTimeStep & multi-Dim-Advec: Exch(U,V) added
768    o staggerTimeStep & NLFS: rescale T & S surface tendencies.
769      affects (truncation error) output of lab_sea & natl_box exp.: updated
770    o change pickup _cd & _ptracers (old pickup restart: usePickupBeforeC54=.T.)
771    
772  checkpoint54a_post  checkpoint54a_post
773  o re-write staggerTimeStep: step fwd U,V and then T,S (reverse the order).  o re-write staggerTimeStep: step fwd U,V and then T,S (reverse the order).
774  o change pickup file (to restart from old pickup, set usePickupBeforeC54=.T.)  o change pickup file (to restart from old pickup, set usePickupBeforeC54=.T.)

Legend:
Removed from v.1.322  
changed lines
  Added in v.1.562

  ViewVC Help
Powered by ViewVC 1.1.22