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

Legend:
Removed from v.1.15  
changed lines
  Added in v.1.53.2.18

  ViewVC Help
Powered by ViewVC 1.1.22