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

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

  ViewVC Help
Powered by ViewVC 1.1.22