/[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.469 by heimbach, Sun Apr 3 16:11:00 2005 UTC revision 1.600 by jmc, Sun Jan 22 16:49:26 2006 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/bulk_force:
8     - add option and parameters to use AIM surface-flux formulae.
9     - Change loading part: S/R BULKF_FIELDS_LOAD only take care of bulkf_fields ;
10       others forcing fields (defined in PARM05, parameter file "data") are loaded
11       from S/R EXTERNAL_FIELDS_LOAD, as usually (with useBulkforce = T or F).
12     - initialise all bulkf_fields in bulkf_init.F ; do in-lining of exf_bulkcdn.F
13     - use the right EXCH call for uwind,vwind (to work on CS-grid).
14     - re-arrange header files (move parameters from BULKF.h to BULKF_PARAMS.h)
15       and parameters (note: calcWindStress replaces .NOT.readwindstress).
16     - cleaner interface with pkg/thSIce (new S/R THSICE_GET_PRECIP).
17    
18    checkpoint58
19    o add "--embed-source" option to genmake2 which, when the supporting
20      tools can be compiled (as determined by genmake2) will turn on the
21      embed_files package which then embeds the entire MITgcm source code
22      (*.[fFhc] + Makefile) used for the build within the executable
23      - requested by CNH but off by default
24      - adds a paltry <9MB to the mitgcmuv executable in most cases
25      - only writes the output when useEMBEDSRC in eedata is true
26    o clean up 3-dim. relaxation codes:
27      * Fix I/O inconsistency in pkg/rbcs: replace precFloat32 by readBinaryPrec
28      * Remove 3-dim. relaxation code from pkg/exf (now use only pkg/rbcs)
29      * Thanks to Tom Haine for testing!
30    
31    checkpoint57z_post
32    o make CG3D solver compatible with Free-surface at k > 1 (p-coordinate):
33      affects output (@ truncation level) of exp. plume_on_slope ; updated.
34    o fix the pickup behavior for obcs in combination with ptracers
35    o fix a bug in ptracers_external_fields_load
36    o no AB-2 at the first iteration for Gw (consistent with Gu,Gv,Gt,Gs ...)
37      affects results of NH experiments (but all our NH tests have Gw[it=1]==0 !!)
38    o transfered surface NH pressure to eta field (if exactConserv).
39    o gmredi: fix bugs in slope tapering ldd97 (depthZ had the wrong sign)
40         and update lab_sea output.txt file.
41    o completing 3-dim. relaxation code: additional term
42         1/tau*( theta(i,j,k) - thetaStar(i,j,k) )
43      in S/R EXTERNAL_FORCING_T (file external_forcing.F)
44      * At compile time, in "EXF_OPTIONS.h" set
45          #define  ALLOW_CLIMTEMP_RELAXATION
46          #define  ALLOW_CLIMSALT_RELAXATION
47      * At runtime in "data", under &PARM03 set (e.g., units in seconds)
48          tauThetaClimRelax3Dim = 15552000.0,
49          tauSaltClimRelax3Dim  = 15552000.0,
50      * 3 cases:
51          1) Use a constant-in-time 3-dim. field
52          2) Provide 12 3-dim. fields corresponding to Jan., ... , Dec.
53          3) Real-time relax. to time-evolving prescribed field
54    o Adding Laplacian-type smoothness constraint on
55      initial and boundary (forcing) controls (ic, bc)
56      * enable at compile-time via
57        ALLOW_SMOOTH_IC_COST_CONTRIBUTION, ALLOW_SMOOTH_BC_COST_CONTRIBUTION
58      * enable at run-time via mult_smooth_ic = 1, mult_smooth_bc = 1
59      * Absolute scale somewhat unclear so far
60      * no area weighting was included since no other cost term does so far
61    
62    checkpoint57y_post
63    First step for a NLFS adjoint
64    o initially suppress rStar (new flag DISABLE_RSTAR_CODE)
65    o new init. routines for calc_r_star, calc_surf_dr
66    o still need to deal with ini_masks_etc
67    o testreport seemed happy
68    checkpoint57y_pre
69    
70    o obcs: always reset wVel & eta (to zero or prescribe it) at the OBs.
71    o add new package rbcs (for relaxing ptracers at boundaries/depth/surface etc)
72    o add new offset feature to offline pkg (plus minor cleanup)
73    o cfc fixes for final year of integration
74    o clean up GCHEM_OPTIONS.h/DIC_OPTIONS.h (all options should
75      be in GCHEM_OPTIONS).
76    
77    checkpoint57x_post
78    o fix testreport Pb in multiple test experiment.
79    o cleanup our namelist syntax in verification:
80      - make it more F95 standards compliant (some work still needed)
81      - allows the vast majority of our tests to work with gfortran
82    o Non-Hydrostatic:
83     - put all NH variables (formerly in DYNVARS.h & GW.h) in NH_VARS.h
84     - fix exchange calls for CS-grid using the new EXCH_S3D_RL.
85    o Allow to apply AB on T,S rather than on AB(gT,gS):
86     - implemented within #ifdef ALLOW_ADAMSBASHFORTH_3
87     - use the same arrays (gtNm,gsNm) to hold tracer field at previous
88       time-steps (if AB(T,S)) and tendencies (if AB(gT,gS)).
89     - need a "clever" read_pickup to restart from the other AB formulation
90    o move local commom bloc /GlobalLo/ (used for singleCpuIO) in EESUPPORT.h
91    o remove some unused variables (reduces number of compiler warnings)
92    o adjoint
93      * Disable useVariableViscosity for adjoint for time being
94        (there are a number of extensive recomputations)
95      * Initialize certain variables needed for adjoint
96    
97    checkpoint57w_post
98    o pkg/mdsio: use MAX_LEN_FNAM (instead of hard coded 80) for file-names
99                 fix the singleCpuIO RS version of MDSWRITEFIELD
100       and add a WARNING if using globalFiles=T with multi-processors.
101    o write grid-file(s) in only one format (MDS or MNC): default=MNC (if
102      using MNC); can force MDS output by setting writegrid_mnc=F in data.mnc
103    o tracer advection scheme:
104      add DST-2 (=Lax-Wendroff) & 1rst order upwind schemes (the way to get
105       those 2 schemes before, changing GAD_FLUX_LIMITER.h + to recompile,
106       was not very convenient).
107      add implicit version for DST-3 & DST3_Flux_Limit vertical advection;  
108       (further tests needed for the implicit DST & Flux-Limiter schemes).
109    o PTRACERS: added namelist parameter PTRACERS_ref in analogy to tRef
110      and sRef for convenience, handy, when you want to initialize
111      ptracers in a large domain with a constant non-zero value. Also,
112      untangle ptracers_init.F a little.
113    
114    checkpoint57v_post
115    o change dome exp. to use variable viscosity in side-drag terms.
116    o remove all the files from the cfc_offline test since they are now
117      incorporated into tutorial_cfc_offline which has been producing
118      identical results for a few days of testing
119    o add new parameter: sideDragFactor to enable half-slip-side BC
120      and change side-drag S/R to use viscosity from mom_calc_visc
121      (can switch back by setting sideDragFactor=0.); affects results at
122      truncation level; regenerate output for exp.: global_ocean.cs32x10(x3),
123       global_ocean_ebm, global_ocean_pressure, matrix_example & MLAdjust(x5).
124    o vorticity & strain are now computed without masking, to account for
125      no-slip-side BC in variable viscosity calculation ; mask is applied
126      anyway later on, before computing advection/coriolis terms.
127    o modify exp4 to test new obcs support for reading from external files
128      and for passive tracers
129    o fix behavior of ptracers_monitor when monitor output is written to a
130      netcdf-file; still not independent of monitor.F (writes in the same
131      file).
132    o change default value of tRef (put a uniform, meaningful value for ocean
133      & atmos) and initialize sRef (was missing, as Martin mentioned).
134    o Redefine viscC?Leith*.  Change the coefficients of Leith viscosity
135      to be proportional to enstrophy dissipation length.  Thus,
136       viscC?leith?_new=pi*(viscC?leith?_old)^(1/3)
137      This is now consistent with Smagorinsky and with the manual.
138    
139    checkpoint57u_post
140    o OBCS and PTRACERS: add open boundary support for passive tracers
141      - either use homogenous (pseudo) v.Neumann conditions or prescribe
142        OB-values from file; this is not different from the way theta and salinity
143        are treated
144      - however, Orlanski-radiation conditions are not supported, and the model
145        will stop if you use pTracers and Orlanski at the same time.
146      - beefed up the rountine obcs_external_fields_load: now only those open
147        boundary values are overwritten with values from files for which there
148        are really files, otherwise the OB-fields remain untouched. This makes
149        it possible to use different OBs at different ends of the domain (as
150        with EXF)
151    o reduce number of exch calls in shap_filt (s2).
152    o CS-grid: fix divergence contribution to Leith viscosity. Affects (@
153      truncation level) 4/5 MLAdjust test results (11&12 digits match).
154    
155    checkpoint57t_post
156    o test biharmonic viscosity + no-slip with exp: global_ocean.cs32x15.viscA4
157    o finish adding brackets (coriolis S/R, vecinv) in multi-terms sum to get
158      same truncation, independent of the face number: affects affects several
159      test. exp.: Update global_ocean.cs32x15 (+.thsice) & MLAdjust (all 5).
160    o fix bug in mom_v_sidedrag (biharmonic viscosity was counted 2 times);
161      note that biharmonic viscosity + no-slip was not tested in any experiment.
162    o fix bug in non-linear free-surf side-drag ; generate new output for
163      global_ocean.cs32x15(+.thsice) & global_ocean_pressure.
164    o make mnc honor the writeBinaryPrec flag for most kinds of output
165    o eesupp: split EEPARAMS into EESIZE/EEPARAMS and add a vector global sum
166    o minor change in averaging W (mom_vi_?_vertshear.F) that affects truncation
167      error; update output from global_ocean.cs32x15(+.thsice) & MLAdjust (all 5).
168    o add brackets in multi-terms sum to get same truncation, independent of
169      the face number (manage to get exactly same value of gU,gV at the cs-edge)
170      affects several test. exp. Update global_ocean.cs32x15 (+.thsice).
171    o Clean, new version of mom_calc_visc.  Adds a new feature, viscAhRemax
172      and viscA4Remax, which allow one to limit the minimum viscosity by specifying
173      a maximum grid-scale Reynolds number.  Also, changes all length calculations
174      in the case of grid anisotropy to geometric mean of dx**2 and dy**2.
175      Suggested values of viscosity parameters found in mom_calc_visc.
176      Many new viscosity diagnostics available.
177    
178    checkpoint57s_post
179    o Add clearing-house for viscosity calculations, mom_calc_visc and
180      correct numerous bugs in LeithD and Smagorinsky discretizations.  
181      mom_calc_visc now allows for Smagorinsky, Leith and LeithD to be
182      used simultaneously, and to be used in mom_vecinv and mom_fluxform.
183      Mom_vecinv can be used with standard viscous calculation (mom_vi_hdissip.F)
184      and with Strain-Tension viscous term calculation (mom_hdissip.F).  
185      The Strain-Tension form is now called with useStrainTensonVisc=.true.
186      ViscAhStrain and viscAhTension are now retired.
187    o diagnostics "VISCAHD" & "VISCA4D" replace "VISCAH" & "VISCA4".
188    o In response to JMC's bug report, genmake2 now ignores any soft-links
189      that it finds in the *current* directory when searching for files.
190      Soft-links found in any other source directories will still work as
191      they did before.
192    o add HAVE_SETRLSTK define and useSETRLSTK flag (eedata) which calls
193      a C routine to unlimit the stack size
194    o mnc-ify pkg/aim snapshot vars
195    o mnc-ify pkg/land as requested by Daniel
196    o various changes to mnc including:
197      - all files use the new "BASENAME[[.ITER].{t|f}NUM].nc" format
198      - output can now be grouped so that all files within a group
199          change the ITER portion of their names in lock-step together
200      - can now read ("global") PER-FACE (in addition to PER-TILE) files
201          and works with both EXCH1 and EXCH2 (but needs more testing)
202      - writing works for all verification test cases w/ g77 on Linux
203    
204    checkpoint57r_post
205    o make MNC variable initialization happen earlier
206    o add diagnostics for (almost) each term of the momentum Eq.
207    o remove SST,SSS,UVEL_k2,VVEL_k2 diagnostics.
208    o move pkg timeave out of pkg-groups "oceanic" & "atmospheric" (pkg/pkg_groups)
209    o remove MINIMAL_TAVE_OUTPUT option ;
210      add "dumpInitAndLast" to replace "nodumps" (and MINIMAL_TAVE_OUTPUT).
211    o move some basic S/R (used elsewhere in the code) from pkg/mdsio to eesupp/src
212      allows to compile without pkg/mdsio (& test successfully hs94.1x64x5)
213    o add MNC output for adjoint of EXF (adexf), SEAICE (adseaice)
214    o add time-dependent SST, SSS control
215    o cost terms in ecco/ modularized (new cost_generic.F)
216    o cost_averages routines are modularized (new cost_averagesgeneric.F)
217    o new infrastructure for seaice model vs. obs misfits in seaice/
218      * driver from the_main_loop.F is seaice_cost_driver.F
219      * first term is AREA vs. SMR observation misfit (ALLOW_SEAICE_COST_SMR_AREA)
220      * gradient check in Exp. 6a of natl_box_adjoint/
221    o natl_box_adjoint input_seaice for Lab. Sea now available online via wget
222      (see README file)
223    
224    checkpoint57q_post
225    o fix initialisation Pb in calc_gw (get NANs in exp5 with g77)
226    o fix annoying months-old bug in mnc/mdsio output for seaice pkg
227      - bug was reported by Jean-Michel and Ian Fenty
228    o fix initialization Pb in AIM-Ocean coupled model (aim_sice2aim.F)
229      update exp. cpl_aim+ocn output.
230    o Implement 4-level checkpointing: AUTODIFF_4_LEVEL_CHECKPOINT
231      Needed for high-res. runs with large global files
232      to be able to limit tapelev size
233    o Changed some tests for adjoint:
234      * carbon/ now tests AUTODIFF_2_LEVEL_CHECKPOINT
235      * natl_box_adjoint/code_bulk/ tests AUTODIFF_4_LEVEL_CHECKPOINT
236      * global_ocean.90x40x15/ back to default 3-level checkpointing
237    o Modifications to enable scripted COMMON to MODULE conversion
238      * verification/OpenAD/code/ has necessary scripts and description;
239      * converts, compiles and runs successfully;
240    
241    checkpoint57p_post
242    o reading of delXfile & delYfile moved from ini_parms.F to ini_grid.F
243    o move ${PKG}_MNC_INIT from ${PKG}_READ_PARAMS to ${PKG}_INIT_FIXED
244      (already the case for some pkgs, including recent MNC_init, e.g. thsice)
245    o call CALC_GW from DYNAMICS (instead of from FORWARD_STEP)
246    o Dissipation & phiHyd gradient are always added to gU,gV in timestep.F
247      (was already the case for dissipation with mom_vecinv,
248       and also the case for grad.PhiHyd when staggered-timeStep)
249      This will allow to put dissipation out-off the AB time-stepping.
250     Unfortunately, affects truncation error. Update output of exp. that "fails"
251      (cg2d matching number) and leave the others for later: front_relax(10),
252      global_ocean_pressure(10),ideal_2D_oce(10),internal_wave(9),lab_sea(12),
253      matrix_example(7!),natl_box(12),plume_on_slope(11),vermix(12x3,11x2).
254    
255    checkpoint57o_post
256    o fix MNC/MDSIO flags in PTRACERS so that (1) it works, and
257      (2) its ready to be documented during the 20050801 DocFest
258    o MNC-ify the gmredi package -- tested and works w/ and w/o mnc
259      for ideal_2D_oce and lab_sea on linux_ia32_g77
260    o set to #undef CTRL_SET_OLD_MAXCVARS_30
261      in global1x1_tot/code_seaice_adj to access indices 32, 33
262      (worth another tag)
263    
264    checkpoint57n_post
265    o adding precip control xx_precip 32
266    o adding swflux control xx_swflux 33
267    o Replacing 10 forcing penalty cost routines by 1 generic.
268    o Implementing partitioning in time-mean and variable adjustment
269      for atmos. state.
270    o Time-mean constant error is now read in data.ecco (instead of hard-coded)
271    o in natl_box_adjoint:
272      * updated exp 1 to 10
273        (but does not have time-mean vs. variable split results yet)
274    o updated global1x1/*_seaice_adj/
275      to incorporate latest changes
276    o enable useSingleCpuIO for mdsio vector routines
277      (applies in particular to tapelev I/O)
278    o removed inefficient K-loop in all active_file*control*.F
279    
280    checkpoint57m_post
281    o re-arrange exp. adjustment.cs-32x32x1 (adjust_nlfs.cs-32x32x1 merge into)
282      and advect_cs (use EXCH-2 and standard cs-32 grid files).
283    o pkg/exch2: filling of face-corner halo regions is optional
284      (ifdef W2_FILL_NULL_REGIONS) and is turned off by default.
285    
286    checkpoint57l_post
287     tag before updating tutorials (pre-release-2)
288    o add cos & sin of grid-direction orientation angle (curvilinear grid only,
289       for output and interpolation of input fields onto model grid)
290    o fix radius in mom_v_metric_cylinder.F (wrong by dy/2).
291       Affects results of exp. rotating_tank ; update output.txt.
292    o pkg/diagnostics: 2 new S/R to fill a diagnostics using a scaling factor
293          and taking the square quantity and/or using a fraction-weight field.
294    o fix aim_diagnostics_init.F mate numbers.
295    o add mnc output capability to diagnostics/diagstat and update
296      our cvsignore files for the ACSII output generated
297    
298    checkpoint57k_post
299    o lab_sea now uses diagnostics package and provides a suite of
300      new EXF diagnostics output.
301    
302    checkpoint57j_post
303    o exf
304      * bug fix in exf_bulkformulae for psimh (spotted by Eliyahu Biton):
305        Bracket missing in eqn. for psimh (eqn. 7 of Large & Pond, 1982);
306        terms -2*ATAN(x) + pi/2 were added to both stable and unstable case.
307      * extended diagnostics output
308        - now includes all EXF variables
309        - hs, hl moved to common block
310        - separate S/R for diagnostics, called after ctrl vector is added
311        - name changed for EXFsw -> EXFswnet, EXFlw -> EXFlwnet
312        - EXFqnet contains true Qnet (i.e. includes qsw)
313      * updated verif. lab_sea, global_with_exf
314      * Rearranging hflux (exf_mapfields -> exf_getforcing)
315        to ensure that diagnostics sees a true EXFqnet
316    o add matlab scripts for CS-grid vectors (in utils/cs_grid)
317    o diagnostics pkg: change pointers so that 1 diagnostic can be used
318      several times with different frequencies.
319    o mnc-ify the thsice package as requested by Daniel Enderton
320      - the monitor--MNC output needs work
321      - many attributes need to be added (most are currently blank)
322    o mnc-ify theaim_v23 package as requested by Daniel Enderton
323      - many attributes need to be added (most are currently blank)
324    o remove "groundAtK1" & "rkFac" (replaced by usingPCoords & -rkSign)
325    o add Sadourny like discretization to the 4th.O vorticity advection scheme
326    o fix bug in rStar code (calc_r_star.F) when used with topo/bathy.
327      update output.txt from: aim.5l_cs (& .thSI), cpl_aim+ocn,
328         fizhi-gridalt-hs and global_ocean.cs32x15 (& .thsice).
329    o fix few little things to avoid floating error with -ftrapuv (ifort v9)
330     (ini_spherical_polar_grid.F, calc_r_star.F, monitor/mon_surfcor.F)
331    
332    checkpoint57i_post
333    o Diagnostics package was changed: diagnostic allocation is now deactivated
334      by setting an empty file name in the namelist (used to be by setting 0 frequency)
335    o momentum advection (VI form) options: activate 4th.O vorticity Coriolis ;
336      add 1rst Order upwind vertical Shear.
337    o add a quick fix for A/B checkpointing in OFFLINE mode
338    o add IGNORE_TIME define and -ignore_time option to genmake2 as an
339      end-run around the C/Fortran linking horror in eesup/src/timers.F
340    o added pkg/runclock: allows user to terminate run based on wall clock
341    o added non-hydrostatic scaling parameter: nh_am2
342    o pkg/my82: futile attempt to make results compiler-independent by adding
343      some "_d 0", etc. no effect.
344    o for mnc output, fill the 'T' coordinate var with myTime and create a
345      separate 'iter' variable for iteration count
346    o pkg/diagnostics:
347      add new capability: output of Global/Regional & per-level statistics ;
348      tested against monitor output (including land & thSIce) on various exp.
349    o make seaice-pkg I/O type flags (MNC/MDS) more standard.
350    
351    checkpoint57h_done
352      tag after changing user customized files (DIAGNOSTICS_SIZE.h,
353      data.diagnostics, data.gchem, data.ptracers) is done.
354    
355    o pkg/diagnostics: prepare for Global/Regional statistics.
356      add 2nd namelist in data.diagnostics and update DIAGNOSTICS_SIZE.h
357    o remove "baseTime" (no used) from arg. list of DIFF_BASE_MULTIPLE
358      and rename it: DIFFERENT_MULTIPLE
359    
360    checkpoint57h_post
361    o move tIter0 from data.gchem to PTRACERS_Iter0 in data.ptracers
362    o pkg/diagnostics: change output frequency, now in seconds (instead
363      of Nb of iterations). This requires to change data.diagnostics.
364    checkpoint57h_pre
365    
366    o in mnc, let the user create the output dir if both mnc_outdir_date
367      and mnc_outdir_num are false
368    o add fflags() to pkg/diagnostics which allows one to specify, on a
369      per-file basis, the file precision [default behavior is unchanged]
370    o added diagnostics to pkg/kpp, including computation of mixed layer
371      depth based on a temperature/density criterion
372    o updated verification/natl_box to test the new pkg/kpp diagnostics
373    o bugs fixed (with useAbsVorticity=T & with useJamartMomAdv=T)
374    o test AB-3 code with 4th.Order advection scheme (advect_xy/input.ab3_c4)
375    o fix mnc flags in pkg/seaice so that they are "owned" by seaice,
376      not mnc -- this mistake was found by JMC and is now corrected
377    
378    checkpoint57g_post
379    o add Adams-Bashforth 3rd Order time stepping:
380      - default remains AB-2 (#undef ALLOW_ADAMSBASHFORTH_3)
381      - not yet implemented with NH, CD_Scheme, pTracers, MNC_pickup ...
382    checkpoint57g_pre
383    
384    o make lambda[Theta,Salt]ClimRelax spatially varying
385      (default remains spatially uniform constant based on tau)
386    o added new control variables
387      * init. uVel, vVel, etanN
388      * lambda[Theta,Salt]ClimRelax
389    o separate masks used for ctrl_pack/unpack 'from write_grid' output
390      (suggested by G. Forget)
391    
392    checkpoint57f_post
393    o add parameter "baseTime" = model base time = time at iteration zero
394      new function DIFF_BASE_MULTIPLE (replace DIFFERENT_MULTIPLE) to
395      account for baseTime shift
396    o move Coriolis arrays from PARAMS.h to GRID.h
397    checkpoint57f_pre
398    
399  o mnc-ifying the seaice package  o mnc-ifying the seaice package
400  o introduced an alternative length scale calculation for use in the limiting  o introduced an alternative length scale calculation for use in the limiting
401    maximum viscosity (off by default, see mom_vi_hdissip.F for details)    maximum viscosity (off by default, see mom_vi_hdissip.F for details)
# Line 24  o adjoint-related modifications Line 417  o adjoint-related modifications
417    
418  checkpoint57e_post  checkpoint57e_post
419  o Adding eddy stress controls a la Ferreira et al.  o Adding eddy stress controls a la Ferreira et al.
420  checkpoint57e_pre  checkpoint57e_pre (actually was tagged: eckpoint57e_pre)
421    
422  o fizhi pkg: fix AtoC and CtoA when called with same input & output array  o fizhi pkg: fix AtoC and CtoA when called with same input & output array
423    update output.txt of exp. fizhi-gridalt-hs    update output.txt of exp. fizhi-gridalt-hs

Legend:
Removed from v.1.469  
changed lines
  Added in v.1.600

  ViewVC Help
Powered by ViewVC 1.1.22