/[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.125 by jmc, Mon Jan 27 21:42:19 2003 UTC revision 1.430 by edhill, Wed Dec 29 02:13:38 2004 UTC
# Line 3  $Header$ Line 3  $Header$
3      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
4      ==============================      ==============================
5    
6    o improvements for the MNC output from DIAGNOSTICS:
7      - correct handling of the unlimitied dimension
8      - all dims now have associated coordinate variables
9      - variables located at U, V, and Corner ("Z") points are now written
10        with the correct horzontal dimensions (eg. 'Xp1', 'Yp1') so that
11        *all* data points are output
12    o added seaice_summary.F and removed obsolete ALLOW_SEAICE's from pkg/seaice
13    o added pkg/seaice/seaice_monitor.F
14    o mdsio_readfield.F can now read files visible only to master MPI process.
15    o pkg/seaice: some test code for ice-modified ocean stress
16    o exf_getffields interpolation defaults to bilinear for all scalar forcing
17      fields (remains bicubic for wind velocity and stress).  This avoids, e.g.,
18      spurious negative numbers for precipitation and humidity.  Will cause
19      some small numerical differences for integrations using pkg/exf/exf_interp.F.
20    
21    checkpoint57b_post
22    o simplify options in diagnostics_fill arguments (remove weird combinations)
23    o fix MNC coordinate variables so that they now contain per-face index
24      values (instead of xC,xG,yC,yG values) when run with EXCH2 since, in
25      general, EXCH2 grids are only aligned to a "local" coordinate system
26    o test diagnostics pkg in dic_example (no output) and ideal_2D_oce (with ouput)
27    o Implement instantaneous output within pkg diagnostics:
28      setting a negative frequency in data.diagnostics produces
29     "snap-shot" output (as opposed to time-average if freq > 0)
30    o move out off EQUIVALENCE all diagnostics that fizhi does not use ;
31      NOTE: change ptracer diagnostics name: use 2 characters to work with
32            more than 9 tracers. Add also diagnostics of advect & diffus flux.
33    o more CF compliance: convert all MNC 'iter' variables to 'T' so that it
34      becomes the coordinate variable for the 'T' dimension
35    o add CF-style coordinate variables to MNC
36      - just a first cut:  numbers are meaningless on the cubesphere and
37        missing along the T axis but otherwise it works!
38    o add surface flux diagnostics: TAUX, TAUY, TFLUX, TRELAX, TICE, SFLUX, SRELAX
39    o pkg/thSIce: read initial state from 6 files ; allow monitor to use MNC.
40    o add diagnostics of advective & diffusive flux for T & S (pTracers coming soon)
41      this is based directly on what the model compute, so that the content of
42      each diagnostics might be affected by switching options (e.g., implicitDiffusion)
43    o small changes for diagnostics (gad_biharm_?.F, arguments of S/R impldiff.F)
44    o clean up build options files for SunOS, in particular
45      - remove -traditional from xmakedepend
46      - change -xarch=v9 to -xarch=native for f77
47      - restore use of make (not gmake)
48      - add CC=gcc if using g77
49    o changes per discussion of AM, JMC, & EH3 today:
50      - move redundant "grid" variables out of "state" -- in preparation of
51        creating proper CF-style coordinate variables and in recognition
52        that any/all grid variables can be easily copied (eg. w/NCO) from
53        the grid files into any of the other NetCDF files
54      - *always* output grid variables with MDSIO (this will eventually be
55        changed)
56      - output MNC grid file if useMNC is true
57    o every instance of _END_MASTER() has been found and replaced with
58      _END_MASTER( myThid ) in order to satisfy certain picky Sun
59      preprocessors
60    o re-arrange diagnostics pkg initialisation:
61     - allow each package to extend the available diagnostics list
62     - add some checking and fix small problems (multi-threaded, ...)
63     - new S/R diagnostics_fill (replace fill_diagnostics):
64       look through the short list of active diag. (instead of the long list)
65       create function DIAGNOSTICS_IS_ON to tell if a diagnostics is active
66    
67    checkpoint57a_post
68    o this set of changes restores TAMC compatibility
69      tested for global_ocean.90x40x15 adjoint on trough
70      (what a pain)
71    
72    checkpoint57a_pre
73    o some modifs in tools/build_options for sunos
74    o call ctrl_pack for ctrl at end for optimcycle=0
75    
76    checkpoint57
77    o add horizontal bi-harmonic viscosity for vertical velocity
78      - new parameter viscA4W (defaults to viscA4)
79      - affects only non-hydrostatic code
80      - to be done: no-slip lateral boundary conditions
81    o switch back to "sflux = sflux - runoff" in exf_getforcing.F
82    o implement Implicit Vertical advection for pTracers
83    o depth convergence accelerator: replace deltaTtracer by dTtracerLev(k)
84      (implemented also for implicit vertical diffusion & advection)
85    o OBCS: extend application of tracer open boundary conditions
86      to a strip beyond the boundary of width Olx/Oly
87    o add call monitor to TAF set of required calls (flow directives)
88      and include in natl_box_adjoint
89    o untangle a few ifdefs related to cost, ctrl, autodiff
90      untangel a few ALLOW_ECCO_OPTIMIZATION
91    o Apply Cooper & Haines representative estimates also at sub-surface (k=Nr)
92      (theta2, salt2 in ecco_cost_weights)
93    
94    checkpoint56c_post
95    o OBCS as control variables
96      - update ctrl_ad_diff.list, obcs_ad_diff.list
97      - remove balance of obcs controls from default
98      - fix index bug nobcs in ctrl_init
99      - fix dummy fields filen in ctrl_pack
100      - add dummy weights for obcs
101    o lsopt: comment out fort.94 output
102    o optim:
103      - remove unnecessary header files
104      - adjusted namelists
105      - add xerbla.F to Makefile
106    o exf:
107      - multiple modifications of exf_check_range
108      - unit change in exf_init_runoff from [m/year] to [m/s]
109    o mdsio:
110      - i/o-vector change debugLevel from debLevA to debLevB
111    
112    checkpoint56b_post
113    o collect all ptracers output in an new routine (PTRACERS_OUTPUT) that
114      is called from DO_THE_MODEL_IO
115      - rename PTRACERS_STATV_WRITE to PTRACERS_WRITE_TIMEAVE
116      - introduce new parameter PTRACERS_dumpFreq (defaults to dumpFreq)
117      - clean up PTRACERS_WRITE_TIMEAVE a little
118    o add another verification experiment that tests both the cfc-pkg and
119      the gchem-pkg with GCHEM_SEPARATE_FORCING undefined, that is with
120      reactive tendencies treated inline with regular timestepping
121    o testreport previously did a lousy job of comparing small numbers, so
122      we (Ed and Martin) changed the  way the cut-off of 1.e-12 is
123      implemented in the little c-progam tmp_cmpnum.c which is embedded in
124      testreport.
125    o ptracers_monitor: bug fix for MPI
126    
127    checkpoint56a_post
128    o GCHEM: finish reorganizating the package
129      - forward_step calls GCHEM_CALC_TENDENDY, which computes gchemTendency
130        (introduces another 3D-array for each passive tracer, but only if
131        GCHEM_SEPARATE_FORCING is undefined. For GCHEM_SEPARATE_FORCING
132        gchemTendency is not needed because the timestep is done separately)
133      - gchemTendency is added to gPtr in GCHEM_ADD_TENDENCY
134      - GCHEM is now---more or less cleanly---separate from PTRACERS
135      - to bo done: handling of surfaceForcingPtr that is needed for KPP not
136        so clear to me how that should be done in a general way.
137    o CFC: improve formatting of output in CFC_ATMOS
138    o PTRACERS:
139      - rename GCHEM_MONITOR to PTRACERS_MONITOR and call it from MONITOR, so
140        that ALL experiments with ptracers enable can be checked. This makes
141        GCHEM_MONITOR obsolete.
142      - include a runtime parameter PTRACERS_monitorFreq that defaults to
143        monitorFreq
144      - set default PTRACERS_write_mdsio to false if PTRACERS_write_mnc is true
145    o add PTRACERS (PTR0[1-5]) to testreport output
146    o exf_check_range:
147      * default changed to .TRUE.
148      * will check values for niter0 if debLevA, every timestep if debLevB
149      * STOP in exf_check_range if 'out of range'
150      * range chosen generous to allow for potential extema
151      TBD: a version with stricter range
152           permitted range would be runtime parameters
153    o GMredi:
154      - fix ldd97 slope limit ; extend valid domain of Psi-Bolus ;
155      - change S/R GRAD_SIGMA to be valid in the overlap on CS-grid.
156      - change the default GMREDI_OPTIONS.h: compile everything except Visbeck
157    o GCHEM:
158      - move call to GCHEM_FORCING_SEP, so that it is now called before
159        the blocking exchanges to avoid computing halos in GCHEM_FORCING_SEP
160      - introduced a useGCHEM runtime flag and applied it everywhere.
161      - renamed PTRACERS_SEPARATE_FORCING to GCHEM_SEPARATE_FORCING;
162        this flag is now only visible within GCHEM-pkg routines.
163      - moved gchem_forcing_int temporarily into ptracers_forcing, this will
164        be replaced by a 3D array that is computed before thermodynamics; for
165        this, the tracer ID iTracer had to be included into the parameter list
166        of ptracers_forcing
167      - set up forward_step to call gchem_forcing, that will replace
168        gchem_forcing_int in ptracers_forcing
169      - cleaning up
170    o small cleaning of exch2: remove files that are also in eesupp/src
171    
172    checkpoint56
173    o AIM: read land-Fraction earlier (from ini-fixed) and monitor land at nIter0
174    o mnc: cleanup "full" files--fixes out-of-memory problem
175    o ECCO-GODAE
176      * model/, pkg/, code/, input/ now complete w.r.t. ECCO-GODAE production setup
177      * fully merged and updated from SIO code
178        windstress sign change affects
179        - exf_inscal_[u/v]stress
180        - sign of xx_tau[u/v] adjustments
181        - signs in cost_scat
182      * ctrl_get_gen: avoid update of tau[u/v] for first few days
183      * natl_box_adjoint updated and compressed
184      * 2-level checkpoint switch added
185        (tested in EXP. 1 of natl_box_adjoint)
186      * new switch doInitXX to avoid init. of xx_... in optimcycle=0
187    o SVD
188      * first complete, non-hacked version for SVD calculations
189      * all interfaces clean w.r.t to handling of xx_..., adxx_..., g_xx_...
190        performed via direct access files admtlm_vector.it????
191        (via ctrl_[un]pack)
192      * optimcycle is used for ARPACK iteration counter
193        (note: adxx_... is iterated, rather than xx_...; latter is constant!)
194      * EV problem ok w.r.t. L2-norm in tangent space; need to check other norms
195        and add linear transforms where necessary
196      * controls are initial/final SST, SSS (can be extended; need to check
197        ctrl_set_[un]pack_xyz.F according to ctrl_set_[un]pack_xy.F
198    o mdsio: filename info to both stderr, stdout
199    o exf: exf_inscal_runoff: separated default conversion [m/year] -> [m/sec]
200      from sign change
201    
202    checkpoint55j_post
203    o isolate dissipation tendency (allow to keep it out off AB) in V.I form.
204      affects (truncation level) output.txt of global_ocean.cs32x15(&.thsice)
205    o add consistent build directories and .cvsignore files to verification
206    o added viscA4GridMin and viscA4GridMax for more control on biharmonic viscosity
207    o make all subroutines 30 or less characters in length for certain older
208      compilers to work (a thorough search only turns up two routines in
209      pkg/ptracers)
210    o allow (vecinv only) a different horiz. viscosity for Divergence and Vorticity;
211      affects (truncation level) output.txt of global_ocean.cs32x15(&.thsice)
212    
213    checkpoint55i_post
214    o change arrays for total vertical diffusivity (2.D if explicit,
215      3.D if implicit) ; each ptracer uses its own background value.
216    o added mnc/NetCDF output capability to ocn_compon_interf
217      - added bits to verification/cpl_aim+ocn so that it can run on
218        ITRDA and other clusters without the mpirun "-wd" option
219    o fixed wayward endif in mom_fluxform.F that messed up cyclindrical
220      configuration
221    o give MNC the ability to create additional files rather than
222      exceeding a specified file size limit "MNC_MAX_FILESIZE"
223      - the default is just less than 2GB which is a practical limit
224        on many systems
225    o Compute the non-local term using either KPP vertical diffusivity (=default)
226       or the total vertical diffusivity (when KPP_ghatUseTotalDiffus=T)
227    
228    checkpoint55h_post
229    o add verification test "vermix"
230    o remove all the *_ioinc flags and replace with the single global
231      outputTypesInclusive flag
232    o allow to set a vertical profile of vertical diffusivity for T & S
233    o call PACKAGE_BOOT & PACKAGES_READPARMS just after INI_PARMS
234    o useMNC moved from data.mnc to data.pkg
235    
236    checkpoint55g_post
237    o Renaming carbon AD experiments to comply with testreport conventions
238    o Updating adjoint of Held-Suarez hs94.1x64x5
239    o Fixing directives for non-ECCO forward_step, after ECCO directives
240      have been fixed to avoid recomp. of do_oceanic_phys
241      Works well for global_ocean.90x40x15,
242      but recomp. issue remains for carbon
243    o Updating adjoint output for natl_box_adjoint after
244      pkg/ecco has been modified (see taga c55d_post)
245    
246    checkpoint55f_post
247    o rename to timeave_init_fixed
248    
249    checkpoint55e_post
250    o some delicate re-shuffle of store directives to avoid one
251      extra call of do_oceanic_physics
252      affects ecco_the_main_loop.F, do_oceanic_physics.F
253      checkpoint_lev1_directives.h
254    o NB: this may break global_ocean adjoint temporarily,
255      but it is clear how to fix it. Will do later, need this now.
256    
257    checkpoint55d_post
258    o ECCO specific cost function terms (up-to-date with 1x1 runs)
259    o ecco_cost_weights is modified to 1x1 runs
260    o modifs to allow observations to be read in as
261      single file or yearly files
262    o enable to read exf forcing fields as either
263      single file or yearly files (flag useExfYearlyFields)
264    checkpoint55d_pre
265    
266    o switch between 2-level and 3-level checkpointing
267    o add ability of MNC to write local and "partial" (eg. 2D slices where
268      the full 3D field is never actually stored) arrays to NetCDF files
269      with the correct (that is, the complete multi-dimensional) set of
270      array indicies
271      - used in mom_vecinv() to write the diagFreq output
272      - tested (demonstrated) in verification/aim.5l_cs
273    o further mnc-ification
274      - add verification/lab_sea to the list with mnc setups
275      - fix undefined mnc v-names in cd_code
276      - add kpp to mnc output (both snapshot and timeave)
277    o non-hydrostatic code
278      - added horizontal viscosity parameter viscAhW for w, that replaces viscAh
279        in calc_gw.F
280      - defaults to viscAh
281      - this is useful, when I want to use viscAh=0 (e.g., only biharmonic
282        friction or Leith) in non-hydrostatic mode, as long as there is
283        no biharmonic friction and/or Leigth or equivalent for vertical velocity.
284    o pkg/cost
285      extend simple cost functions to treat time mean quantities
286      (T,U,V) via cost_accumulate_state from cost_tile
287    o multidimAdvection on CS-grid: implement the full 3 pass ; overlap needs to
288        be 2 times larger than the minimum size the advection scheme requires.
289        now get a perfect conservation of salt in advect_cs test-exp (updated)
290    o GGL90 (Gaspar's TKE mixed layer)
291      - add horizontal diffusion of TKE, requires exchanges in
292        do_fields_blocking_exchanges, horizontal diffusivity is zero by
293        default. In OPA there is no horizontal diffusion of TKE but the
294        mixing coefficients are computed from a horizontal average of TKE of
295        6 points or so. I think that diffusion has a little more physical
296        justification.
297      - clean up ggl90_calc in the hope of reducing memory usage (this hope
298        was in vain)
299      - mask tke-variable in ggl90_init
300    o fix mask Pb in multidimAdvection on CS-grid (still a small Pb with ipass)
301    o fix biharmonic diffusion on CS-grid.
302    o more obcs stuff
303      - added obcs_external_fields_load as an alternative to the EXF-pkg option
304        for reading boundary values. This routine is called from
305        obcs_prescribe_read
306      - updated obcs_check
307      - changed sponge layer relaxation parameter units for days to seconds
308      - turned off sponge layer by default
309      - changed argument list of OBCS_CALC to myTime+deltaTclock
310      - fixed about 35 bugs in obcs_external_fields_load
311    
312    checkpoint55c_post
313    o obcs stuff
314      - new runtime flags useOBCSprescribe, useOBCSbalance
315      - re-arranged obcs_calc
316      - moved exf_getobcs to obcs_prescibe_read
317        obcs_prescibe_read is called after ORLANSKI stuff
318        and independent of it (executable can contain all).
319      - updated obcs_check
320      - added exchanges for U,V,gU,gV for useOBCSprescribe=.TRUE.
321        These may be necessary only if tangential velocities are
322        prescribed at OB, not sure, needs testing.
323    o make the MNC_CW_ADD_VATTR_* subroutines all take scalar arguments
324      which simplifies the calls and passes the ifc check-bounds test
325    
326    checkpoint55b_post
327    o add a 2D scalar, Z location, exchange_2 routine.
328    o EXCH_UV for CS-grid: add one u,v in the corner-halo region, allows
329      to compute vorticity on a wider stencil [e.g., vort3(0,1)&(1,0)]
330      affects advect_cs results (for the wrong reason): update output.txt
331    o use a more standard discretization for biharmonic viscosity ;
332     (original version still available with #define MOM_VI_ORIGINAL_VISCA4 )
333      affects results of dome set-up: update output.txt
334    o fix gad_advection.F (CubedSphere part), back to version 1.23
335    o fix bug in mom_vi_del2uv.F (CubedSphere part).
336    
337    checkpoint55a_post
338    o merged code to
339      * prescribe/read time-dependent open boundaries
340        (works in conjunction with exf, cal)
341      * sponge layer code for open boundaries
342      * each boundary N/S/E/W now has its own CPP option
343        (healthy for the adjoint)
344    
345    checkpoint55
346    o up-to-date adjoint of previous breaks
347      - natl_box_adjoint: problem for exp 12, 13: cost = 0. needs fix
348      - global_ocean_ebm: adjoint still needs fix (TLM ok)
349      - global_ocean.90x40x15: extended GMREDI_OPTIONS.h
350      - carbon: * remove tr1-related adjoint verification
351                * add ptracer as control variable
352    o remove all tr1-related code (ALLOW_PASSIVE_TRACER)
353      (adjoint stuff still has some tr1 'names', but all use ptracer arrays)
354    
355    checkpoint54f_post
356    o in verification/carbin/ remove experiment related to
357      ALLOW_PASSIVE_TRACER (array tr1 etc)
358      code_ad/ input_ad/ results_ad
359    
360    o add two new packages
361      - ggl90, TKE-model of Gaspar et al. (1990), Blanke+Delecluse (1993)
362        + subject to optimization (memory)
363      - opps, OPPS (ocean penetrative plume scheme) of Paluszkiewicz+Romea (1997)
364        + subject to reordering (many GOTOs in the original code)
365        + so far opps is called for every (i,j) point, and then operates in
366          the vertical; one may want to reorder the scheme in order operate in
367          horizontal slabs at the cost of (a lot of) memory, at least ten new 3D
368          fields)
369    o overhaul of IO so that we now have flags for MDSIO and/or MNC
370      - all verification tests compile and run with linux_ia32_g77
371      - defaults are compatible with current input files--nothing
372        should change if you were not previously using MNC
373      - MNC output has been added in numerous places (eg. timeave)
374        but there are still a few writes not yet do-able with MNC
375        (this is in progress)
376      - flags now allow for either/or/both use of MDSIO and MNC and
377        documentation will soon follow
378      - numerous small formatting cleanups for ProTeX
379    o add version info (via BUILD_INFO.h) to MNC and stdout
380    
381    checkpoint54e_post
382    o add two new packages
383      - pp81 (Packanowski and Philander, 1981), Richardson number and
384        stratification dependent mixing
385      - my82 (Mellor and Yamada, 1982) level 2 turbulence closure scheme
386      - these scheme operate in a similar manner as KPP (without ghat, of
387        course), however there is only one diffusivity that is used for both
388        temperature and salinity (and passive tracers)ç
389    o add offline package
390    o add "verification/dic_example" which contains a dic-gchem-ptracer setup
391      provided by Stephanie Dutkiewicz
392    o genmake2: add ability to search for C compilers and cleanup test output
393      - fixes recent SX-6 problems and should help with others (eg. HP-UX)
394    
395    checkpoint54d_post
396    o data.diagnostics: if levels() is unspecified then ALL levels are diagnosed
397    o bug fix in pkg/cal/cal_addtime.F for TheCalendar='model' day count is wrong,
398      leading to additional shift by 5 days each year of integration
399       (i.e. leading to considerable offset over the years)
400    o update global_ocean.cs32x15/thsice: use z* + RealFW + staggerTimeStep
401    o start with no AB and no initial filtering (staggerTimeStep):
402      change the results of test-exp: hs94.128x64x5, hs94.1x64x5 & hs94.cs-32x32x5
403    o move ocean specific S/R calls from forward_step.F to do_oceanic_phys.F
404      (external loading & cpl import/export stay in forward_step.F)
405    o update coupling interface to work with new staggerTimeStep
406    o change MDSIO ptracers_pickup.
407    o fix a bug in Flux deriv. vs Ts (pkg/aim_v23/phy_suflux_sice.F);
408    o genmake2 fixes so netcdf now works on halem ("osf1_alpha_*")
409    o bugs fixed in kpp_calc.F (ustarY) and external_forcing.F (Qsw & Partial-cell)
410    
411    checkpoint54c_post
412    o replace surfaceTendency U,V,S,T,Tice,Ptr by surfaceForcing U,V,S,T,Tice,Ptr
413      this affects (truncation error) output.txt of test-exp:
414       global_ocean_ebm,_pressure,.cs32x15(&.thsice), lab_sea & natl_box
415    o pkg/kpp: replace pMask by maskC to reduce memory size (one 3.D array)
416    o change Qnet to always be the net heat flux, (+upward).
417      affects (truncation error) output of natl_box exp.: updated
418    o define the max number of passive tracers in PTRACERS_SIZE.h
419    o start to test mnc routinely in exp0
420    o add sea-ice loading (sIceLoad) as a new forcing field.
421    
422    checkpoint54b_post
423    o add testreport "-j JOBS" option for parallel builds (tested and pretty
424       impressive on Altix and Opteron systems)
425    o diagnostics can now write NetCDF files through the mnc package
426    o staggerTimeStep & NLFS: update pkg aim_v23 & thsice; update aim.5l_cs output
427    o staggerTimeStep & multi-Dim-Advec: Exch(U,V) added
428    o staggerTimeStep & NLFS: rescale T & S surface tendencies.
429      affects (truncation error) output of lab_sea & natl_box exp.: updated
430    o change pickup _cd & _ptracers (old pickup restart: usePickupBeforeC54=.T.)
431    
432    checkpoint54a_post
433    o re-write staggerTimeStep: step fwd U,V and then T,S (reverse the order).
434    o change pickup file (to restart from old pickup, set usePickupBeforeC54=.T.)
435    o get a perfect restart when using RealFreshWaterFlux + NLFS (not finished)
436    o update output of all exp. that use staggerTimeStep (except hs94.cs & 2D)
437      + internal_wave (shift in writing cg2d_ini_res)
438    checkpoint54a_pre
439    
440    o require forcing_In_AB=.FALSE. and remove surfaceTendencyTice from pkg/seaice
441      - modified verification/lab_sea and natl_box_adjoint accordingly
442    
443    checkpoint54
444    checkpoint53g_post
445    o prepare splitting of thermodynamics: store convect.counter in common block
446    o store d.etaH/dt (instead of Div.hV) in common ; affects (truncation error)
447      output of: global_ocean.cs32x15, global_ocean_pressure & internal_wave
448    o cnh's modifs to gad_advection.F for cube-sphere multi-dim advection
449    o new parameter "nShapS": allow to treat differently S from T (nShapT)
450    o separate Vert.Advec.Scheme from horizontal Advec.Scheme (T & S)
451    o restore adjointability
452    
453    checkpoint53f_post
454    o modifications that affect AIM experiment results (update output.txt):
455      - no advection of S at top interface Nr (pkg/generic_advdiff)
456      - air surf. temp: use lower value between T0 & T1 (phy_suflux_prep.F)
457    o AIM pkg:
458      - include stability function into surf.Flux derivative relative to Tsurf
459      - calculate clear-sky radiation & surface temp. change (for diagnostics)
460    
461    checkpoint53e_post
462    o merged cylindrical coord configuration
463    o added rotating_tank experiment
464    checkpoint53e_pre
465    
466    checkpoint53d_post
467    o faulks upgraded: re-generate output.txt that have changed:
468       global_ocean.cs32x15(.thsice), global_ocean_ebm, lab_sea, natl_box
469    o Added Bryan and Lewis, 1979, vertical diffusivity profile
470    o pkg/land: fix problem in land_impl_temp.F when Ts arround freezing.
471    o added Sadourny discretization of Coriolis
472      - moved some PARAMETERS from mom_*_coriolis.F to PARAMS.h
473      - re-enabled use of omega3 (useAbsVorticity)
474    o added Leith (Phys. Fluids, 1968, 10, 1409-1416) variable viscosity for
475      vector-invariant equations
476      - note: does *NOT* yet use same variable visc. for no-slip BC's.
477    o recoded the lateral boundary conditions for non-hydrostatic w, this time
478      hopefully without new bugs
479      - still to do: biharmonic friction for non-hydrostatic w
480    o bug fix for mom_*_sidedrag: rA -> rAs,rAw
481    o regenerated output for global_ocean_ebm (using -ieee)
482    o fix mom_common/mom_*_sidedrag.F to recover numeric output prior to creation
483      of mom_common/
484      - simple re-arrangement of instructions within computing loop
485    checkpoint53d_pre
486    
487    checkpoint53c_post
488    o new version of coupler for AIM+thSIce and Ocean models
489     - new fields (SSS,h_MixLayer ...) are exchanged through the coupler
490     - land: change Evaporation of snow
491     - aim with thSIce: fix bug in snow-precip.
492    o changes to calc_gw.F
493     - bug fix for w^2 term near the bottom boundary
494     - (hopefully) improve the lateral slip boundary condtions for use with
495        partial/looped cells
496      - because the bug fix changes two verification experiments anyway (exp5
497        and plume on slope), change the lateral boundary condition from half slip
498        to the value of no_slip_sides
499    o ebm package wasnt quite up to the parallel task. Fixed that.
500    o Adjoint of EBM package + verification
501      * TLM OK
502      * ADM not sufficient accuracy yet (needs further testing)
503    
504    checkpoint53b_post
505    o Commiting new energy balance model to repository
506      * package is pkg/ebm
507      * verif. is verification/global_ocean_ebm
508      * references are in ebm_driver.F
509    C      * X. Wang, P. Stone and J. Marotzke, 1999:
510    C        Global thermohaline circulation. Part I:
511    C        Sensitivity to atmospheric moisture transport.
512    C        J. Climate 12(1), 71-82
513    C      * X. Wang, P. Stone and J. Marotzke, 1999:
514    C        Global thermohaline circulation. Part II:
515    C        Sensitivity with interactive transport.
516    C        J. Climate 12(1), 83-91
517    C      * M. Nakamura, P. Stone and J. Marotzke, 1994:
518    C        Destabilization of the thermohaline circulation
519    C        by atmospheric eddy transports.
520    C        J. Climate 7(12), 1870-1882
521    o Will need long integration testing.
522    checkpoint53b_pre
523    
524    o created pkg/mom_common in preparation for variable viscosity code
525    o renamed and split ini_mnc_io
526    o pkg/land: only liquid water can diffuse or run-off
527    o AIM using land: soil wetness availability account for snow
528    o added printMapIncludesZeros to EEPARMS namelist
529    
530    checkpoint53a_post
531    o restore TAMC compatiility for exf_constants.h
532      (no usage of _d in .h)
533    o Additional storing in KPP in an attempt to fix
534      TAMC problem with adjoint of KPP code.
535      (no success...)
536      Identical code works fine with TAF.
537    o Fixed verification/natl_box_adjoint experiments.
538      Initial conditions for Experiments 4 and 5 are now
539      set to "SEAICE_initialHEFF=0", which is more reasonable,
540      and hence gives results closer to that of Experiment 2.
541      Experiment 6 requires "SEAICE_initialHEFF=1" and is working once again.
542    
543    checkpoint53
544    o stable checkpoint with up to date adjoint
545      TLM tests only run for 1st grdchk at the moment. Its unclear if
546      this is a code problem or a problem with resetting code for g_
547      variables that is being autogenerated wrong.
548      Otherwise:
549       o code is testing well on Linux (P4 and AMD), SGI Alitix and Irix.
550       o IBM and HPQ tests could not be run because NCAR (IBM) and NCCS (HPQ)
551         are both still in chaos following their security messes.
552    
553    checkpoint52n_post
554    o various build (mostly genmake2) changes including:
555      - ability to build/run more easily within Cygwin and MacOS X
556      - more complicated Makefiles with a stronger dependence on Gnu Make
557    o pkg/seaice modifications
558      - added SEAICE_deltaTtherm and SEAICE_deltaTdyn in order to reduce cost
559        of pkg/seaice.  For time being, SEAICE_deltaTtherm = deltaTtracer
560        and SEAICE_deltaTdyn must be integer multiple of SEAICE_deltaTtherm
561      - changed proxy for geostrophic velocity and updated
562        verification/lab_sea/results/* accordingly
563      - removed ADI dynamic solver from pkg/seaice
564      - replaced all occurrences of 1/CSTICE or 1/CSUICE
565        they caused a segmentation fault under certain circumstances
566      - removed unused field WATR
567    o bug fix in exf-package:
568      -  u/vwind are defined at tracer/pressure points. The values of u/vwindmask
569         now reflect that.
570    o small fixes in the cal-package:
571      - set reference date to first of January for the 'model'-calendar
572      - failing of cal_CheckDate in cal_FullDate now actually results in a
573        warning
574    o small modifications in exf-package to increase flexibility:
575      - change climtempfreeze from a constant to a runtime parameter that
576        is specified in data.exf_clim (default = -1.9)
577      - introduce runtime parameter windstressmax (default = 2.0) that is
578        specified in data.exf
579    o fix in pkg/thsice:
580      - update Evap (Tsf changes) to be consistent with Latent heat flux
581      - maintain snow precipitation unchanged (even if Tsf >=0).
582     both affect global_ocean.cs32x15/(.thsice) results ; update output.txt.thsice
583    
584    checkpoint52m_post
585    o commented out call to cal_GetMonthsRec in swfrac.F and added some comments;
586      this does not change any of the results, because myIter=0 in swfrac always
587      lead to jwtype=2 (the default anyway), but the call makes little sense
588      as a default
589    o no SHORTWAVE HEATING lost at the bottom; affects lab_sea output; updated
590    o re-work pkg/thsice interface with ocean & bulk_force pkg to allow
591      atmospheric model (AIM) to use it ; add a "slab ocean" component.
592    o pkg/aim_v23 : add interface to call thermodynamic sea-ice (thsice)
593    o update global_ocean.cs32x15/output (.thsice) after changes in pkg/thsice
594    o extending useSingleCpuIO option to work with new exch2 I/O format
595      - old-style, missing-tile I/O is still accessible by defining CPP
596        option MISSING_TILE_IO in pkg/mdsio/MDSIO_OPTIONS.h
597    o monitor package can write to NetCDF files and/or STDOUT
598    o fix re-definition bug in MNC_GRID_INIT_ALL()
599    o doc/api_reference added
600      - a framework for building an API Reference Manual using all
601        the "protex" comments embedded in the code
602      - see pkg/generic_advdiff, pkg/mnc for examples
603    o MNC:
604      - make myThid the last argument for all subroutines
605      - new default for the grid files: NO halos
606      - add useMNC and other run-time flags
607      - separate per-file-group handling of the unlimited dimension
608      - early initialization of MNC w/ flags read at the eeboot stage
609        and lookup tables set in initialize_fixed
610      - write all MNC output to a freshly-created directory
611    o thermodynamics sea-ice (thsice) is now tested with testreport.
612    o test exp. advect_cs: use the standard cs32 grid ; update output.
613    o Added functionality to grdchk:
614      pick global i,j,k position (or nearest wet) where to perform check.
615    
616    checkpoint52l_post
617    o new land formulation:
618      a) use ground enthalpy as prognostic variable to ensure exact
619         energy conservation.
620      b) account for water temperature and for latent heat of freezing
621         in all processes (rain, run-off, ground storage)
622      c) compute surface and ground temperature implicitly.
623    o aim_v23 modification for new land model:
624      a) Treat separately land / ocean / sea-ice surface fluxes
625         to allow implicit computation of land & sea-ice surface temp.
626      b) add snow precipitation.
627    checkpoint52l_pre
628    
629    o fix problem (when 1 tile is empty) in min/max monitor.
630    o fix bug in timeAve (u,vZetatave in common block)
631    o no restoring terms under ice for pkg/seaice
632    o moved SEAICE_DO_DIAGS to S/R do_the_model_io
633    o bug fix for pkg/seaice pickups
634    o change MNC call locations and add coordinate attributes
635    o mask vorticity at the corner ; affects global_ocean.cs output
636    o fix ini_curvilinear_grid ; test CS experiments with mpi
637    o aim.5l_cs: modify sea-ice fraction input file ; update output
638    o exf: Adding simple range check routine for exf fields after read
639    
640    checkpoint52k_post
641    o removed top-level directory "diags"
642      - we migrated these functions to pkg/timeave a long time ago
643    o fixed bug introduced in pkg/monitor
644    o accuracy ctrlprec = 32 insuffient for gradient checks using
645      averaged fields (I/O via cost_averages)
646      -> use ctrl.h in active_file*.F to control I/O precision.
647    o paramter list of CALL ADTHE_MAIN_LOOP
648    o added initial do_the_model_io to ecco
649    o set all ...Freq to zero after cost_final
650      taveFreq, dumpFreq, pChkptFreq
651    o MAIN and ECCO differentiability restored
652    
653    checkpoint52j_post
654    o fix nchklev in tamc.h for global_ocean...
655    o Bringing flow and store directives up-to-date
656    o Really weird thing!
657      call do_the_model_io from the_main_loop with parameters
658      starttime, niter0, instead of mytime, myiter, screws up the adjoint:
659      TAF places a faulty re-call of initialise_varia
660      after cost_final call which should not be there!
661    checkpoint52j_pre
662    
663    o tweaked pkg/mdsio/mdsio_readfield.F to have more useful logic and
664      error messages
665    o fix errorMessageUnit problem. remove old version of mdsio from eesup/src
666    o modified pkg/mdsio/mdsio_readfield.F -- commented out diskspace-eating
667      debug output
668    o modfied mdsio_writefield.F to handle non-global files under exch2
669    o update AIM Cubed-Sphere exp (aim.5l_cs):
670      use land, p*, and Franco.M forcing fields with fractional land-sea mask.
671    o update AIM Equatorial Channel exp:
672      use standard aim_v23 pkg and change the SST fields to be more realistic.
673    o globalFile now works with exch2
674    o merged mom_vi_calc_relvort3.F, mom_vi_del2uv.F and
675      mon_vort3.F to make exch2 friendly with >1 tile per cube face
676    o limit timeave output for hi-res integrations
677    
678    checkpoint52i_post
679    o removed CPP_EEOPTIONS.h from verification/*/code
680    o updated the tiling for global_ocean_pressure
681    checkpoint52i_pre
682    
683    o update aim.5l_LatLon using the standard aim_v23 pkg (instead of
684      the old pkg/aim).
685    
686    checkpoint52h_pre
687    o shortened offending lines in exch2_send_rx?.template
688    o modified W2_EXCH2_TOPOLOGY.h to reflect current topology generator
689    o genmake2: add build & execute test for NetCDF code
690    o modded aim.5l_cs and global_ocean.cs32x15 to use exch2, removed
691      old grid files, moved CPP_EEMACROS.h to pkg/exch2
692    o added useSingleCPUIO flag to monitor.F and mon_out.F
693    o added temporary hack for sea-ice dynamics on the cube:
694      metric terms are ignored and it is assumed that
695      there is no sea-ice on cube faces 1, 2, 4, and 5.
696    
697    checkpoint52f_post
698    o added exch2 cube routines to pkg/exch2
699    o modified hs94.cs-32x32x5 to use it
700    o added new grid files to hs94.cs-32x32x5
701    checkpoint52f_pre
702    
703    checkpoint52e_post
704    o first attempt to solve vertical advection (momemtum & T,S) Implicitly
705      for now, only implemented with Lax-Wendroff (tracer) and VectInv (mom)
706    o step.1 : rewrite (as in MultiDimAdvec) explicit tracer stepping (gad_calc_rhs.F)
707      to work with implicit vertical advection and AB ;
708    o Implic. vert. advect. implemented with flux-limiter, c2, u3 and c4 scheme.
709    o update output (gad_calc_rhs.F changes affect truncation error) of exp:
710     front_relax, global_ocean .cs32x15 & _pressure, internal_wave, lab_sea, natl_box
711    checkpoint52e_pre
712    
713    o fix bug in impldiff when Nr=1 or Nr=2.
714    o change the albedo in pkg/thsice (as GISS model); update output_thsice.txt
715    o little changes (fftpack, aim/phy_suflux ...) to pass the "checkbounds" test.
716    o fix deltaTfreesurf in update_cg2d.F (left from c45d_post): affects 2
717      ocean exp. that use NLFS: global_ocean.cs32x15 & global_ocean_pressure
718    o added exf_offset_atemp for Celsius to Kelvin conversion of atemp
719    o eesupp/inc/EEPARAMS.h: MAX_NO_PROCS=1024
720    o pkg/cal/cal_toseconds.F fix for long (>60 years) integrations
721    
722    checkpoint52d_post
723    o re-tiled many expts to allow comparison in multi-processor mode
724      - updated output accordingly
725      - changed hs94.128x64x5 to use intial T from file rather than use the
726        random number generator
727    o add infrastructure in model routines for fizhi and gridalt packages
728    o change global_ocean.cs32x15 because of Pb with GM on CS-grid.
729    o changes to permit hi-res, cubed-sphere, configuration
730      - added useSingleCpuIO capability to mdsio_readfield.F and exf_interp.F
731      - added "#undef ALLOW_USE_MPI" support to eesupp/src/scatter_2d.F
732      - added pkg/exf/exf_set_uv.F for on-the-fly interpolation and rotation
733        of surface winds for the cube
734      (A verification experiment, based on global_ocean.cs32x15, but with
735       pkg/seaice turned on and with on-the-fly interpolation from the NCEP
736       Gaussian grid is described in MITgcm_contrib/high_res_cube/README_ice,
737       complete with example surface forcing files and matlab scripts to look
738       at the output and compare it with that of global_ocean.cs32x15.)
739    o packages pickup: $PKG_write_pickup called from packages_write_pickup ;
740       but call to $PKG_read_pickup remains in $PKG_ini_vars: change CD_code
741       to conform to the common rule.
742    o check-in the first version of the coupler + interfaces for multi-components
743       set-up (Chris's version, adapted to work on cubed-sphere grid); use MPI.
744       - imply modification in eesupp (MPI_COMM_MODEL < MPI_COMM_WORLD).
745       - atmosphere: use pkg aim_v23 ; no sea-ice for now.
746       - ocean and atmos. share the same horizontal grid (no interpolation).
747       - exchanges between component and coupler is done in forward_step
748    o new verification experiment, cpl_aim+ocn:
749       coupled ocean - AIM atmosphere on cs32 grid.
750    
751    checkpoint52d_pre
752    o surface flux time-av diagnostic modified for NLFS & RealFreshWater
753    o add call to AIM pendant S/R in external_forcing & external_fields_load.F
754    
755    checkpoint52c_post
756    o Fixing OPTIONS files for use of exf:
757      - ALLOW_ECCO not needed
758      - ECCO_CPPOPTIONS.h should not be included from
759        EXF_OPTIONS.h/CAL_OPTIONS.h, but from CPP_OPTIONS.h
760        as has been the case in the past
761      - All cal/exf related options are currently set in
762        single header file. Should remain so until we
763        agree on a consistent new policy.
764    o Removed all CPP options for cal package.
765      cal has no more CPP options.
766    o modified STOREs in GAD_ADVECTION
767    o corrected key comp. for passkey
768    
769    checkpoint52b_post
770    o new version: "thsice" of thermodynamic sea-ice pkg:
771     - only 1 call from "forward_step"; conserve energy, fresh-water & salt.
772     - modify fluxes but do not change theta directly;
773     - light cleaning of bulk_force pkg (still needed with thsice).
774     - add forcing fields + data files in global_ocean.cs32x15/inp_thsice
775       + output_thsice.txt to test thsice & bulk_force pkgs.
776    o put back grid & coriolis monitor output.
777    checkpoint52b_pre
778    
779    o call "do_the_model_io" at the beginning (=> dump initial state)
780    o use rhoConstFresh to define convertEmP2rUnit (was done only in ocean-P)
781    o sort out interplay between tamc.h and PTRACERS_OPTIONS.h
782      (need info on NUMBER_OF_PTRACERS)
783    o missing PTRACERS headers in some routines
784    o default tamc.h in pkg/autodiff supposed to crash
785      to ensure proper customization
786    
787    checkpoint52a_post
788    o modifications to make FREEZE (_SURFACE) flux visible to pkg/kpp
789      - moved surfaceTendencyTice from pkg/seaice to main code
790      - subroutine FREEZE_SURFACE now limits only surface temperature
791        and is called in FORWARD_STEP (if allowFreezing=.TRUE.)
792        => new output.txt for global_ocean.cs32x15 & global_with_exf
793      - keep the old version of FREEZE for backward compatibility;
794        global_ocean.90x40x15 left unchanged using useOldFreezing=.TRUE.
795      - corresponding modifs for TAF directives
796    o added surface flux output variables to TIMEAVE_STATVARS
797    o time-averaged output for pkg/ptracers
798    o fix problem with ECCO-related divided adjoint
799      snapshot file was missing some ad-variables,
800      but no warning issued by TAF
801    
802    checkpoint52a_pre
803    o some bug fixes for #undef REAL4_IS_SLOW
804    
805    checkpoint52 = ecco_c52_e35
806    o after testing adjoints of checkpoint51u_post
807    
808    checkpoint51u_post
809    o this is the post-merge tag of the ecco-branch
810      (needs another clean checkout and re-testing)
811    o various natl_box_adjoint configs and results
812      but no input fields
813    o obcs adjoint not yet merged!
814    o adding ECCO global 1x1 and 2x2 degree configs
815    o updated/extended some store directives for seaice
816    o pkg/ecco now containes ecco-specific part of cost function
817    o top level routines the_main_loop, forward_step
818      supersede those in model/src/
819      previous input data.cost now in data.ecco
820      (new namelist ecco_cost_nml)
821    o in ctrl/ cleaned some cross-dependencies and updated CPP options
822    
823    checkpoint51t_post
824    o this is the pre-merge tag of the ecco-branch
825    
826    checkpoint51s_post
827    o cleanup: removed various obsolete #define-s
828    o pkg/grdchk
829      - renamed 'ph-grd 3' to 'grad-res'
830      - merged from ecco-branch
831        (remaining bug fixes for obcs gradient checks)
832      - additional high-precision output for testreport
833        (grep for 'precision_grdchk_result')
834    
835    checkpoint51r_post
836    o cleaned up or removed CPP_OPTIONS.h files
837    o updated results for some of the tests to reflect the new
838      optfiles (-ieee: -O0 instead of -O3)
839    
840    checkpoint51q_post
841    o cd_code:
842      - moved cd_scheme.F -> cd_code_scheme.F
843      - separate read_checkpoint from cd_code_ini_vars.F
844      - separated cd_code part from write_checkpoint
845      - updated AD_SOURCE, generated .flow
846      - added CD_CODE_VARS.h to the_main_loop
847      - Moving cd_code specific store dir.s to pkg/cd_code
848    o ctrl package totally restructured
849      - pack/unpack now optional and decoupled from
850        xx_/adxx_ I/O
851      - ctrl_pack/unpack cleaned
852        (new routines ctrl_init_ctrlvar.F, pkg/ctrl/ctrl_init_wet.F)
853      - confined inclusion of AD_CONFIG.h to where necessary.
854    o genmake2: changed AD dependencies from SRCFILES to AD_FILES
855    
856    checkpoint51p_post
857    o create initial cd_code package
858      - WARNING: the initialization of fields within packages
859        is broken because INI_FIELDS (where READ_CHECKPOINT is
860        called) is called *before* PACKAGES_INIT_VARIABLES.
861        This seems to be backwards since
862        1) its important to initially zero the entire field including
863           the "halo" region
864        2) zeroing needs to be done *before* reading pickup info
865           and the pickup call might or might not happen in any
866           particular run
867      - this needs an overhaul for R2
868    o cleanup verification/*/code/GMREDI_OPTIONS.h
869    o cleanup testreport
870    
871    checkpoint51o_post
872    o bringing AD-related verif's up to date with genmake2
873      - carbon/
874      - global_ocean.90x40x15/
875      - hs.94.1x64x5/
876      - (front_relax/ )
877    o (more) consistent directory structure for AD-related verif.'s
878    o cleaning ALLOW_GRADIENT_CHECK -> ALLOW_GRDCHK
879    o cleaning some ALLOW_TANGENTLINEAR_RUN -> ALLOW_AUTODIFF
880    o bug fix in find_alpha.F for MDJWF:
881      - modif. to alpha = 1/D*( dN/dT - rho*dD/Dt) to account for
882        change rho -> rho-rhoConst
883      - replace call find_rho to find_rhonum
884    o initialisation of rFlx extended to full array (required by TAF)
885      and shifted to thermodynamics
886    o removed PTRACERS.h in ptracers routine
887    o added surfacetendencyPtr to S/R parameter list pracers_forcing
888    o Correcting initialisations for fVerU, fVerV.
889    o helping TAF to recognize dependency on kUp for
890      fVerU, fVerV
891    o Replacing delZ by delR in pkg/ctrl/
892    checkpoint51o_pre
893    
894    o undid all of cp51 pending some cleanups and discussion
895    o added the [#include "AD_CONFIG.h"] statement to all files that need
896       it for adjoint/tl #defines
897     o re-worked the build logic in genmake2 to support AD_CONFIG.h
898     o removed tools/genmake since it no longer works
899    
900    checkpoint51n_post
901    o modifications to make FREEZE flux visible to pkg/kpp
902      - moved surfaceTendencyTice from pkg/seaice to main code
903      - FREEZE & EXTERNAL_FORCING_SURF moved to FORWARD_STEP
904      - subroutine FREEZE now limits only surface temperature
905        (this means new output.txt for global_ocean.90x40x15,
906         global_ocean.cs32x15, and global_with_exf)
907    o added surface flux output variables to TIMEAVE_STATVARS
908    
909    checkpoint51n_pre
910    o added "#undef ALLOW_USE_MPI" support to eesupp/src/gather_2d.F
911    o added [#include "AD_CONFIG.h"] to all files that use the following
912      defines:
913      - ALLOW_ADJOINT_RUN
914      - ALLOW_TANGENTLINEAR_RUN
915      - ALLOW_ECCO_OPTIMIZATION
916    
917    checkpoint51m_post
918    o incorporating changes to get TAMC/TAF working in genmake2
919      - added new TAMC/TAF targets to the Makefile
920      - various cleanups related to package handling
921      - these changes should have no impact on the forward model
922    
923    checkpoint51l_post
924    o changes to pkg/cal and pkg/exf that allow and speed-up long integrations
925     - faster algorithm for cal_addtime.F
926     - higher precision arithmetic, where needed
927     - pkg/exf *startdate variables changed from calendar date to
928       model integration time
929    
930    checkpoint51l_pre
931    o add salt flux to forcing fields (used when salty sea-ice forms or melts)
932    o enable to apply restoring on S & T only in a latitude band.
933    o update output (external_forcing_surf modif. change truncation errors)
934       global_ocean.cs32x15, global_ocean_pressure, lab_sea, natl_box
935    
936    checkpoint51k_post
937    o change default to: useNHMTerms=.FALSE.
938     - new output.txt for atmos. exp (NHMTerms were wrong but now turned off):
939       adjustment.128x64x1, aim.5l_Eq_Ch, aim.5l_LatLon, hs94.128x64x5, hs94.1x64x5
940     - new output.txt for idealized oceanic exp (NHMTerms are now turned off):
941        exp1, ideal_2D_oce
942     - change data file of oceanic exp (leave the results unchanged for now)
943       exp2, global_ocean[90x40x15,pressure,with_exf], lab_sea, natl_box
944    o set gravitySign automatically according to the vertical coordinate used
945      (and change sign: back to "logical" value: +1 when R increases downward)
946    o added an include barrier to the default CPP_OPTIONS.h and
947      removed the #include "PACKAGES_CONFIG.h" from it
948    o fix a bug in mom_fluxform (from chk51j_post)
949    
950    checkpoint51j_post
951    o Added some AD-related initialisations in mom_vecinv/ mom_fluxform/
952    o adjusted some flow directives (dynamics, thermodynamics)
953    o added cubed-sphere case to test cost function
954    o heckpoint_lev?_directives.h now include
955      pkg-specific directives, whenever those are enabled.
956    o Moving pkg-specific flow directives to corresponding pkg
957      Moving pkg-specific differentiation list to corresponding pkg
958      Moving pkg-specific checkpoint-lev storing to corresponding pkg
959      ---> conventions are
960           - pkg_ad.flow
961           - pkg_ad_diff.list
962           - pkg_ad_check_lev?_dir.h
963    
964    checkpoint51i_post
965    o merge of the branch-genmake2
966      - knowingly breaks the older genmake
967      - automatic generation of all ALLOW_${PKG_NAME} defines
968      - new testreport supersedes older testscript
969    o large number of package inclusion and header cleanups
970    checkpoint51i_pre
971    
972    o new output for adjoin of global ocean vector invariant
973    o fix for checkpoint of thermodynamic seaice and bulk_force
974    o Steph gchem various cleanups
975    
976    checkpoint 51h_pre
977    o fixed some single quotes
978    o modify gchem pkg to be more versatile
979    o modifications to clean up dic pkg
980    o add pkg/cfc
981    
982    checkpoint51g_post
983    o provide links for ARPACK and ADM*TLM
984    o start removing verification/vero/
985    o update AD-related stuff
986      (in particular some IF-statements in model/src/ routines)
987    o adding to verification/global_ocean.90x40x15/ adjoint of
988      vector invariant setup
989    
990    checkpoint51f_post
991    o update advect_xz/output.txt (left from chekpoint50f_pre, ini_vel modif)
992    o Mods and bug fixes to pkg/cal, pkg/exf, etc., needed for computation
993      of tracer Green's fucntions for ocean inversion project.
994    
995    checkpoint51f_pre
996    o Added on-the-fly spatial interpolation capability
997        "USE_EXF_INTERPOLATION" to pkg/exf.
998      - This is a temporary Cartesian-grid hack until
999        the super-duper ESMF coupler becomes available.
1000      - See verification/global_with_exf/README for usage example.
1001      - Removed obsolete EXFwindOnBgrid and SEAICEwindOnCgrid
1002        flags and modified pkg/seaice accordingly.
1003    o Bug fix to pkg/ptracers, pkg/generic_advdiff/gad_calc_rhs.F,
1004        and pkg/kpp/kpp_transport_ptr.F for dealing with tracer
1005        non-local transport term.
1006    
1007    checkpoint51e_post
1008    o pkg/mom_vecinv:
1009      - changes related to hFac: use S/R from aim.5l_cs/code (coriolis & vort.advec)
1010      - add time-ave diagnostic of vorticity advection.
1011    o add diagnostic (instantaneous) of Shapiro Filter effect for T,S & UV.
1012    o atmospheric geopotential: - include water vapor effect;
1013                                - use p^kappa in p* scaling.
1014    o land pkg: read initial state from files.
1015    o AIM : add stratospheric drag in the upper level
1016    
1017    checkpoint51d_post
1018    o change function ILNBLNK (=> last non-blank char.) to return zero
1019      (instead of the string length) when the string. char is empty
1020    o fix bug in dxV,dyU definition of cubed-sphere grid (ini_curvilinear_grid)
1021    o modif's to restore TAMC compatibility
1022      - avoid "_d" constructs in PARAMETER declarations
1023      - avoid interrupting lines by comment lines
1024    o Use cluster local disks for purely local I/O
1025      vs. globally visible disks needed for ctrl stuff
1026      (merged from ecco-branch)
1027      - new active_file_loc... and mdsio_..._loc routines
1028      - affected packages: autodiff, ctrl, grdchk, mdsio
1029    
1030    checkpoint51c_post
1031    o introducing integer flag debugLevel
1032      - debLevZero: suppress all output
1033      - debLevA: standard
1034      - debLevB: equivalent to current debugMode=.TRUE.
1035    o introducing pathname variable mdsioLocalDir for mdsio
1036      that can be specified at runtime
1037      (relevant for cluster I/O to local disk)
1038    `
1039    >>>checkpoint51b_post
1040    adjoint of ptracers
1041    o disentangled ALLOW_PTRACERS using new ALLOW_GCHEM
1042    o extended state in checkpoint_lev?, etc.
1043    o alternative ctrl/cost with tr1 or ptracer
1044    o new comlev1_bibj_ptracers
1045    o new ptracers.flow
1046    o made ptracers_forcing same as external_forcing_s
1047    o added verification for adjoint with ptracers
1048      - adm. grdchk fail so far
1049      - tlm. grdchk OK
1050      - checked tapelev/comlev recomputations: OK
1051    <<<checkpoint51b_pre
1052    
1053    checkpoint51a_post
1054    o added code for biogeochemistry package
1055      - new pkgs: dic, gchem
1056      - new subroutine in ptracers
1057    o modify code for biogeo packages
1058      - in model/src and pkg/ptracers
1059    
1060    checkpoint51
1061    o merged improved packages from ecco-branch (ecco_c51_e34) to MAIN
1062      - autodiff, ctrl, exf, grdchk, seaice
1063      kept separate packages
1064      - cost, ecco, obcs
1065    o updating verification/internal_wave, verification/lab_sea
1066      (all verif's pass on faulks.lcs.mit.edu RH7.3, g77)
1067    
1068    checkpoint50i_post
1069    o Preparing next differentiable checkpoint and sync
1070      of MAIN vs. ecco-branch
1071      - 1st step: this one is differentiable
1072      - 2nd step: next(! not this) checkpoint will have updated packages
1073                  from ecco-branch)
1074    
1075    checkpoint50h_post
1076    o new package "land": provide surface BC for AIM.
1077    o pkg/ptracers: apply exchange to all tracers after reading a pickup.
1078    o AIM: use true log-P extrapolation for near surface temp (= as in
1079        F.Molteni paper) ; update aim.5l_cs output.
1080    o New variable in PARM03 for more flexible pickups
1081    o somewhat cleaned package initialisation sequence for
1082      ctrl/ cost/ ecco/ in packages_... routines
1083    
1084    checkpoint50g_post
1085    o merged with release1_p17 (pkg/seaice and verification/lab_sea)
1086      - added SEAICE_MULTILEVEL for 8-category sea-ice thermodynamics
1087      - LSR sea-ice dynamic solver moved to SouthWest B-grid location and
1088        made the default because of faster convergence than ADI
1089    
1090    checkpoint50f_post
1091    o exf totally restructured
1092      - replaced all exf_set_ routines by one generic exf_set_gen.F
1093        and made sure it's still differentiable
1094      - split exf_getffields.F into new exf_bulkformulae.F
1095      - exf_inscal_/exf_outscal_ suffixes consistent with field names
1096      - updated adjoint/makefile and relevant verif. accordingly
1097    
1098    checkpoint50f_pre
1099     o AIM: near surface temp evaluated from Pot.Temp: fixed for Part Cell ;
1100          + change Evap over land. (update aim.5l_cs output)
1101     o added missing .cvsignores and made uniform across expts
1102     o changed configuration of tidal_basin_2d expt
1103     o added pkg/debug functions for tracing code in fatal crashes
1104     o tidied pkg/monitor to use MONITOR_OPTIONS.h
1105     o new fn in pkg/monitor to stop model if solution grows too big
1106     o removed lots of single quotes from comments
1107    
1108    checkpoint50e_post
1109    o make KPP work with PTRACERS
1110     - fix gad_calc_rhs to call new routine kpp_transport_ptr, which is
1111       nearly a copy of kpp_transport_s
1112     - there is no analogue to SurfaceTendencyS, so I have to use
1113       gPtr(of the surface layer) instead
1114    o add a new platform SunFire+mpi (SunFire 15000) to genmake
1115    checkpoint50e_pre
1116    
1117    checkpoint50d_post
1118    o change kpp output from multiple-record state files to single-record state
1119      files analogous to write_state.F
1120    o reduce the output frequency of cg3d-related stuff to the monitor frequency,
1121      analogous to the cg2d-related output.
1122    o fix small problem with in ptracers_write_checkpoint.F: len(suff)=512,
1123      so that writing to internal file fn (with length 512) fails.
1124    checkpoint50d_pre
1125    
1126    checkpoint50c_post
1127    o fix problem in ini_procs.F when using MPI (was there since checkpoint48f)
1128    o add monitor diagnostic of vorticity (mon_vort3.F) and potential energy.
1129    o add time-average diagnostic of U*V and vertical diffusive flux for theta.
1130    o bug fixed in convective adjustment diagnostic (multi-tile set-up).
1131    o 4th Order Adv scheme: return to previous (c40pre7) masking near boundaries.
1132    
1133    checkpoint50c_pre
1134    Merging from release1_p13:
1135    o bug fix for pkg/seaice dynamic solver
1136    o Added SEAICE_initialHEFF to pkg/seaice
1137    
1138    checkpoint50b_post
1139    o store u*,v* in gU,V instead of in guNm1,gvNm1
1140    o in order to put the momForcing out of the Adams-Bashforth:
1141      move forcing & CD-scheme calls from mom_fluxform & mom_vecinv
1142      to timestep.F
1143    o new flag "useCDscheme" (default=F); replace guCD,gvCD by local arrays
1144    o re-generate output for highly sensitive test-exp:
1145       global_ocean_pressure, ideal_2D_oce, lab_sea, natl_box
1146    
1147    checkpoint50b_pre
1148    o restore the use of momAdvection & useCoriolis flags (mom_vecinv)
1149    o corrected CPP option mismatch in exf_Bulk... functions for case
1150      #define ALLOW_ATM_WIND && #undef ALLOW_ATM_TEMP
1151    
1152    checkpoint50a_post
1153    o Bug fix for merging between c50 and KPP.
1154      ikey was passed from thermodynamics to kpp_calc via
1155      common block rather than being recomputed in kpp_calc,
1156      in contradiction with new key itdkey.
1157      New key ikppkey created, and tamc.h headers updated.
1158    
1159    checkpoint50
1160    - 2nd step of merge with ecco-branch:
1161      merge changes in ecco-branch back into main trunk
1162    - bug fix in find_alpha
1163    - more storing in gmredi_calc_tensor.F, kpp_routines.F
1164    - avoid iterative loop in ini_pressure for ALLOW_AUTODIFF_TAMC
1165    - merged some sliced AD support routines
1166    
1167    checkpoint49
1168    merged from ecco-branch:
1169    o exf:
1170      - Enable initialisation of forcing fields to constant
1171        (runtime) values.
1172      - in exf_getffields.F
1173        Reduce i-/j-loop to interior domain, discarding overlaps.
1174        That also fixes wrong TAF-key computations for key_1, key_2
1175        with bulf formulae.
1176      - exf_init.F modify #ifdef for exf_init_evap
1177      - exf_getffieldrec.F, ctrl_getrec.F
1178        The following INT-usages are not safe:
1179          fldsecs  = int(fldsecs/fldperiod)*fldperiod
1180          fldcount = int(fldsecs/fldperiod) + 1
1181        and were modified.
1182    o autodiff: checkpoint_lev...
1183      - updated storing for bulk formulae (some arrays were missing)
1184      - added state for seaice package
1185      - synchronized with main branch
1186    o DIVA:
1187      Modif.s in
1188      - the_main_loop.F
1189      - the_model_main.F
1190      and added cost_final_restore.F cost_final_store.F
1191      o With these changes, it is possible to fully separate
1192        the first forward run to compute the cost function (mdthe_main_loop)
1193        and adjoint runs over individual DIVA intervals (adthe_main_loop)
1194        into separate model executions.
1195        This enables better tuning of DIVA to given queue sizes.
1196      o Loss of cost function value in consecutive DIVA runs is
1197        fixed by storing to 'costfinal' file.
1198      o Appropriate call of ctrl_unpack/_pack,grdchk_main at
1199        beginning/end of adjoint integration is accounted for.
1200      The current changes apply to TAF-1.4.26.
1201      TAF has one remaining bug, requiring one manual change
1202      (see MITgcm manual).
1203    o cal: synchronized between MAIN and ecco-branch
1204    
1205    checkpoint48i_post
1206    o Changes to restore differentiability of code w.r.t. previous tag
1207      (mostly adding new routines to make list and replacing
1208      pressure by totPhiHyd).
1209    o Updated and merged grdchk package
1210      - has both ADM and TLM checks
1211      - works for single- and multi-proc.
1212      - output cleaned
1213      - worked successfully for parallel DIVA
1214    o genmake:
1215      - Adding -platform=SP4
1216      - Modif. for DEC Alpha (many don't have makedepend; use mkdep instead).
1217    o Modif. for DIVA:
1218      ctrl_unpack should not be called in intermediate DIVA interval.
1219      (similar thing would apply for active files such as
1220      tbar, sbar, psbar, which should not be reinitialised;
1221      only relevant for ecco-branch)
1222    
1223    checkpoint48h_post
1224    o improve "ini_p_ground" when using finite difference form for calc_phi_hyd
1225    o Added net flux to downward flux conversion to pkg/exf/exf_getffields.F
1226    o Added SEAICE_initialHEFF to pkg/seaice
1227    o ecco_the_model_main.F: SEAICE_WRITE_PICKUP must precede WRITE_CHECKPOINT
1228    
1229    checkpoint48g_post
1230    --- EOS:
1231    o compute locally the pressure for use in EOS: UNESCO, JMD95P, MDJWF
1232      store total Potential in totPhyHyd for diagnostics & EOS.
1233    o fix restart and overlap Pb when using Z-coord and EOS funct. of P
1234    --- Pressure/geopotential gradient:
1235    o use Ro_surf & R_low instead of hFac in cal_phi_hyd:
1236    o NLFS + p-coord.: eta*Alpha' is not longer lagging 1.time-step behind
1237      ( changes results of global_ocean_pressure )
1238    o NLFS + z-coord.: add eta*Rho' contribution.
1239    o accurate phiHyd when using interface-W at the middle between 2 centers
1240     ( changes results of ideal_2D_oce )
1241    o includes r* 2nd term in potential gradient.
1242    
1243    checkpoint48f_post
1244    Merging from release1_p12:
1245    o Modifications for using pkg/exf with pkg/seaice
1246      - improved description of the various forcing configurations
1247      - added basic radiation bulk formulae to pkg/exf
1248      - units/sign fix for evap computation in exf_getffields.F
1249      - updated verification/global_with_exf/results/output.txt
1250    o Added pkg/sbo for computing IERS Special Bureau for the Oceans
1251      (SBO) core products, including oceanic mass, center-of-mass,
1252      angular, and bottom pressure (see pkg/sbo/README.sbo).
1253    o Lower bound for viscosity/diffusivity in pkg/kpp/kpp_routines.F
1254      to avoid negative values in shallow regions.
1255      - updated verification/natl_box/results/output.txt
1256      - updated verification/lab_sea/results/output.txt
1257    o MPI gather, scatter: eesupp/src/gather_2d.F and scatter_2d.F
1258    o Added useSingleCpuIO option (see PARAMS.h).
1259    o Updated useSingleCpuIO option in mdsio_writefield.F to
1260      work with multi-field files, e.g., for single-file pickup.
1261    o pkg/seaice:
1262      - bug fix in growth.F: QNET for no shortwave case
1263      - added HeffFile for specifying initial sea-ice thickness
1264      - changed SEAICE_EXTERNAL_FLUXES wind stress implementation
1265    o Added missing /* */ to CPP comments in pkg/seaice, pkg/exf,
1266      kpp_transport_t.F, forward_step.F, and the_main_loop.F
1267    o pkg/seaice:
1268      - adjoint-friendly modifications
1269      - added a SEAICE_WRITE_PICKUP at end of the_model_main.F
1270    
1271    checkpoint48e_post
1272    o New S/R for diagnostic of bottom pressure (phi0surf was missing in c48d_post)
1273    o dynamics: change definition of computational domain & adapt mom_fluxform
1274      accordingly ; when viscA4=0, allows to run the dynamics with Olx=Oly=2.
1275    o following exp works with Olx=Oly=2 (and pass through checkbounds option):
1276        adjust_nlfs.cs-32x32x1 adjustment.128x64x1 adjustment.cs-32x32x1
1277        exp0 exp1 exp2 exp4 exp5 hs94.cs-32x32x5 hs94.128x64x5 hs94.1x64x5
1278        global_ocean.90x40x15 global_with_exf global_ocean_pressure
1279        inverted_barometer solid-body.cs-32x32x1
1280      (high order AdvScheme and/or multiDimAd works with Olx=Oly=2 ? not sure)
1281    
1282    checkpoint48d_post
1283    o in preparation for r*:
1284     a) use pre-computed gradient of hydrostatic potential:
1285        changes in timestep.F & mom_cdscheme.F affects results of ideal_2D_oce
1286     b) move phi0surf from calc_phi_hyd to calc_grad_phi_hyd:
1287        => affects results of glob_oce_pressure (different truncation error)  
1288      update output.txt of ideal_2D_oce & global_ocean_pressure
1289    
1290    checkpoint48d_pre
1291    o in preparation for r*:
1292      new S/R (calc_grad_phi_hyd.F) to compute Hydrostatic potential gradient.
1293      pass the 2 comp. of the grad. as arguments to momentum S/R.
1294      but for the moment, only used if it does not change the results.
1295    o add finite volume form of calc_phi_hyd for buoyancyRelation OCEANIC & OCEANICP
1296    
1297    checkpoint48c_post
1298    Modifications in treatment of initial flux forcing controls
1299    to avoid extra storing of flux fields.
1300    
1301    checkpoint48c_pre
1302    o Added tidal_basin_2d experiment (currently 1D!)
1303    o can use r* Coordinate with OBC (but Orlanski Rad. BC not yet implemented)
1304    
1305  checkpoint48b_post  checkpoint48b_post
1306  o r* coordinate added in #ifdef NONLIN_FRSURF block.  o r* coordinate added in #ifdef NONLIN_FRSURF block.
1307   (modification to pressure gradient not yet implemented)   (modification to pressure gradient not yet implemented)

Legend:
Removed from v.1.125  
changed lines
  Added in v.1.430

  ViewVC Help
Powered by ViewVC 1.1.22