/[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.24 by adcroft, Wed Mar 15 16:17:17 2000 UTC revision 1.53.2.29 by dimitri, Sat Feb 15 14:22:39 2003 UTC
# Line 3  $Header$ Line 3  $Header$
3      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
4      ==============================      ==============================
5    
6    untagged
7    o Added missing /* */ to CPP comments in pkg/seaice, pkg/exf,
8      kpp_transport_t.F, forward_step.F, and the_main_loop.F
9    o pkg/seaice:
10      - adjoint-friendly modifications
11    
12    release1_p12_pre
13    o Updated useSingleCpuIO option in mdsio_writefield.F to
14      work with multi-field files, e.g., for single-file pickup.
15    o pkg/seaice:
16      - bug fix in growth.F: QNET for no shortwave case
17      - added HeffFile for specifying initial sea-ice thickness
18      - changed SEAICE_EXTERNAL_FLUXES wind stress implementation
19    
20    release1_p11
21    o Modifications for using pkg/exf with pkg/seaice
22      - improved description of the various forcing configurations
23      - added basic radiation bulk formulae to pkg/exf
24      - units/sign fix for evap computation in exf_getffields.F
25      - updated verification/global_with_exf/results/output.txt
26    o Added pkg/sbo for computing IERS Special Bureau for the Oceans
27      (SBO) core products, including oceanic mass, center-of-mass,
28      angular, and bottom pressure (see pkg/sbo/README.sbo).
29    o Lower bound for viscosity/diffusivity in pkg/kpp/kpp_routines.F
30      to avoid negative values in shallow regions.
31      - updated verification/natl_box/results/output.txt
32      - updated verification/lab_sea/results/output.txt
33    o MPI gather, scatter: eesupp/src/gather_2d.F and scatter_2d.F
34    o Added useSingleCpuIO option (see PARAMS.h).
35    
36    release1_p10
37    o modifications for using pkg/exf with pkg/seaice
38      - pkg/seaice CPP options SEAICE_EXTERNAL_FORCING
39        and SEAICE_EXTERNAL_FLUXES
40      - pkg/exf CPP options EXF_READ_EVAP and
41        EXF_NO_BULK_COMPUTATIONS
42      - usage examples are Experiments 8 and 9 in
43        verification/lab_sea/README
44      - verification/lab_sea default experiment now uses
45        pkg/gmredi, pkg/kpp, pkg/seaice, and pkg/exf
46    
47    release1_p9
48    o pkg/seaice
49      - removed GOTO's and added taf directives
50      - double precision constants to reduce the g77 (Linux)
51        to F77 (SGI) differences reported in release1_p8
52    o tools/genmake
53      - added SGI options
54    o verification/testscript
55      - updated to that of checkpoint47a_post
56    o verification/global_ocean.90x40x15/input/eedata
57      - modified for SGI f77 compatibility
58    o verification/lab_sea
59      - added description of sea-ice model
60      - added missing matlab routines
61      - added test of thermodynamics parallelization
62    
63    release1_p8
64    o verification/natl_box:
65      updating new external_fields_load routine
66    o New package: pkg/seaice
67      Sea ice model by D. Menemenlis (JPL) and Jinlun Zhang (Seattle).
68      The sea-ice code is based on Hibler (1979-1980).
69      Two sea-ice dynamic solvers, ADI and LSR, are included.
70      In addition to computing prognostic sea-ice variables and diagnosing
71      the forcing/external data fields that drive the ocean model,
72      SEAICE_MODEL also sets theta to the freezing point under sea-ice.
73      The implied surface heat flux is then stored in variable
74      surfaceTendencyTice, which is needed by KPP package (kpp_calc.F and
75      kpp_transport_t.F) to diagnose surface buoyancy fluxes and for the
76      non-local transport term.  Because this call precedes model
77      thermodynamics, temperature under sea-ice may not be "exactly" at
78      the freezing point by the time theta is dumped or time-averaged.
79      N.B.: fairly large differences in accuracy occur across
80            different platforms/compilers; comparison between
81            g77 (Linux) and F77 (SGI Origin 2000/MIPSpro)
82            generated output gives:
83       T           S           U           V
84      C D M    c        m  s        m  s        m  s        m  s
85      n p a R  g  m  m  e  .  m  m  e  .  m  m  e  .  m  m  e  .
86      f n k u  2  i  a  a  d  i  a  a  d  i  a  a  d  i  a  a  d
87      g d e n  d  n  x  n  .  n  x  n  .  n  x  n  .  n  x  n  .
88    
89      Y Y Y Y  5  5  7  7  7  8 10  9  6  6  6  6  7  5  7  5  7 FAIL  lab_sea
90    
91    release1_p7
92    o GAD:
93      - generated new common blocks to account for call of
94        same gad routines with differing traceridentities
95        (needed to modify tracerIdentity indices in GAD.h)
96      - generated separate common blocks for case useCubedSphereExchange
97        (Department of Futurology)
98      - parameter lists to gmredi_?transport: added tracerIdentity
99      - added new key indices to tamc.h
100    o external_fields_load:
101      - added this routine to TAF list
102      - needed to make some common blocks global and additional storing
103        along the same lines as exf package (checkpoint_lev?_directives.h)
104    o exf:
105      updated external forcing package
106      - bug fixes carried over from ecco-branch
107        (missing OBCS_OPTIONS.h in two routines)
108      - enable easy to use "no forcing".
109      - added exf I/O for atmospheric loading
110      - added exf I/O for runoff data
111      - transfered scaling between exf <-> MITgcm to exf namelist
112    o Adding new verification experiment global_with_exf.
113      This verification experiment is almost identical to the
114      global_ocean.90x40x15 experiment, except that it uses
115      the exf (and cal) package instead of the
116      external_fields_load routine (cf README file).
117    
118    release1_p6
119    o fixed the verification/global_ocean.90x40x15 experiment:
120     - new bathymetry (the world according to A., JMC, and M.)
121     - new initial fields and forcing fields (*.bin files)
122     - new POLY3.COEFFS (for the next release one should switch to a full
123       equation of state)
124     - fixed several errors and redundancies in the data file
125     - experiment uses looped cells
126     - added matlab directory with diagnostic scripts for plotting of output
127    
128    release1_p5
129    o import recent fix from MAIN branch:
130      - use recip_dx*,recip_dy* instead of /dx*,/dy* in orlanski_E,W,N,S
131      - change phiMin in exp1 (to agree with documentation)
132     from checkpoint45 to checkpoint45a_post:
133      - specific exchange for X-slice domain (case Ny=1)
134      - argument futureIter of S/R obcs_calc missing in
135        exp4 & internal_wave /code
136      - solve_for_pressure : set cg2d_x to zero where OBCS are applied
137     from checkpoint44f_post to checkpoint44g_post:
138      - fix surface correction term in multiDimAdvection
139        (affects plume_on_slope results
140    o bug fix in packages_readparms (missing ALLOW_CALENDAR)
141    o bug fix in CG2D.h (correct array size for LETS_MAKE_JAM
142    o Adjoint-related bug fixes in kpp:
143      - kpp_calc: sore of kpphbl avoids recomputation/call to S/R kppmix
144      - kpp_routines: store of Rib avoids partial recomputation bug of TAF.
145    o added Eliassen-Palm flux hooks (dynamics,ini_fields)
146    o removed unused TAF keys iikey, idkey (dynamics,thermodynamics)
147    o flow directives:
148      - new for S/R do_the_model_io
149      - enhanced for S/R checkpoint
150    o added Eliassen Palm flux controls to gradient check package
151    o new ctrl package
152      - adopted from ECCO environment to enable optimization
153      - added Eliassen Palm fluxes to controls
154      - adjusted global_ocean.90x40x15/ and carbon/ accordingly
155    
156    release1_p4
157    o Removed f90 comments ("!")
158    o Modified initialisations to enable exf package for MITgcm
159      (without invoking ECCO_PACKAGE).
160    o modifications to gradient check package (Martin Losch)
161      - enable centered differences
162      - modified format of standard output
163    
164    release1_p3
165    o added tangent linear setup to verification/carbon/
166    o added adjoint sensitivity setup to verification/global_ocean...
167    o moved packages_init_variables before convective_adjustment
168    o output of verif. which use GMRedi brought up-to-date with
169      MAIN trunk (those were re-created after changes in GMRedi)
170    o included CPP option SINGLE_LAYER_MODE
171      to configure barotropic setup (Martin Losch).
172    o Removed auxiliary variable in impldiff
173      (caused numerical differences with MAIN trunk routine).
174    o Introduced CPP option ALLOW_AUTODIFF_MONITOR to
175      disable adcommon.h/g_common.h by default.
176    o Cleaned exchange calls in cg2d.
177    
178    release1_p2
179    o fixed array boundary problem for adjoint
180      (related to partial recomputation within subroutine
181      related to dynamics -> calc_viscosity -> mom_...
182    o fixed recomputation in thermodynamics
183    o prepare (but not complete) recomputation problem in impldiff
184    o fixed problem for adjoint of global_max
185    o switched off sponge layer code in external_forcing
186    
187    release1_p1
188    o merged necessary patches:
189      - AD-related changes for GMRedi
190      - fixes i KPP (delZ -> drF)
191      - hook to OBCS songe layer code in external_forcing
192      - errorMessageUnit non-zero in eeboot.F
193      - modified test cost function and carbon verif.
194    
195    release1_chkpt44d_post = chkpt44d_post
196    
197    chkpt44d_pre,post
198    o added missing EXCLUDE_MONITOR flags
199    o changed "e" to "_d" in gmredi_slope_limit, gmredi_slope_psi
200      (incompatible typ in MIN/MAX expressions caused problems
201      on IBM SP3)
202    o in genmake added variable MAKEDEPEND
203      plus resetting for case SunOS
204    o added timer_stats.c routine for IBM SP3
205    o removed variables in dynamics
206    
207    o real fresh water flux implemented with non-linear free-surface.
208    
209    chkpt44c_pre,post
210    o few fix (mask in shap_s2, EmPmR in external_field_load,
211      USE_NATURAL_BCS in solve_for_P);
212    o add arguments myIter & myTime to S/R obcs_calc & solve_for_P
213    
214    checkpoint44b_pre/_post
215    o merge of relevant stuff from the ecco-branch:
216      - genmake: removed $S64 overwrite for case SunOS
217      - pkg/exf: update and corrections for field swapping and obcs
218      - pkg/ecco: parameter lists for the_model_main, the_main_loop
219                  harmonized between ECCO and MITgcm
220      - pkg/autodiff: added flow directives for obcs, mdsio_gl_slice
221                      updated checkpointing_lev... lists for obcs
222      - model/src: minor changes in forward_step, plot_field
223                   added directive for divided adjoint in the_main_loop
224      - pkg/mdsio: added mdsio_gl_slice
225    
226    o check parameters & config (chkpt44a_pre,post)
227    o OBC and NonLin_FrSurf.
228    
229    checkpoint44
230    o fix bug in mom_vi_del2uv
231    o select when filters are applied ; add options to zonal_filter (data.zonfilt)
232    o gmredi: fix Pb in the adiabatic form ; add options (.e.g. Bolus advection)
233    o update AIM experiments (NCEP input files)
234    o improve and extend diagnostics (Monitor, TimeAve with NonLin-FrSurf)
235    o added some stuff for AD
236    
237    checkpoint43
238    o added two new advection tests
239    o added global 4x4 degree ocean test
240    o added test of H&S94 with free surface on cube
241    o some final mods for gradient check, adjoint,...
242    
243    checkpoint42
244      Fixed AD-related problems:
245    o Store directives up-to-date with re-arranged Adams-Bashforth
246      (mainly thermodynamics.F)
247    o New store directives for multi-dim. advection schemes
248      * new CPP flag ALLOW_MULTI_DIM_ADVECTION
249      * new common block and key passkey
250      (mainly gad_advection.F)
251    o Modified store directives for split of dynamics/thermodynamics
252      for the case ALLOW_KPP
253    o Cleaned argument list for timestep_tracer.F
254    
255    checkpoint41
256    o re-formatted/added comments in prologues of key subroutines
257      to work with protex
258    
259    checkpoint40
260    o moved calc_gs, calc_gt and calc_tr1 back to model/src
261    o added FLT (floats) package from Arne along with demo. experiment
262    o re-arranged Adams-Bashforth scheme for tracers to allow easier
263      implementation of forward-in-time forcing terms
264    o more mods for non-linear free-surface including new variable
265    o modified multi-dim method to work on cube
266    o bug fix in KPP (from DM)
267    
268    checkpoint40pre9
269    o added DST advection schemes
270    o fix MPI bug on SGI's
271    o modifications for non-linear free-surface
272    o fixed conditionals for fixed flow/passive tracer only mode
273    o added tension/strain form of stress tensor
274    o changes to commenting of arguments for TAF/TAMC
275    o added/updated many matlab scripts
276    o added multi-dimensional advection method for tracers
277      
278    checkpoint40pre8
279    o new package rw/
280      Added method for dumping intermediate local arrays:
281      mdsio_writetile - same as mdsio_writefield except works from inside
282                        bi,bj loop
283      mdsio_writelocal - same as mdsio_writetile except works for local
284                         arrays
285      write_local_r? - higher-level wrapper for mdsio_writelocal
286      Controlled by diagFreq. Defaults to zero (ie. no dumps)
287      Example given at end of mom_vecinv.F that dumps some local arrays.
288    o replaced calc_mom_rhs.F by mom_fluxform.F/mom_vecinc.F to
289      control flux-form versus vector invariant code.
290      Switch is runtime flag vectorInvariantMomentum (defaults to false)
291      or genmake -DISABLE ...
292    o TAMC-related update to cope with mom_fluxform.F/mom_vecinc.F
293      (additional storing is now needed for case vecinv;
294      currently nothing implemented to switch this storing off
295      in case fluxform is used since no CPP flag available).
296    
297    checkpoint40pre7
298    o bug fix in dynamics.F
299      calc_viscosity called before k=1,Nr loop.
300    o added some #ifdef's ALLOW_PASSIVE_TRACER
301    o cleaned initialisations in ctrl_map_ini
302      related to TAF
303    
304    checkpoint40pre6
305    o split dynamics into thermodynamics & dynamics
306    o corresponding split of calc_diffusivity into
307      calc_diffusivity, calc_viscosity
308      (kpp_calc_diff, kpp_calc_visc).
309    o Added diffkr, kapgm to control variables
310    o bug fix in gmredi_slope_limit for ldd97
311    
312    checkpoint40pre5
313    o proper initialization of Adams-Bashforth time stepping
314      + uses forward step for very first step of model (iter=0)
315    o re-generated *all* output since almost all output is modified by this
316      change (sorry but we've been putting this one off for about 2 years)
317      + natl_box, aim.5l_Equatorial_Channel and aim.5l_zon-ave were
318        *not* regenerated since they are already out of date and I don't
319        want to create the impression that they are suddenly working.
320    o removed KAP stuff for DEC's
321    o modified/added many .cvsignore files in */code and */input
322    o added new expt "solid-body.cs-32x32x1"
323      + this uses an alternative form of ini_curvilinear_grid.F which
324        is not necessarily any better than the current one...
325    
326    checkpoint40pre4
327    o added re-initialisations of utrans,vtrans,rtrans in
328      calc_common_factors which are crucial for TAF.
329    o extended iMin,jMin range for calc_common_factors,
330      calc_diffusivity
331    o added option ALLOW_PASSIVE_TRACER
332    o a few minor updates and fixes
333    
334    checkpoint40pre3
335    o created calc_gtr1.F for gad package
336    o split the_main_loop and re-introduced forward_step
337    o some recomputations of nIter0 for TAMC
338    
339    checkpoint40pre2
340    o Updated to latest branch of AJA, JMC
341    o Added gradient check package
342    o Added routines for passive tracer handling
343    o Added carbon sequestration sensitivity experiment
344    
345    checkpoint39
346     o Modifications and fixes to support TAMC
347       (mainly missing or wrong directives)
348     o Corrected common blocks when fooling TAMC to produce adjoint I/O
349       in addummy_in_stepping
350     o Updated verification/vero/ (bug fixes in code/, correct pickups in input/)
351     o Enabled "sliced" (xz-,yz-) exchanges, needed for obcs.
352     o Included following packages:
353       cal: calendar
354       exf: external forcing
355       ecco: essential routines to control use of cal, exf
356             (NB: this is not the full ECCO environment)
357     o disabled some packages by default in genmake
358    
359    checkpoint38
360     o see notes_c37_adj.txt
361     o corrected wrong layer index in external_forcing_t
362     o replaced the_main_loop/forward_step by the_main_loop
363     o removed forceoutput from write_state
364       (replaced criteria for initial/final state)
365     o added runtime flag for pre-C35 pickups: usePickupBeforeC35
366    
367    checkpoint37
368     o mdsio.F routine split and packaged in pkg/mdsio
369       (mdsio.F and mdsio_gl.F still exist in eesupp/src but are not
370        used unless genmake -disable=mdsio)
371     o allow a more precise surface-geopotential gradient for the atmosphere
372       taking into account the change in space of Alpha (=1/rho) at the surface.
373     o variable "etaN" (replace cg2d_x) is the surface R-anomaly [r unit]
374       (ocean: sea surface height [m] / atmos: surface pressure anomaly [Pa])
375     o Change units: Phi_Hydrostatic (=phiHyd), Phi_Surface(=cg2d_x) and
376       Phi_NonHydrostatic (=cg3d_x), all have now the dimension of a potential
377       [m2/s2] (pressure/rhoConst in the ocean ; Geo-Potential in the atmosphere).
378     o Time-Average diagnostics defined as a pseudo package "timeave".
379     o pickup files : old pickup (before c35) did not work with new code (c35
380       and after) unless activating 2 commented lines in initialise-varia.
381     o Non-Hydrostatic pickup file Pb fixed.
382     o bug with Rigid-lid version (since c35) fixed.  
383    
384    checkpoint36
385     o implement Crank-Nickelson barotropic time-stepping
386     o recover Time-Average diagnostics
387     o fix Pb in checkpoint (PR#19)
388     o AIM become a standard package ; clean unused CPP_kees
389    
390    checkpoint35
391     o subtantial rewrite of dynamics.f
392     o allows staggered time-stepping
393     o packaged obcs, aim (Atmospheric Physics), zonal_filt, shap_filt
394     o added bottom drag (linear + quadratic)
395    
396    checkpoint34
397     o Modified exchange routines for correct reverse simulation.
398     o Added verification output to comply with bug fix in impldiff.F
399       as of c33 (exp2, natl_box).
400     o Corrected store directives in dynamics.F
401     o Corrected array boundaries in impldiff.F
402     o Corrected array dimensions in gmredi.
403       Added temporary scalars to avoid storage by TAMC (gmredi, kpp).
404     o Added routine GLOBAL_SUM_INT to global_sum.F
405     o Added mdsio_gl.F for ECCO purposes.
406    
407    checkpoint33
408     o Fixed bug in lower BC in impldiff.F
409     o Fixed confusion about units of forcing arrays in FFIELDS.h
410       namely Fu,Fv,Qnet,Qsw,EmPmR:
411       - Removed verification/natl_box/code/external_fields_scale.F
412         (did not differ from that in model/src)
413       - Changed units of fu,fv,Qnet,Qsw,EmPmR back to proper units
414         (see FFIELDS.h for description)
415       - Scale fu,fv,Qnet,Qsw,EmPmR when used in external_forcing_surf.F,
416         kpp_calc.F and kpp_transport_t.F
417       - Removed model/src/external_fields_scale.F and calls to it
418       - verification/natl_box uses flux data with "atmospheric" sign so
419         a special version of external_fields_load.F is used to
420         change the data as it's read in. This way, the arrays
421         have the right units and signs at all times tha a user could
422         possibly use them.
423     o Corrected genmake to delete a temporary file during configuration
424    
425    checkpoint32
426     o Scaling of forcing fields moved from external_forcing.F to
427       external_fields_scale.F, called directly after loading fields.
428     o Surface relaxation terms added to surface tendency fields in
429       extra subroutine.
430     o impldiff.F changed to avoid storing by TAMC of huge intermediate
431       fields.
432     o Changes in GMRedi to comply with packaging structure.
433     o Modifications and bug fixes in KPP package.
434     o Verification experiment for KPP added (verification/nat_box/)
435    
436    checkpoint31
437     o Packages interface brought in line with defined standard
438       -> new routines packages_...F
439       -> changes in initialise_fixed.F, initialise_varia.F
440       -> enables initialisation interface for ECCO package
441     o Rescaling of external forcing fields immediately after read
442       (removed from external_forcing.F)
443       -> new: surface_fields_scale.F
444       -> affects ini_foorcing.F, external_fields_load.F
445     o Computation of surface tendencies before tendency updates.
446       -> new: external_forcing_surf.F
447     o Change of variable names useGMRedi, useKPP, useECCO
448     o Further changes in dynamics.F, impldiff.F for TAMC
449     o Tested for experiments 0, 2, 4.
450       - not yet tested for GMRedi.
451       - not yet tested for KPP.
452    
453    checkpoint30
454     o Updates for OBCs
455     o New experiment for test OBCs (internal_wave)
456     o New output.txt in verification/exp4/results/
457     o Updates for KPP: calculation of viscosity corrected, new variables
458       kpp_dumpFreq and kpp_taveFreq
459     o CPP'd calls to system routines for TARGET_CRAY_VECTOR (P.H.)
460       and entry for T90 in genmake
461    
462    checkpoint29
463     o packaged KPP and GM/Redi
464    
465    checkpoint28
466     o Corrected initialization of hFacMin for difference vertical coordinates
467     o Modified calculation of partial cell thickness to more robust algorithm
468     o config_summary.F: replaced write_1D_... by write_0D_...
469       read_write.F: added subroutines write_0D_...
470     o routines calc_common_factors, calc_gs, calc_gt, calc_phi_hyd, find_rho:
471       included some initialisations required for TAMC.
472     o routine calc_isoslopes: modified sqrt computation to make it
473       differentiable for zero argument.
474     o routines dynamics, impldiff:
475       included store directives and tape key computations required for TAMC.
476     o ALL TAMC related changes are between ifdef ALLOW_AUTODIFF_TAMC
477    
478    checkpoint27
479     o fixed calc_isoslopes() to so that cancellation of terms in tensor
480       formulation works properly with variable resolution.
481     o restructured the calling tree between the_model_main() and dynamics()
482     o split initialise() into initialise_fixed() and initialise_varia()
483     o introduced initialization file pSurfInitFile for free surface (cg2d_x)
484       in new routine ini_psurf()
485    
486    checkpoint26
487     o moved some #ifdef in optional routines to encompass everything
488       except the argument declarations. This was using up some memory.
489     o fixed macros like _ADT to work with both versions of Linux cpp
490     o cleaned up some unused and uninitialized variables
491       (helps when debugging with strict compile options)
492     o split up CPP_EEOPTIONS.h into options and macros
493       (macros are now in eesupp/inc/CPP_EEMACROS.h)
494     o patch for 2 processor JAM mode
495    
496  checkpoint25  checkpoint25
497   o updates for OBCs and NH   o updates for OBCs and NH
498   o dramatically reduced memory usage   o dramatically reduced memory usage

Legend:
Removed from v.1.24  
changed lines
  Added in v.1.53.2.29

  ViewVC Help
Powered by ViewVC 1.1.22