/[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.1402 by heimbach, Thu Mar 24 12:19:17 2011 UTC revision 1.1452 by jmc, Fri Jun 10 21:18:45 2011 UTC
# Line 4  $Name$ Line 4  $Name$
4      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
5      ==============================      ==============================
6    
7    o model/src (rStar):
8      - add rStar scaling factor in diags_phi_hyd.F (similar to calc_grad_phi_hyd.F);
9        affect solution only if z* with full pressure in EOS;
10        update output of test-exp global_ocean.90x40x15.
11    o pkg/seaice:
12      - introduce siEps=1e-5 parameter
13      - use areaMax in AREA update (part 4), consistent with ridging step (part 2.5).
14      - re-organize SEAICE_ADD_SUBLIMATION_TO_FWBUDGET code.
15      - introduce ALLOW_SITRACER and seaice_tracer_phys.F to handle generic seaice tracer.
16        For now it covers, and was tested for, ice salinity and age (attached to HEFF),
17        as well as ice cover age and ridging index (attached to AREA).
18        For now the run time parameters (in data.seaice/SEAICE_PARM03) are
19        SItrName (e.g. 'age') and SItrMate ('HEFF', which is the default, or 'AREA').
20        Up to SItrMaxNum=3 tracers can be used simultaneously.
21    o pkg/salt_plume:
22      -introduce SPsalFRAC run time parameter that sets the fraction of the
23       salt by-product of ice growth (SPsalFRAC*(1-SIsalFRAC)*salt typically)
24       that gets vertically redistributed (fluxed down) by pkg/salt_plume.
25    o model debug options:
26      - Switch reading of debugMode from S/R INI_PARMS (parameter file "data", stored
27        in PARAMS.h) to S/R EESET_PARMS (parameter file "eedata", stored in EEPARAMS.h).
28      - Refine debug-msg printing selection (3 new levels):
29        debugMode  : controls printing of debug messages (sequence of S/R calls).
30        debugLevel : controls printing of algorithm-relevant auxiliary/debug messages
31         debLevZero =  0 ; /* level of disabled aux. msg printing */
32         debLevA =  1 ; /* level of minimum  aux. msg printing */
33         debLevB =  2 ; /* level of low aux. print (report read-file opening)*/
34         debLevC =  3 ; /* level of moderate debug prt (most pkgs debug msg) */
35         debLevD =  4 ; /* level of enhanced debug prt (add DEBUG_STATS prt) */
36         debLevE =  5 ; /* level of extensive debug printing */
37        New debugLevel default: with default debugMode value (=F),
38          = 2 (debLevB) or = 1 (debLevA) in case ALLOW_AUTODIFF is defined.;
39          and if debugMode=T, default debugLevel = 4 (debLevD).
40        Relation with previous settings:
41         debLevB (=2) corresponds to former debLevA (=1)
42         debLevD (=4) corresponds to former debLevB (=2)
43        Note:
44         a) if debugLevel=0, skip WRITE_GRID call when nIter0 > 0 (same as before);
45         b) default debugLevel=1 is convenient in AD runs (avoid many file opening msgs);
46            to recover previous default, set debugLevel=2 (e.g. AD-test hs94.1x64x5)
47      - Add new parameter (printResidualFreq, read from PARM02 namelist) to print
48        detailed CG solvers convergence; off (=0) by default, except if debugLevel=5.
49    o pkg/obcs:
50      - change OBCSfixTopo default from True to False (should not change the results);
51        keep OBCSfixTopo=T in verification-exp. seaice_obcs.
52    o pkg/thsice:
53      - fix bug in thsice_calc_thickn.F (was introduced in version 1.18) in
54        2nd layer seaice sublimation (unlikely to happen)
55      - use Interior mask for OBCS in thsice_advection.F (similar to what is
56        done in gad_advection & seaice_advection).
57    o adjoint:
58      bug fix spotted by Gael Forget:
59      seaice_advection and thsice_advection still had
60      legacy CPP options to avoid CS corner updates for adjoint
61    o pkg/seaice:
62      => Change some of the defaults (2011/05/29):
63         - change SEAICEuseFluxForm default (from False to True)
64         - change DIFF1 default (from 0.004 m/s to 0. m/s)
65         And print warnings if DIFF1 is not set in data.seaice and centered
66          avection scheme is used without any diffusion.
67      also:
68      - fix seaice_diffusion calls in default AdvScheme part of seaice_advdiff.F;
69      - set SEAICEdiffKh[] default in the same way as SEAICEadvSch[]
70      - stop if DIFF1<>0 with SEAICEadvScheme <> 2, if DIFF1<>0 with any
71        other non-zero SEAICEdiffKh[] diffusivity, if SEAICEadvSalt=T with
72        #undef SEAICE_VARIABLE_SALINITY, if SEAICEadvAge=T with #undef SEAICE_AGE.
73      update results of test exp.:
74         lab_sea: output.fd (switch to AdvScheme=33 with diffKh=20)
75             output.hb87, output_adm.evp (SEAICEuseFluxForm=T and diffKh=200)
76             output_adm.noseaicedyn (SEAICEuseFluxForm=T)
77         offline_exf_seaice: output.seaicetd, output_adm (SEAICEuseFluxForm=T)
78         seaice_obcs: output (SEAICEuseFluxForm=T)
79      and prescribe old default for SEAICEuseFluxForm (=F) and DIFF1 (=0.004)
80          for standard fwd & AD lab_sea tests (to keep the same output).
81    o pkg/seaice/seaice_growth.F:
82      - use Ian Fenty's capping formulas for actual ice
83      thickness thoughout EVOLUTION branch.
84      - put treatment pathological case #2) in CPP brackets
85      (ALLOW_AVOID_INFINITESIMAL_AREA, undef by default).
86      - update global_ocean.cs32x15 and 1D_ocean_ice_colum results accordingly.
87    o pkg/seaice:
88      - seaice_diffusion.F : remove the min(DX,DY) factor permanently;
89      pass the Laplacian diffusivity (in m^2/s) diffKh as a parameter;
90      also pass fac as a param, which can be 1. (to update the tendency
91      field) or the time step (to update the field itself).
92      - seaice_advdiff.F: for multidim, call seaice_diffusion with
93      e.g. SEAICEdiffKhHeff and with fac=1; for single-dim, call
94      seaice_diffusion with e.g. SEAICEdiffKhHeff and with fac=time step.
95      - SEAICE_PARAMS.h, seaice_readparms.F, seaice_check.F :
96      hooks to handle SEAICEdiffKhHeff, SEAICEdiffKhArea, etc.
97    o pkg/seaice:
98      diffusion with centered advection scheme (diffus.F & advect.F):
99      - simplify S/R DIFFUS (put deltaT & DIFF1 factor outside, move EXCH outside)
100        to just compute the laplacian of input-field.
101      - unroll k loop (harmonic,biharmonic diff) in advect.F to save 1 exch call.
102      - fix flux-form version in diffus.F to conserve tracer.
103      update output of lab_sea.fd & lab_sea.hb87 (1rst set of modif affects
104       machine truncation) and lab_sea.salt_plume (conservative flux-form modif)
105    
106    checkpoint62y (2011/05/26)
107    o pkg/seaice:
108     - seaice_growth.F : in EVOLUTION branch, always include
109       a_QSWbyATM_cover in qnet (as it should be).
110     - verification/global_ocean.cs32x15 : update results accordingly
111       (output.seaice.txt output_adm.seaice.txt).
112    o pkg/seaice + obcs:
113     - use maskInW & maskInS in multi-dim advection and biharmonic diffusion:
114       equivalent of assuming no tracer gradient outside the OB region.
115       update output of seaice_obcs (uses DIFF1 <>0 => biharmonic diffusion)
116     - remove calls to OBCS_COPY_TRACER after EXCH calls (no longer needed
117       after changes above);
118     - obcs+seaice cleaning: apply seaice-tracer OB values to tracer field
119       only at OB location (instead of over a band of OLx width).
120    o pkg/seaice:
121     - fix wrong indices in old (non Flux-Form) diffusion default S/R diffus.F
122       (dxG(I+1, ...) changed to dxG(I, ...), no impact on Lat-Lon grid)
123    o pkg/obcs:
124      - split header file "OBCS.h" into 4 separated files:
125        OBCS_PARAMS.h, OBCS_GRID.h, OBCS_FIELDS.h & OBCS_SEAICE.h
126       Note: OBCS_PARAMS.h & OBCS_GRID.h can be included without OBCS_OPTIONS.h
127         (contain no conditional statement which depends on OBCS options).
128      - move "useOBCSYearlyFields" from "data.obcs" (hold in OBCS_PARAMS.h)
129        to parameter file "data.exf", namelist EXF_NML_OBCS (in EXF_PARAM.h).
130    o ctrl, cost, grdchk & autodiff pkgs:
131      - make options file more standard (like other {PKG}_OPTIONS.h file but
132        with AD_CONFIG.h); clean-up some of the included header files.
133    o pkg/obcs:
134      - do not mask tracer when applying OB (tracer == 0 could generate problems)
135      - apply tracer OB values to tracer field only at OB location (instead of
136        over a band of OLx width)
137      - clean-up obcs_apply_w.F & obcs_apply_eta.F (since less calls to these S/R)
138      - remove OBCS_MULTIDIM_OLD_VERSION code in gad_advection.F and remove
139        obcs_apply_tloc.F & obcs_apply_sloc.F
140    o obcs in model/src:
141      - call OBCS_APPLY_W only if NonHydrostatic.
142      - call OBCS_APPLY_ETA only if NonLinFreeSurf.
143      - reset dEtaHdt and wVel to zero outside OB interior region ;
144      - leave tracer unchanged outside OB interior region: This has no effect
145        on the solution but just to prevent unrealistic tracer value outside OB.
146      - zero out velocity outside OB interior region: This has no effect on
147        the solution but just to prevent unrealistic velocity outside OB.
148    o obcs and non-lin free-surf:
149       move call to OBCS_APPLY_R_STAR from update_r_star.F to calc_r_star.F
150       and call to OBCS_APPLY_SURF_DR from update_surf_dr.F to calc_surf_dr.F
151       + add argument "etaFld" to OBCS_APPLY_R_STAR & OBCS_APPLY_SURF_DR:
152       this fixes missing EXCH + get consistent eta OB value (+ fix restart).
153       update results of test-exp. exp4(nlfs).
154    o exp4 (nlfs) test-exp:
155       use OBC for Eta at Western & Eastern OB (to test prescribing Eta
156       with NonLin-FreeSurf); update output.nlfs.txt
157    o obcs and 2d/3d solver norm:
158       use interior masks (maskInC) to cancel out cg2d & cg3d matrix coeff at OB
159       and outside OB interior region (will allow to place OB further inside the
160       domain). Depending on the domain, can affects cg2d-Norm (previous
161       cancellation outside OB was only partial), e.g. in exp4 & obcs_ctrl,
162       and cg3d-Norm (previous Norm was computed before canceling OB terms),
163       e.g. in tutorial_plume_on_slope.
164      - update output of exp.: exp4 (x2), obcs_ctrl and tutorial_plume_on_slope.
165    o pkg rbcs:
166      - split RBCS.h into 3 files: RBCS_SIZE.h, RBCS_PARAMS.h & RBCS_FIELDS.h
167      - add capability to apply relaxation to horizontal velocity uVel & vVel.
168    o pkg/grdchk: add gradient check for control variable xx_shifwflx
169    o pkg/shelfice/shelfice_init_fixed.F
170      fix CPP-flag combinations
171    o pkg/seaice: Merge iceage code of Pierre Rampal
172      * update/change/correct ice age calculations
173      * add age updates for pathological cases
174      Probably needs more testing...
175    
176    checkpoint62x (2011/05/13)
177    o pkg/mom_vecinv:
178       high-order vorticity scheme: use interior masks (maskInW & S)
179       to zero-out (outside OB) gradient of vorticity.
180    o verification exp.:
181       turn on "useEnergyConservingCoriolis" (better discretisation) in exp.
182       hs94.128x64x5 and seaice_obcs ; update results.
183    o pkg/obcs:
184      fix bug in OBeta for YZ sections in obcs_exf_load.F
185    o pkg/ctrl, pkg/shelfice, and optim:
186      - add new control variable xx_shifwflx (fresh water flux underneath ice
187        shelves). This is almost as tedious as obcs-ctrl, because the
188        variables needs its own mask.
189      - add a cost function term that penalizes the deviation of xx_shifwflx
190        from the first guess (zero) in analogy to other control variables
191    o pkg/shelfice:
192      - start basic adjoint
193    o pkg/ctrl:
194      - remove extra 2D field "for good measure" when initializing in
195        ctrl_set_globfld_[xy/xz/yz].F
196      - replace hard coded precision 32 (a bug) in ctrl_map_ini_gen by ctrlprec
197      - improve error messages in ctrl_set_unpack_*
198    o OBC implementation in momentum:
199       use interior masks (maskInC,W & S) in momentum S/R:
200       - multiply divergence, tension and some del^i.u or del^j.v by maskInC
201       - multiply del2u,del2v by maskInW/S (biharmonic viscosity)
202       - multiply horiz. grad of vorticity by maskInW/S (in Leith scheme)
203       - multiply gradient of wVel by maskInW/S in del2w calculation (NonHyd)
204       Motivation: fix/clean implementation of OBC with biharmonic-viscosity
205        (and also with Leith/Smagorinsky harmonic-viscosity).
206       Update output of experiment dome and exp4 (+nlfs).
207    o exp4 test-exp:
208      - turn on: nonHydrostatic, exactConserv, viscA4 (with momDissip_In_AB=F)
209        and prescribe time-varying OB (without pkg/exf) for zonal-velocity
210        at Western & Eastern Boundaries (+/- 1 per-cent); Also prescribe
211        time-varying OB at Western-side for wVel (NonHyd); update output.
212      - add secondary set-up (.nlfs) using NonLin FreeSurf (z*) + mom_vecinv
213        and biharmonic-viscosity ; also use prescribed time varying OB.
214    o pkg/obcs:
215      fix bug in OBWeta,OBWeta indices in obcs_apply_r_star.F
216    o model/src:
217      - fix startTime setting when baseTime<>0 & nIter0=0 are specified ;
218      - initialise startTime & nIter0 with unlikely values: allows to set one
219        from the other without ambiguity.
220    o seaice_obcs test-exp.:
221      add small diffK4T,S to test biharmonic diffusivity with OBCS ; update output.
222    o pkg/obcs:
223      - remove calls to OBCS_COPY_TRACER after EXCH for T,S & pTracer:
224        no longer needed with maskInC,W,S in pkg/generic_advdiff.
225    o pkg/seaice:
226      - retired SEAICE_SALINITY and SEAICE_salinity in favor of
227        SEAICE_VARIABLE_SALINITY and SIsalFRAC, respectively.
228      - fixed bug in the initialization of sea ice salinity variable HSALT
229        in seaice_init_varia.F  (removed dependence on ICE2WATR)
230    o fizhi-cs test exp.:
231       switch reference output convention for these 2 non-standard test-exp,
232        from: pgi  6.1-5 on faulks (FC.6, -of linux_ia32_pgf77+authors_fc5)
233          to: ifort 11.1 on baudelaire (FC.13, -of linux_amd64_ifort11)
234       reason: faulks might get retired soon and pkg/fizhi has still Pb with gfortran
235    o model/inc:
236      - change type of PmEpR array (from _RS to _RL) to fix restart (with "-use_r4")
237        of exp. global_ocean.90x40x15 (Suncronous time-stepping + Real-FW + NonLin-FS)
238    o pkg/seaice:
239      - fix calculation of saltFlux and saltPlumeFlux when using SEAICE_SALINITY
240    o verification/lab_sea, 1D_ocean_ice_column, seaice_obcs, global_ocean.cs32x15
241      - updated output*.txt files due to bug fixes in salt, saltPlumeFlux,
242        and initial HSALT
243    
244    checkpoint62w (2011/04/26)
245    o pkg/mom_fluxform:
246      - fix calculation of del2u & del2v (no-slip BC) when using Non-Lin Free-Surf.
247      - use parameter "sideDragFactor" in no-slip BC side-drag part.
248      - update output of exp. global_ocean.90x40x15
249    o pkg/mom_vecinv:
250      mask del2u & del2v (no effect on results, but cleaner & closer to mom_fluxform)
251    o update seaice exp.:
252      use more consistent parameter values (remove "backward compatability only":
253       ICE2WATR, SEAICE_lhSublim, SEAICE_cpAir, SEAICE_rhoAir + set rhoConstFresh)
254      related to thermodynamics seaice. Update output (fwd+AD) of exp.:
255       1D_ocean_ice_column (x2), lab_sea (x8), ioffline_exf_seaice (x2) & seaice_obcs
256    o update test-exp global_ocean.90x40x15:
257      o use default CD_CODE_OPTIONS file (Adams-Bashforth on CD Mom & Coriolis).
258      o increase Overlap size from 2 to 3 (to allow to test bi-harmonic Visc.)
259      o new pickup-files from a 100.yr run with pkg/down_slope (input.dwnslp params)
260      o turn on zStar & viscA4 in standard set-up (dir input/)
261        and update output files: output.txt & output.dwnslp.txt
262    o new AD-test experiment: obcs_ctrl
263      (From Matt MITgcm_Contrib/SOSE/BoxAdj) to test OBCS as control vector.
264    o pkg/dic:
265      fix two bugs in handling water vapour pressure in carbonate chemistry
266      and air-sea fluxes. Found by Val Bennington and Galen McKinley
267      (add DIC Option = WATERVAP_BUG to recover old results)
268      update output of tutorial_global_oce_biogeo (fwd+AD) & tutorial_dic_adjoffline
269    o adding allowInteriorFreezing option to check for water below freezing point
270      at depth and bring the negative heat anomaly to the surface level
271    o pkgs _fields_load:
272      - extend GET_PERIODIC_INTERVAL to deal with non-periodic case (from pkg/rbcs)
273      - use new S/R GET_PERIODIC_INTERVAL in pkgs:
274        bulk_force, cheapaml, cfc, dic, obcs (+ ctrl/ctrl_get_gen_rec), offline and
275        rbcs to get interpolation weights and time reccord number.
276      - fix multi-threading in aim_fields_load.F
277      - apply EXCH to temp arrays [0,1] after reading in dic_fields_load.F
278    o external_fields_load:
279      new S/R GET_PERIODIC_INTERVAL to calculate which time-record (and linear
280       interpolation weights) to use in a periodic time-series ; do not divide by
281       time-step to convert to integer:
282       - this fixes case where externForcingPeriod is not multiple of time-step
283          (Thanks to Christopher L. Wolfe)
284       - this fixes case where externForcingPeriod is an odd multiple of time-step
285         (was wrong by half of time-step); update results of tutorial_global_oce_in_p.
286      store index of time-record which is currently loaded:
287       - works without any assumption on sequence of calls to EXTERNAL_FIELDS_LOAD ;
288       - needed for the adjoint but not yet used because of extensive recomputations;
289         (to be fixed soon)
290    
291    checkpoint62v (2011/04/02)
292    o verification/1D_ocean_ice_column added to test Ian Fenty's
293      pkg/seaice_growth.F modifications for improving sea ice code differentiability
294    o update output of exp4, internal_wave, seaice_obcs, tutorial_plume_on_slope
295      (new velocity statistics after changing maskInW & maskInS definition)
296    o pkg/generic_advdiff with OBCS:
297      use maksInW & maskInS in advective flux and in biharmonic diffusion calculation:
298      equivalent to assumption of no tracer gradient outside the OB region.
299      This will affect the results if using obcs+biharmonic diffusion.
300      update output_adm.txt of experiment bottom_ctrl_5x5 (not expected since no obc)
301    o pkg/obcs:
302      change definition of maskInW & maskInS: leave OB edges inside (maskIn=1)
303      (e.g., maskInW(OB_Ie)=1 ) so that velocity normal-component at OB is still
304      in Interior region. No impact on solution but affects Velocity monitor stats.
305  o pkg/ptracers (adjoint)  o pkg/ptracers (adjoint)
306    New option AUTODIFF_PTRACERS_SPLIT_FILES for writing separate    New option AUTODIFF_PTRACERS_SPLIT_FILES for writing separate
307    tape file for each tracer    tape file for each tracer
308  o model/inc/scr and pkg/autodiff: add parameters that allow to turn  o model/inc/src and pkg/autodiff: add parameters that allow to turn
309    of parts of the adjoint code at run time. For now, there are only    of parts of the adjoint code at run time. For now, there are only
310    useKPPinAdMode, useGMrediInAdMode, and useSEAICEinAdMode. These    useKPPinAdMode, useGMrediInAdMode, and useSEAICEinAdMode. These
311    parameters are set in data.pkg.    parameters are set in data.pkg.
312    This is the lazy coward's version of doing this, but still useful for    This is the lazy coward's version of doing this, but still useful for
313    debugging. In order to do it right, everything needs to be moved to    debugging. In order to do it right, everything needs to be moved to
314    pkg/autodiff.    pkg/autodiff.
315  o pkg/autodiff: fix global_sum_tile_ad.F by resetting adsumPhi at  o pkg/autodiff: fix global_sum_tile_ad.F by resetting adsumPhi at
316    the end; this fixes the adjoint balancing code for open boundaries.    the end; this fixes the adjoint balancing code for open boundaries.
317  o pkg/ctrl:  o pkg/ctrl:
318    - change behavior of xx_${varname}period to be analogous to exf-conventions:    - change behavior of xx_${varname}period to be analogous to exf-conventions:
319      xx_${varname}period =   0.,  means time-independent control part      xx_${varname}period =   0.,  means time-independent control part
320      xx_${varname}period = -12., means one-year-periodic monthly control part      xx_${varname}period = -12., means one-year-periodic monthly control part
321    - introduce helper routine ctrl_init_rec (part of ctrl_init.F) to    - introduce helper routine ctrl_init_rec (part of ctrl_init.F) to
322      clean up ctrl_init a little, remove unused variables      clean up ctrl_init a little, remove unused variables
323    - ctrl_init: fixed the handling of the start/endrec for obcs-variables    - ctrl_init: fixed the handling of the start/endrec for obcs-variables

Legend:
Removed from v.1.1402  
changed lines
  Added in v.1.1452

  ViewVC Help
Powered by ViewVC 1.1.22