/[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.2107 by jmc, Wed Dec 17 17:58:39 2014 UTC revision 1.2178 by mlosch, Tue Sep 8 09:45:55 2015 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/seaice: introduce new parameter SEAICEscaleSurfStress (default = .FALSE.)
8      - if TRUE scale ice-ocean and ice-atmosphere stress acting on sea ice
9        by AREA according to Connelly et al. (2004), JPO.
10      - For EVP and the LSR solver, the implicit part of the drag term is
11        the only non-zero term in the denominator when there is no ice (which
12        prevented running the model with zero ice-ocean drag). If
13        SEAICEscaleSurfStress = .TRUE., this results in a division by zero
14        (or zero main diagonals BU/BV) which need to be caught. A practical
15        consequence is that for open water, the momentum equation reduce
16        to trivially 0 = 0 + 0 (for EVP). For LSR, BU/BV are reset to 1, if
17        they happen to be zero, often leading to a non-zero solution over
18        open water.
19    o pkg/seaice: revise EVP code (seaice_evp.F) in preparation for a more
20        efficient EVP method.
21      - introduce area-weighted averages for e12 (analogously to
22        seaice_calc_viscosities.F); this totally changes lab_sea.hb87 (2 digits
23        remain, but also changing the order of terms in the previous average
24        changed the results as much) -> update experiment
25      - add SEAICE_DELTA_SMOOTHREG code
26      - disentangle computation of zetaC/deltaC and zetaZ/deltaZ, also for
27        TEM-code
28      - adjust loop bounds so that only required fields are computed
29      - add new averaging code for zetaZ/deltaZ (again similar to
30        seaice_calc_viscosities.F), inactive by default for now (will change
31        results again), but will replace old code eventually
32    o eesupp/src:
33      - add an other alternative for multi-proc GLOBAL_SUM (in global_sum_tile.F)
34        to always cumulate tile local-sum in the same order
35        (option #define GLOBAL_SUM_ORDER_TILES in CPP_EEOPTIONS.h).
36        Still uses MPI_Allreduce (like standard code) but on array of tiles
37        and should be faster than GLOBAL_SUM_SEND_RECV code.
38      - switch almost all verification experiments that use GLOBAL_SUM_SEND_RECV
39        (defined in CPP_EEOPTIONS.h_mpi) to GLOBAL_SUM_ORDER_TILES instead.
40      - add CPP_EEOPTIONS.h_mpi with GLOBAL_SUM_ORDER_TILES defined in 13 more exp.:
41         aim.5l_cs, cheapAML_box, deep_anelastic, dome, fizhi-cs-32x32x40,
42         fizhi-cs-aqualev20, global_ocean_ebm, matrix_example, natl_box,
43         solid-body.cs-32x32x1, tutorial_advection_in_gyre, tutorial_baroclinic_gyre
44         and tutorial_held_suarez_cs.
45    
46    checkpoint65n (2015/07/29)
47    o pkg/thsice:
48      - add a warning when used with pkg/aim but without updating SST
49        (stepFwd_oceMxL=F & useCoupler=F & tauRelax_MxL<>-1 ).
50    o pkg/offline:
51      - change where Offline-Fields are loaded, from load_fields_driver.F to
52        directly within FORWARD_STEP, just after updating iter number and time;
53      - move setting of GM and KPP diffusivity out of OFFLINE_FIELDS_LOAD into new
54        S/R OFFLINE_GET_DIFFUS that is called towards the end of DO_OCEANIC_PHYS;
55       These changes allow:
56        a) to recover exactly on-line results using deltaToffline=deltaTClock,
57        tested (using offlineIter0= nIter0 -1 and offlineTimeOffset= -deltaT/2)
58        both with Lin & Non-Lin Free-Surf, both with staggerTimeStep & synchronous
59        time-step, both with GM & KPP files and with recomputing these fields;
60        b) no needs to switch on staggerTimeStep anymore;
61        c) simplify rescaling of offline horiz. velocity with Non-Lin Free-Surf.
62      - update output of experiment tutorial_dic_adjoffline (only 3 digits left).
63    o pkg/offline:
64      - change (rarely used) offset-iteration parameter to an offset time (in s):
65        can easily recover previous offset-iter effect by setting offset-time
66        (offlineTimeOffset) to offset-iter x deltaToffline;
67      - do not turn-off Temp & Salinity surface relaxation when using KPP (used
68        in KPP as part of surface buoyancy forcing) in offline run.
69      - fix ptracers KPP non-local term in the case where KPP is re-computed.
70    o OpenAD
71      - Adding preliminary ggl90 test to OpenAD verification.
72        Config. with ggl90 currently diverges after 64 time steps
73        so will need more work to become more stable
74      - Adding preliminary kpp test to OpenAD verification.
75        required small tweakes in kpp_routines.F
76      - Merge and update from Krishna Narayanan's contrib area:
77        * Add one variable for preliminary OpenAD DIVA
78        * Add replacement time-stepping for OpenAD DIVA
79        * genmake2 flag -diva (but only for OpenAD; preliminary)
80        * required modifs for OAD_support
81        successful preliminary test for tutorial_global_oce_biogeo/
82    o pkg/seaice:
83      - initialise deltaC in seaice_lsr, cosmetic changes in seaice_lsr
84      - add cpp-flag SEAICE_DELTA_SMOOTHREG for option of regularising
85        delta with a smooth function in s/r seaice_calc_viscosity
86        (no effect on EVP)
87      - rename local suffix "sqr" into "sq" for more consistent variable names
88    o pkg/seaice:
89        add new parameter SEAICE_deltaMin that is used ***only***
90        for regularizing Delta (and nothing else, like the parameter
91        which is also used for all sorts of things SEAICE_EPS).
92        Defaults to SEAICE_EPS for backward compatibility only.
93    o pkg/seaice: replace erroneously storing e12Csqr on the wrong tape with
94        the wrong key by inialising it before use -> fixes a recomputation
95        problem but does not fix the gradient
96    o pkg/layers:
97      - move resetting of flux arrays to outside the iLa loop
98        (this caused layers_diapycnal to not work with more than one layer coord.)
99      - fix bug in calculation of layers_recip_delta in layers_init_fixed.F
100    o pkg/layers:
101      - remove from common block 3D layers fields (used to diagnose transport
102        in tracer coords) and declare them as local arrays in layers_calc.F
103    o pkg/seaice:
104      - Rename SEAICE_VECTORIZE_LSR_ZEBRA to SEAICE_LSR_ZEBRA and define it
105        in lab_sea forward experiment (changes results -> updated)
106      - update adjoint experiment lab_sea after cleaning up seaice_lsr_tridiagu/v
107    o pkg/seaice: modify seaice_lsr.F in order to improve the gradient
108       computations; for SEAICE_VECTORIZE_LSR
109      - move the loops over which the tridiagonal solvers (seaice_lsr_tridiagu/v)
110        sweep to the outside,
111      - remove store directives and add "CADJ loop sequential" directives
112        in analogy to model/src/solve_tridiagonal.F
113      - replace many "#ifdef SEAICE_VECTORIZE_LSR_ZEBRA" by variable loop
114        boundaries to yield more readable code. This has also the charming side
115        effect that your can use SEAICE_VECTORIZE_LSR_ZEBRA without
116        SEAICE_VECTORIZE_LSR (i.e. adjoint without recomputations in
117        seaice_lsr_tridiagu/v now requires either of these flags, vectorization
118        still requires SEAICE_VECTORIZE_LSR with SEAICE_VECTORIZE_LSR_ZEBRA as
119        an additional option)
120       The tridiagonal solvers are now completely analoguous to solve_tridiagonal.F
121       but the adjoint gradients (which are affected by this change) still explode.
122    o coupler (atm & ocn _compon_interf):
123      - avoid using Exch2 IO mapping if not suitable.
124    
125    checkpoint65m (2015/06/15)
126    o pkg/layers:
127      - clean-up old parameters setting (from Sep 2012):
128        + remove old parameters setting from common block (declared locally);
129        + stop if any old parameter is mixed with new parameters;
130        + check for valid or consistent parameter setting (e.g., layers_name)
131      - check that layers_bounds for Pot.Density are in the right range;
132        this is supposed to catch un-updated setting after recently shifting
133        potential density field "prho" by -1000 (now in "sigma" scale).
134    o pkg/layers:
135      - Added missing call to layers_fill for keeping track of tottend in
136        pkg/diagnostics/diagnostics_fill_state.F
137    o pkg/layers:
138      - added CPP flux LAYERS_FINEGRID_DIAPYCNAL to disable fine-grid binning
139        of diapycnal fluxes
140    o pkg/layers:
141      - reverted changes to interpolation to previous treatment; there
142        was never actually a problem
143    o pkg/layers:
144      - fix interpolation of layers tracers in the presence of partial cells
145      - add lots of new functionality to compute water mass transformation
146        (enabled by CPP flag LAYERS_THERMODYNAMICS)
147      - add new calls from main code (diags_oceanic_surf_flux.F,
148        thermodynamics.F, impldiff.F) and gad to save the necessary fields
149        for layers_thermodynamics calculations
150    o pkg/ptracers:
151      - add capability of stepping a passive tracer forward without advection
152        by setting PTRACERS_advScheme to 0.
153    o pkg/diagnostics:
154      - add few (threads) _BARRIER around any update of "diag_pkgStatus".
155    o pkg/layers:
156      - shift potential density field "prho" by -1000 for density layer averaging so
157        that it corresponds to usual "sigma" definition (i.e., rho(p=const)-1000);
158        Note that density bin boundaries (layers_bounds in data.layers) have
159        to be set accordingly (i.e., shifted, in sigma scale).
160    o pkg/layers:
161      - fix snap-shot output of layer thickness @ V.pt and output of pot.density
162      - fix calculation of layer non-weighted velocity and layer probability
163      - add diagnostics for pot.density used for layer averaging
164    o pkg/seaice:
165      - seaice_calc_viscosity.F: change computation of deltaC**2 to ensure
166        positiveness, modify a few comments and improve variable names,
167      - the changed computation of deltaC affects most seaice-related
168        experiments at the truncation level.
169        seaice_itd.thermo is affected by far the most, with
170        only 7 digits of agreement remaining; update experiments.
171    
172    checkpoint65l (2015/05/04)
173    o pkg/shelfice:
174      - in shelfice_thermodynamics.F, if SHELFICEBoundaryLayer=.true., then set
175        factor drKp1 to zero where it is negative (ie. do not use
176        SHELFICEBoundaryLayer if hFacC>1)
177      - the same for factor drLoc in shelfice_forcing.F
178    o tools/genmake2: move FEXTRAFLAGS from FFLAGS to FOPTIM to avoid a problem
179        with modules in ptracers, when using testreport option "-small_f"
180    o pkg/seaice/seaice_growth.F (in case of SEAICE_ITD)
181      - replace tmpscal1**1.36 by faster exp(1.36*log(tmpscal1))
182    o verification/testreport
183      - add new option -small_f
184        with this option testreport first makes the target small_f (*.f files)
185        before running make (all). This is useful for explicit inlining when
186        all sources need to be full available.
187    o pkg/exf/exf_interp.F:
188        remove previous changes related to reverse (decreasing) input grids latitude
189    
190    checkpoint65k (2015/04/01)
191    o pkg/ecco:
192        fix missing cosphi initialization; use eccoiter in place of optimcycle;
193        if autodiff is not compiled then use READ_REC_XY_RL/READ_REC_XYZ_RL
194        instead of active read/write
195    o pkg/ctrl:
196        if autodiff is not compiled then use READ_REC_XY_RL/READ_REC_XYZ_RL
197        instead of active read/write.
198    o pkg/autodiff: make autodiff_readparms.F and autodiff_whtapeio_sync.F
199        return if .NOT.useAUTODIFF
200    o pkg/seaice: add CPP brackets (cost function related).
201    o model/src:
202        add useAUTODIFF run time switch.
203    o pkg/exf/exf_interp.F:
204        add code to allow input grids with latitude starting in the north (i.e. when
205        j=1 corresponds to northern edge of field); modify global_with_exf to test
206        this feature.
207    o verification/testreport:
208      - replace "grep -A3" with POSIX conformal sed command, because there are
209        implementations of grep that cannot do contextual searches
210      - replace "cat -n" by "nl" (two occurrences), because not all implementations
211        of "cat" have the option "-n"
212    o model/src:
213        add new file gsw_teos10.F that contains 3 functions, more or less a copy
214        of the gsw_toolbox.f90 of the TEOS-10 fortran interface, that are used to
215        convert from conservative to potential temperature. For now they are not
216        called anywhere.
217    o pkg/ggl90: make "useIDEMIX" useful
218      - re-organize code in s/r ggl90_calc a little to move computations that
219        are different for idemix into separate loops (changes verification
220        experiment idemix at truncation level, 12 digits remain -> updated)
221      - requires 2 new 2D fields KappaM, verticalShear
222      - make hFacI and recip_hFacI local 3D variables that are passed to
223        s/r ggl90_idemix
224      - fix and improve some comments
225    
226    checkpoint65j (2015/02/25)
227    o pkg/openad
228      - synchronize seawater.F with version in model/src: replace routine
229        body of sw_temp by calling sw_ptmp and fix/add a few comments.
230    o pkg/mnc:
231      - change default value of pickup_read/write_mnc params to FALSE
232        (since few features are missing in reading MNC pickup files).
233    o model/src:
234      - change default (background) vertical diffusivity for salt to be the
235        temperature (background) vertical diffusivity.
236      - change background vertical diffusivity in vertical mixing pkgs ggl90,
237        kl10, my82 and pp81 from temperature diffusivity to salinity diffusivity.
238        This makes ptracers default diffusivity (that uses salt diffKr) more
239        consistent with vertical mixing schemes.
240    o verification/testreport:
241      - fix typo in "-pcls" option ;
242      - put temp files in /tmp (instead of in local dir)
243      - add option "-ncad" to use genmake2 new option "-nocat4ad"
244      - allow to use "-j" option (for multi-procs make) for AD, OAD and TLM.
245    o pkg/ggl90 (idemix code):
246      - apply few fixes ; add some missing "_d 0" ; update output of exp.
247        global_ocean.90x40x15.idemix
248    o OpenAD
249      - enable active file I/O and begin removal of work-around code
250        for OpenAD for handling control variables (memory vs. active files)
251      - new CPP options file OPENAD_OPTIONS.h
252      - revert to genarr2d gradient check for hs94.1x64x5
253      - (genarr3d tested by tutorial_global_oce_biogeo, tutorial_tracer_adjsens)
254      - gentim2d works for halfpipe_streamice but not yet hs94.1x64x5
255    o tools/genmake2:
256      - add option for an alternative Makefile (from Martin) where multiple
257        source files are sent to TAF (instead of all in one file).
258    o pkg/ggl90: add IDEMIX (Olbers and Eden, 2013)
259      - code provided by Carsten Eden as an extension of ggl90
260      - so far the code is turned on within ggl90 by setting a CPP-flag at
261        compile time; a runtime flag implementation is not yet complete
262      - tested in new verification experiment global_ocean.90x40x15.idemix
263    o verification:
264      - reduce length of the AD test run by half for experiments
265        global_ocean.cs32x15 (std + thsice) and isomip
266      - enable active file I/O for OpenAD, adjust verifications accordingly
267      - halfpipe_streamice: change gradient check from genarr2d to gentim2d
268    o verification/testreport:
269      - fix two non-POSIX sed statements so that there are no error messages
270        on Mac OS X
271      - replace hostname -s with hostname | sed 's/\..*$//'
272    o model/src/seawater.F:
273      - simplify SW_TEMP to just calling SW_PTMP with P and PR exchanged
274        (following the matlab code), which would have avoided the bug caught
275        by Matt (see below) in the first place
276    o pkg/shelfice:
277      - implement alternative discretisation of quadratic drag (selectBotDragQuadr)
278        and true distance in no-slip BC (bottomVisc_pCell) similar to bottom-drag.
279      - fix sign of friction tendency (no-slip BC) and fix u,v drag for thin
280        ice-shelf case (i.e., within surface level).
281      - add config summary in shelfice_check.F
282      - remove global variable recip_SHELFICElatentHeat and replace by a local
283        variable recip_latentHeat
284      - introduce diagnostics for friction velocity uStar (in case of
285        SHELFICEuseGammaFrict)
286      - change verification experiment isomip.htd:
287        + start from pickup (as input_ad at nIter0=8640)
288        + start from SHELFICEmassFile instead of SHELFICEloadAnomaly file
289        + test SHELFICEuseGammaFrict = .TRUE.
290        + test SHELFICEadvDiffHeatFlux = .TRUE.
291    o model/src:
292      - fix bug (Thanks to Matt) in function SW_TEMP (to convert Pot.Temp to
293        in-situ Temp) and in routine SW_TEMP (in pkg/openad);
294        update output of experiments global_with_exf.yearly and isomip (all 6).
295    o pkg/shelfice:
296      - change setting of kTopC to also be zero where there is no ice-shelf.
297      - zero out surface forcing arrays (for now, for T & S + EmPmR) where
298        ice-shelf is.
299      - first attempt to get RealFreshWaterFlux effects: for now, only without
300        SHELFICEboundaryLayer ; not consistent if using synchronous time-stepping.
301    o pkg/seaice: add the option to prescribe a fixed thickness PDF
302      for thermodynamic calculations
303      - because of divisions of the type 7/7 not exactly equal to 1, this change
304        affects results of some verification experiments by up to 4 digits:
305        global_ocean.cs32x15.seaice, lab_sea, lab_sea.fd, lab_sea.salt_plume,
306        seaice_obcs, seaice_obcs.seaiceSponge, seaice_obcs.tides
307        adjoint: lab_sea, lab_sea.noseaicedyn
308        -> updated
309    
310    checkpoint65i (2015/01/23)
311    o model/src:
312      - change units of frictionHeating field from W to W/m^2
313      - fix bug in frictional heating from stratospheric drag in
314        S/R ATM_PHYS_TENDENCY_APPLY_V
315      - with synchronous time-stepping: move resetting to zero of frictionHeating
316        field from load_fields_driver.F to thermodynamics.F ;
317      - add diagnostics for frictional heating.
318    o model/src & gmredi K3D:
319      - add frictionHeating field to pickup-files (for synchronous time-stepping)
320      - move ALLOW_EDDYPSI block out of DYNVARS.h and merge it into FFIELDS.h
321      - rename uMean,vMean --> uEulerMean,vEulerMean (+ change diagnostics name
322        and name in pickup file).
323      - fix arguments of few DIAGNOSTICS_FILL calls in gmredi_k3d.F
324    o model/src:
325      - move (from ini_forcing.F) initialisation of all arrays in header file
326        FFIELDS.h into new S/R ini_ffields.F ; this fix broken restart
327        (since Nov 2012) with option selectAddFluid=1.
328    o pkg/shelfice:
329      - change units (+ document) of newly added field "shelfIceMassDynTendency"
330      - upgrade from _RS to _RL shelficeMass & shelficeLoadAnomaly arrays.
331    o pkg/obcs: re-organize obcs_calc_stevens.F to prepare for passive tracers
332    o pkg/seaice: two new runtime parameters:
333      - SEAICE_cStar replaces the hard wired "20" in the strength formulation,
334        long overdue
335      - SEAICE_tensilFac: preparation for Koenig-Beatty+Holland (2012)
336        parameterization of tensil stress for fast ice (does not do anything yet)
337    o pkg/seaice/seaice_check.F: left over from restricted addtive Schwarz method
338        for LSR: move checking overlaps out of JFNK-if-block
339    o pkg/atm_phys:
340      - move copy of grid and dynamical fields out of atm_phys_driver.F into
341        new S/R ATM_PHYS_DYN2PHYS.
342      - fix level height for Linear Free-Surf case (to be consistent with
343        fixed-in-time pressure levels).
344    o pkg/mom_common (bottomdrag):
345      - average bottomDragFld (ALLOW_BOTTOMDRAG_CONTROL) from grid-cell center
346        to correct location (U & V point) in S/R MOM_U/V_BOTTOMDRAG;
347        update output (adm & tlm) of experiment global_ocean.90x40x15.bottomdrag.
348    o pkg/shelfice (u/v_drag):
349      - add one argument (the other velocity component) to S/R SHELFICE_U/V_DRAG;
350      - use SHELFICEDragLinear & SHELFICEDragQuadratic in shelfice_v_drag.F
351        (now similar to shelfice_u_drag.F)
352      - remove condition on bottomDragTerms when calling SHELFICE_U/V_DRAG
353        from mom_vecinv.F (similar to mom_fluxform calls).
354    o pkg/mom_common (bottomdrag):
355      - add one argument (the other velocity component) to S/R MOM_U/V_BOTTOMDRAG;
356      - add options for alternative discretisation of velocity norm in quadratic
357        bottom drag: averaging of grid-cell-center KE to U.point and V.point
358        (selectBotDragQuadr=0, original code) can produce noisy patterns; this
359        improves when averaging only the other component (e.g. vVel for U bottom
360        drag) using wet-point method (selectBotDragQuadr=2) or not (=1).
361      - add options (bottomVisc_pCell) to account for partial-cell in bottom
362        friction (no-slip BC) thus getting the true distance from the bottom;
363        off by default since this also reduces model stability (explicit bottom
364        friction). Changes produce different machine truncation with linear-drag
365        + no-slip BC: update output of experiments exp4.stevens (10 digits) and
366        front_relax (bvp & mxl, 10 & 11 digits).
367    o model/src & mom pkgs:
368      - add one more level to vertical viscosity local arrays (Nr+1, previously Nr)
369        since no-slip bottom BC uses viscosity @ k+1 to update velocity @ level k
370      - for now and until vertical mixing scheme are updated to fill up level Nr+1,
371        just copy level Nr value to level Nr+1.
372    o doc:
373      - add notes form Abhisek Chakraborty on how to close Heat & Salt budgets.
374    o pkg/streamice:
375      - shelfice_init_varia.F, shelfice_init_fixed.F, shelfice_readparms.F,
376        SHELFICE.h: move array shelficemass to init_varia, initialise
377        from array shelficemassinit, which is set in init_fixed and
378        has option to be set from file; introduce array
379        shelficeMassDynTend array, set thru file in init_fixed
380      - NEW FILE: shelfice_step_icemass.F: update shelficemass from either
381        shelfIceFreshWaterFlux and shelficeMassDynTend or H_streamice in
382        pkg/streamice
383      - shelfice_thermodynamics.F: call shelfice_step_icemass if
384        SHELFICEMassStepping = .true.
385      - shelfice_ad_diff.list: add new subroutine shelfice_step_icemass.f
386    
387  checkpoint65h (2014/12/17)  checkpoint65h (2014/12/17)
388  o verification/global_ocean.90x40x15, global_ocean_ebm:  o verification/global_ocean.90x40x15, global_ocean_ebm:
389    - update to generic controls.    - update to generic controls.

Legend:
Removed from v.1.2107  
changed lines
  Added in v.1.2178

  ViewVC Help
Powered by ViewVC 1.1.22