/[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.1203 by jmc, Wed Dec 2 02:21:09 2009 UTC revision 1.1270 by jmc, Mon May 17 02:32:49 2010 UTC
# Line 4  $Name$ Line 4  $Name$
4      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
5      ==============================      ==============================
6    
7    o eesupp/src (exch-1):
8      - Fix AD EXCH code for 2-D domain special cases (Nx=1 or Ny=1).
9      - Separate buffer filling and MPI sending: allow EXCH-1 to work for local
10        array (non-shared) when using MPI+MTH. Also reduces number of BARRIER
11        (even without using MPI).
12      - Message mode: move RecvAck setting (indicator of buffer being ready)
13        from send_put to recv_get S/R (was useless before, but not sure if
14        it's much more useful now);
15      - switch the order of sync: MPI-proc 1rst and then threads;
16      - take out spin-waiting code (#undef EXCH_USE_SPINNING), use BARRIER instead.
17    o model/src:
18      initialise dPhiHydX,dPhiHydY inside calc_grad_phi_hyd.F (so that TAF does
19      not drop it in S/R mddynamics, producing NaN in hs94.1x64x5 AD-test exp).
20    o utils/matlab/rdmnc.m: adapt to be able to use the generic matlab netcdf API
21    o pkg/ctrl: require a specific set of control variables and exf-flags for
22      adjoint of seaice (stop in ctrl_check.F if conditions are not satisfied)
23    o model/src:
24     a) 1rst version of a new driver S/R to turn-off output freq and flags after the
25       1rst forward sweep, to avoid over-writing output files during recomputations
26       recomputations (& grdchk); called from cost_final.F (& ctrl_init_ctrlvar.F ?)
27     b) 2nd version:
28      - add specific pkg S/R for seaice & ptracers (called from S/R TURNOFF_MODEL_IO);
29      - switch-off more output flags (exf_monFreq, chkPtFreq, dumpInitAndLast,
30         writePickupAtEnd) + seaice & ptracers output;
31      - do not switch off MNC flags (otherwise, won't get admonitor netcdf file)
32    o model/src:
33      - new S/R rotate_uv2en_rl (..._rs) that rotates vector fields.
34    o pkg/exch2:
35      - remove "simulationMode" from arg. list of S/R EXCH2_RX1,2_CUBE ;
36      - add argument "signOption" to EXCH2_RX1_CUBE (will be needed for SM exch).
37    o pkg/autodiff & exch2:
38      process exch_uv_agrid_3d_rx.f & exch2_uv_agrid_3d_rx.f through TAF
39      (for now, only if ALLOW_EXCH2 is defined).
40    o pkg/autodiff:
41      - include PACKAGES_CONFIG.h in exch*ad.flow & exch*ad.F
42        (not supposed to be in CPP_OPTIONS.h) to get ALLOW_EXCH2 defined correctly.
43       + clean-up comments (_RS is not always real*4)
44      - fix bug in ADEXCH_UV_3D_RX (without EXCH2, was calling the forward exch S/R)
45      - add a stop in ADEXCH_UV_AGRID_3D_RX if trying to use it with EXCH2:
46        was calling a forward exch2, which is wrong ; used in SEAICE & EXF pkgs.
47    o testreport (AD-tests):
48      no longer link files from dir "../input" (1rst link files from
49      "../input_ad.[xx]" if secondary test "xx" and then from "../input_ad")
50    
51    checkpoint62f (2010/04/29)
52    o model/src/the_main_loop.F:
53      adjust store directives for seaice evp and multicategory according to
54      pkg/ecco/the_main_loop.F
55    o adjoint:
56      global_sum_ad was incomplete (noted many times by many people ;)
57      nice description by Jean U. as follows:
58      * allreduce(var) in global_sum.F can be interpreted as
59        reduce(sum) followed by broadcast of sum.
60      * The adjoint of that is
61        sum(adjoint) followed by broadcast(summed adjoint value)
62        or in other words, allreduce(sum, adjoint vars)
63      We were missing the sum(adjoint)!
64      Benign, except(!) for "global" scalars appearing in tile loops (bi,bj)
65      (noted by J.M. Campin, e.g., in cost_ssh_mean, variable offset).
66      The fix should produce 16-digit accuracy between
67      single-CPU multi-tile (e.g. nSx=2, nPx=1) and
68      multi-CPU single-tile (e.g. nSx=1, nPx-2)
69      We'll probably change this yet again shortly
70    o eesupp/src:
71      - fix global_sum_r4 (wrong from previous modif in Jun 2009; ever used ?)
72    o pkg/icefront
73      - ALLOW_SUBGLACIAL_RUNOFF option adds capability for time-evolving
74        specification of addmass array based on a 2D field, which is added
75        at bottommost wet level at each horizontal location.
76    o model/src:
77     horizontal grid initialisation (other than curvilinear): add code for Exch2 IO
78     layout; (not always compatible with delX,delY setting; commented out for now).
79    o pkg/exch2:
80     change tile to processor setting (case nSy*nPy > 1): allows default model mapping
81     (myX and myYGlobalLow) to be used for simple (1 facet, no blank tile) config.
82    
83    checkpoint62e (2010/04/15)
84    o pkg/obcs:
85      - fix wrong index in OBCS_SPONGE_V for Eastern-OB (reported by David Hebert).
86    o pkg/dic:
87      -fix bug in fe_chem.F for multi-tile (nSx*nSy > 1) set-up;
88        (note: not presently tested in any forward verification exp.)
89       update tutorial_global_oce_biogeo AD output file.
90    o pkg/exf:
91      - account for the variation of albedo as a function of zenith angle
92        by defining ALLOW_ZENITHANGLE in EXF_OPTIONS.h
93    o build_options:
94     - rename "linux_ia64_ifort+mpi_ice_nas" to "linux_amd64_ifort+mpi_ice_nas"
95    o pkg/dic:
96      change DIC atmos-CO2 box (method 3, dic_int1=3) initialisation & restart:
97      - use binary pickup file for restart;
98      - initialise atmos-CO2 box from dic_pCO2 parameter;
99      - fix multi-threaded.
100    o pkg/rbcs:
101     - clean-up RBCS code: add RBCS_OPTIONS.h file ; fix multi-threaded ;
102       change (+ fix IO calls) type of array RBC_mask from _RL to _RS.
103     - add RBCS to exp4 passive tracer 01 (rbcs was previously untested)
104       and update output.txt
105    o pkg/kpp:
106     - add diagnostics for KPP non-local flux of Temp, Salinity and pTracers;
107     - change diagnostic of KPP non-local term: output average of KPPghat*KPPdiffKzS
108       (= ratio of KPP non-local (salt) flux relative to surface-flux) when
109       using pkg/timeave & pkg/diagnostics (diag 'KPPghatK' replaces 'KPPghat ');
110     - change pkg/offline to read-in average KPPghat*KPPdiffKzS from file
111       KPP_ghatKFile (instead of the average of KPPghat from file KPP_ghatFile).
112    o pkg/offline:
113      fix bug in S/R OFFLINE_FIELDS_LOAD regarding surfaceForcing conversion factor
114      (bug was added in version 1.10 on 2007-08-23).
115    o pkg/offline:
116      - no need to specify periodicExternalForcing, etc ... to use offline pack
117      - offline input files no longer just single prec --> parameter offlineLoadPrec
118    o verification/lab_sea:
119      change AD test to multi-tile setup and update all 4 AD output.
120      NOTE: while cost function values remain very similar,
121      gradients are very different, although gradient checks are self-consistent
122      Should try to get to the bottom of this (cost function summation order?)
123    o pkg/dic:
124      in carbon_chem.F, replace log10 (AUTODIFF) with explicit form to avoid
125      a weakness of TAF that drops part of double precision in log10 derivative.
126      <= changes removed since problem has been fixed in current TAF version 1.9.71
127      update AD output of exp. tutorial_dic_adjoffline & tutorial_global_oce_biogeo.
128    o pkg/ecco:
129      add missing "_d 0" in cost_readers.F, cost_readtopex.F & cost_readtopexmean.F
130      update all 4 lab_sea AD output.
131    
132    checkpoint62d (2010/03/22)
133    o build_options:
134      remove '-r8' (and '-i4') from linux_*pgf and linux_*ifort optfiles.
135    o remove unbalanced quote (single or double) in commented line of source code
136      (may cause some warning with some preprocessor/makedepend versions).
137    o pkg/seaice:
138      fix seaice_model.F for adjoint (gael) and update AD results of experiments
139       lab_sea (std + evp + noseaicedyn) and offline_exf_seaice.
140    o testreport:
141      add option '-runonly' (short: '-ro') to just do the run part (without make).
142    o eesupp: remove JAM communication code (obsolete).
143    o add option to genmake2 & testreport to switch "_RS" type to "real*4"
144      (if allowed in CPP_EEOPTIONS.h); update default CPP_EEOPTIONS.h and return
145      to default CPP_EEOPTIONS.h for exp. inverted_barometer & solid-body.cs-32x32x1
146      (update also the output).
147    
148    checkpoint62c (2010/03/02)
149    o tools/build_options :
150       move (some) old optfiles from build_options/ to build_options/unsupported/
151    o model/src and pkg/exf
152       surface relaxation -- separating data and data.exf options
153       The point is to ensure that we specify the surface relaxation
154       either in data or in data.exf (but not half and half) and to
155       avoid an accidental relaxation to 0 (which happened if a time
156       scale was specified but the file name was left empty)
157    o model/src model/inc and pkg/mom_common
158       ALLOW_3D_VISCAH/ALLOW_3D_VISCA4 => 3D specification of Viscosity
159       => addition to the viscosity field as computed by others schemes
160    o tools/build_options:
161      - rename "_generic_mpi" -> "+mpi_generic" (like other "+mpi" optfile)
162        but keep the former optfile for few weeks for smooth transition
163    o pkg/ecco
164      - allow user defined cost function contributions
165            CPP: ALLOW_USERCOST_CONTRIBUTION
166            USAGE: compute contributions in cost_usercost_all.F
167      - note: this is identical to what ALLOW_GENCOST_CONTRIBUTION once was.
168          the two options are complementary.
169    o pkg/smooth
170      - migration from contrib to the main repository
171    
172    checkpoint62b (2010/01/26)
173    o pkg/monitor:
174      - change back mon_printstats_rl.F & mon_stats_rl.F and add a stop
175        (in case someone forgot to update customized pieces of code)
176    o nonHydrostatic:
177      - add Non-hydrostatic free-surface form (selectNHfreeSurf=1)(not fully tested);
178      - add a simple 2-D experiment (short_surf_wave) to test it.
179    o pkg/icefront:
180       adding the shell of, and the hooks to, a new package that
181       will model melting and freezing of vertical glacier ice fronts
182    o momentum:
183      add diagnostics of momentum tendency from Hydrostatic pressure gradient
184       (without surf.pressure term: would need a 2nd filling since implicit term).
185    o add 3 "_d 0"s so that fizhi compiles with xlf on iblade, and replace
186      two " &end" by " &" (in fizhi-cs-*) because S/R NML_SET_TERMINATOR
187      cannot deal with the former
188    o cleaning:
189      - remove all (except OpenAD) old TLM output from results_ad dirs.
190      - remove unused S/R (MDSWRITEMETA, DIAGNOSTICS_ADD2LIST, old DFILE IO S/R)
191      - comment out maskH definition (replaced by maskInC)
192    o pkg/monitor:
193      - change mon_printstats_rl.F & mon_stats_rl.F (were similar to mon_writestats_rl
194        & mon_calc_stats_rl) to be the RL equivalent of mon_printstats_rs & mon_stats_rs.
195    
196    checkpoint62a (2010/01/15)
197    o model/src:
198      - bottom pressure diagnostic: correct for r* (when nonlinFreeSurf >= 4)
199    o pkg/diagnostics:
200      - add optional level number diagnostics (i.e., level number to be define
201        explictly with S/R DIAGNOSTICS_SETKLEV) with parser-code(10)="X".
202      - strictly check for valid parser-code(10) ;
203      - check if adding diag to the list from the right place.
204    o pkg/longstep:
205      - change parameters and fix tracer conservation with rstar/nonlinear free surface
206    o diagnostics:
207     - in all pkgs, replace remaining calls to old S/R DIAGNOSTICS_ADD2LIST with newer
208       S/R DIAGNOSTICS_ADDTOLIST ; fix seaice VICE diagnostics.
209    o pkg/diagnostics:
210     - Add option for writing vertical integral (sum of selected levels) of an output
211        field instead of writing output field levels. Activate this option on a per
212        output-file basis, by setting the 2nd character of fileflag to 'I'.
213     - Add field-specific information relative to level integral in 3rd postion
214        of parser diagnostics code (gdiag): " "=cumulate levels, "R"=integrate
215        vertically (x level-thickness x hFac), "r"=same but without hFac.
216    o do_the_model_io:
217      - pass end-of-model-run flag as argument, from forward_step to diagnostics_write:
218        in case useSIGREG, will write (averaged) diagnostics (if dumpAtLast) before
219        writing pickups and stopping.
220    o pkg/diagnostics (for now, only with mdsio):
221      - write time information to meta file (and modify accordingly rdmds.m) :
222        time-averaged diagnostics output: write starting and ending time of the
223        time-averaging interval ; snap-shot diagnostics output remains unchanged;
224    o pkg/timeave:
225      - S/R TIMEAVE_NORMALIZ: change size of cumulated-time array (was previously
226        always Nr), now assumed to be equal to number of levels of averaged field;
227        only used for DIC_COST monthly mean arrays: this fixes dic_aver_final.F
228    o pkg/sbo:
229      - fix ocean bottom pressure global-average & 2-D time-ave output (was
230        neither initialised nor filled).
231      - add starting iteration in suffix of global-average output file
232        (to avoid over-writing the file after a restart)
233      - use standard MDSIO pkg S/R instead of SBO_WRITEVECTOR (fix byte-swap Pb).
234    o time-average:
235      - use simple cumulative-time array (no k index) in all pkgs: {PKG}_timeAve(bi,bj)
236        (pkgs: aim_v23, bulk_force, dic, gmredi, kpp, land, ocn_compon_interf,
237         ggl90, my82, opps, pp81, ptracers, sbo, seaice, shelfice, thsice)
238        this fix DIC_COST cumulative-time array (previously: bi,bj,k)
239      - fix 1rst call (nIter0) snap-shot output and accumulation (pkg/shelfice)
240      - fix missing accumulation for pkg/opps.
241      - cumulate fields only if doing time-ave output ({PKG}_taveFreq > 0)
242         (pkgs: ptracers, kpp, ocn_compon_interf, ggl90, my82, pp81);
243      - fix initialisation of time-ave vars and do only full time-step increment
244        (i.e.: no first & last "half time-step") (pkgs: ggl90, my82, opps, pp81);
245    o pkg/layers:
246      - use standard RW pkg S/R to write the output
247        and remove local write_fld version (which had a problem).
248      - use simple cumulative-time array (no level index) to fix time-ave S/R calls.
249      - fix LAYERS_CALC argument list.
250    o pkg/timeave:
251      - store cumulative-time in a simple tiled array (drop the level index)
252      - add new S/R (TIMEAVE_NORMALIZE) which uses simple cumulative-time array.
253    o pkg/ocn,aim_compon_interf
254      - changes for multi-threaded coupled run. (tested with ifort-11 on danton)
255    
256    checkpoint62  (2009/12/23)
257    o switch on useOBCSbalance in tutorial_plume_on_slope exp. and update output.
258        (was not previously tested in any other exp.)
259    o pkg/monitor:
260      - clean-up _RL/_RS version: add specific S/R for statistics with mask & volume:
261        mon_writestats_rl/s,F mon_calc_stats_rl/s.F ; will keep the old one
262        (mon_printstats_rl/s,F mon_stats_rl/s.F) just for bare statistics.
263      - use hFac & 2-D mask (instead of 3-D mask + hFac in previous mon_stats_rl.F).
264      - change del2 calculation.
265      - use interior masks (instead of maskH, <- to be remove).
266      - shorter monitor suffix for forcing stats ("forcing" instead of "extforcing").
267    o mask & obcs:
268      - define 2-D "interior" masks (i.e., zero beyond OB) at 3 locations (C, W & S).
269      - move global area computation from ini_masks_etc.F to ini_linear_phisurf.F
270        (called after packages_init_fixed)
271    o pkg/obcs:
272      - move bi,bj loops into obcs_calc, so obcs_prescribe_read is called only once.
273        Fixes bug in obcs+exf with nSx*nSy.GT.1
274      - fix multi-tile handling in obcs balance code
275    o nonHydrostatic:
276      - Implement AB-3 for non-hydrostatic vertical momentum ;
277        (change ordering of var. stored in pickup file when using NH)
278      - move NH code from solve_for_pressure.F to 2 new S/R: PRE_CG3D & POST_CG3D.
279      - add 2-D field to store Hydrostatic Surface Pressure adjusment from cg3d_x
280        (in prep. for new NH free surface form).
281    o pkg/obcs:
282      add files & OB-variables for wVel (Non-Hydrostatic) with useOBCSprescribe
283    o model/src:
284      fix 2-D solver initialisation for deep-atmosphere (p-coord) with topography
285    
286  checkpoint61z (2009/12/01)  checkpoint61z (2009/12/01)
287  o nonHydrostatic:  o nonHydrostatic:
288    Fix missing vertical flux of vert. momentum near surface (k=1). This fixes    Fix missing vertical flux of vert. momentum near surface (k=1). This fixes
# Line 42  o pkg/cd_code: Line 321  o pkg/cd_code:
321     lab_sea (3 Fwd +3 AD), natl_box (x2), tutorial_global_oce_biogeo (Fwd+AD),     lab_sea (3 Fwd +3 AD), natl_box (x2), tutorial_global_oce_biogeo (Fwd+AD),
322     tutorial_global_oce_latlon, tutorial_global_oce_optim & tutorial_tracer_adjsens.     tutorial_global_oce_latlon, tutorial_global_oce_optim & tutorial_tracer_adjsens.
323    Keep old results by adding CD_CODE_OPTIONS.h in exp: cfc_example, exp2,    Keep old results by adding CD_CODE_OPTIONS.h in exp: cfc_example, exp2,
324         lobal_ocean.90x40x15(+AD), global_ocean_ebm(+AD) and OpenAD.         global_ocean.90x40x15(+AD), global_ocean_ebm(+AD) and OpenAD.
325  o pkg/obcs:  o pkg/obcs:
326   - fix bug in initialisation (broken since Oct 1rst modification)   - fix bug in initialisation (broken since Oct 1rst modification)
327     for useOBCSprescribe without useEXF.     for useOBCSprescribe without useEXF.

Legend:
Removed from v.1.1203  
changed lines
  Added in v.1.1270

  ViewVC Help
Powered by ViewVC 1.1.22