/[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.192 by dimitri, Wed Oct 22 16:35:47 2003 UTC revision 1.308 by jmc, Sat Jun 12 21:18:11 2004 UTC
# Line 2  $Header$ Line 2  $Header$
2    
3      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
4      ==============================      ==============================
5    o faulks upgraded: re-generate output.txt that have changed:
6       global_ocean.cs32x15(.thsice), global_ocean_ebm, lab_sea, natl_box
7    o Added Bryan and Lewis, 1979, vertical diffusivity profile
8    o pkg/land: fix problem in land_impl_temp.F when Ts arround freezing.
9    o added Sadourny discretization of Coriolis
10      - moved some PARAMETERS from mom_*_coriolis.F to PARAMS.h
11      - re-enabled use of omega3 (useAbsVorticity)
12    o added Leith (Phys. Fluids, 1968, 10, 1409-1416) variable viscosity for
13      vector-invarianet equations
14      - note: does *NOT* yet use same variable visc. for no-slip BC's.
15    o recoded the lateral boundary conditions for non-hydrostatic w, this time
16      hopefully without new bugs
17      - still to do: biharmonic friction for non-hydrostatic w
18    o bug fix for mom_*_sidedrag: rA -> rAs,rAw
19    o regenerated output for global_ocean_ebm (using -ieee)
20    o fix mom_common/mom_*_sidedrag.F to recover numeric output prior to creation
21      of mom_common/
22      - simple re-arrangement of instructions within computing loop
23    checkpoint53d_pre
24    
25  untagged  checkpoint53c_post
26    o new version of coupler for AIM+thSIce and Ocean models
27     - new fields (SSS,h_MixLayer ...) are exchanged through the coupler
28     - land: change Evaporation of snow
29     - aim with thSIce: fix bug in snow-precip.
30    o changes to calc_gw.F
31     - bug fix for w^2 term near the bottom boundary
32     - (hopefully) improve the lateral slip boundary condtions for use with
33        partial/looped cells
34      - because the bug fix changes two verification experiments anyway (exp5
35        and plume on slope), change the lateral boundary condition from half slip
36        to the value of no_slip_sides
37    o ebm package wasnt quite up to the parallel task. Fixed that.
38    o Adjoint of EBM package + verification
39      * TLM OK
40      * ADM not sufficient accuracy yet (needs further testing)
41    
42    checkpoint53b_post
43    o Commiting new energy balance model to repository
44      * package is pkg/ebm
45      * verif. is verification/global_ocean_ebm
46      * references are in ebm_driver.F
47    C      * X. Wang, P. Stone and J. Marotzke, 1999:
48    C        Global thermohaline circulation. Part I:
49    C        Sensitivity to atmospheric moisture transport.
50    C        J. Climate 12(1), 71-82
51    C      * X. Wang, P. Stone and J. Marotzke, 1999:
52    C        Global thermohaline circulation. Part II:
53    C        Sensitivity with interactive transport.
54    C        J. Climate 12(1), 83-91
55    C      * M. Nakamura, P. Stone and J. Marotzke, 1994:
56    C        Destabilization of the thermohaline circulation
57    C        by atmospheric eddy transports.
58    C        J. Climate 7(12), 1870-1882
59    o Will need long integration testing.
60    checkpoint53b_pre
61    
62    o created pkg/mom_common in preparation for variable viscosity code
63    o renamed and split ini_mnc_io
64    o pkg/land: only liquid water can diffuse or run-off
65    o AIM using land: soil wetness availability account for snow
66    o added printMapIncludesZeros to EEPARMS namelist
67    
68    checkpoint53a_post
69    o restore TAMC compatiility for exf_constants.h
70      (no usage of _d in .h)
71    o Additional storing in KPP in an attempt to fix
72      TAMC problem with adjoint of KPP code.
73      (no success...)
74      Identical code works fine with TAF.
75    o Fixed verification/natl_box_adjoint experiments.
76      Initial conditions for Experiments 4 and 5 are now
77      set to "SEAICE_initialHEFF=0", which is more reasonable,
78      and hence gives results closer to that of Experiment 2.
79      Experiment 6 requires "SEAICE_initialHEFF=1" and is working once again.
80    
81    checkpoint53
82    o stable checkpoint with up to date adjoint
83      TLM tests only run for 1st grdchk at the moment. Its unclear if
84      this is a code problem or a problem with resetting code for g_
85      variables that is being autogenerated wrong.
86      Otherwise:
87       o code is testing well on Linux (P4 and AMD), SGI Alitix and Irix.
88       o IBM and HPQ tests could not be run because NCAR (IBM) and NCCS (HPQ)
89         are both still in chaos following their security messes.
90    
91    checkpoint52n_post
92    o various build (mostly genmake2) changes including:
93      - ability to build/run more easily within Cygwin and MacOS X
94      - more complicated Makefiles with a stronger dependence on Gnu Make
95    o pkg/seaice modifications
96      - added SEAICE_deltaTtherm and SEAICE_deltaTdyn in order to reduce cost
97        of pkg/seaice.  For time being, SEAICE_deltaTtherm = deltaTtracer
98        and SEAICE_deltaTdyn must be integer multiple of SEAICE_deltaTtherm
99      - changed proxy for geostrophic velocity and updated
100        verification/lab_sea/results/* accordingly
101      - removed ADI dynamic solver from pkg/seaice
102      - replaced all occurrences of 1/CSTICE or 1/CSUICE
103        they caused a segmentation fault under certain circumstances
104      - removed unused field WATR
105    o bug fix in exf-package:
106      -  u/vwind are defined at tracer/pressure points. The values of u/vwindmask
107         now reflect that.
108    o small fixes in the cal-package:
109      - set reference date to first of January for the 'model'-calendar
110      - failing of cal_CheckDate in cal_FullDate now actually results in a
111        warning
112    o small modifications in exf-package to increase flexibility:
113      - change climtempfreeze from a constant to a runtime parameter that
114        is specified in data.exf_clim (default = -1.9)
115      - introduce runtime parameter windstressmax (default = 2.0) that is
116        specified in data.exf
117    o fix in pkg/thsice:
118      - update Evap (Tsf changes) to be consistent with Latent heat flux
119      - maintain snow precipitation unchanged (even if Tsf >=0).
120     both affect global_ocean.cs32x15/(.thsice) results ; update output.txt.thsice
121    
122    checkpoint52m_post
123    o commented out call to cal_GetMonthsRec in swfrac.F and added some comments;
124      this does not change any of the results, because myIter=0 in swfrac always
125      lead to jwtype=2 (the default anyway), but the call makes little sense
126      as a default
127    o no SHORTWAVE HEATING lost at the bottom; affects lab_sea output; updated
128    o re-work pkg/thsice interface with ocean & bulk_force pkg to allow
129      atmospheric model (AIM) to use it ; add a "slab ocean" component.
130    o pkg/aim_v23 : add interface to call thermodynamic sea-ice (thsice)
131    o update global_ocean.cs32x15/output (.thsice) after changes in pkg/thsice
132    o extending useSingleCpuIO option to work with new exch2 I/O format
133      - old-style, missing-tile I/O is still accessible by defining CPP
134        option MISSING_TILE_IO in pkg/mdsio/MDSIO_OPTIONS.h
135    o monitor package can write to NetCDF files and/or STDOUT
136    o fix re-definition bug in MNC_GRID_INIT_ALL()
137    o doc/api_reference added
138      - a framework for building an API Reference Manual using all
139        the "protex" comments embedded in the code
140      - see pkg/generic_advdiff, pkg/mnc for examples
141    o MNC:
142      - make myThid the last argument for all subroutines
143      - new default for the grid files: NO halos
144      - add useMNC and other run-time flags
145      - separate per-file-group handling of the unlimited dimension
146      - early initialization of MNC w/ flags read at the eeboot stage
147        and lookup tables set in initialize_fixed
148      - write all MNC output to a freshly-created directory
149    o thermodynamics sea-ice (thsice) is now tested with testreport.
150    o test exp. advect_cs: use the standard cs32 grid ; update output.
151    o Added functionality to grdchk:
152      pick global i,j,k position (or nearest wet) where to perform check.
153    
154    checkpoint52l_post
155    o new land formulation:
156      a) use ground enthalpy as prognostic variable to ensure exact
157         energy conservation.
158      b) account for water temperature and for latent heat of freezing
159         in all processes (rain, run-off, ground storage)
160      c) compute surface and ground temperature implicitly.
161    o aim_v23 modification for new land model:
162      a) Treat separately land / ocean / sea-ice surface fluxes
163         to allow implicit computation of land & sea-ice surface temp.
164      b) add snow precipitation.
165    checkpoint52l_pre
166    
167    o fix problem (when 1 tile is empty) in min/max monitor.
168    o fix bug in timeAve (u,vZetatave in common block)
169    o no restoring terms under ice for pkg/seaice
170    o moved SEAICE_DO_DIAGS to S/R do_the_model_io
171    o bug fix for pkg/seaice pickups
172    o change MNC call locations and add coordinate attributes
173    o mask vorticity at the corner ; affects global_ocean.cs output
174    o fix ini_curvilinear_grid ; test CS experiments with mpi
175    o aim.5l_cs: modify sea-ice fraction input file ; update output
176    o exf: Adding simple range check routine for exf fields after read
177    
178    checkpoint52k_post
179    o removed top-level directory "diags"
180      - we migrated these functions to pkg/timeave a long time ago
181    o fixed bug introduced in pkg/monitor
182    o accuracy ctrlprec = 32 insuffient for gradient checks using
183      averaged fields (I/O via cost_averages)
184      -> use ctrl.h in active_file*.F to control I/O precision.
185    o paramter list of CALL ADTHE_MAIN_LOOP
186    o added initial do_the_model_io to ecco
187    o set all ...Freq to zero after cost_final
188      taveFreq, dumpFreq, pChkptFreq
189    o MAIN and ECCO differentiability restored
190    
191    checkpoint52j_post
192    o fix nchklev in tamc.h for global_ocean...
193    o Bringing flow and store directives up-to-date
194    o Really weird thing!
195      call do_the_model_io from the_main_loop with parameters
196      starttime, niter0, instead of mytime, myiter, screws up the adjoint:
197      TAF places a faulty re-call of initialise_varia
198      after cost_final call which should not be there!
199    checkpoint52j_pre
200    
201    o tweaked pkg/mdsio/mdsio_readfield.F to have more useful logic and
202      error messages
203    o fix errorMessageUnit problem. remove old version of mdsio from eesup/src
204    o modified pkg/mdsio/mdsio_readfield.F -- commented out diskspace-eating
205      debug output
206    o modfied mdsio_writefield.F to handle non-global files under exch2
207    o update AIM Cubed-Sphere exp (aim.5l_cs):
208      use land, p*, and Franco.M forcing fields with fractional land-sea mask.
209    o update AIM Equatorial Channel exp:
210      use standard aim_v23 pkg and change the SST fields to be more realistic.
211    o globalFile now works with exch2
212    o merged mom_vi_calc_relvort3.F, mom_vi_del2uv.F and
213      mon_vort3.F to make exch2 friendly with >1 tile per cube face
214    o limit timeave output for hi-res integrations
215    
216    checkpoint52i_post
217    o removed CPP_EEOPTIONS.h from verification/*/code
218    o updated the tiling for global_ocean_pressure
219    checkpoint52i_pre
220    
221    o update aim.5l_LatLon using the standard aim_v23 pkg (instead of
222      the old pkg/aim).
223    
224    checkpoint52h_pre
225    o shortened offending lines in exch2_send_rx?.template
226    o modified W2_EXCH2_TOPOLOGY.h to reflect current topology generator
227    o genmake2: add build & execute test for NetCDF code
228    o modded aim.5l_cs and global_ocean.cs32x15 to use exch2, removed
229      old grid files, moved CPP_EEMACROS.h to pkg/exch2
230    o added useSingleCPUIO flag to monitor.F and mon_out.F
231    o added temporary hack for sea-ice dynamics on the cube:
232      metric terms are ignored and it is assumed that
233      there is no sea-ice on cube faces 1, 2, 4, and 5.
234    
235    checkpoint52f_post
236    o added exch2 cube routines to pkg/exch2
237    o modified hs94.cs-32x32x5 to use it
238    o added new grid files to hs94.cs-32x32x5
239    checkpoint52f_pre
240    
241    checkpoint52e_post
242    o first attempt to solve vertical advection (momemtum & T,S) Implicitly
243      for now, only implemented with Lax-Wendroff (tracer) and VectInv (mom)
244    o step.1 : rewrite (as in MultiDimAdvec) explicit tracer stepping (gad_calc_rhs.F)
245      to work with implicit vertical advection and AB ;
246    o Implic. vert. advect. implemented with flux-limiter, c2, u3 and c4 scheme.
247    o update output (gad_calc_rhs.F changes affect truncation error) of exp:
248     front_relax, global_ocean .cs32x15 & _pressure, internal_wave, lab_sea, natl_box
249    checkpoint52e_pre
250    
251    o fix bug in impldiff when Nr=1 or Nr=2.
252    o change the albedo in pkg/thsice (as GISS model); update output_thsice.txt
253    o little changes (fftpack, aim/phy_suflux ...) to pass the "checkbounds" test.
254    o fix deltaTfreesurf in update_cg2d.F (left from c45d_post): affects 2
255      ocean exp. that use NLFS: global_ocean.cs32x15 & global_ocean_pressure
256    o added exf_offset_atemp for Celsius to Kelvin conversion of atemp
257    o eesupp/inc/EEPARAMS.h: MAX_NO_PROCS=1024
258    o pkg/cal/cal_toseconds.F fix for long (>60 years) integrations
259    
260    checkpoint52d_post
261    o re-tiled many expts to allow comparison in multi-processor mode
262      - updated output accordingly
263      - changed hs94.128x64x5 to use intial T from file rather than use the
264        random number generator
265    o add infrastructure in model routines for fizhi and gridalt packages
266    o change global_ocean.cs32x15 because of Pb with GM on CS-grid.
267    o changes to permit hi-res, cubed-sphere, configuration
268      - added useSingleCpuIO capability to mdsio_readfield.F and exf_interp.F
269      - added "#undef ALLOW_USE_MPI" support to eesupp/src/scatter_2d.F
270      - added pkg/exf/exf_set_uv.F for on-the-fly interpolation and rotation
271        of surface winds for the cube
272      (A verification experiment, based on global_ocean.cs32x15, but with
273       pkg/seaice turned on and with on-the-fly interpolation from the NCEP
274       Gaussian grid is described in MITgcm_contrib/high_res_cube/README_ice,
275       complete with example surface forcing files and matlab scripts to look
276       at the output and compare it with that of global_ocean.cs32x15.)
277    o packages pickup: $PKG_write_pickup called from packages_write_pickup ;
278       but call to $PKG_read_pickup remains in $PKG_ini_vars: change CD_code
279       to conform to the common rule.
280    o check-in the first version of the coupler + interfaces for multi-components
281       set-up (Chris's version, adapted to work on cubed-sphere grid); use MPI.
282       - imply modification in eesupp (MPI_COMM_MODEL < MPI_COMM_WORLD).
283       - atmosphere: use pkg aim_v23 ; no sea-ice for now.
284       - ocean and atmos. share the same horizontal grid (no interpolation).
285       - exchanges between component and coupler is done in forward_step
286    o new verification experiment, cpl_aim+ocn:
287       coupled ocean - AIM atmosphere on cs32 grid.
288    
289    checkpoint52d_pre
290    o surface flux time-av diagnostic modified for NLFS & RealFreshWater
291    o add call to AIM pendant S/R in external_forcing & external_fields_load.F
292    
293    checkpoint52c_post
294    o Fixing OPTIONS files for use of exf:
295      - ALLOW_ECCO not needed
296      - ECCO_CPPOPTIONS.h should not be included from
297        EXF_OPTIONS.h/CAL_OPTIONS.h, but from CPP_OPTIONS.h
298        as has been the case in the past
299      - All cal/exf related options are currently set in
300        single header file. Should remain so until we
301        agree on a consistent new policy.
302    o Removed all CPP options for cal package.
303      cal has no more CPP options.
304    o modified STOREs in GAD_ADVECTION
305    o corrected key comp. for passkey
306    
307    checkpoint52b_post
308    o new version: "thsice" of thermodynamic sea-ice pkg:
309     - only 1 call from "forward_step"; conserve energy, fresh-water & salt.
310     - modify fluxes but do not change theta directly;
311     - light cleaning of bulk_force pkg (still needed with thsice).
312     - add forcing fields + data files in global_ocean.cs32x15/inp_thsice
313       + output_thsice.txt to test thsice & bulk_force pkgs.
314    o put back grid & coriolis monitor output.
315    checkpoint52b_pre
316    
317    o call "do_the_model_io" at the beginning (=> dump initial state)
318    o use rhoConstFresh to define convertEmP2rUnit (was done only in ocean-P)
319    o sort out interplay between tamc.h and PTRACERS_OPTIONS.h
320      (need info on NUMBER_OF_PTRACERS)
321    o missing PTRACERS headers in some routines
322    o default tamc.h in pkg/autodiff supposed to crash
323      to ensure proper customization
324    
325    checkpoint52a_post
326    o modifications to make FREEZE (_SURFACE) flux visible to pkg/kpp
327      - moved surfaceTendencyTice from pkg/seaice to main code
328      - subroutine FREEZE_SURFACE now limits only surface temperature
329        and is called in FORWARD_STEP (if allowFreezing=.TRUE.)
330        => new output.txt for global_ocean.cs32x15 & global_with_exf
331      - keep the old version of FREEZE for backward compatibility;
332        global_ocean.90x40x15 left unchanged using useOldFreezing=.TRUE.
333      - corresponding modifs for TAF directives
334    o added surface flux output variables to TIMEAVE_STATVARS
335    o time-averaged output for pkg/ptracers
336    o fix problem with ECCO-related divided adjoint
337      snapshot file was missing some ad-variables,
338      but no warning issued by TAF
339    
340    checkpoint52a_pre
341    o some bug fixes for #undef REAL4_IS_SLOW
342    
343    checkpoint52 = ecco_c52_e35
344    o after testing adjoints of checkpoint51u_post
345    
346    checkpoint51u_post
347    o this is the post-merge tag of the ecco-branch
348      (needs another clean checkout and re-testing)
349    o various natl_box_adjoint configs and results
350      but no input fields
351    o obcs adjoint not yet merged!
352    o adding ECCO global 1x1 and 2x2 degree configs
353    o updated/extended some store directives for seaice
354    o pkg/ecco now containes ecco-specific part of cost function
355    o top level routines the_main_loop, forward_step
356      supersede those in model/src/
357      previous input data.cost now in data.ecco
358      (new namelist ecco_cost_nml)
359    o in ctrl/ cleaned some cross-dependencies and updated CPP options
360    
361    checkpoint51t_post
362    o this is the pre-merge tag of the ecco-branch
363    
364    checkpoint51s_post
365    o cleanup: removed various obsolete #define-s
366    o pkg/grdchk
367      - renamed 'ph-grd 3' to 'grad-res'
368      - merged from ecco-branch
369        (remaining bug fixes for obcs gradient checks)
370      - additional high-precision output for testreport
371        (grep for 'precision_grdchk_result')
372    
373    checkpoint51r_post
374    o cleaned up or removed CPP_OPTIONS.h files
375    o updated results for some of the tests to reflect the new
376      optfiles (-ieee: -O0 instead of -O3)
377    
378    checkpoint51q_post
379    o cd_code:
380      - moved cd_scheme.F -> cd_code_scheme.F
381      - separate read_checkpoint from cd_code_ini_vars.F
382      - separated cd_code part from write_checkpoint
383      - updated AD_SOURCE, generated .flow
384      - added CD_CODE_VARS.h to the_main_loop
385      - Moving cd_code specific store dir.s to pkg/cd_code
386    o ctrl package totally restructured
387      - pack/unpack now optional and decoupled from
388        xx_/adxx_ I/O
389      - ctrl_pack/unpack cleaned
390        (new routines ctrl_init_ctrlvar.F, pkg/ctrl/ctrl_init_wet.F)
391      - confined inclusion of AD_CONFIG.h to where necessary.
392    o genmake2: changed AD dependencies from SRCFILES to AD_FILES
393    
394    checkpoint51p_post
395    o create initial cd_code package
396      - WARNING: the initialization of fields within packages
397        is broken because INI_FIELDS (where READ_CHECKPOINT is
398        called) is called *before* PACKAGES_INIT_VARIABLES.
399        This seems to be backwards since
400        1) its important to initially zero the entire field including
401           the "halo" region
402        2) zeroing needs to be done *before* reading pickup info
403           and the pickup call might or might not happen in any
404           particular run
405      - this needs an overhaul for R2
406    o cleanup verification/*/code/GMREDI_OPTIONS.h
407    o cleanup testreport
408    
409    checkpoint51o_post
410    o bringing AD-related verif's up to date with genmake2
411      - carbon/
412      - global_ocean.90x40x15/
413      - hs.94.1x64x5/
414      - (front_relax/ )
415    o (more) consistent directory structure for AD-related verif.'s
416    o cleaning ALLOW_GRADIENT_CHECK -> ALLOW_GRDCHK
417    o cleaning some ALLOW_TANGENTLINEAR_RUN -> ALLOW_AUTODIFF
418    o bug fix in find_alpha.F for MDJWF:
419      - modif. to alpha = 1/D*( dN/dT - rho*dD/Dt) to account for
420        change rho -> rho-rhoConst
421      - replace call find_rho to find_rhonum
422    o initialisation of rFlx extended to full array (required by TAF)
423      and shifted to thermodynamics
424    o removed PTRACERS.h in ptracers routine
425    o added surfacetendencyPtr to S/R parameter list pracers_forcing
426    o Correcting initialisations for fVerU, fVerV.
427    o helping TAF to recognize dependency on kUp for
428      fVerU, fVerV
429    o Replacing delZ by delR in pkg/ctrl/
430    checkpoint51o_pre
431    
432    o undid all of cp51 pending some cleanups and discussion
433    o added the [#include "AD_CONFIG.h"] statement to all files that need
434       it for adjoint/tl #defines
435     o re-worked the build logic in genmake2 to support AD_CONFIG.h
436     o removed tools/genmake since it no longer works
437    
438    checkpoint51n_post
439    o modifications to make FREEZE flux visible to pkg/kpp
440      - moved surfaceTendencyTice from pkg/seaice to main code
441      - FREEZE & EXTERNAL_FORCING_SURF moved to FORWARD_STEP
442      - subroutine FREEZE now limits only surface temperature
443        (this means new output.txt for global_ocean.90x40x15,
444         global_ocean.cs32x15, and global_with_exf)
445    o added surface flux output variables to TIMEAVE_STATVARS
446    
447    checkpoint51n_pre
448  o added "#undef ALLOW_USE_MPI" support to eesupp/src/gather_2d.F  o added "#undef ALLOW_USE_MPI" support to eesupp/src/gather_2d.F
449    o added [#include "AD_CONFIG.h"] to all files that use the following
450      defines:
451      - ALLOW_ADJOINT_RUN
452      - ALLOW_TANGENTLINEAR_RUN
453      - ALLOW_ECCO_OPTIMIZATION
454    
455  checkpoint51m_post  checkpoint51m_post
456  o incorporating changes to get TAMC/TAF working in genmake2  o incorporating changes to get TAMC/TAF working in genmake2

Legend:
Removed from v.1.192  
changed lines
  Added in v.1.308

  ViewVC Help
Powered by ViewVC 1.1.22