/[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.38 by heimbach, Tue Apr 10 22:35:24 2001 UTC revision 1.53.4.46 by heimbach, Fri Jun 20 22:36:51 2003 UTC
# Line 2  $Header$ Line 2  $Header$
2    
3      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
4      ==============================      ==============================
5    
6    ecco_c50_e33
7    o minor changes to pkg/seaice pkg/cost/cost_ice.F
8      and verification/natl_box_adjoint/README
9    o Modif's to enable tangent linear run in ECCO environment
10      including time-dependent forcing
11      * main problem is missing call mdsreadfield out of exf_set_gen
12        (i.e. computation of trajectory in TLM mode)
13      * incorrect g_active_write_...
14      * (re-) init of bar files and g_bar files
15    o Reverted back to 3-dim. tbar, sbar for SST, SSS bar files.
16    o MERGES:
17      * obcs/ ctrl/ G. Gebbie code
18        (major changes in ctrl handling, volume flux balancing etc.)
19      * cost/ ctrl/ A. Koehl code
20        - new cost contributions (new data types)
21        - efficient pack/unpack for time-dependent 2-d fields
22    o replaced mutiple ctrl_get... by single generic ctrl_get_gen.F
23      (except obcs)
24    o somewhat cleaned package initialisation sequence for
25      ctrl/ cost/ ecco/
26    o extended grdchk to enable obcs gradient checks
27    o some generalizations for easier TLM <-> ADM switches
28    o added configuration example for parallel divided adjoint
29      (see verification/natl_box_adjoint/code_diva_mpi/README )
30    
31    ecco_c50_e32
32    o Patrick's adjoint-model storage directives for pkg/seaice
33    o merged with checkpoint50g_post (pkg/seaice and verification/lab_sea)
34      - added SEAICE_MULTILEVEL for 8-category sea-ice thermodynamics
35      - LSR sea-ice dynamic solver moved to SouthWest B-grid location and
36        made the default because of faster convergence than ADI
37    o Modifications for adjoint of SEAICE_ALLOW_DYNAMICS
38      - extended state in checkpoint_lev...
39      - in lsr.F, replaced GO TO by fixed loop index (also avoid DO WHILE)
40      - YEAH: in lsr.F, (first) successful use of CADJ LOOP = ITERATION
41      - avoid stoing in S/R budget for now
42      - in dynsolver.F, avoid NPSEUDO loop for adjoint
43      - new comlev1_lsr in the_main_loop
44    o Small modif's in lsopt/, optim/ to ease compilation
45      New script to run optim (lsopt)
46    
47    ecco_c50_e31
48    o exf totally restructured
49      - replaced all exf_set_ routines by one generic exf_set_gen.F
50        and made sure it's still differentiable
51      - split exf_getffields.F into new exf_bulkformulae.F
52      - exf_inscal_/exf_outscal_ suffixes consistent with field names
53    o New cost function: Tini-Tfin to do model spinup optimization.
54    o Started new verification exp for Tini-Tfin optimization.
55    
56    ecco_c50_e30
57    o corrected CPP option mismatch in exf_Bulk... functions for case
58      #define ALLOW_ATM_WIND && #undef ALLOW_ATM_TEMP
59    o Merging from release1_p13 and from icebear5
60      - bug fix for pkg/seaice dynamic solver
61      - Added SEAICE_initialHEFF to pkg/seaice
62      - Additional options for pkg/cost/cost_ice.F
63      - Updates to verification/natl_box_adjoint
64      - pkg/ctrl/ctrl_init.F
65        Fix for determination of startrec and endrec.
66      - pkg/cal/cal_toseconds.F
67        Fix for negative intervals shorter than 1 day.
68    
69    ecco_c50_e29
70    Bug fix for merging between c50 and KPP.
71    ikey was passed from thermodynamics to kpp_calc via
72    common block rather than being recomputed in kpp_calc,
73    in contradiction with new key itdkey.
74    New key ikppkey created, and tamc.h headers updated.
75    
76    ecco_c50_e28
77    o major merge:
78      ecco-branch merged with checkpoint50
79      gmredi now available, grdchk, DIVA up-to-date for MPI
80      However, two outstanding problems:
81      - kpp adjoint is broken, needs fixing!
82      - a few minor modif's in handling of CPP option
83        ALLOW_TANGENTLINEAR_RUN in conjunction with
84        ALLOW_ECCO_OPTIMIZATION are necessary to enable
85        TLM runs with ECCO setup
86    
87    ecco_c44_e27
88    o exf:
89      - Enable initialisation of forcing fields to constant
90        (runtime) values.
91      - in exf_getffields.F
92        Reduce i-/j-loop to interior domain, discarding overlaps.
93        That also fixes wrong TAF-key computations for key_1, key_2
94        with bulf formulae.
95      - exf_init.F modify #ifdef for exf_init_evap
96      - exf_getffieldrec.F, ctrl_getrec.F
97        The following INT-usages are not safe:
98          fldsecs  = int(fldsecs/fldperiod)*fldperiod
99          fldcount = int(fldsecs/fldperiod) + 1
100        and were modified.
101      - added repeatPeriod (from MAIN branch)
102    o grdchk: updated and merged
103      - has both ADM and TLM checks
104      - works for single- and multi-proc.
105      - output cleaned
106      - worked successfully for parallel DIVA
107      Needed one update in EEPARAMS.h and updates in ctrl package
108      More modif's may be necessary for ECCO code to support TLM.
109    o autodiff: checkpoint_lev...
110      - updated storing for bulk formulae (some arrays were missing)
111      - added state for seaice package
112      - synchronized with main branch
113    o DIVA:
114      Modif.s in
115      - cost_init.F
116      - cost_averagesfields.F
117      - ecco_the_main_loop.F
118      - ecco_the_model_main.F
119      and added cost_final_restore.F cost_final_store.F
120      o With these changes, it is possible to fully separate
121        the first forward run to compute the cost function (mdthe_main_loop)
122        and adjoint runs over individual DIVA intervals (adthe_main_loop)
123        into separate model executions.
124        This enables better tuning of DIVA to given queue sizes.
125      o Loss of cost function value in consecutive DIVA runs is
126        fixed by storing to 'costfinal' file.
127      o Appropriate call of ctrl_unpack/_pack,grdchk_main at
128        beginning/end of adjoint integration is accounted for.
129      The current changes apply to TAF-1.4.26.
130      TAF has one remaining bug, requiring one manual change
131      (see MITgcm manual).
132    o bug fix plus modif for ubar, vbar in cost_averagesfields
133    o cal: synchronized between MAIN and ecco-branch
134    
135    icebear4
136    o Added cost_ice for sea-ice volume sensitivity experiment.
137    o ecco_the_model_main.F: SEAICE_WRITE_PICKUP must precede WRITE_CHECKPOINT
138    o Reduced derivative singularities in pkg/seaice.
139    o Updated verification/natl_box_adjoint
140    
141    icebear3
142    o Removed spurious iikey and idkey
143    o pkg/exf
144      - bug fix in treatment of downward radiation
145    o pkg/seaice
146      - added initial sea-ice thickness parameter SEAICE_initialHEFF
147    o updated verification/natl_box_adjoint
148    
149    icebear2
150    o Added missing /* */ to CPP comments in pkg/seaice, pkg/exf,
151      kpp_transport_t.F,and ecco_the_main_loop.F
152    o adjoint-friendly modifications to pkg/seaice
153    o added verification/lab_sea as per release1_p12_pre
154    
155    ecco_c44_e26
156    o Merging pkg/exf and pkg/seaice from cvs tag ecco_ice2
157    o exf: Modifications to correctly handle evap field for adjoint
158    o grdchk:
159      Added code to perform gradient checks for bulk formulae/atmos. state
160      (atemp, aqh, uwind, vwind).
161      NOTE:
162      This package is out of synch with c48 package.
163      The latter also has the tangent linear gradient checks.
164      Need to be merged.
165    o verification/natl_box_adjoint:
166      * added new setup: code_bulk/, input_bulk, results_bulk
167        (Experiment 2, described in README)
168        uses bulk formulae and atmos. state as control instead of
169        air-sea fluxes.
170        Performs gradient checks for first 4 elements of atemp control.
171      * changed standard verification to perform
172        gradient checks on first 4 elements on hflux control.
173      * gmredi switched off (will come after merge with c48).
174    
175    ecco_c44_e25
176    o Merging some GM changes from main trunk (c47) to ecco-branch.
177    o Updating verif. natl_box_adjoint with GMRedi.
178    o Adding setup with explicit differentiaton of pressure solver.
179    o Bug fix: missing OBCS_OPTIONS.h for sponge layer code.
180    o (Re-?) Commiting old bug fixes in kpp to ecco-branch
181      (kpp_calc.F, kpp_routines.F)
182    o exf:
183      updated external forcing package
184      - cleaned old exfa stuff
185      - bug fixes
186        (missing OBCS_OPTIONS.h in two routines)
187      - enable easy to use "no forcing".
188      - added exf I/O for atmospheric loading
189      - added exf I/O for runoff data
190      - transfered scaling between exf <-> MITgcm to exf namelist
191    
192    ecco_c44_e24
193    o modifications to gradient check package (Martin Losch)
194      - enable centered differences
195      - modified format of standard output
196    o bug fix for nwettile contents
197      so far assumed global sum  in first entry (1,1,k),
198      needed for global control vector
199      -> introduced new variable nwet[c/w/s]global(nr)
200    o shifts of calls to cal/exf package to be accessible
201      in MITgcm stand-alone
202    o shifted packages_init_variables before convective_adjustment_ini
203      (corresponding update of TAF tape initialisation).
204    o removed auxiliary field in impldiff
205      (caused numerical differences for GMRedi cases)
206    o updated obcs control part (G. Gebbie)
207    o removed some f90 comments ("!")
208    o Bug fixes and updates in cost package
209     * cost_final: correct multiplier mult_tauv, mult_sflux
210     * cost_hyd: added call cost_ssh
211     * cost_init_barfiles.F: replaced arrays by tmpfld's
212     * cost_readtopexmean.F: ersmask -> tpmeanmask
213     * cost_weights.F: corrected wtheta[2], wsalt[2]
214    o cleaned exchanges in cg2d.F
215    
216    ecco_c44_e23
217    merged patches between release1_p1 and release1_p2:
218    o fixed array boundary problem for adjoint
219      (related to partial recomputation within subroutine
220      related to dynamics -> calc_viscosity -> mom_...
221    o fixed recomputation in thermodynamics
222    o prepare (but not complete) recomputation problem in impldiff
223    o fixed problem for adjoint of global_max
224    o switched off sponge layer code in external_forcing
225    Bug fix in ctrl_mask_set_yz (spotted by G. Gebbie)
226    
227    ecco_c44_e22
228    o Finally, the merges with the Scripps cost function terms:
229      Various additions, modifications, quality checks.
230    o Plus: Included switch ALLOW_AUTODIFF_MONITOR to handle
231      monitoring of adjoint state.
232    o Plus: removed comm_stats, ini_communication_patterns from diff. list
233      (no more need to "keep" MPI headers for adjoint generation)
234    o Plus: exf changes:
235      o added run-off routine
236      o additional storing needed for ustress,vstess
237        because of state-dependent quality check
238      o added missing initialisations
239    o Plus: genmake with MAKEDEPEND variable was still missing in ecco-branch
240    NB: - verification/natl_box_adjoint/ 240 steps run
241          * looks ok under Linux (twain.lcs.mit.edu)
242          * looks ok on MIT SUN's (fjord.mit.edu)
243          * NaN in reverse mode on Scripps SUN's at iter=214
244          * NaN in reverse mode on IBM SP3 (BlueHorizon) at iter=204
245        - 1 year forward int. global 2x2 deg. produces similar cost functions
246          * all cost terms of new code are slightly smaller (0.5 to 3%).
247    
248    ecco_c44_e21
249    o reversed order of ctrl/cost initialisation
250    o gmredi_slope_psi.F: Inconsistent types in MIN/MAX expressions
251    o modified to enable ctrl field swapping
252    o bug fix for global sum of ncvarlength in ctrl_init
253    o no more call to ctrl_unpack from ctrl_init
254    o no more write of ctrl vector in ctrl_pack
255      however, init. of control vector from ctrl_unpack
256    o various bug fixes & consistent nobcs handling in
257      ctrl_pack/unpack routines (by G. Gebbie)
258    o optim package: Added obcs control part for lsopt I/O
259      (by G. Gebbie)
260    o missing call to obcs_diags
261    o moved calls in packages_init_fixed to packages_readparms
262      because some quantities are needed earlier.
263    
264    ecco_c44_e20
265    o before major merges from the Scripps setup
266      here are two small updates:
267      - field swapping for surface flux controls enabled
268        (remains t.b.d. for atmos. state plus obcs)
269      - bug fix in active_file.F for xz-/yz- routines
270      - added missing xz-/yz- routines to active_file_ad.F
271    
272    ecco_c44_e19
273    o merged necessary patches:
274      - AD-related changes for GMRedi
275      - fixes i KPP (delZ -> drF)
276      - hook to OBCS songe layer code in external_forcing
277      - errorMessageUnit non-zero in eeboot.F
278      - included GMREDI, EXACT_CONSERV to natl_box_adjoint verif.
279    
280    ecco_c44_e18
281    o sponge layer code for obcs was missing
282      - added hook in external_forcing.F
283      - added storing for TAF
284    o new routine cost_init_barfiles to initialise
285      adjoint fields adtbar, adsbar, adpsbar
286      (needed in conjunction with corrected ladinit for active I/O)
287    o cleaned up and corrected order in packages_readparms, ecco_readparms
288    o corrected and simplified weights for obcs controls
289      - weight fields simplified
290      - bug fix in ctrl_pack
291      - no more write of control vector in ctrl_pack
292    o i/j index bug fixes in cost_ssh_mean
293    
294    ecco_c44_e17
295    o bug fixes in cost package
296      * wrong identifier for active I/O of monthly mean psbar
297        (cost_averagesfields, cost_ssh) xx_psbar_dummy
298      * cleaned all identifier for active I/O of monthly fields
299      * wrong ladinit in various cost routines
300    o merge with interval (chkpt44c_post - chkpt44d_post)
301      * added missing EXCLUDE_MONITOR flags
302      * changed "e" to "_d" in gmredi_slope_limit, gmredi_slope_psi
303        (incompatible typ in MIN/MAX expressions caused problems
304        on IBM SP3)
305      * in genmake added variable MAKEDEPEND
306        plus resetting for case SunOS
307        added timer_stats.c routine for IBM SP3
308      * removed variables in dynamics
309    
310    ecco_c44_e16
311    o new ECCO checkpoint, the first since ecco_c43_e15
312      which is branched from MITgcm.
313      All changes were merged in between (see ecco-branch-mod? tags).
314    o last changes:
315      * assuming path for TAF and TAMC are known (e.g. in $path)
316      * genmake:
317        - added tools/xmakedepend to circumvene shortcoming of
318          SUN's makedepend (size too small)
319        - invoking ../tools/xmakedepend instead of makedepend
320        - changed compiler flags for case SunOS
321    
322    ecco-branch-mod5
323    o mod's to reproduce open boundary run
324    o enable field swapping for OB's and climatology
325    o update store directives for OB control
326    o added option ALLOW_OBCS_PRESCRIBE
327    o call of getobcs now out of obcs_calc (param. list modified)
328    
329    ecco-branch-mod4
330    o this is the second part of changes necessary to reconcile
331      the natl_box_adjoint verification (with and without grdchk).
332      >>>!!! CHANGES BETWEEN THE TAGS ecco-branch-mod3 !!!<<<
333      >>>!!!                      AND ecco-branch-mod4 !!!<<<
334      >>>!!! SHOULD BE MERGED INTO THE MAIN TRUNK      !!!<<<
335      - genmake: removed $S64 overwrite for case SunOS
336      - pkg/exf: update and corrections for field swapping and obcs
337      - pkg/ecco: parameter lists for the_model_main, the_main_loop
338                  harmonized between ECCO and MITgcm
339      - pkg/autodiff: added flow directives for obcs, mdsio_gl_slice
340                      updated checkpointing_lev... lists for obcs
341      - model/src: minor changes in forward_step, plot_field
342      - pkg/mdsio: added mdsio_gl_slice
343    
344    ecco-branch-mod3
345    o this is the first part of changes necessary to reconcile
346      natl_box_adjoint verification (with and without grdchk).
347      This set of changes is relevant for ECCO only.
348      The next set/tag of changes (ecco-branch-mod4)
349      should be merged into the main trunk.
350      - update some options
351      - parameter lists of ecco_the_model_main and ecco_the_main_loop
352        differed from those of the MITgcm counterparts.
353    
354    ecco-branch-mod2
355    o update ecco-branch-mod1 to checkpoint44
356    o exclude from updates:
357      - verification/
358      - adjoint/
359      - pkg/cost
360      - pkg/ctrl
361      - pkg/ecco
362      - pkg/obcs
363      - model/src/the_model_main.F
364      - model/src/the_main_loop.F
365    
366    checkpoint44
367    o apply Shapiro filter on T&S before calc_PhiHyd (stagger time stepping)
368    o fix bug in mom_vi_del2uv
369    o added some stuff for AD
370    
371    ecco-branch-mod1
372    o based on c43
373    o replaced packages cost, ctrl, ecco, obcs
374    o removed MITgcm verif.'s, added ECCO verif.'s
375    o added lsopt, optim for line search optimization.
376    
377    checkpoint43
378    o added two new advection tests
379    o added global 4x4 degree ocean test
380    o added test of H&S94 with free surface on cube
381    o some final mods for gradient check, adjoint,...
382    
383    checkpoint42
384      Fixed AD-related problems:
385    o Store directives up-to-date with re-arranged Adams-Bashforth
386      (mainly thermodynamics.F)
387    o New store directives for multi-dim. advection schemes
388      * new CPP flag ALLOW_MULTI_DIM_ADVECTION
389      * new common block and key passkey
390      (mainly gad_advection.F)
391    o Modified store directives for split of dynamics/thermodynamics
392      for the case ALLOW_KPP
393    o Cleaned argument list for timestep_tracer.F
394    
395    checkpoint41
396    o re-formatted/added comments in prologues of key subroutines
397      to work with protex
398    
399    checkpoint40
400    o moved calc_gs, calc_gt and calc_tr1 back to model/src
401    o added FLT (floats) package from Arne along with demo. experiment
402    o re-arranged Adams-Bashforth scheme for tracers to allow easier
403      implementation of forward-in-time forcing terms
404    o more mods for non-linear free-surface including new variable
405    o modified multi-dim method to work on cube
406    o bug fix in KPP (from DM)
407    
408    checkpoint40pre9
409    o added DST advection schemes
410    o fix MPI bug on SGI's
411    o modifications for non-linear free-surface
412    o fixed conditionals for fixed flow/passive tracer only mode
413    o added tension/strain form of stress tensor
414    o changes to commenting of arguments for TAF/TAMC
415    o added/updated many matlab scripts
416    o added multi-dimensional advection method for tracers
417      
418    checkpoint40pre8
419    o new package rw/
420      Added method for dumping intermediate local arrays:
421      mdsio_writetile - same as mdsio_writefield except works from inside
422                        bi,bj loop
423      mdsio_writelocal - same as mdsio_writetile except works for local
424                         arrays
425      write_local_r? - higher-level wrapper for mdsio_writelocal
426      Controlled by diagFreq. Defaults to zero (ie. no dumps)
427      Example given at end of mom_vecinv.F that dumps some local arrays.
428    o replaced calc_mom_rhs.F by mom_fluxform.F/mom_vecinc.F to
429      control flux-form versus vector invariant code.
430      Switch is runtime flag vectorInvariantMomentum (defaults to false)
431      or genmake -DISABLE ...
432    o TAMC-related update to cope with mom_fluxform.F/mom_vecinc.F
433      (additional storing is now needed for case vecinv;
434      currently nothing implemented to switch this storing off
435      in case fluxform is used since no CPP flag available).
436    
437    checkpoint40pre7
438    o bug fix in dynamics.F
439      calc_viscosity called before k=1,Nr loop.
440    o added some #ifdef's ALLOW_PASSIVE_TRACER
441    o cleaned initialisations in ctrl_map_ini
442      related to TAF
443    
444    checkpoint40pre6
445    o split dynamics into thermodynamics & dynamics
446    o corresponding split of calc_diffusivity into
447      calc_diffusivity, calc_viscosity
448      (kpp_calc_diff, kpp_calc_visc).
449    o Added diffkr, kapgm to control variables
450    o bug fix in gmredi_slope_limit for ldd97
451    
452    checkpoint40pre5
453    o proper initialization of Adams-Bashforth time stepping
454      + uses forward step for very first step of model (iter=0)
455    o re-generated *all* output since almost all output is modified by this
456      change (sorry but we've been putting this one off for about 2 years)
457      + natl_box, aim.5l_Equatorial_Channel and aim.5l_zon-ave were
458        *not* regenerated since they are already out of date and I don't
459        want to create the impression that they are suddenly working.
460    o removed KAP stuff for DEC's
461    o modified/added many .cvsignore files in */code and */input
462    o added new expt "solid-body.cs-32x32x1"
463      + this uses an alternative form of ini_curvilinear_grid.F which
464        is not necessarily any better than the current one...
465    
466    checkpoint40pre4
467    o added re-initialisations of utrans,vtrans,rtrans in
468      calc_common_factors which are crucial for TAF.
469    o extended iMin,jMin range for calc_common_factors,
470      calc_diffusivity
471    o added option ALLOW_PASSIVE_TRACER
472    o a few minor updates and fixes
473    
474    checkpoint40pre3
475    o created calc_gtr1.F for gad package
476    o split the_main_loop and re-introduced forward_step
477    o some recomputations of nIter0 for TAMC
478    
479    checkpoint40pre2
480    o Updated to latest branch of AJA, JMC
481    o Added gradient check package
482    o Added routines for passive tracer handling
483    o Added carbon sequestration sensitivity experiment
484    
485    checkpoint39
486     o Modifications and fixes to support TAMC
487       (mainly missing or wrong directives)
488     o Corrected common blocks when fooling TAMC to produce adjoint I/O
489       in addummy_in_stepping
490     o Updated verification/vero/ (bug fixes in code/, correct pickups in input/)
491     o Enabled "sliced" (xz-,yz-) exchanges, needed for obcs.
492     o Included following packages:
493       cal: calendar
494       exf: external forcing
495       ecco: essential routines to control use of cal, exf
496             (NB: this is not the full ECCO environment)
497     o disabled some packages by default in genmake
498    
499  checkpoint38  checkpoint38
500   o see notes_c37_adj.txt   o see notes_c37_adj.txt
501   o corrected wrong layer index in external_forcing_t   o corrected wrong layer index in external_forcing_t

Legend:
Removed from v.1.38  
changed lines
  Added in v.1.53.4.46

  ViewVC Help
Powered by ViewVC 1.1.22