/[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.1088 by jmc, Sat Apr 18 21:23:13 2009 UTC revision 1.1188 by jmc, Sat Oct 31 03:22:33 2009 UTC
# Line 4  $Name$ Line 4  $Name$
4      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
5      ==============================      ==============================
6    
7    o pkg/ggl90:
8     - fix previous modif (unfortunatly has not been documented here).
9    o pkg/seaice/autodiff:
10     - add CPP flag to include clipping of zeta in EVP code;
11       although clipping of zeta is not necessary for EVP and not recommended
12       it was done by default, now clipping is disabled by default
13     - modify computation and store zetaC/Z in seaice_evp for TAF
14     - add CPP-flag SEAICE_ALLOW_CLIPVELS (undefined by default)
15     - change seaice_calc_viscosities/strainraties for better
16       vectorization after AD by TAF
17     - rearrange common blocks in SEAICE.h once again for easier dumps of
18       adjoint output, adjust adcommon.h and g_common.h
19     - change flux form of default advection scheme for better vectorization
20       of adjoint code
21     - modify lab_sea/input.lsr to test the flux form of default advection
22       scheme
23    o autodiff: fix seaice fields in g_common.h (left over from 3 to 1 level
24      transition in checkpoint61r)
25    
26    checkpoint61x
27    o adjoint: adding two new verification experiments
28      * tutorial_global_biogeo: an online dic sensitivity experiment
29        (work with G. Forget)
30      * tutorial_dic_adjoffline: an offline dic sensitivity experiment
31        (an update of the Dutkiewicz et al., 2006 paper)
32      Both use the same CO2FLUX cost function, but different controls
33      Gradient checks look good, but some recomp. could still be traightened out
34      Should add xx_dic control variable to test at some point
35    o model/src:
36      add run-time parameters to check and/or mask initial Temp & Salt
37    o pkg/ptracers:
38      apply zonal filter (if used) to all passive tracers
39    
40    checkpoint61w
41    o adjoint:
42      * update and finish work on adjoint of dic package (G. Forget)
43      * start adjoint of offline package
44      * bug fix for cube-sphere TLM code (active_file_g.F)
45    o tutorial_global_oce_optim:
46      now tested with 4 tiles (change data.grdchk and update output_adm.txt)
47      and add SIZE.h_mpi for MPI testing
48    o pkg autodiff
49     - fix bug in autodiff_restore
50     - make genmake2 remove comments and empty lines from ad_input_code.f in
51       order to reduce file size (new script file remove_comments_sed)
52    o allows to specify vertical profile of vertical viscosity (viscArNr)
53    o pkg autodiff
54      autodiff_ini_model_io: comment out writing of grid information to netcdf
55      files, because at this time the grid fields are a bunch of zeros
56      (this is analogous to ini_mnc_vars.F)
57    o pkg seaice/autodiff:
58     left-over from removing the 3-time-level fields:
59     - small rearrangement of common blocks (SEAICE.h)
60     - fix field declaration in order to get meaningful output in
61       adseaice.*.nc (adcommon.h)
62    o pkg obcs:
63     - go through NH code only if nonHydrostatic=T
64     - fix restart for Orlanski (Hydrostatic; still to fix NH+Orlanski restart)
65     - move call to OBCS_CALC before SEAICE_MODEL which needs seaice-obc fields
66       => Update output of experiment seaice_obcs
67     - useOBCSbalance: code is wrong with multi-tile / proc: add a stop.
68     - fix NH+Orlanski restart (add wvel OBC value in pickup file)
69     - fix restart for useOBCSprescribe + useEXF
70    o pkg ctrl
71     - make obcs as control parameter work also with useSingleCPUio
72     - replace a few sny and snx by Ny and Nx to be consistent with
73       ctrl_set_globfld_x/yz.F
74    o pkg seaice
75     - re-introduce global field frWtrAtm for the case of
76       ALLOW_MEAN_SFLUX_COST_CONTRIBUTION defined (SEAICE.h, seaice_growth.F)
77     - catch the case of an empty filename in seaice_cost_init_fixed.F
78    o pkg ecco:
79     - small bug fixes in the_main_loop
80      . fix order of monitor arguments
81      . change SEAICE_MULTILEVEL to SEAICE_MULTICATEGORY
82      . move include DYNVARS.h up outside the ALLOW_AUTODIFF_TAMC block so
83        that ALLOW_ECCO_FORWARD_RUN works with NONLIN_FRSURF
84     - replace cos(yc*deg2rad) by _rA in cost_mean_heat/saltflux.F, fix the
85       imbalance diagnostics for wmean_h/sflux = 0
86     - add actual values to f_obcsn/s/w/e in ecco_cost_final.F
87     - catch the case of empty filenames in ecco_cost_init_fixed.F
88       and ecco_readparms.F
89     - fix the logic of wsalt=0.and.wsalt2=0 to wsalt=0.or.wsalt2=0 (and theta)
90       to make this statement meaningfull in ecco_cost_weights.F
91    o pkg zonal_filt:
92      - change ZONAL_FILTER S/R interface (allows to filter 2-D fields)
93      - when using rStar, filter uVel*hFacW instead of uVel
94       (tested without topography: fix a Pb of growing instability with NLFS)
95    o pkg/aim/thsice:
96     -Add capacity to read a Q-Flux to be applied in slab-mixed layer thsice_slab_ocean.F
97      (works as SST restoring)
98    o pkg/thsice:
99     -add specific parameter for salt restoring in slab mixed-layer
100       (by default equal to the temperature restoring)
101    
102    checkpoint61v
103    o pkg/kpp:
104     -add double diffusive contributions as a hack, turned off by default
105      for now, and the code can be excluded with a CPP-flag
106      EXCLUDE_KPP_DOUBLEDIFF just as EXCLUDE_KPP_SHEAR_MIX
107     -add a verification experiments to "vermix" to test this code
108    o pkg/mom_common:
109      Move computation of length scales to mom_init_fixed.F (avoid recomputation
110      at each time-steps*levels).
111    o pkg/layers:
112      Created a new package for computing volume fluxes in temperature or
113      [not yet implemented] density layers, e.g. for calculating residual
114      overturning circulations.
115    o pkg/diagnostics:
116      implement a RS type version for the set of DIAGNOSTICS-FILL subroutines
117    o fix few RS/RL type mismatch (check with ifort 11.1 "-warn all" option)
118    o pkg/mdsio (& pkg/rw): rework high level S/R interface:
119      To avoid mixing type (RS/RL) of input/output array argument,
120      replace single mixed-type array with a pair from each type (RS/RL).
121    o setting pickupSuff force to start from a pickup (even if nIter0=0): this
122      is now implemented for all pkgs (previously only done for the main pickup)
123    
124    checkpoint61u
125    o pkg/obcs:
126      - change OB?eta from _RS to _RL and put them into a separate commen block
127      - add code to read OB?eta from a file via obcs_prescribe_read: the code
128        compiles and does not destroy any other experiments, the data is read
129        properly, but the code is not tested in actual applications
130    o ini_mnc_vars.F: if available (ALLOW_CAL), use startTime_1 and 2 to
131      create a meaningful unit attribute for the time coordinate variable
132    o pkg/ebm: add plenty of missing "_d 0" ;
133       update results of experiment global_ocean_ebm (fwd + adjoint tests)
134      Notes: several pieces of code only works for (very) specific set up
135       (domain size, lat range, etc ...); should be documented & stop if one
136       of those assumptions is not meet.
137    o pkg/seaice: add missing "_d 0" in HSNOW initialisation
138       update results of experiments: lab_sea (3 fwd tests + 2 adjoint tests)
139          and offline_exf_seaice (seaicetd + adjoint).
140    o add missing "_d 0" in ShortWave flux penetration (S/R SWFRAC):
141       update results of experiments: lab_sea (4 fwd tests + 3 adjoint),
142        seaice_obcs, global_ocean.cs32x15 (icedyn & thsice) and natl_box (x2).
143    o few changes to pass when compiling with strick checking of arguments
144       across S/R (allow to find few bugs in S/R calls).
145    o pkg/seaice:
146     - seaice_evp: move if-statement out of loop (TEM) at the cost of 11 new
147       2d-fields, for slightly better performance
148    
149    checkpoint61t
150    o pkg/seaice:
151     - remove unused variables in seaice_evp
152     - reduce number of SQRT in seaice_evp and seaice_calc_viscosities
153    o eeset_parms.F, open_copy_data_file.F & ini_parms.F:
154       named file replacing SCRATCH files (for TARGET_BGL & TARGET_CRAYXT):
155       each processor opens a different file (a fix from Matt).
156    o cg2d:
157       use simple EXCH (overlap size = 1 and ignore corners), like in cg3d.F :
158       this reduces number of EXCH calls by 2 when using exch2.
159       For now, keep previous size array for gc2d_nsa.F to avoid Pb with store
160       directives and missing simple EXCH (exch_s3d_rx) adjoint code.
161    o pkg/thsice:
162       add code for Near Infra-Red albedo (from Jeff)
163       (turned on with run-time flag: thSIce_calc_albNIR, in data.ice).
164    o ini_model_io:
165       move (from packages_readparms.F & initialise_fixed.F) to ini_model_io.F
166       MNC & MONITOR initialisation calls; move MNC calls from {pkg}_readparms.F
167       to {pkg}_init_fixed.F for {pkg}= kpp, seaice & shelfice.
168    
169    checkpoint61s
170    o pkg/exch2 (exch2_rxN_cube*):
171       remove last BARRIER (no need to synchronise after getting data from shared
172       buffer (get) as long as any change to buffer (put,recv) is between BARRIER)
173    o change tiling of natl_box (from 2 to 4 tiles) to get it tested with MPI+MTH
174      and generate new output (for the 2 tests) using default rotationPeriod.
175    o pkg/exch2:
176      - always call exch2_*_cube, not exch-1 anymore, if useCubedSphereExchange=F
177        (was already the case with AUTODIFF_EXCH2 defined)
178      - add bj in exch2 arrays and S/R.
179      - can now use pkg/exch2 for regular (non CS) set-up; switch test experiment
180        MLAdjust to exch2 (identical results except with MPI -> truncation diff);
181    o add pkg/longstep for ptracer timestep a multiple of U/V/T/S timestep
182      - adds deltaT argument to the subroutines TIMESTEP_TRACER DWNSLP_APPLY
183        GAD_ADVECTION GAD_CALC_RHS GAD_IMPLICIT_R GAD_SOM_ADVECT
184      - verification experiment natl_box.longstep
185    o build_options: ifort+mpi_aces optfile (following Constantinos advise):
186      allow different versions of ifort (8 or 9) and different versions
187       of mpi (mpich or mpich2) to be used with the same optfile.
188      requires to load a netcdf module and set MPI_INC_DIR (see comments inside
189       optfile). Change testing scripts (example_scripts/ACESgrid) accordingly.
190    o pkg/seaice:
191      fix previous modif (3-level field removed) for old-pickup reading
192    
193    checkpoint61r
194    o pkg/seaice:
195     - clean up the 3-time levels of UICE,VICE,HEFF,AREA in three steps:
196      1. introduce fields for time step (N-1)
197      2. do not use levels 2 and 3 anymore (but keep them)
198      3. replace 3D versions of UICE,VICE,HEFF,AREA by 2D versions. This
199         includes changes to pkg/thsice/thsice_get_velocity.F,
200         model/src/external_forcing_surf.F, pkg/obcs/obcs_apply_seaice.F, and
201         pkg/obcs/obcs_apply_uvice.F.
202     - completely remove code for leap-frog time stepping for second order
203       advection
204     - adjusted adjoint accordingly;
205       gradient checks have improved by an order of magnitude!
206    
207    checkpoint61q
208    o pkg/seaice: fix bug in free slip boundary conditons for LSOR solver
209     - the boundary conditions along open boundaries are unclear, because the
210       associated masks are set to zero and are thus treated as closed when
211       applying the slip-boundary conditions.
212     - move initialisation of grid variables from seaice_init_varia to _fixed
213    o adding doc/diags_changes.txt
214    o model/src:
215      do_the_model_io: rename few pkg S/R which are called from do_the_model_io,
216       to avoid "_diags" naming if no relation to pkg/diagnostics.
217      ini_theta,ini_salt: fix (at least compile the code) reading from NetCDF
218       file and only call PLOT_FIELD_XYZ if debugMode=T.
219      remove few PLOT_FIELD_XY calls outside initialisation.
220      remove few unnecessary BARRIER.
221    o pkg/salt_plume: add SaltPlumeSouthernOcean to allow disabling
222      of salt_plume package in Southern Ocean
223    o pkg/thsice:
224     - fix hOceMxL in overlap (needed for sea-ice advection);
225       update output of experiment global_ocean.cs32x15.icedyn.
226    o pkg/seaice:
227     - make the (placeholder-)tracer IceAge a little more meaningful
228      by avoiding ridging of age due to convergent ice flow
229     - add diagnostics for surface temperature, atmospheric and oceanic
230       heat flux, and atmospheric and oceanic ice growth
231    
232    checkpoint61p
233    o eesupp (global_max & global_sum):
234     - add one more element to buffer (start at index 0) for GL_MAX/SUM output;
235     - remove starting & endding barrier (no longer needed)
236    o pkg/mdsio, writelocal:
237       works also in multi-threaded when LOCBIN_IO_THREAD_SAFE is undefined
238       (remove the STOP): uses shared buffer IO to store data from all threads
239       and then let master-thread write nThreads tiles.
240    o pkg/mdsio (read/write field):
241     - tiled IO done in 1 piece (all levels at a time);
242     - new header file "MDSIO_BUFF_3D.h" with 3-D buffers.
243     - multi-threaded: allow to read/write local (non-shared) array
244       (was already working with singleCpuIO ; now works also without);
245       => no longer needs barrier call after reading a file (added inside
246       mds_read/write field).
247     - move barrier calls outside gather/scatter_2d to mds_read/write_field
248    o pkg/obcs/exf
249      - exf_getffieldrec.F: add a few ". _d 0" and
250                            add code to catch the case fldperiod = 0.  
251      - obcs_precribe_read.F: change if statements so that they match
252                              the variable type (_RL)
253      - add a separate exf_iprec_obcs to exf_set_obcs (by default equal to
254        exf_iprec) as part of namelist EXF_NML_01
255    o pkg/mdsio:
256      - read/write tiled (local) files: read/write 1-level tile chunk at a time
257        (instead of segment of length sNx); expected to speed up tiled IO.
258    o pkg/exch2:
259      - take buffer copy from/to array out of S/R exch2_send/recv into new
260        S/R exch2_put/get ; Exch of local variable now works with MPI+MTH
261        (tested by removing commom block statement in SOLVE_FOR_PRESSURE.h).
262      - ad version of send/recv no longer needed (but needs exch2_ad_put/ad_get)
263      - simplify argument list of S/R exch2_get_uv_bounds and exch2_get_scal_bounds
264        (which replaces exch2_get_recv_bounds & exch2_get_send_bounds) by
265        including Topology header file (and common blocks).
266      - implement EXCH_IGNORE_CORNERS in scalar exchange (rx1);
267        remove 2nd exch call in exch2_s3d_rx (no longer needed).
268      - document S/R arg. list (+ update some comments)
269    o pkg/seaice:
270      - added SEAICE_CLIM_AIR code, which permits modulation of surface air
271        temperature and humidity over sea ice based on climatological values.
272      - clean up computation of Hibler+Bryan (1987) stress coupling for the case
273        of LSR (this change is expected to change the results slightly because now
274        it uses slightly difference moduli from the second last LSR solution, but
275        that is more consistent with the stress computations; this part of the code
276        is not tested in the verification experiments)
277      - fix diagnostics for flux of ice in case of B-grid
278      - turn strain rates eij and press into global fields within global
279        common block in SEAICE.h for more straighforward diagnostics
280      - fix diagnostics for principal stress components, press, zeta, eta
281        to give something meaning full
282    o change tiling of global_ocean.cs32x15 (12 tiles, 32x16) and generate
283      new output (all 4 tests) using default rotationPeriod.
284    o pkg KPP:
285      - add flag (LimitHblStable) to avoid limiting BL depth under stable conditions
286      - fix vertical indices in RI_IWMIX (match between KPP grid from 0 to Nr+1
287        and normal grid from 1 to Nr)
288    o Fix computations of L4rdt in mom_calc_visc.F
289    o eesupp:
290      new S/R ALL_PROC_DIE (like EEDIE, without irrelevant threads err msg):
291      should be called before a "stop" if we know that all process are going
292      to stop; if one Proc does call this S/R, will hang in MPI_FINALISE.
293    
294    checkpoint61o
295    o pkg/exch2: change check_depths to issue just a warning (instead of error+stop)
296    o model/src/ini_curvilinear_grid.F:
297       compute angleSin/CosC when they are not read from a file
298    o pkg/seaice:
299       add pseudo time stepping for LSOR
300    o pkg/exch2:
301       temporary fix for exch2_s3d_rx; update results of exp. hs94.cs-32x32x5.impIGW
302    o pkg/seaice:
303       Adding separate sea ice albedo, drag coefficients, and HO in Southern
304       Ocean from those in Arctic Ocean.  See *_south in SEAICE_PARAMS.h
305    o SingleCpuIO:
306       fix bug put before chkp61n (May 11), when more than 2 MPI cpu are used.
307    o pkg/seaice:
308       put exchanged variable in (local) common block for MPI+Multi-Threads
309       to work (necessary with exch1, and for now with exch2 too).
310    o verification: to get more experiments tested with mpi, mth and mpi+mth,
311      change tiling of:
312       aim.5l_Equatorial_Channel, aim.5l_LatLon, dome, exp4, global_ocean.90x40x15,
313       hs94.cs-32x32x5, MLAdjust, offline_exf_seaice & tutorial_plume_on_slope
314      update output of exp:
315       exp4, global_ocean.90x40x15(+.dwslp), MLAdjust(all 5),
316       tutorial_plume_on_slope and hs94.cs-32x32x5 (use default rotationPeriod)
317      + ideal_2D_ocean: use default rotation period + test Global_Sum_SINGLECPU
318                       (note: output.txt generated on faulks using only 1 tile)
319    o eesupp & mdsio (SingleCpuIO):
320     - remove MISSING_TILE_IO (from MDSIO_OPTIONS.h), replaced by run-time
321       parameter "W2_useE2ioLayOut" (read from file "data.exch2").
322       Note: was not effective for globalFile & useSingleCpuIO=F; now fixed.
323     - move MDSIO_SCPU.h (pkg/mdsio) to EEBUFF_SCPU.h (eesupp/inc).
324     - fix GLOBAL_SUM_SINGLECPU when using Exch2; re-use same buffers and same
325       gather/scatter S/R as with SingleCpuIO (=> 1 less 2D global RL array).
326    o pkg/exch2:
327     - new code to set-up W2-Exch2 topology (replace matlab-topology-generator):
328       read parameter file "data.exch2" if it exists; otherwise try default regular
329       cube without blank-tile; new header file "W2_EXCH2_SIZE.h";
330     - update matlab-topology-generator (exch2_setup_cs6_print.m) to be compatible
331       with new code (not to be used, just as a backup solution).
332     - add examples (e.g., for lat-lon-cap_120) of parameter file "data.exch2"
333       in utils/exch2/input.
334    
335    checkpoint61n
336    o eesupp & mdsio (SingleCpuIO):
337      - move mapping to global io-buffer inside gather_2d/scater_2d: this save
338        memory (1 less 2D global RL array); skip 1 buffer copy; and only send/
339        receive real*4 array (instead of real*8) to read/write 32.bit files.
340        (new template for gather_2d/scater_2d, new set of S/R MDS_PASS_R4,8toRL,S
341         and remove new mapping S/R)
342    o pkg/mdsio: in preparation for topology-generator within pkg/exch2:
343      - Change declaration of SingleCpuIO buffer, reduced to only 1 dim.:
344        xyBuffer_size, which is set to W2_ioBufferSize from W2_EXCH2_PARAMS.h
345        when using exch2. Add S/R to map global io-buffer to global model array.
346      - uses exch2_global_Nx,y instead of exch2_domain_nxt,nyt.
347    
348    checkpoint61m
349    o write_utils : change WRITE_1D_R8 to WRITE_1D_RL
350      and add 3 other S/R for other types (R4,R8,RS).
351      Change calls to WRITE_0D/1D_R[4,8,S,L] to match the type of argument.
352    o eesupp/inc/CPP_EEMACROS.h (EXCH & GLOBAL_SUM/MAX macros):
353     - ensure suffix (_R4,_R8,_RS,_RL) correspondance between macro and S/R ;
354     - reduce number of macro definitions (keep only those which are used);
355       can always call directly the corrresponding S/R if needed.
356     - everywhere in the code: change macros (EXCH & GLOBAL_SUM/MAX) suffix
357       _R4/_R8 to _RS/_RL when applied to _RS/_RL variable.
358     Fixed wrong type of arg in:
359       atm2d/put_ocnvars.F cheapaml/cheapaml.F ocn_compon_interf/ocn_apply_import.F
360       ctrl/ctrl_map_ini_ecco.F seaice/seaice_do_diags.F seaice/seaice_model.F
361     To fix: global_sum of var in common block is wrong (multi-threaded) in:
362       dic/dic_atmos.F ebm/ebm_area_t.F ebm/ebm_zonalmean.F sbo/sbo_calc.F
363     To fix: aim_v23/aim_do_co2.F (BARRIER & GLOBAL_SUM within bi,bj loops)
364    o adjustment.cs-32x32x1: test "blank tiles" when compiling with mpi; 2nd
365      "nlfs" mpi test is going to stop when checking for unconnected tile egdes.
366    o eesupp/src: new S/R to stop everyone when 1 (or more) Proc. find an error
367    o pkg/exch2: new S/R EXCH2_CHECK_DEPTHS to check that unconnected tile
368      edges are closed (zero depth); might happen with "blank tiles";
369      for now, disabled if using OBCS.
370    o tools/gemake2: delete modifs from March 27-29 2009 (with option "-mpi":
371      link *_mpi files from "MODS" dir) to return to a strait-forward behavior.
372    o move read_write.F to write_utils.F ; new parameter (maxLengthPrt1D)
373      to reduce length of 1.D array print in STDOUT.
374  o adjustment.cs-32x32x1: changed to oceanic test with 1 continent  o adjustment.cs-32x32x1: changed to oceanic test with 1 continent
375    + use 48 tiles (16x8): this will allow to test "blank tiles".    + use 48 tiles (16x8): this will allow to test "blank tiles".
376  o start to test MPI + multi-threaded (change testreport to skip tests  o start to test MPI + multi-threaded (change testreport to skip tests
# Line 35  o pkg/fizhi: Line 402  o pkg/fizhi:
402    (e.g., datein=dates(n) is overwritten by timein=times(n) since both    (e.g., datein=dates(n) is overwritten by timein=times(n) since both
403     datein & timein, resp. 2nd and 3rd arg., are pointed to the same "ndum"     datein & timein, resp. 2nd and 3rd arg., are pointed to the same "ndum"
404     address) and produces error.     address) and produces error.
405    o tools/gemake2: (March 27-29 2009)
406      with option "-mpi": link *_mpi files from "MODS" dir (this is what
407      testreport does).
408  o lab_sea experiment: change from 2x1 tiles to 2x2 tiles and regenerate output  o lab_sea experiment: change from 2x1 tiles to 2x2 tiles and regenerate output
409  o pkg/seaice: fix bug in new version of S/R SEAICE_LSR.F:  o pkg/seaice: fix bug in new version of S/R SEAICE_LSR.F:
410     update lab_sea.lsr & lab_sea.salt_plume results     update lab_sea.lsr & lab_sea.salt_plume results

Legend:
Removed from v.1.1088  
changed lines
  Added in v.1.1188

  ViewVC Help
Powered by ViewVC 1.1.22