/[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.2040 by jmc, Wed Aug 6 23:19:25 2014 UTC revision 1.2175 by jmc, Wed Jul 29 15:05:41 2015 UTC
# Line 4  $Name$ Line 4  $Name$
4      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
5      ==============================      ==============================
6    
7    checkpoint65n (2015/07/29)
8    o pkg/thsice:
9      - add a warning when used with pkg/aim but without updating SST
10        (stepFwd_oceMxL=F & useCoupler=F & tauRelax_MxL<>-1 ).
11    o pkg/offline:
12      - change where Offline-Fields are loaded, from load_fields_driver.F to
13        directly within FORWARD_STEP, just after updating iter number and time;
14      - move setting of GM and KPP diffusivity out of OFFLINE_FIELDS_LOAD into new
15        S/R OFFLINE_GET_DIFFUS that is called towards the end of DO_OCEANIC_PHYS;
16       These changes allow:
17        a) to recover exactly on-line results using deltaToffline=deltaTClock,
18        tested (using offlineIter0= nIter0 -1 and offlineTimeOffset= -deltaT/2)
19        both with Lin & Non-Lin Free-Surf, both with staggerTimeStep & synchronous
20        time-step, both with GM & KPP files and with recomputing these fields;
21        b) no needs to switch on staggerTimeStep anymore;
22        c) simplify rescaling of offline horiz. velocity with Non-Lin Free-Surf.
23      - update output of experiment tutorial_dic_adjoffline (only 3 digits left).
24    o pkg/offline:
25      - change (rarely used) offset-iteration parameter to an offset time (in s):
26        can easily recover previous offset-iter effect by setting offset-time
27        (offlineTimeOffset) to offset-iter x deltaToffline;
28      - do not turn-off Temp & Salinity surface relaxation when using KPP (used
29        in KPP as part of surface buoyancy forcing) in offline run.
30      - fix ptracers KPP non-local term in the case where KPP is re-computed.
31    o OpenAD
32      - Adding preliminary ggl90 test to OpenAD verification.
33        Config. with ggl90 currently diverges after 64 time steps
34        so will need more work to become more stable
35      - Adding preliminary kpp test to OpenAD verification.
36        required small tweakes in kpp_routines.F
37      - Merge and update from Krishna Narayanan's contrib area:
38        * Add one variable for preliminary OpenAD DIVA
39        * Add replacement time-stepping for OpenAD DIVA
40        * genmake2 flag -diva (but only for OpenAD; preliminary)
41        * required modifs for OAD_support
42        successful preliminary test for tutorial_global_oce_biogeo/
43    o pkg/seaice:
44      - initialise deltaC in seaice_lsr, cosmetic changes in seaice_lsr
45      - add cpp-flag SEAICE_DELTA_SMOOTHREG for option of regularising
46        delta with a smooth function in s/r seaice_calc_viscosity
47        (no effect on EVP)
48      - rename local suffix "sqr" into "sq" for more consistent variable names
49    o pkg/seaice:
50        add new parameter SEAICE_deltaMin that is used ***only***
51        for regularizing Delta (and nothing else, like the parameter
52        which is also used for all sorts of things SEAICE_EPS).
53        Defaults to SEAICE_EPS for backward compatibility only.
54    o pkg/seaice: replace erroneously storing e12Csqr on the wrong tape with
55        the wrong key by inialising it before use -> fixes a recomputation
56        problem but does not fix the gradient
57    o pkg/layers:
58      - move resetting of flux arrays to outside the iLa loop
59        (this caused layers_diapycnal to not work with more than one layer coord.)
60      - fix bug in calculation of layers_recip_delta in layers_init_fixed.F
61    o pkg/layers:
62      - remove from common block 3D layers fields (used to diagnose transport
63        in tracer coords) and declare them as local arrays in layers_calc.F
64    o pkg/seaice:
65      - Rename SEAICE_VECTORIZE_LSR_ZEBRA to SEAICE_LSR_ZEBRA and define it
66        in lab_sea forward experiment (changes results -> updated)
67      - update adjoint experiment lab_sea after cleaning up seaice_lsr_tridiagu/v
68    o pkg/seaice: modify seaice_lsr.F in order to improve the gradient
69       computations; for SEAICE_VECTORIZE_LSR
70      - move the loops over which the tridiagonal solvers (seaice_lsr_tridiagu/v)
71        sweep to the outside,
72      - remove store directives and add "CADJ loop sequential" directives
73        in analogy to model/src/solve_tridiagonal.F
74      - replace many "#ifdef SEAICE_VECTORIZE_LSR_ZEBRA" by variable loop
75        boundaries to yield more readable code. This has also the charming side
76        effect that your can use SEAICE_VECTORIZE_LSR_ZEBRA without
77        SEAICE_VECTORIZE_LSR (i.e. adjoint without recomputations in
78        seaice_lsr_tridiagu/v now requires either of these flags, vectorization
79        still requires SEAICE_VECTORIZE_LSR with SEAICE_VECTORIZE_LSR_ZEBRA as
80        an additional option)
81       The tridiagonal solvers are now completely analoguous to solve_tridiagonal.F
82       but the adjoint gradients (which are affected by this change) still explode.
83    o coupler (atm & ocn _compon_interf):
84      - avoid using Exch2 IO mapping if not suitable.
85    
86    checkpoint65m (2015/06/15)
87    o pkg/layers:
88      - clean-up old parameters setting (from Sep 2012):
89        + remove old parameters setting from common block (declared locally);
90        + stop if any old parameter is mixed with new parameters;
91        + check for valid or consistent parameter setting (e.g., layers_name)
92      - check that layers_bounds for Pot.Density are in the right range;
93        this is supposed to catch un-updated setting after recently shifting
94        potential density field "prho" by -1000 (now in "sigma" scale).
95    o pkg/layers:
96      - Added missing call to layers_fill for keeping track of tottend in
97        pkg/diagnostics/diagnostics_fill_state.F
98    o pkg/layers:
99      - added CPP flux LAYERS_FINEGRID_DIAPYCNAL to disable fine-grid binning
100        of diapycnal fluxes
101    o pkg/layers:
102      - reverted changes to interpolation to previous treatment; there
103        was never actually a problem
104    o pkg/layers:
105      - fix interpolation of layers tracers in the presence of partial cells
106      - add lots of new functionality to compute water mass transformation
107        (enabled by CPP flag LAYERS_THERMODYNAMICS)
108      - add new calls from main code (diags_oceanic_surf_flux.F,
109        thermodynamics.F, impldiff.F) and gad to save the necessary fields
110        for layers_thermodynamics calculations
111    o pkg/ptracers:
112      - add capability of stepping a passive tracer forward without advection
113        by setting PTRACERS_advScheme to 0.
114    o pkg/diagnostics:
115      - add few (threads) _BARRIER around any update of "diag_pkgStatus".
116    o pkg/layers:
117      - shift potential density field "prho" by -1000 for density layer averaging so
118        that it corresponds to usual "sigma" definition (i.e., rho(p=const)-1000);
119        Note that density bin boundaries (layers_bounds in data.layers) have
120        to be set accordingly (i.e., shifted, in sigma scale).
121    o pkg/layers:
122      - fix snap-shot output of layer thickness @ V.pt and output of pot.density
123      - fix calculation of layer non-weighted velocity and layer probability
124      - add diagnostics for pot.density used for layer averaging
125    o pkg/seaice:
126      - seaice_calc_viscosity.F: change computation of deltaC**2 to ensure
127        positiveness, modify a few comments and improve variable names,
128      - the changed computation of deltaC affects most seaice-related
129        experiments at the truncation level.
130        seaice_itd.thermo is affected by far the most, with
131        only 7 digits of agreement remaining; update experiments.
132    
133    checkpoint65l (2015/05/04)
134    o pkg/shelfice:
135      - in shelfice_thermodynamics.F, if SHELFICEBoundaryLayer=.true., then set
136        factor drKp1 to zero where it is negative (ie. do not use
137        SHELFICEBoundaryLayer if hFacC>1)
138      - the same for factor drLoc in shelfice_forcing.F
139    o tools/genmake2: move FEXTRAFLAGS from FFLAGS to FOPTIM to avoid a problem
140        with modules in ptracers, when using testreport option "-small_f"
141    o pkg/seaice/seaice_growth.F (in case of SEAICE_ITD)
142      - replace tmpscal1**1.36 by faster exp(1.36*log(tmpscal1))
143    o verification/testreport
144      - add new option -small_f
145        with this option testreport first makes the target small_f (*.f files)
146        before running make (all). This is useful for explicit inlining when
147        all sources need to be full available.
148    o pkg/exf/exf_interp.F:
149        remove previous changes related to reverse (decreasing) input grids latitude
150    
151    checkpoint65k (2015/04/01)
152    o pkg/ecco:
153        fix missing cosphi initialization; use eccoiter in place of optimcycle;
154        if autodiff is not compiled then use READ_REC_XY_RL/READ_REC_XYZ_RL
155        instead of active read/write
156    o pkg/ctrl:
157        if autodiff is not compiled then use READ_REC_XY_RL/READ_REC_XYZ_RL
158        instead of active read/write.
159    o pkg/autodiff: make autodiff_readparms.F and autodiff_whtapeio_sync.F
160        return if .NOT.useAUTODIFF
161    o pkg/seaice: add CPP brackets (cost function related).
162    o model/src:
163        add useAUTODIFF run time switch.
164    o pkg/exf/exf_interp.F:
165        add code to allow input grids with latitude starting in the north (i.e. when
166        j=1 corresponds to northern edge of field); modify global_with_exf to test
167        this feature.
168    o verification/testreport:
169      - replace "grep -A3" with POSIX conformal sed command, because there are
170        implementations of grep that cannot do contextual searches
171      - replace "cat -n" by "nl" (two occurrences), because not all implementations
172        of "cat" have the option "-n"
173    o model/src:
174        add new file gsw_teos10.F that contains 3 functions, more or less a copy
175        of the gsw_toolbox.f90 of the TEOS-10 fortran interface, that are used to
176        convert from conservative to potential temperature. For now they are not
177        called anywhere.
178    o pkg/ggl90: make "useIDEMIX" useful
179      - re-organize code in s/r ggl90_calc a little to move computations that
180        are different for idemix into separate loops (changes verification
181        experiment idemix at truncation level, 12 digits remain -> updated)
182      - requires 2 new 2D fields KappaM, verticalShear
183      - make hFacI and recip_hFacI local 3D variables that are passed to
184        s/r ggl90_idemix
185      - fix and improve some comments
186    
187    checkpoint65j (2015/02/25)
188    o pkg/openad
189      - synchronize seawater.F with version in model/src: replace routine
190        body of sw_temp by calling sw_ptmp and fix/add a few comments.
191    o pkg/mnc:
192      - change default value of pickup_read/write_mnc params to FALSE
193        (since few features are missing in reading MNC pickup files).
194    o model/src:
195      - change default (background) vertical diffusivity for salt to be the
196        temperature (background) vertical diffusivity.
197      - change background vertical diffusivity in vertical mixing pkgs ggl90,
198        kl10, my82 and pp81 from temperature diffusivity to salinity diffusivity.
199        This makes ptracers default diffusivity (that uses salt diffKr) more
200        consistent with vertical mixing schemes.
201    o verification/testreport:
202      - fix typo in "-pcls" option ;
203      - put temp files in /tmp (instead of in local dir)
204      - add option "-ncad" to use genmake2 new option "-nocat4ad"
205      - allow to use "-j" option (for multi-procs make) for AD, OAD and TLM.
206    o pkg/ggl90 (idemix code):
207      - apply few fixes ; add some missing "_d 0" ; update output of exp.
208        global_ocean.90x40x15.idemix
209    o OpenAD
210      - enable active file I/O and begin removal of work-around code
211        for OpenAD for handling control variables (memory vs. active files)
212      - new CPP options file OPENAD_OPTIONS.h
213      - revert to genarr2d gradient check for hs94.1x64x5
214      - (genarr3d tested by tutorial_global_oce_biogeo, tutorial_tracer_adjsens)
215      - gentim2d works for halfpipe_streamice but not yet hs94.1x64x5
216    o tools/genmake2:
217      - add option for an alternative Makefile (from Martin) where multiple
218        source files are sent to TAF (instead of all in one file).
219    o pkg/ggl90: add IDEMIX (Olbers and Eden, 2013)
220      - code provided by Carsten Eden as an extension of ggl90
221      - so far the code is turned on within ggl90 by setting a CPP-flag at
222        compile time; a runtime flag implementation is not yet complete
223      - tested in new verification experiment global_ocean.90x40x15.idemix
224    o verification:
225      - reduce length of the AD test run by half for experiments
226        global_ocean.cs32x15 (std + thsice) and isomip
227      - enable active file I/O for OpenAD, adjust verifications accordingly
228      - halfpipe_streamice: change gradient check from genarr2d to gentim2d
229    o verification/testreport:
230      - fix two non-POSIX sed statements so that there are no error messages
231        on Mac OS X
232      - replace hostname -s with hostname | sed 's/\..*$//'
233    o model/src/seawater.F:
234      - simplify SW_TEMP to just calling SW_PTMP with P and PR exchanged
235        (following the matlab code), which would have avoided the bug caught
236        by Matt (see below) in the first place
237    o pkg/shelfice:
238      - implement alternative discretisation of quadratic drag (selectBotDragQuadr)
239        and true distance in no-slip BC (bottomVisc_pCell) similar to bottom-drag.
240      - fix sign of friction tendency (no-slip BC) and fix u,v drag for thin
241        ice-shelf case (i.e., within surface level).
242      - add config summary in shelfice_check.F
243      - remove global variable recip_SHELFICElatentHeat and replace by a local
244        variable recip_latentHeat
245      - introduce diagnostics for friction velocity uStar (in case of
246        SHELFICEuseGammaFrict)
247      - change verification experiment isomip.htd:
248        + start from pickup (as input_ad at nIter0=8640)
249        + start from SHELFICEmassFile instead of SHELFICEloadAnomaly file
250        + test SHELFICEuseGammaFrict = .TRUE.
251        + test SHELFICEadvDiffHeatFlux = .TRUE.
252    o model/src:
253      - fix bug (Thanks to Matt) in function SW_TEMP (to convert Pot.Temp to
254        in-situ Temp) and in routine SW_TEMP (in pkg/openad);
255        update output of experiments global_with_exf.yearly and isomip (all 6).
256    o pkg/shelfice:
257      - change setting of kTopC to also be zero where there is no ice-shelf.
258      - zero out surface forcing arrays (for now, for T & S + EmPmR) where
259        ice-shelf is.
260      - first attempt to get RealFreshWaterFlux effects: for now, only without
261        SHELFICEboundaryLayer ; not consistent if using synchronous time-stepping.
262    o pkg/seaice: add the option to prescribe a fixed thickness PDF
263      for thermodynamic calculations
264      - because of divisions of the type 7/7 not exactly equal to 1, this change
265        affects results of some verification experiments by up to 4 digits:
266        global_ocean.cs32x15.seaice, lab_sea, lab_sea.fd, lab_sea.salt_plume,
267        seaice_obcs, seaice_obcs.seaiceSponge, seaice_obcs.tides
268        adjoint: lab_sea, lab_sea.noseaicedyn
269        -> updated
270    
271    checkpoint65i (2015/01/23)
272    o model/src:
273      - change units of frictionHeating field from W to W/m^2
274      - fix bug in frictional heating from stratospheric drag in
275        S/R ATM_PHYS_TENDENCY_APPLY_V
276      - with synchronous time-stepping: move resetting to zero of frictionHeating
277        field from load_fields_driver.F to thermodynamics.F ;
278      - add diagnostics for frictional heating.
279    o model/src & gmredi K3D:
280      - add frictionHeating field to pickup-files (for synchronous time-stepping)
281      - move ALLOW_EDDYPSI block out of DYNVARS.h and merge it into FFIELDS.h
282      - rename uMean,vMean --> uEulerMean,vEulerMean (+ change diagnostics name
283        and name in pickup file).
284      - fix arguments of few DIAGNOSTICS_FILL calls in gmredi_k3d.F
285    o model/src:
286      - move (from ini_forcing.F) initialisation of all arrays in header file
287        FFIELDS.h into new S/R ini_ffields.F ; this fix broken restart
288        (since Nov 2012) with option selectAddFluid=1.
289    o pkg/shelfice:
290      - change units (+ document) of newly added field "shelfIceMassDynTendency"
291      - upgrade from _RS to _RL shelficeMass & shelficeLoadAnomaly arrays.
292    o pkg/obcs: re-organize obcs_calc_stevens.F to prepare for passive tracers
293    o pkg/seaice: two new runtime parameters:
294      - SEAICE_cStar replaces the hard wired "20" in the strength formulation,
295        long overdue
296      - SEAICE_tensilFac: preparation for Koenig-Beatty+Holland (2012)
297        parameterization of tensil stress for fast ice (does not do anything yet)
298    o pkg/seaice/seaice_check.F: left over from restricted addtive Schwarz method
299        for LSR: move checking overlaps out of JFNK-if-block
300    o pkg/atm_phys:
301      - move copy of grid and dynamical fields out of atm_phys_driver.F into
302        new S/R ATM_PHYS_DYN2PHYS.
303      - fix level height for Linear Free-Surf case (to be consistent with
304        fixed-in-time pressure levels).
305    o pkg/mom_common (bottomdrag):
306      - average bottomDragFld (ALLOW_BOTTOMDRAG_CONTROL) from grid-cell center
307        to correct location (U & V point) in S/R MOM_U/V_BOTTOMDRAG;
308        update output (adm & tlm) of experiment global_ocean.90x40x15.bottomdrag.
309    o pkg/shelfice (u/v_drag):
310      - add one argument (the other velocity component) to S/R SHELFICE_U/V_DRAG;
311      - use SHELFICEDragLinear & SHELFICEDragQuadratic in shelfice_v_drag.F
312        (now similar to shelfice_u_drag.F)
313      - remove condition on bottomDragTerms when calling SHELFICE_U/V_DRAG
314        from mom_vecinv.F (similar to mom_fluxform calls).
315    o pkg/mom_common (bottomdrag):
316      - add one argument (the other velocity component) to S/R MOM_U/V_BOTTOMDRAG;
317      - add options for alternative discretisation of velocity norm in quadratic
318        bottom drag: averaging of grid-cell-center KE to U.point and V.point
319        (selectBotDragQuadr=0, original code) can produce noisy patterns; this
320        improves when averaging only the other component (e.g. vVel for U bottom
321        drag) using wet-point method (selectBotDragQuadr=2) or not (=1).
322      - add options (bottomVisc_pCell) to account for partial-cell in bottom
323        friction (no-slip BC) thus getting the true distance from the bottom;
324        off by default since this also reduces model stability (explicit bottom
325        friction). Changes produce different machine truncation with linear-drag
326        + no-slip BC: update output of experiments exp4.stevens (10 digits) and
327        front_relax (bvp & mxl, 10 & 11 digits).
328    o model/src & mom pkgs:
329      - add one more level to vertical viscosity local arrays (Nr+1, previously Nr)
330        since no-slip bottom BC uses viscosity @ k+1 to update velocity @ level k
331      - for now and until vertical mixing scheme are updated to fill up level Nr+1,
332        just copy level Nr value to level Nr+1.
333    o doc:
334      - add notes form Abhisek Chakraborty on how to close Heat & Salt budgets.
335    o pkg/streamice:
336      - shelfice_init_varia.F, shelfice_init_fixed.F, shelfice_readparms.F,
337        SHELFICE.h: move array shelficemass to init_varia, initialise
338        from array shelficemassinit, which is set in init_fixed and
339        has option to be set from file; introduce array
340        shelficeMassDynTend array, set thru file in init_fixed
341      - NEW FILE: shelfice_step_icemass.F: update shelficemass from either
342        shelfIceFreshWaterFlux and shelficeMassDynTend or H_streamice in
343        pkg/streamice
344      - shelfice_thermodynamics.F: call shelfice_step_icemass if
345        SHELFICEMassStepping = .true.
346      - shelfice_ad_diff.list: add new subroutine shelfice_step_icemass.f
347    
348    checkpoint65h (2014/12/17)
349    o verification/global_ocean.90x40x15, global_ocean_ebm:
350      - update to generic controls.
351    o pkg/ctrl:
352      - ctrl_map_ini_genarr.F: test for igen>0
353      - ctrl_init_variables.F: add call to CTRL_MAP_INI_GENTIM2D.
354      - move gentim2d part of ctrl_map_ini_genarr.F to
355        new separate routine : ctrl_map_ini_gentim2d.F
356      - ctrl_cost_driver.F,ctrl_init.F ctrl_map_ini_genarr.F:
357        add time variable weights and cyclic controls (time mean,
358        seasonal cycle, etc) capabilities to gentim2d
359    o pkg/ecco:
360      - move reading of error, conversion to weights from
361        ecco_cost_init_fixed.F to ecco_toolbox.F (ecco_readwei)
362    o global_oce_llc90, cs32:
363      - activte sbo.
364      - CTRL_SIZE.h : add maxCtrlProc.
365      - activate the new genctrl capabilities.
366      - update following reorganization of global_oce_input_fields.tar.gz  
367    o pkg/ctrl/ctrl_ad_diff.list:
368      - add missing ctrl_init_rec.f
369    o tools/OAD_support/keepOriginal:
370      - add ctrl_init_rec.F
371    o model/src/the_main_loop.F, pkg/ctrl/ctrl_map_ini_genarr.F:
372      - avoid recomputations of xx_gentim2d_dummy.
373    o momentum diagnostics:
374      - move filling of diagnostics Um_Diss & Vm_Diss from mom_fluxform.F and
375        mom_vecinv.F to timestep.F (to include Smag-3D contribution).
376    o pkg/seaice/seaice_lsr.F:
377      - fix computation of BU/BV, make sure they are non-zero, only necessary
378        for cubed sphere exchanges and SEAICE_OLx/y>0.
379        This makes calling s/r fill_cs_corner_rl obsolete (removed).
380    o verification/global_ocean.cs32x15/input.seaice
381      - add test for strong implicit coupling and restricted addtive Schwarz
382        methods for LSR
383      - update results/output.seaice.txt
384    o verification/tutorial_global_oce_biogeo:
385      - AD & OAD set-up: switch off ALLOW_OLD_VIRTUALFLUX (like in fwd set-up)
386        and set PTRACERS_EvPrRn(1,2) to zero (for DIC & ALK);
387        update output_adm,_oadm,_tlm.txt
388    o pkg/dic:
389      - change default to "#undef ALLOW_OLD_VIRTUALFLUX" in DIC_OPTIONS.h
390      - add a stop when ALLOW_OLD_VIRTUALFLUX is defined and PTRACERS_EvPrRn
391        for tracer 1 & 2 is set (to avoid double counting of dilution effect).
392    o verification/tutorial_global_oce_biogeo:
393      - AD & OAD set-up: do not set PTRACERS_EvPrRn for tracer 1 & 2 since
394        dilution is already added by pkg/dic ALLOW_OLD_VIRTUALFLUX ;
395        update output_adm,_oadm,_tlm.txt
396    o eesupp/src:
397      - add fill_cs_corner_rl.F (_RL-copy of fill_cs_corner_rs.F)
398        and call it in seaice_lsr when using nonzero SEAICE_OLx/y
399    o pkg/seaice: introduce strongly implicit coupling, intended for stabilizing
400      LSR (following Hutchings et al. 2004)
401      - introduce zetaZ as a global variable (requires adjustments in
402        seaice_evp.F and seaice_jfnk.F) and compute analoguously to etaZ
403        in seaice_calc_viscosities.F
404      - new flag SEAICEuseStrImpCpl (default off)
405      - add new terms zetaZ*du/dy and zetaZ*dv/dx on both sides of the
406        momentum equations
407      - JFNK-solver (preconditioner) adjusted to allow using this method
408        (where it does not have any positive effect)
409    o pkg/seaice
410      - add overlap for restrictive additive Schwartz method also to LSR, but
411        turn it off by default (because it only seems to work for non-cubed
412        sphere/llc topologies)
413    o pkg/autodiff
414      - add extra exchanges in addummy_in_steppging also for mnc output
415    o pkg/seaice:
416      - add extra exchanges before dumping adjoint fields in seaice_ad_dump.F
417        to avoid stripes in the adjoint output (similar to addummy_in_stepping.F)
418    o pkg/obcs:
419      - add option to specify domain-connected piece Id along OB though files
420        (for now, only used to diagnose PhiVel; default =1 -> global correction)
421      - modify obcs_diag_balance.F to process each connected-part separately;
422        exclude OB where Id = 0 but keep the full divergence there (-> constant
423        Psi along this portion of OB and all inflow derived from grad(Phi))
424      - add example of OB-conect files in verification/so_box_biogeo/input.
425    o pkg/diagnostics:
426      - improve treatment of Open-Boundaries in Velocity-Potential calculation:
427      a) use non zero matrix element across OB and solve for Phi 1 grid point
428         outside OB (i.e, where tracer OBCS are applied).
429      b) global imbalance of inFlow/outFlow across OB: instead of modifying
430         velocity across OB, spread it uniformly along the OB in the RHS.
431    
432    checkpoint65g (2014/11/19)
433    o pkg/diagnostcis:
434      - add preconditioner off-diagonal factor (diagCG_pcOffDFac) as run-time param
435    o pkg/my82,pp81,kl10:
436      - fix ALLOW_3D_DIFFKR implementation (previously had no effect): use 3-D
437        field diffKr as background diffusivity to set minimum diffusivity value.
438    o pkg/seaice:
439      - add new parameter SEAICEuseEVPrev (for revisited EVP by
440        Bouillon et al 2013)
441      - add SEAICE_evpAlpha/Beta to namelist
442      - modify seaice_evp code to able to use SEAICEuseEVPrev. These changes
443        involve trivial re-ordering of divisions/multiplications that should not
444        have any effects, but ... they do change the results of lab_sea.hb87 so
445        that only 2 digits of agreement remain, in line with the general
446        instability/fragility of the evp-code. For now, I do not care and just
447        update the verification experiment
448    o pkg/ctrl : add generic pre-processing (xx_genarr2d_preproc etc)
449      - remove xx_genarr2d_numsmooth etc
450      - use xx_genarr2d_preproc etc instead
451      - carry out smooth_correl2D at initialization stage rather than during
452        time stepping.
453      - get smoothOpNb from xx_gentim2d_preproc
454    o global_oce_cs32 :
455      - add test of generic ecco capabilities.
456    o pkg/exf/exf_getsurfacefluxes.F :
457      - add to tmpUE/tmpVN rather than re-initializing them (conventional behavior).
458    o pkg/ctrl,ecco :
459      - omit un-necessary arguments to ctrl_cost_gen.F unless ECCO_CTRL_DEPRECATED
460        is defined.
461    o pkg/seaice: add diagnostics for Delta (deformation parameter)
462    o model/src:
463      - when ALLOW_3D_DIFFKR is defined, add a Warning if any of the vertical
464        diffusivity (background) is specified but ignored.
465    o verification:
466      - in testreport, convert hostname to lower case for default output dir name
467    o model, pkg : add useCTRL, useECCO parameters (on/off run time switch).
468    o pkg/dic: add modifications from Hajoon:
469      - add iron sedimentation flux function of the flux of PO4 out of bottom layer
470      - light attenuation: add self-shading effect by climatological Chlorophyll
471        (read from file).
472    o pkg/seaice/seaice_preconditioner.F : fix cpp flags, so that code also
473        compiles when SEAICE_ALLOW_DYNAMICS is undefined
474    o global_oce_llc90,cs32 : ecco_v4 verification exps now use separate
475        AUTODIFF_OPTIONS.h, CTRL_OPTIONS.h, ECCO_OPTIONS.h rather than
476        ECCO_CPPOPTIONS.h (i.e. replacing the deprecated, circumvoluted,
477        approach where CPP_OPTIONS.h includes an omnipotent
478        ECCO_CPPOPTIONS.h that superseeds pkgs '_OPTIONS.h').
479    o pkg/ctrl/ctrl_map_ini_genarr.F : include GMREDI_OPTIONS.h where
480        ALLOW_3D_KAPGM, ALLOW_3D_KAPREDI (to be added later) belong.
481    o pkg/seaice/SEAICE_SIZE.h : replace ALLOW_AUTODIFF_TAMC with ALLOW_AUTODIFF
482        to avoid needing AUTODIFF_OPTIONS.h anytime SEAICE_SIZE.h is included
483        (it seems that THSICE_SIZE.h, PTRACERS_SIZE.h have the same issue...)
484    o model/src, pkg/smooth, profiles, salt_plume, seaice, exf, ecco, ctrl :
485      add ECCO_OPTIONS.h, AUTODIFF_OPTIONS.h, CTRL_OPTIONS.h when needed
486      - ECCO_OPTIONS.h is needed when including ecco_cost.h, ecco.h
487      - AUTODIFF_OPTIONS.h is needed when including tamc.h, tamc_keys.h
488      - CTRL_OPTIONS.h is needed when including ctrl.h, optim.h, etc
489    o pkg/ctrl,ecco,exf :
490      - remove variables associated with NON-generic costs,
491        unless ECCO_CTRL_DEPRECATED is defined.
492      - remove NON-generic NON-obcs controls,
493        unless ECCO_CTRL_DEPRECATED is defined.
494    o pkg/ctrl : added ctrl_local_params.h
495    o pkg/ecco : added ecco_local_params.h
496    o verification : added ECCO_CTRL_DEPRECATED to most as and oad
497        experiments, which will progressively be removed once the
498        experiments are revised to use only generic controls/costs.
499    
500    checkpoint65f (2014/10/13)
501    o pkg/ctrl, ecco, seaice : minor changes in headers
502    o global_oce_llc90,cs32 : ecco_v4 verification exps now test generic
503        cost function and control capabilities added since checkpoint65c.
504    o pkg/ctrl: regroup all obcs ctrl variables in CTRL_OBCS.h.
505    o pkg/ecco: increase modularity and improve logic
506      - ecco_toolbox.F (new) : basic operations that are often used,
507        including ecco_zero, ecco_cp, ecco_cprsrl, ecco_diffmsk,
508        ecco_addcost, ecco_add, ecco_div, ecco_readbar.
509      - cost_gencal.F (new) : determine filnames and records.
510      - cost_genread.F, cost_generic.F : condense code using ecco_toolbox.
511      - cost_generic.F : use spzeroloc rather than hard-coded -9999,
512        and exploit the above functions leading to more compact code.
513      - cost_genread.F : rm un-necessary arguments, re-arrange args order.
514      - ecco_check.F, ecco_readparms.F : bring logic up to date (using_tpj,
515        using_ers, using_gfo, using_mdt is now only defined within gencost)
516    o pkg/ecco: extend generic cost capabilities
517      - pkg/ecco : added 3D gencost (ALLOW_GENCOST3D), added gencost
518        capabilities via gencost_preproc (+ _c,_i,_r related params),
519        gencost_posproc (+ _c,_i,_r related params), gencost_nrecperiod,
520        gencost_outputlevel arguments to cost_generic
521      - pkg/ecco/cost_genread.F (new) : interface between cost_generic
522        and active_read, making room for gencost_preproc to take effect.
523        Added preproc code ('climmon') to replace GENERIC_BAR_MONTH.
524      - pkg/ecco/cost_generic.F :
525        compute and store misfit maks*(model-data) in localdif that is
526        then used in cost and for output, output misfit if outlev.GT.0
527      - pkg/ecco/cost_averagesfields.F : depend on gencost_barskip
528        rather gencost_barfile for deciding whether to write barfile
529      - pkg/ecco/ecco_cost_driver.F : extract call to cost_profiles from cost_hyd
530      - pkg/ecco/ecco_cost_init_fixed.F : extract gencost weights from
531        ecco_cost_weights, re-activate ecco_summary, determine gencost_barskip
532      - pkg/ecco/ecco_summary.F : report gencost variables
533      - pkg/ecco/cost_gencost_customize.F : treat case of scatterometer costs
534    o pkg/sea/SEAICE_OPTIONS.h : add ALLOW_COST_ICE, ALLOW_SEAICE_COST_SMR_AREA
535    o pkg/ecco: internal re-organization
536      - resolve un-necessary dependancies within pkg/ecco and to pkg/ctrl
537        (rm includes of optim.h and ctrl.h, replace optimcycle with eccoiter,
538        mv relevant variables definition from ecco_cost.h to ecco.h,
539        make sure gencost routines only include ecco.h)
540      - throughout : add missing CCP switches, rm unused variables,
541        and rm un-necessary CPP switches
542      - throughout gencost routines : replace modelstartdate with
543        gencost_startdate when needed
544      - cost_bp_read.F : use arguments, instead of common blocs
545        so that it can be used also by (new) cost_gencost_bpv4.F
546      - ecco_init_varia.F : initialize RHOsumGlob_0, VOLsumGlob_0
547      - ecco_phys.F : compute etanFull
548      - ecco_readparms.F : rename using_topex as using_tpj, add
549        bpv4-grace to gencost list, initialize added parameters
550      - ecco_summary.F : include SIZE.h needed for augmented ecco.h
551    
552    checkpoint65e (2014/09/28)
553    o pkg/obcs:
554      - replaced the just-added CPP options with run-time variables
555        (see pkg/obcs/OBCS_PARAMS.h for details)
556    o pkg/obcs:
557      - add additional CPP options for sponge boundary layers
558        (see pkg/obcs/OBCS_OPTIONS.h for details)
559    o pkg/atm_phys:
560      - implement simple (obliquity only, assuming circular planet orbit)
561        seasonal cycle for incoming insolation ; used when run-time parameter
562        "select_incSW" is set to 1 ; by default (=0), uses old unchanged formula.
563    o pkg/exf, pkg/ecco, pkg/ctrl:
564      - add ctrlUseGen and .NOT.ctrlUseGen exclusive brackets
565      - activate gentim2d for xx_atemp,xx_aqh,xx_swdown,xx_lwdown,xx_precip
566      - implement gentim2d for xx_tauu, xx_tauv
567    o pkg/ctrl, pkg/ecco :
568      - fix and complement the generic controls implementation
569    o pkg/exf/exf_getclim.F, exf_getffields.F, exf_getsurfacefluxes.F,
570        pkg/shelfice/shelfice_thermodynamics.F,
571        verification/hs94.1x64x5/code_ad/ctrl_map_gentim2d.F,
572        verification/hs94.1x64x5/code_oad/ctrl_map_gentim2d.F :
573      - add weight in CTRL_GET_GEN calls
574    o pkg/ctrl :
575      - ctrl_get_gen.F : add weight as input parameter, and apply
576        it directly rather than using smooth_correl2Dw (to be retired).
577      - ctrl_map_gentim2d.F : add wgentim2d in CTRL_GET_GEN call
578    o pkg/ctrl :
579      - introduce run time switch ctrlUseGen (in ctrl.h, ctrl_check.F,
580        ctrl_init_variables.F, ctrl_readparms.F, ctrl_summary.F)
581      - re-activate ctrl_summary (call in ctrl_init.F)
582    o pkg/ctrl/ctrl_cost_gen.F :
583      - fix CCP brackets, remove un-necessary myiter, mytime
584    o pkg/ecco, pkg/ctrl :
585      - remove cost_genctrl.F (now pkg/ctrl/ctrl_cost_driver.F)
586      - remove cost_forcing_gen.F (now pkg/ctrl/ctrl_cost_gen2d.F)
587      - add ctrl_cost_driver.F (replaces pkg/ecco/cost_genctrl.F)
588      - add ctrl_cost_gen2d.F (replaces pkg/ecco/cost_forcing_gen.F)
589    
590    checkpoint65d (2014/09/15)
591    o pkg/ctrl/CTRL_GENARR.h, ctrl_readparms.F :
592      - add xx_genarr2d_bounds,xx_genarr3d_bounds,
593        xx_genarr2d_numsmooth, xx_genarr3d_numsmooth
594    o pkg/ctrl/ctrl_map_ini_genarr.F :
595      - remove compilation failure
596      - replace hard coded example
597      - use ctrl_map_ini_gen2D, 3D
598    o pkg/ctrl/ctrl_pack.F, ctrl_unpack.F :
599      - on/off switch based upon xx_genarr2d_weight,3d
600    o src/packages_init_variables.F :
601      - regroup pkg/estimation calls
602      - remove CTRL_MAP_INI, CTRL_MAP_INI_ECCO
603        (moved to ctrl_init_variables)
604    o cost/cost_init_varia.F :
605      - remove ecco_cost_init_varia
606        (moved to ecco_init_varia)
607    o ctrl/ctrl_init_variables.F :
608      - add CTRL_MAP_INI, CTRL_MAP_INI_ECCO
609      - add CTRL_MAP_INI_GENARR, SEAICE_CTRL_MAP_INI
610    o ctrl/ctrl_map_ini.F :
611      - remove ctrl_map_ini_genarr, seaice_ctrl_map_ini
612        (moved to ctrl_init_variables)
613    o ctrl/ctrl_map_ini_ecco.F :
614      - remove ECCO_PHYS (mv to ecco_init_varia)
615      - remove seaice_ctrl_map_ini (mv to ctrl_init_variables)
616    o ecco/ecco_ad_diff.list :
617      - add ecco_init_varia.f
618    o ecco/ecco_init_varia.F
619      - new routine
620    o pkg/streamice:
621      - move call to STREAMICE_INITIALIZE_PETSC from the_model_main.F
622        to streamice_init_fixed.F ; fix setting of STREAMICEisOn.
623      - from model/src, only call pkg/streamice routines if useStreamIce is TRUE.
624    o pkg/generic_advdiff:
625      - fix bug causing negatives in GAD_SMOLARKIEWICZ_HACK, introduced 8/8/2014.
626    o pkg/exf:
627      - exf_getffields.F : add xxg_atemp, xxg_aqh, xxg_swdown, xxg_lwdown,
628         xxg_precip capability
629      - exf_wind.F : no need for ALLOW_WSPEED_CONTROL cpp switch
630    o pkg/ctrl:
631      - ctrl_pack.F, ctrl_unpack.F : omit (un)packing of undefined xx_gentim2d
632    o model/src/load_fields_driver.F :
633      - move call to CTRL_MAP_GENTIM2D ahead of BULKF_FIELDS_LOAD, EXF_GETFORCING
634        so xx_gentim2d can be applied to e.g. exf fields in a timely manner.
635    o OpenAD verification experiments:
636      - Include explicitly AUTODIFF_OPTIONS.h, COST_OPTIONS.h, and CTRL_OPTIONS.h
637        in src files (to enable to skip the ECCO_CPPOPTIONS.h);
638        for now, only in pkgs used in OpenAD verification experiments.
639      - Change all except one (halfpipe_streamice) OpenAD experiments to use pkg
640        specific option file (AUTODIFF_OPTIONS.h, COST_OPTIONS.h & CTRL_OPTIONS.h)
641        instead of using ECCO_CPPOPTIONS.h (with all relevant options in it).
642        This applies to both TAF (*/code_ad/) and OpenAD (*/code_oad/) tests.
643    o OpenAD verification tests:
644      - finish removing ALLOW_AUTODIFF_OPENAD (replaced by ALLOW_OPENAD);
645      - finish replacing ALLOW_AUTODIFF_TAMC by ALLOW_AUTODIFF (except for
646        tape/storage which are specific to TAF/TAMC) in pkgs used in OpenAD exp.
647      - leave ALLOW_AUTODIFF_TAMC undef in OpenAD verification tests (*/code_oad/)
648        and remove local copy of "tamc.h" (needed only if ALLOW_AUTODIFF_TAMC).
649    o model/src & generic_advdiff:
650      - change hard-coded loop-range in S/R APPLY_FORCING_T/S to set T & S
651        forcing over 0:sNx+1, 0:sNy=1 (instead of just 1:sNx,1:sNy): Model
652        dynamics requires valid tracer forcing only over tile interior but, for
653        some diagnostics, may need to extend it over 1 point in tile halo region.
654      - in gad_calc_rhs.F, update calls to gmredi_x/ytransport to get valid
655        tendency over i,j_Min,Max range. This allows to simplfy i,j_Min,Max
656        setting in temp/salt/ptracer_integrate.F
657    o pkg/dic:
658      - multiply tracer tendencies by maskInC (if ussing OBCS) before updating
659        gchem tracers: this allows to skip the 2nd call to OBCS_APPLY_PTRACER
660        in gchem_forcing_sep.F
661    o pkg/autodiff & obcs:
662      - add storage of current OB values for U & V (was already done for T & S).
663    
664    checkpoint65c (2014/08/30)
665    o pkg/dic:
666      - take out of dic_atmos.F the initialisation part (corresponding to istate=0)
667        and move it to new S/R DIC_INI_ATMOS ; also simplify the dependencies for
668        AD compilers (but still a Pb with multi-threading and Ajoint dependencies).
669    o verification:
670      - new experiment testing OBCS and DIC pkgs, using params & output from
671        tutorial_global_oce_biogeo but limited to a sub-domain around Drake
672        passage: take OBCS from the last year of a 2 yrs simulation and initial
673        conditions from t=1.yr while keeping the same forcing.
674    o model/src:
675      - when allowFreezing=T, only reset below freezing initial Temp to Tfreezing
676        (at any k) if checkIniTemp is not set to FALSE (default checkIniTemp=T).
677    o pkg/diagnostics (Stats-Diags):
678      - re-write S/R DIAGSTATS_CALC (more similar to TARGET_NEC_SX part) to:
679        a) refine region where stats are computed, excluding where arrhFac=0 ;
680        b) fix missing interior mask (use with OBCS) in 3-D fields statistics;
681        c) extend regional stats over the region edges (for U or V pt location).
682    o pkg/gchem:
683      - add a (2nd) call to OBCS_APPLY_PTRACER in gchem_forcing_sep.F (needed since
684        pkg/dic is currently changing/updating ptracers values beyond the OB).
685    o verification (hs94):
686      - convert Held & Suarez external_forcing.F (from hs94.cs, with Sigma-coords
687        bits) to apply_forcing.F and undef USE_OLD_EXTERNAL_FORCING in experiments
688        hs94.cs-32x32x5 and tutorial_held_suarez_cs ; also use the same version of
689        apply_forcing.F in 2D hs94 (fwd, ad & oad) but keep LatLon hs94 unchanged.
690    o pkg/ptracers:
691      - implement Adams-Bashforth on pTracers (instead of on tracer tendency),
692        switched on by setting PTRACERS_doAB_onGpTr=F (default set to doAB_onGtGs)
693      - change exp4 secondary test (input.nlfs) to test AB on T & S & pTracer
694        with AB-2 code (so that it get tested).
695    o model/src:
696      - allow to apply Adams-Bashforth on Temp & Salt (instead of on gT,gS)
697        with AB-2 code (previously only available with AB-3 code).
698        Also move the code (call to ADAMS_BASHFORTH S/R) form thermodynamics.F
699        to temp/salt_integrate.F (since the 2nd part of gt/sNm1 update is done
700        there, by calling CYCLE_AB_TRACER).
701    o pkg/generic_advdiff:
702      - change Tracer argument (drop bi,bj indices) in S/R GAD_CALC_RHS,
703        GAD_C2_ADV_R, GAD_U3_ADV_R, GAD_C4_ADV_R, GAD_DIFF_R, GAD_BIHARM_R
704        + also in GMREDI_X/Y/RTRANSPORT ; and update corresponding calls in
705        S/R temp/salt/ptracers_integrate.F
706    o model/src & pkg/ptracers:
707      - remove common block variables gT,gS (in DYNVARS.h), except when
708         USE_OLD_EXTERNAL_FORCING is defined; update TAF storage accordingly.
709      - remove common block variable gPtr.
710    o model/src & pkgs:
711      - change gTracer (and/or tracer) argument (drop bi,bj indices) in S/R
712         ADAMS_BASHFORTH(2&3), CYCLE_(AB_)TRACER, FREESURF_RESCALE_G,
713         IMPLDIFF, SOLVE_TRIDIAGONAL & _PENTADIAGONAL, GAD_SOM_ADVECT,
714         GAD_ADVECTION, GAD_CALC_RHS, GAD_IMPLICIT_R, TIMEAVE_CUMUL_DIF_1T
715      + change accordingly all calling S/R.
716      - use local temperature/salinity/ptracer tendency array (without bi,bj)
717        in S/R temp/salt/ptracers_integrate.F
718    o pkg/seaice:
719      - move computation of stress contributions to rhsU/V in s/r seaice_lsr
720        to separate s/r seaice_lsr_rhsu/v in order to be able to re-use code
721      - make u/vIceC local variables if SEAICE_CGRID is defined only to be used
722        in seaice_lsr
723      - seaice_lsr.F: make local 4D arrays UXX, VYY, etc 2D
724        in s/r seaice_lsr_calc_coeffs
725    o pkg/mdsio:
726      - in MDS_READ/WRITE_FIELD, stop if file-name (+prefix) is too long
727        (e.g., > MAX_LEN_MBUF -90 ) or, in INI_MODEL_IO, if mdsioLocalDir is
728        too long (e.g., > MAX_LEN_FNAM/2 )
729    
730    checkpoint65b (2014/08/12)
731    o pkg/matrix:
732      - pass, as argument, updated tracer field to S/R MATRIX_STORE_TENDENCY_EXP
733    o model/src:
734      - fix initialisation of geothermalFile; compile geothermal-flux code in
735        natl_box verification experiment.
736    o model/src & pkg/down_slope:
737      - push the k loop inside S/R TIMESTEP_TRACER (now called outside the k loop).
738      - in dwnslp_apply.F, update tracer tendency instead of the future tracer
739        field and call S/R DWNSLP_APPLY before TIMESTEP_TRACER; this affects
740        results at machine truncation level: update output of experiments
741        global_ocean.90x40x15.dwnslp (FWD) and lab_sea.noseaicedyn (AD).
742    o pkg/diagnostics (Stats-Diags):
743      - do not cumulate the full volume when DIAGNOSTICS_FILL is
744        called with bibjFlg < 0 (no increment of the counter for 2D/3D diag);
745        This fix the mean statistics when DIAGNOSTICS_FILL is called multiple
746        times (but Min,Max and StD are still wrong).
747    o model/src:
748      - add geothermal flux forcing: read in ini_forcing.F as time-constant
749        field "geothermalFlux" applied in S/R APPLY_FORCING_T (apply_forcing.F)
750    o model/src:
751      - move CYCLE_TRACER calls from tracers_correction_step.F to temp/salt/ptracer
752        _integrate.F so that, when leaving S/R THERMODYANMICS, theta,salt and pTrac
753        arrays are already updated while adjustments (filters, conv.adjustment) are
754        still applied later, in S/R TRACERS_CORRECTION_STEP.
755  o model/src:  o model/src:
756    - store in common bloc array "rhoInSitu" the virtual potential temperature    - store in common bloc array "rhoInSitu" the virtual potential temperature
757      anomaly that is used to compute geopotential: this make the atmos code      anomaly that is used to compute geopotential: this make the atmos code
# Line 82  o model/src: Line 830  o model/src:
830    - collect T & S forcing tendency into local 2-D array (passed as argument to    - collect T & S forcing tendency into local 2-D array (passed as argument to
831      apply_forcing S/R); add 3-D diagnostics for temp & salt forcing tendency.      apply_forcing S/R); add 3-D diagnostics for temp & salt forcing tendency.
832      affects results at machine truncation level (e.g., ocean: if using      affects results at machine truncation level (e.g., ocean: if using
833      SHORTWAVE_HEATING and atmos:, if using FrictionHeating or (atm_Rq<>0)      SHORTWAVE_HEATING ; atmos: if using FrictionHeating or (atm_Rq<>0) moist
834      moist correction due to vertical advection).      correction due to vertical advection).
835    - update output of experiments: fizhi-cs-32x32x40 (13 digits),    - update output of experiments: fizhi-cs-32x32x40 (13 digits),
836      global_ocean.cs32x15 (fwd: icedyn, seaice, thsice, all 3 @ 11d; adm & tml:      global_ocean.cs32x15 (fwd: icedyn, seaice, thsice, all 3 @ 11d; adm & tml:
837      seaice_dynmix & thsice, fwd grd @ 3 & 8), hs94.1x64x5 (ad grd @ 13),      seaice_dynmix & thsice, fwd grd @ 3 & 8), hs94.1x64x5 (ad grd @ 13),
# Line 112  o pkg/seaice: more clean up Line 860  o pkg/seaice: more clean up
860      nearly a factor of 10 (but keep in mind there is mostly seaice code in      nearly a factor of 10 (but keep in mind there is mostly seaice code in
861      this experiment):      this experiment):
862      > size mitgcmuv_ad      > size mitgcmuv_ad
863      text    data        bss     dec        hex        text    data        bss     dec        hex
864      5100659 1216  220458952  225560827  d71c8fb      5100659 1216  220458952  225560827  d71c8fb
865      5339425 1200 1868783272 1874123897 6fb4dc79 (SEAICE_LSR_ADJOINT_ITER)      5339425 1200 1868783272 1874123897 6fb4dc79 (SEAICE_LSR_ADJOINT_ITER)
866      but only a moderate increase of 36% for global_ocean.cs32x15:      but only a moderate increase of 36% for global_ocean.cs32x15:
867      text    data        bss     dec        hex      text    data        bss     dec        hex

Legend:
Removed from v.1.2040  
changed lines
  Added in v.1.2175

  ViewVC Help
Powered by ViewVC 1.1.22