/[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.1901 by jmc, Thu Jul 25 01:12:45 2013 UTC revision 1.2218 by jmc, Fri Dec 25 04:40:29 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/atm_compon_interf:
8      - store state variables (for now, only thSIce fields) just before beeing
9        exported (in cpl_export_import_data.F, like on ocean side) instead of from
10        atm_store_my_data.F like all exported fluxes.
11      - new version of pickup_cpl: write field names into meta file and read meta
12        file to find field postion in pickup. Also only write/read fields meeded for
13        restart (same logic as main pickup file ; also using pickupStrictlyMatch)
14    o pkg/dic:
15      - fix bug (added on 2014/08/30) in dic_atmos.F for the case dic_int1= 2 or 3.
16    o pkg/seaice: add new parameter SEAICEpressReplFac to choose between
17        pressure replacement method (=1., default) or original Hibler (1979) (=0.)
18        value can be from domain [0,1] to average between the two methods
19    o pkg/atm_phys:
20      - allow to provide 2-d map of albedo and mixed-layer depth from files (but
21        hold fixed in time).
22    
23    checkpoint65r (2015/12/21)
24    o pkg/seaice:
25        fix bug in tridiagonal solvers for SEAICE_OLx/y>0, this affects the JFNK
26        solver (offline.dyn_jfnk) and global_ocean.cs32x15.seaice -> updated
27    o pkg/seaice:
28      - fix a bug in computing areaS in (J-J -> J-1) that affects runs
29        when SEAICEscaleSurfStress=.TRUE.,
30      - apply areaW and areaS in S/R seaice_calc_lhs
31    o pkg/atm_phys:
32      - add diagnostics for 3-D, Nr+1 levels diagnostics of radiative fluxes
33        (shortwave & longwave, net & downward) and diagnostics of temp. tendency
34        for individual contribution (convection, LSC cond, radiation)
35      - add Ruth Geen etal, GRL 2016, radiation optionis (see paper supp.
36        information); activated with: solar_exponent=0. and wv_exponent=-1.
37    o pkg/ggl90:
38      - within IDEMIX add upper limit for horizontal group velocity to
39        avoid instability problems in the explicit horizontal diffusion term for
40        long time steps or high resolution
41    o pkg/diagnostics:
42      - simplify setting of local-array size in diagstats_output.F: uses "numLevels"
43        (from DIAGNOSTICS_SIZE.h) to allow to write out more than Nr levels.
44    o testreport:
45      - remove "-v" (verbose option) in default mpirun command.
46    o pkg/seaice/seaice_growth:
47      - catch potential division by zero in ITD code, does not change
48        verification results
49    o pkg/ecco:
50      - retire old codes to the Attic. The calls to retired functions are
51        left in a commented form in case they ever need to be re-activated.
52      - ecco_check.F: issue warning if any old CPP option is
53        defined that corresponds to retired codes -- then stop.
54    o pkg/atm_compon_interf:
55      - change seaice fraction (use for OCN dic surf.flux) stored and sent to
56        coupler: use last time-step value instead of average over cplSendFrq_iter
57        time-step, similar to what is done for seaIceMass.
58        This will affect results (pkg/dic) of coupled ATM-OCN+dic set-up.
59    o eesupp & genmake2:
60      - from Jinxuan Zhu: change etime fct call to S/R call (fix gfortran ETIME);
61        <= remove until a fix is found for some ifort version on ia32 machine.
62    o pkg/seaice/seaice_evp:
63      - refine residual computation
64    
65    checkpoint65q (2015/11/18)
66    o pkg/seaice/seaice_evp:
67      - fix residual computations so that they no longer affect the actual
68        simulation code
69      - fix seaice_readparams to be able to actually set new parameters
70        SEAICEaEVPcStar and SEAICEaEVPalphaMin, also fix logic a little
71    o model/src:
72      - fix wrong truncation (single prec) from "FLOAT" function in expressions
73        like: deltaT*FLOAT(myIter) when myIter is large:
74         a) replaced by DFLOAT (if not seen by TAF);
75         b) remove "FLOAT" and use implicit type conversion (if seen by TAF).
76    o pkg/aim_v23:
77      - write/read the expected CO2 pickups (from S/R AIM_DO_CO2): fix reading
78        when pickupSuff is set ; do write rolling pickups + at the end of the run.
79    o pkg/atm_ocn_coupler + ocn_compon_interf:
80      - in prep for using pkg/seaice Dyn in coupled set-up, implement sequential
81        coupling option-1: ATM -(cpl)-> OCN and then OCN -(cpl)-> ATM ;
82        add corresponding call in DO_OCEANIC_PHYS.
83    o coupler pkgs:
84      Start a new way to set-up optionally-exchanged variables (previously, only
85       there for exchange_DIC): switch on/off from 1 place, at run-time, in coupler
86       data.cpl (new) instead of at compile time in ATMIDS.h & OCNIDS.h ;
87       send switch to ATM & OCN compon before reading their own "data.cpl" (so that
88       compononent param default can be set accordingly).
89      Note: this new switch (cpl_exchange_[xxx]) is not a per variable switch
90       but rather applies to a group a fields (going both ways like for DIC)
91       and corresponds to an option of coupling config.
92      coupler (pkg/atm_ocn_coupler):
93      - change parameter file from "data" to "data.cpl" (in cpl_read_params.F),
94        and read namelist directly (without eessup S/R calls) instead of
95        in the very un-flexible old way, 1 param per line, in fixed order;
96      - add error-counter to track errors (e.g., missing "data.cpl") and to stop
97        cleanly in CPL_CHECK_CPLCONFIG
98      - add new coupling-exchange selectors (some not yet active) including
99        cpl_exchange_DIC (to set to 3 to replace atmCpl_exchange_DIC=T in ATMIDS.h
100                                             and ocnCpl_exchange_DIC=T in OCNIDS.h);
101      - add 2 new S/R (CPL_SEND_ATM/OCN_CPLPARMS) to send coupler-params to each
102        component ; called directly from coupler.F, after comp. registrations;
103      - rename few variable-ID names (in ATMIDS.h & OCNIDS.h):
104         atm/ocnSeaIceName --> atm/ocnSIceMassName ; atm/ocnFCO2Name ->
105          -> atm/ocnCO2FluxName ; atm/ocnWSpdName --> atm/ocnWindSpdName
106      components (pkg/atm_ & ocn_compon_interf):
107      - add ATM/OCN_CPL_OPTIONS.h in component pkgs and include the corresponding
108        CPP header file in all pkg source files.
109      - move checking of comp. configs out of cpl_exch_configs.F into new S/R
110        ATM/OCN_CHECK_CPLCONFIG;
111      - add error-counter to track errors (e.g., in "data.cpl") and to stop
112        cleanly in ATM/OCN_CHECK_CPLCONFIG;
113      - add new S/R CPL_IMPORT_CPLPARMS to import coupling-exchange selectors
114        from coupler ; called from initialise_fixed.F, after PACKAGES_BOOT and
115        before PACKAGES_READPARMS;
116      verification/cpl_aim+ocn/:
117      - update ATMIDS.h & OCNIDS.h (in shared_code) and use new parameter file
118        "data.cpl" for coupler (in input_cpl).
119    o eesupp/inc:
120      - change the MPI-global-sum default (in CPP_EEOPTIONS.h) to:
121        #define GLOBAL_SUM_ORDER_TILES (only affects MPI built of global_sum_tile.F)
122        to always cumulate tile local-sum in the same order (still uses
123        MPI_Allreduce like standard code).
124      - in verification experiment code, remove local CPP_EEOPTIONS.h_mpi files
125        that are now identical to standard version (in eesupp/inc).
126    o pkg/shelfice:
127      - add SHELFICETransCoeffTFile for initializing spatially varying
128        heat and salt transfer coefficients
129    o pkg/atm_compon_interf & ocn_compon_interf:
130      - combine into 1 (new) S/R CPL_EXPORT_IMPORT_DATA the two previous
131        S/R CPL_EXPORT_MY_DATA & CPL_IMPORT_EXTERNAL_DATA
132      - move bi,bj loops inside S/R OCN_STORE_MY_DATA
133    o pkg/atm_ocn_coupler:
134      - initialise to zero ATMVARS.h & OCNVARS.h arrays.
135    o pkg/rbcs:
136      - select RBCS-mask for Temp & Salt the same way as for pTracer ; this allows
137        to compile with maskLEN=1 when all tracers use the same RBCS-mask.
138      - add a short report (to STDOUT) about RBCS-mask settings.
139    
140    checkpoint65p (2015/10/23)
141    o pkg/seaice/seaice_evp.F: fix store directives and key computations, since
142        there is no adjoint test for EVP, we don't know what it does to the adjoint
143        solution, but at least there are no more recomputation warnings left
144    o pkg/seaice/seaice_evp.F: slight modification of averaging so that EVP stands
145        a chance of giving the same results as a fully converged VP (JFNK) solver
146    o tools/adjoint_options/adjoint_diva:
147      - fix bug (typo) in Tang-Linear FLAGS setting for MPI + DIVA
148    o pkg/streamice:
149      - spotted bug in streamice_driving_stress using dyG where should have been dxG
150    o pkg/exf:
151      - remove STOP statement that prevented to use wind or (wind-)stress
152        interpolation for constant-in-time forcing fields (wind/stress period = 0).
153    o pkg/seaice:
154      - replace SEAICE_EVP_USE_ADAPTATION by run time parameters, requires
155        5 additionals 2D fields and 6 new store directives
156      - change logic in seaice_readparms.F: EVP code can now be turned on in
157        various ways, setting SEAICE_deltaTev is no longer required,
158        alternatively set SEAICE_evpAlpha/Beta, SEAICEuseEVPstar, SEAICEuseEVPrev,
159        or SEAICEaEVPcoeff
160    o pkg/shelfice/shelfice_thermodynamics.F
161      - redefining uLoc/vLoc to u/v, instead of 2u/v
162    o pkg/seaice/seaice_evp.F: introduce "adaptive EVP" by Madlen Kimmritz
163      - this is an intermediate state of a truely converging EVP that has
164        the potential of outperforming implicit VP methods, I do not recommend
165        using it yet.
166      - for now, "adaptive EVP" is turned on by setting SEAICE_EVP_USE_ADAPTATION
167        and all parameters are hardwired
168      - for convergence it still requires very smooth regularisations, that means,
169        if SEAICE_DELTA_SMOOTHREG is defined, deltaCreg=deltaC+deltaMin, which is
170        different from the VP case with deltaCreg=sqrt(deltaC**2+deltaMin**2); also
171        specific averaging appears to be required, still subject to tuning
172      - still needs cleaning and I need to turn parameter into runtime parameters
173      - add code to compute and print residuals of iteration, compile with
174        defining ALLOW_SEAICE_EVP_RESIDUAL to enable it
175    o pkg/seaice/seaice_evp.F: fix a bug (factor of four in front of e12Csq)
176      that entered with r1.54 on Sep04, 2015, -> update results
177    
178    checkpoint65o (2015/09/14)
179    o pkg/mom_vecinv & mom_common:
180      - add deep-atmosphere geometry factor in mom_calc_visc.F + in routines
181        called from there.
182      - add anelastic and deep-atmosphere geometry factor in pkg/mom_vecinv ; this
183        allows to use Vector-Invariant form in deep atmos and anelastic formulation
184    o pkg/seaice: introduce fast ice parameterisation following Itkin et al. (2015)
185      and Koenig-Beatty+Holland (2012)
186      - two new parameters SEAICE_tensilFac and SEAICE_tensilDepth
187      - global 2D field tensileStrength, computed in seaice_calc_ice_strength
188      - requires an extra input argument for S/R seaice_calc_viscosities
189      - tensileStrength's depth dependence is different from Itkin et al. (2015)
190        (to be changed and played with, for now exponential)
191    o pkg/seaice: introduce new parameter SEAICEscaleSurfStress (default = .FALSE.)
192      - if TRUE scale ice-ocean and ice-atmosphere stress acting on sea ice
193        by AREA according to Connelly et al. (2004), JPO.
194      - For EVP and the LSR solver, the implicit part of the drag term is
195        the only non-zero term in the denominator when there is no ice (which
196        prevented running the model with zero ice-ocean drag). If
197        SEAICEscaleSurfStress = .TRUE., this results in a division by zero
198        (or zero main diagonals BU/BV) which need to be caught. A practical
199        consequence is that for open water, the momentum equation reduce
200        to trivially 0 = 0 + 0 (for EVP). For LSR, BU/BV are reset to 1, if
201        they happen to be zero, often leading to a non-zero solution over
202        open water.
203    o pkg/seaice: revise EVP code (seaice_evp.F) in preparation for a more
204        efficient EVP method.
205      - introduce area-weighted averages for e12 (analogously to
206        seaice_calc_viscosities.F); this totally changes lab_sea.hb87 (2 digits
207        remain, but also changing the order of terms in the previous average
208        changed the results as much) -> update experiment
209      - add SEAICE_DELTA_SMOOTHREG code
210      - disentangle computation of zetaC/deltaC and zetaZ/deltaZ, also for
211        TEM-code
212      - adjust loop bounds so that only required fields are computed
213      - add new averaging code for zetaZ/deltaZ (again similar to
214        seaice_calc_viscosities.F), inactive by default for now (will change
215        results again), but will replace old code eventually
216    o eesupp/src:
217      - add an other alternative for multi-proc GLOBAL_SUM (in global_sum_tile.F)
218        to always cumulate tile local-sum in the same order
219        (option #define GLOBAL_SUM_ORDER_TILES in CPP_EEOPTIONS.h).
220        Still uses MPI_Allreduce (like standard code) but on array of tiles
221        and should be faster than GLOBAL_SUM_SEND_RECV code.
222      - switch almost all verification experiments that use GLOBAL_SUM_SEND_RECV
223        (defined in CPP_EEOPTIONS.h_mpi) to GLOBAL_SUM_ORDER_TILES instead.
224      - add CPP_EEOPTIONS.h_mpi with GLOBAL_SUM_ORDER_TILES defined in 14 more exp.:
225         aim.5l_cs, cheapAML_box, deep_anelastic, dome, fizhi-cs-32x32x40,
226         fizhi-cs-aqualev20, fizhi-gridalt-hs, global_ocean_ebm, matrix_example,
227         natl_box, solid-body.cs-32x32x1, tutorial_advection_in_gyre,
228         tutorial_baroclinic_gyre and tutorial_held_suarez_cs.
229    
230    checkpoint65n (2015/07/29)
231    o pkg/thsice:
232      - add a warning when used with pkg/aim but without updating SST
233        (stepFwd_oceMxL=F & useCoupler=F & tauRelax_MxL<>-1 ).
234    o pkg/offline:
235      - change where Offline-Fields are loaded, from load_fields_driver.F to
236        directly within FORWARD_STEP, just after updating iter number and time;
237      - move setting of GM and KPP diffusivity out of OFFLINE_FIELDS_LOAD into new
238        S/R OFFLINE_GET_DIFFUS that is called towards the end of DO_OCEANIC_PHYS;
239       These changes allow:
240        a) to recover exactly on-line results using deltaToffline=deltaTClock,
241        tested (using offlineIter0= nIter0 -1 and offlineTimeOffset= -deltaT/2)
242        both with Lin & Non-Lin Free-Surf, both with staggerTimeStep & synchronous
243        time-step, both with GM & KPP files and with recomputing these fields;
244        b) no needs to switch on staggerTimeStep anymore;
245        c) simplify rescaling of offline horiz. velocity with Non-Lin Free-Surf.
246      - update output of experiment tutorial_dic_adjoffline (only 3 digits left).
247    o pkg/offline:
248      - change (rarely used) offset-iteration parameter to an offset time (in s):
249        can easily recover previous offset-iter effect by setting offset-time
250        (offlineTimeOffset) to offset-iter x deltaToffline;
251      - do not turn-off Temp & Salinity surface relaxation when using KPP (used
252        in KPP as part of surface buoyancy forcing) in offline run.
253      - fix ptracers KPP non-local term in the case where KPP is re-computed.
254    o OpenAD
255      - Adding preliminary ggl90 test to OpenAD verification.
256        Config. with ggl90 currently diverges after 64 time steps
257        so will need more work to become more stable
258      - Adding preliminary kpp test to OpenAD verification.
259        required small tweakes in kpp_routines.F
260      - Merge and update from Krishna Narayanan's contrib area:
261        * Add one variable for preliminary OpenAD DIVA
262        * Add replacement time-stepping for OpenAD DIVA
263        * genmake2 flag -diva (but only for OpenAD; preliminary)
264        * required modifs for OAD_support
265        successful preliminary test for tutorial_global_oce_biogeo/
266    o pkg/seaice:
267      - initialise deltaC in seaice_lsr, cosmetic changes in seaice_lsr
268      - add cpp-flag SEAICE_DELTA_SMOOTHREG for option of regularising
269        delta with a smooth function in s/r seaice_calc_viscosity
270        (no effect on EVP)
271      - rename local suffix "sqr" into "sq" for more consistent variable names
272    o pkg/seaice:
273        add new parameter SEAICE_deltaMin that is used ***only***
274        for regularizing Delta (and nothing else, like the parameter
275        which is also used for all sorts of things SEAICE_EPS).
276        Defaults to SEAICE_EPS for backward compatibility only.
277    o pkg/seaice: replace erroneously storing e12Csqr on the wrong tape with
278        the wrong key by inialising it before use -> fixes a recomputation
279        problem but does not fix the gradient
280    o pkg/layers:
281      - move resetting of flux arrays to outside the iLa loop
282        (this caused layers_diapycnal to not work with more than one layer coord.)
283      - fix bug in calculation of layers_recip_delta in layers_init_fixed.F
284    o pkg/layers:
285      - remove from common block 3D layers fields (used to diagnose transport
286        in tracer coords) and declare them as local arrays in layers_calc.F
287    o pkg/seaice:
288      - Rename SEAICE_VECTORIZE_LSR_ZEBRA to SEAICE_LSR_ZEBRA and define it
289        in lab_sea forward experiment (changes results -> updated)
290      - update adjoint experiment lab_sea after cleaning up seaice_lsr_tridiagu/v
291    o pkg/seaice: modify seaice_lsr.F in order to improve the gradient
292       computations; for SEAICE_VECTORIZE_LSR
293      - move the loops over which the tridiagonal solvers (seaice_lsr_tridiagu/v)
294        sweep to the outside,
295      - remove store directives and add "CADJ loop sequential" directives
296        in analogy to model/src/solve_tridiagonal.F
297      - replace many "#ifdef SEAICE_VECTORIZE_LSR_ZEBRA" by variable loop
298        boundaries to yield more readable code. This has also the charming side
299        effect that your can use SEAICE_VECTORIZE_LSR_ZEBRA without
300        SEAICE_VECTORIZE_LSR (i.e. adjoint without recomputations in
301        seaice_lsr_tridiagu/v now requires either of these flags, vectorization
302        still requires SEAICE_VECTORIZE_LSR with SEAICE_VECTORIZE_LSR_ZEBRA as
303        an additional option)
304       The tridiagonal solvers are now completely analoguous to solve_tridiagonal.F
305       but the adjoint gradients (which are affected by this change) still explode.
306    o coupler (atm & ocn _compon_interf):
307      - avoid using Exch2 IO mapping if not suitable.
308    
309    checkpoint65m (2015/06/15)
310    o pkg/layers:
311      - clean-up old parameters setting (from Sep 2012):
312        + remove old parameters setting from common block (declared locally);
313        + stop if any old parameter is mixed with new parameters;
314        + check for valid or consistent parameter setting (e.g., layers_name)
315      - check that layers_bounds for Pot.Density are in the right range;
316        this is supposed to catch un-updated setting after recently shifting
317        potential density field "prho" by -1000 (now in "sigma" scale).
318    o pkg/layers:
319      - Added missing call to layers_fill for keeping track of tottend in
320        pkg/diagnostics/diagnostics_fill_state.F
321    o pkg/layers:
322      - added CPP flux LAYERS_FINEGRID_DIAPYCNAL to disable fine-grid binning
323        of diapycnal fluxes
324    o pkg/layers:
325      - reverted changes to interpolation to previous treatment; there
326        was never actually a problem
327    o pkg/layers:
328      - fix interpolation of layers tracers in the presence of partial cells
329      - add lots of new functionality to compute water mass transformation
330        (enabled by CPP flag LAYERS_THERMODYNAMICS)
331      - add new calls from main code (diags_oceanic_surf_flux.F,
332        thermodynamics.F, impldiff.F) and gad to save the necessary fields
333        for layers_thermodynamics calculations
334    o pkg/ptracers:
335      - add capability of stepping a passive tracer forward without advection
336        by setting PTRACERS_advScheme to 0.
337    o pkg/diagnostics:
338      - add few (threads) _BARRIER around any update of "diag_pkgStatus".
339    o pkg/layers:
340      - shift potential density field "prho" by -1000 for density layer averaging so
341        that it corresponds to usual "sigma" definition (i.e., rho(p=const)-1000);
342        Note that density bin boundaries (layers_bounds in data.layers) have
343        to be set accordingly (i.e., shifted, in sigma scale).
344    o pkg/layers:
345      - fix snap-shot output of layer thickness @ V.pt and output of pot.density
346      - fix calculation of layer non-weighted velocity and layer probability
347      - add diagnostics for pot.density used for layer averaging
348    o pkg/seaice:
349      - seaice_calc_viscosity.F: change computation of deltaC**2 to ensure
350        positiveness, modify a few comments and improve variable names,
351      - the changed computation of deltaC affects most seaice-related
352        experiments at the truncation level.
353        seaice_itd.thermo is affected by far the most, with
354        only 7 digits of agreement remaining; update experiments.
355    
356    checkpoint65l (2015/05/04)
357    o pkg/shelfice:
358      - in shelfice_thermodynamics.F, if SHELFICEBoundaryLayer=.true., then set
359        factor drKp1 to zero where it is negative (ie. do not use
360        SHELFICEBoundaryLayer if hFacC>1)
361      - the same for factor drLoc in shelfice_forcing.F
362    o tools/genmake2: move FEXTRAFLAGS from FFLAGS to FOPTIM to avoid a problem
363        with modules in ptracers, when using testreport option "-small_f"
364    o pkg/seaice/seaice_growth.F (in case of SEAICE_ITD)
365      - replace tmpscal1**1.36 by faster exp(1.36*log(tmpscal1))
366    o verification/testreport
367      - add new option -small_f
368        with this option testreport first makes the target small_f (*.f files)
369        before running make (all). This is useful for explicit inlining when
370        all sources need to be full available.
371    o pkg/exf/exf_interp.F:
372        remove previous changes related to reverse (decreasing) input grids latitude
373    
374    checkpoint65k (2015/04/01)
375    o pkg/ecco:
376        fix missing cosphi initialization; use eccoiter in place of optimcycle;
377        if autodiff is not compiled then use READ_REC_XY_RL/READ_REC_XYZ_RL
378        instead of active read/write
379    o pkg/ctrl:
380        if autodiff is not compiled then use READ_REC_XY_RL/READ_REC_XYZ_RL
381        instead of active read/write.
382    o pkg/autodiff: make autodiff_readparms.F and autodiff_whtapeio_sync.F
383        return if .NOT.useAUTODIFF
384    o pkg/seaice: add CPP brackets (cost function related).
385    o model/src:
386        add useAUTODIFF run time switch.
387    o pkg/exf/exf_interp.F:
388        add code to allow input grids with latitude starting in the north (i.e. when
389        j=1 corresponds to northern edge of field); modify global_with_exf to test
390        this feature.
391    o verification/testreport:
392      - replace "grep -A3" with POSIX conformal sed command, because there are
393        implementations of grep that cannot do contextual searches
394      - replace "cat -n" by "nl" (two occurrences), because not all implementations
395        of "cat" have the option "-n"
396    o model/src:
397        add new file gsw_teos10.F that contains 3 functions, more or less a copy
398        of the gsw_toolbox.f90 of the TEOS-10 fortran interface, that are used to
399        convert from conservative to potential temperature. For now they are not
400        called anywhere.
401    o pkg/ggl90: make "useIDEMIX" useful
402      - re-organize code in s/r ggl90_calc a little to move computations that
403        are different for idemix into separate loops (changes verification
404        experiment idemix at truncation level, 12 digits remain -> updated)
405      - requires 2 new 2D fields KappaM, verticalShear
406      - make hFacI and recip_hFacI local 3D variables that are passed to
407        s/r ggl90_idemix
408      - fix and improve some comments
409    
410    checkpoint65j (2015/02/25)
411    o pkg/openad
412      - synchronize seawater.F with version in model/src: replace routine
413        body of sw_temp by calling sw_ptmp and fix/add a few comments.
414    o pkg/mnc:
415      - change default value of pickup_read/write_mnc params to FALSE
416        (since few features are missing in reading MNC pickup files).
417    o model/src:
418      - change default (background) vertical diffusivity for salt to be the
419        temperature (background) vertical diffusivity.
420      - change background vertical diffusivity in vertical mixing pkgs ggl90,
421        kl10, my82 and pp81 from temperature diffusivity to salinity diffusivity.
422        This makes ptracers default diffusivity (that uses salt diffKr) more
423        consistent with vertical mixing schemes.
424    o verification/testreport:
425      - fix typo in "-pcls" option ;
426      - put temp files in /tmp (instead of in local dir)
427      - add option "-ncad" to use genmake2 new option "-nocat4ad"
428      - allow to use "-j" option (for multi-procs make) for AD, OAD and TLM.
429    o pkg/ggl90 (idemix code):
430      - apply few fixes ; add some missing "_d 0" ; update output of exp.
431        global_ocean.90x40x15.idemix
432    o OpenAD
433      - enable active file I/O and begin removal of work-around code
434        for OpenAD for handling control variables (memory vs. active files)
435      - new CPP options file OPENAD_OPTIONS.h
436      - revert to genarr2d gradient check for hs94.1x64x5
437      - (genarr3d tested by tutorial_global_oce_biogeo, tutorial_tracer_adjsens)
438      - gentim2d works for halfpipe_streamice but not yet hs94.1x64x5
439    o tools/genmake2:
440      - add option for an alternative Makefile (from Martin) where multiple
441        source files are sent to TAF (instead of all in one file).
442    o pkg/ggl90: add IDEMIX (Olbers and Eden, 2013)
443      - code provided by Carsten Eden as an extension of ggl90
444      - so far the code is turned on within ggl90 by setting a CPP-flag at
445        compile time; a runtime flag implementation is not yet complete
446      - tested in new verification experiment global_ocean.90x40x15.idemix
447    o verification:
448      - reduce length of the AD test run by half for experiments
449        global_ocean.cs32x15 (std + thsice) and isomip
450      - enable active file I/O for OpenAD, adjust verifications accordingly
451      - halfpipe_streamice: change gradient check from genarr2d to gentim2d
452    o verification/testreport:
453      - fix two non-POSIX sed statements so that there are no error messages
454        on Mac OS X
455      - replace hostname -s with hostname | sed 's/\..*$//'
456    o model/src/seawater.F:
457      - simplify SW_TEMP to just calling SW_PTMP with P and PR exchanged
458        (following the matlab code), which would have avoided the bug caught
459        by Matt (see below) in the first place
460    o pkg/shelfice:
461      - implement alternative discretisation of quadratic drag (selectBotDragQuadr)
462        and true distance in no-slip BC (bottomVisc_pCell) similar to bottom-drag.
463      - fix sign of friction tendency (no-slip BC) and fix u,v drag for thin
464        ice-shelf case (i.e., within surface level).
465      - add config summary in shelfice_check.F
466      - remove global variable recip_SHELFICElatentHeat and replace by a local
467        variable recip_latentHeat
468      - introduce diagnostics for friction velocity uStar (in case of
469        SHELFICEuseGammaFrict)
470      - change verification experiment isomip.htd:
471        + start from pickup (as input_ad at nIter0=8640)
472        + start from SHELFICEmassFile instead of SHELFICEloadAnomaly file
473        + test SHELFICEuseGammaFrict = .TRUE.
474        + test SHELFICEadvDiffHeatFlux = .TRUE.
475    o model/src:
476      - fix bug (Thanks to Matt) in function SW_TEMP (to convert Pot.Temp to
477        in-situ Temp) and in routine SW_TEMP (in pkg/openad);
478        update output of experiments global_with_exf.yearly and isomip (all 6).
479    o pkg/shelfice:
480      - change setting of kTopC to also be zero where there is no ice-shelf.
481      - zero out surface forcing arrays (for now, for T & S + EmPmR) where
482        ice-shelf is.
483      - first attempt to get RealFreshWaterFlux effects: for now, only without
484        SHELFICEboundaryLayer ; not consistent if using synchronous time-stepping.
485    o pkg/seaice: add the option to prescribe a fixed thickness PDF
486      for thermodynamic calculations
487      - because of divisions of the type 7/7 not exactly equal to 1, this change
488        affects results of some verification experiments by up to 4 digits:
489        global_ocean.cs32x15.seaice, lab_sea, lab_sea.fd, lab_sea.salt_plume,
490        seaice_obcs, seaice_obcs.seaiceSponge, seaice_obcs.tides
491        adjoint: lab_sea, lab_sea.noseaicedyn
492        -> updated
493    
494    checkpoint65i (2015/01/23)
495    o model/src:
496      - change units of frictionHeating field from W to W/m^2
497      - fix bug in frictional heating from stratospheric drag in
498        S/R ATM_PHYS_TENDENCY_APPLY_V
499      - with synchronous time-stepping: move resetting to zero of frictionHeating
500        field from load_fields_driver.F to thermodynamics.F ;
501      - add diagnostics for frictional heating.
502    o model/src & gmredi K3D:
503      - add frictionHeating field to pickup-files (for synchronous time-stepping)
504      - move ALLOW_EDDYPSI block out of DYNVARS.h and merge it into FFIELDS.h
505      - rename uMean,vMean --> uEulerMean,vEulerMean (+ change diagnostics name
506        and name in pickup file).
507      - fix arguments of few DIAGNOSTICS_FILL calls in gmredi_k3d.F
508    o model/src:
509      - move (from ini_forcing.F) initialisation of all arrays in header file
510        FFIELDS.h into new S/R ini_ffields.F ; this fix broken restart
511        (since Nov 2012) with option selectAddFluid=1.
512    o pkg/shelfice:
513      - change units (+ document) of newly added field "shelfIceMassDynTendency"
514      - upgrade from _RS to _RL shelficeMass & shelficeLoadAnomaly arrays.
515    o pkg/obcs: re-organize obcs_calc_stevens.F to prepare for passive tracers
516    o pkg/seaice: two new runtime parameters:
517      - SEAICE_cStar replaces the hard wired "20" in the strength formulation,
518        long overdue
519      - SEAICE_tensilFac: preparation for Koenig-Beatty+Holland (2012)
520        parameterization of tensil stress for fast ice (does not do anything yet)
521    o pkg/seaice/seaice_check.F: left over from restricted addtive Schwarz method
522        for LSR: move checking overlaps out of JFNK-if-block
523    o pkg/atm_phys:
524      - move copy of grid and dynamical fields out of atm_phys_driver.F into
525        new S/R ATM_PHYS_DYN2PHYS.
526      - fix level height for Linear Free-Surf case (to be consistent with
527        fixed-in-time pressure levels).
528    o pkg/mom_common (bottomdrag):
529      - average bottomDragFld (ALLOW_BOTTOMDRAG_CONTROL) from grid-cell center
530        to correct location (U & V point) in S/R MOM_U/V_BOTTOMDRAG;
531        update output (adm & tlm) of experiment global_ocean.90x40x15.bottomdrag.
532    o pkg/shelfice (u/v_drag):
533      - add one argument (the other velocity component) to S/R SHELFICE_U/V_DRAG;
534      - use SHELFICEDragLinear & SHELFICEDragQuadratic in shelfice_v_drag.F
535        (now similar to shelfice_u_drag.F)
536      - remove condition on bottomDragTerms when calling SHELFICE_U/V_DRAG
537        from mom_vecinv.F (similar to mom_fluxform calls).
538    o pkg/mom_common (bottomdrag):
539      - add one argument (the other velocity component) to S/R MOM_U/V_BOTTOMDRAG;
540      - add options for alternative discretisation of velocity norm in quadratic
541        bottom drag: averaging of grid-cell-center KE to U.point and V.point
542        (selectBotDragQuadr=0, original code) can produce noisy patterns; this
543        improves when averaging only the other component (e.g. vVel for U bottom
544        drag) using wet-point method (selectBotDragQuadr=2) or not (=1).
545      - add options (bottomVisc_pCell) to account for partial-cell in bottom
546        friction (no-slip BC) thus getting the true distance from the bottom;
547        off by default since this also reduces model stability (explicit bottom
548        friction). Changes produce different machine truncation with linear-drag
549        + no-slip BC: update output of experiments exp4.stevens (10 digits) and
550        front_relax (bvp & mxl, 10 & 11 digits).
551    o model/src & mom pkgs:
552      - add one more level to vertical viscosity local arrays (Nr+1, previously Nr)
553        since no-slip bottom BC uses viscosity @ k+1 to update velocity @ level k
554      - for now and until vertical mixing scheme are updated to fill up level Nr+1,
555        just copy level Nr value to level Nr+1.
556    o doc:
557      - add notes form Abhisek Chakraborty on how to close Heat & Salt budgets.
558    o pkg/streamice:
559      - shelfice_init_varia.F, shelfice_init_fixed.F, shelfice_readparms.F,
560        SHELFICE.h: move array shelficemass to init_varia, initialise
561        from array shelficemassinit, which is set in init_fixed and
562        has option to be set from file; introduce array
563        shelficeMassDynTend array, set thru file in init_fixed
564      - NEW FILE: shelfice_step_icemass.F: update shelficemass from either
565        shelfIceFreshWaterFlux and shelficeMassDynTend or H_streamice in
566        pkg/streamice
567      - shelfice_thermodynamics.F: call shelfice_step_icemass if
568        SHELFICEMassStepping = .true.
569      - shelfice_ad_diff.list: add new subroutine shelfice_step_icemass.f
570    
571    checkpoint65h (2014/12/17)
572    o verification/global_ocean.90x40x15, global_ocean_ebm:
573      - update to generic controls.
574    o pkg/ctrl:
575      - ctrl_map_ini_genarr.F: test for igen>0
576      - ctrl_init_variables.F: add call to CTRL_MAP_INI_GENTIM2D.
577      - move gentim2d part of ctrl_map_ini_genarr.F to
578        new separate routine : ctrl_map_ini_gentim2d.F
579      - ctrl_cost_driver.F,ctrl_init.F ctrl_map_ini_genarr.F:
580        add time variable weights and cyclic controls (time mean,
581        seasonal cycle, etc) capabilities to gentim2d
582    o pkg/ecco:
583      - move reading of error, conversion to weights from
584        ecco_cost_init_fixed.F to ecco_toolbox.F (ecco_readwei)
585    o global_oce_llc90, cs32:
586      - activte sbo.
587      - CTRL_SIZE.h : add maxCtrlProc.
588      - activate the new genctrl capabilities.
589      - update following reorganization of global_oce_input_fields.tar.gz  
590    o pkg/ctrl/ctrl_ad_diff.list:
591      - add missing ctrl_init_rec.f
592    o tools/OAD_support/keepOriginal:
593      - add ctrl_init_rec.F
594    o model/src/the_main_loop.F, pkg/ctrl/ctrl_map_ini_genarr.F:
595      - avoid recomputations of xx_gentim2d_dummy.
596    o momentum diagnostics:
597      - move filling of diagnostics Um_Diss & Vm_Diss from mom_fluxform.F and
598        mom_vecinv.F to timestep.F (to include Smag-3D contribution).
599    o pkg/seaice/seaice_lsr.F:
600      - fix computation of BU/BV, make sure they are non-zero, only necessary
601        for cubed sphere exchanges and SEAICE_OLx/y>0.
602        This makes calling s/r fill_cs_corner_rl obsolete (removed).
603    o verification/global_ocean.cs32x15/input.seaice
604      - add test for strong implicit coupling and restricted addtive Schwarz
605        methods for LSR
606      - update results/output.seaice.txt
607    o verification/tutorial_global_oce_biogeo:
608      - AD & OAD set-up: switch off ALLOW_OLD_VIRTUALFLUX (like in fwd set-up)
609        and set PTRACERS_EvPrRn(1,2) to zero (for DIC & ALK);
610        update output_adm,_oadm,_tlm.txt
611    o pkg/dic:
612      - change default to "#undef ALLOW_OLD_VIRTUALFLUX" in DIC_OPTIONS.h
613      - add a stop when ALLOW_OLD_VIRTUALFLUX is defined and PTRACERS_EvPrRn
614        for tracer 1 & 2 is set (to avoid double counting of dilution effect).
615    o verification/tutorial_global_oce_biogeo:
616      - AD & OAD set-up: do not set PTRACERS_EvPrRn for tracer 1 & 2 since
617        dilution is already added by pkg/dic ALLOW_OLD_VIRTUALFLUX ;
618        update output_adm,_oadm,_tlm.txt
619    o eesupp/src:
620      - add fill_cs_corner_rl.F (_RL-copy of fill_cs_corner_rs.F)
621        and call it in seaice_lsr when using nonzero SEAICE_OLx/y
622    o pkg/seaice: introduce strongly implicit coupling, intended for stabilizing
623      LSR (following Hutchings et al. 2004)
624      - introduce zetaZ as a global variable (requires adjustments in
625        seaice_evp.F and seaice_jfnk.F) and compute analoguously to etaZ
626        in seaice_calc_viscosities.F
627      - new flag SEAICEuseStrImpCpl (default off)
628      - add new terms zetaZ*du/dy and zetaZ*dv/dx on both sides of the
629        momentum equations
630      - JFNK-solver (preconditioner) adjusted to allow using this method
631        (where it does not have any positive effect)
632    o pkg/seaice
633      - add overlap for restrictive additive Schwartz method also to LSR, but
634        turn it off by default (because it only seems to work for non-cubed
635        sphere/llc topologies)
636    o pkg/autodiff
637      - add extra exchanges in addummy_in_steppging also for mnc output
638    o pkg/seaice:
639      - add extra exchanges before dumping adjoint fields in seaice_ad_dump.F
640        to avoid stripes in the adjoint output (similar to addummy_in_stepping.F)
641    o pkg/obcs:
642      - add option to specify domain-connected piece Id along OB though files
643        (for now, only used to diagnose PhiVel; default =1 -> global correction)
644      - modify obcs_diag_balance.F to process each connected-part separately;
645        exclude OB where Id = 0 but keep the full divergence there (-> constant
646        Psi along this portion of OB and all inflow derived from grad(Phi))
647      - add example of OB-conect files in verification/so_box_biogeo/input.
648    o pkg/diagnostics:
649      - improve treatment of Open-Boundaries in Velocity-Potential calculation:
650      a) use non zero matrix element across OB and solve for Phi 1 grid point
651         outside OB (i.e, where tracer OBCS are applied).
652      b) global imbalance of inFlow/outFlow across OB: instead of modifying
653         velocity across OB, spread it uniformly along the OB in the RHS.
654    
655    checkpoint65g (2014/11/19)
656    o pkg/diagnostcis:
657      - add preconditioner off-diagonal factor (diagCG_pcOffDFac) as run-time param
658    o pkg/my82,pp81,kl10:
659      - fix ALLOW_3D_DIFFKR implementation (previously had no effect): use 3-D
660        field diffKr as background diffusivity to set minimum diffusivity value.
661    o pkg/seaice:
662      - add new parameter SEAICEuseEVPrev (for revisited EVP by
663        Bouillon et al 2013)
664      - add SEAICE_evpAlpha/Beta to namelist
665      - modify seaice_evp code to able to use SEAICEuseEVPrev. These changes
666        involve trivial re-ordering of divisions/multiplications that should not
667        have any effects, but ... they do change the results of lab_sea.hb87 so
668        that only 2 digits of agreement remain, in line with the general
669        instability/fragility of the evp-code. For now, I do not care and just
670        update the verification experiment
671    o pkg/ctrl : add generic pre-processing (xx_genarr2d_preproc etc)
672      - remove xx_genarr2d_numsmooth etc
673      - use xx_genarr2d_preproc etc instead
674      - carry out smooth_correl2D at initialization stage rather than during
675        time stepping.
676      - get smoothOpNb from xx_gentim2d_preproc
677    o global_oce_cs32 :
678      - add test of generic ecco capabilities.
679    o pkg/exf/exf_getsurfacefluxes.F :
680      - add to tmpUE/tmpVN rather than re-initializing them (conventional behavior).
681    o pkg/ctrl,ecco :
682      - omit un-necessary arguments to ctrl_cost_gen.F unless ECCO_CTRL_DEPRECATED
683        is defined.
684    o pkg/seaice: add diagnostics for Delta (deformation parameter)
685    o model/src:
686      - when ALLOW_3D_DIFFKR is defined, add a Warning if any of the vertical
687        diffusivity (background) is specified but ignored.
688    o verification:
689      - in testreport, convert hostname to lower case for default output dir name
690    o model, pkg : add useCTRL, useECCO parameters (on/off run time switch).
691    o pkg/dic: add modifications from Hajoon:
692      - add iron sedimentation flux function of the flux of PO4 out of bottom layer
693      - light attenuation: add self-shading effect by climatological Chlorophyll
694        (read from file).
695    o pkg/seaice/seaice_preconditioner.F : fix cpp flags, so that code also
696        compiles when SEAICE_ALLOW_DYNAMICS is undefined
697    o global_oce_llc90,cs32 : ecco_v4 verification exps now use separate
698        AUTODIFF_OPTIONS.h, CTRL_OPTIONS.h, ECCO_OPTIONS.h rather than
699        ECCO_CPPOPTIONS.h (i.e. replacing the deprecated, circumvoluted,
700        approach where CPP_OPTIONS.h includes an omnipotent
701        ECCO_CPPOPTIONS.h that superseeds pkgs '_OPTIONS.h').
702    o pkg/ctrl/ctrl_map_ini_genarr.F : include GMREDI_OPTIONS.h where
703        ALLOW_3D_KAPGM, ALLOW_3D_KAPREDI (to be added later) belong.
704    o pkg/seaice/SEAICE_SIZE.h : replace ALLOW_AUTODIFF_TAMC with ALLOW_AUTODIFF
705        to avoid needing AUTODIFF_OPTIONS.h anytime SEAICE_SIZE.h is included
706        (it seems that THSICE_SIZE.h, PTRACERS_SIZE.h have the same issue...)
707    o model/src, pkg/smooth, profiles, salt_plume, seaice, exf, ecco, ctrl :
708      add ECCO_OPTIONS.h, AUTODIFF_OPTIONS.h, CTRL_OPTIONS.h when needed
709      - ECCO_OPTIONS.h is needed when including ecco_cost.h, ecco.h
710      - AUTODIFF_OPTIONS.h is needed when including tamc.h, tamc_keys.h
711      - CTRL_OPTIONS.h is needed when including ctrl.h, optim.h, etc
712    o pkg/ctrl,ecco,exf :
713      - remove variables associated with NON-generic costs,
714        unless ECCO_CTRL_DEPRECATED is defined.
715      - remove NON-generic NON-obcs controls,
716        unless ECCO_CTRL_DEPRECATED is defined.
717    o pkg/ctrl : added ctrl_local_params.h
718    o pkg/ecco : added ecco_local_params.h
719    o verification : added ECCO_CTRL_DEPRECATED to most as and oad
720        experiments, which will progressively be removed once the
721        experiments are revised to use only generic controls/costs.
722    
723    checkpoint65f (2014/10/13)
724    o pkg/ctrl, ecco, seaice : minor changes in headers
725    o global_oce_llc90,cs32 : ecco_v4 verification exps now test generic
726        cost function and control capabilities added since checkpoint65c.
727    o pkg/ctrl: regroup all obcs ctrl variables in CTRL_OBCS.h.
728    o pkg/ecco: increase modularity and improve logic
729      - ecco_toolbox.F (new) : basic operations that are often used,
730        including ecco_zero, ecco_cp, ecco_cprsrl, ecco_diffmsk,
731        ecco_addcost, ecco_add, ecco_div, ecco_readbar.
732      - cost_gencal.F (new) : determine filnames and records.
733      - cost_genread.F, cost_generic.F : condense code using ecco_toolbox.
734      - cost_generic.F : use spzeroloc rather than hard-coded -9999,
735        and exploit the above functions leading to more compact code.
736      - cost_genread.F : rm un-necessary arguments, re-arrange args order.
737      - ecco_check.F, ecco_readparms.F : bring logic up to date (using_tpj,
738        using_ers, using_gfo, using_mdt is now only defined within gencost)
739    o pkg/ecco: extend generic cost capabilities
740      - pkg/ecco : added 3D gencost (ALLOW_GENCOST3D), added gencost
741        capabilities via gencost_preproc (+ _c,_i,_r related params),
742        gencost_posproc (+ _c,_i,_r related params), gencost_nrecperiod,
743        gencost_outputlevel arguments to cost_generic
744      - pkg/ecco/cost_genread.F (new) : interface between cost_generic
745        and active_read, making room for gencost_preproc to take effect.
746        Added preproc code ('climmon') to replace GENERIC_BAR_MONTH.
747      - pkg/ecco/cost_generic.F :
748        compute and store misfit maks*(model-data) in localdif that is
749        then used in cost and for output, output misfit if outlev.GT.0
750      - pkg/ecco/cost_averagesfields.F : depend on gencost_barskip
751        rather gencost_barfile for deciding whether to write barfile
752      - pkg/ecco/ecco_cost_driver.F : extract call to cost_profiles from cost_hyd
753      - pkg/ecco/ecco_cost_init_fixed.F : extract gencost weights from
754        ecco_cost_weights, re-activate ecco_summary, determine gencost_barskip
755      - pkg/ecco/ecco_summary.F : report gencost variables
756      - pkg/ecco/cost_gencost_customize.F : treat case of scatterometer costs
757    o pkg/sea/SEAICE_OPTIONS.h : add ALLOW_COST_ICE, ALLOW_SEAICE_COST_SMR_AREA
758    o pkg/ecco: internal re-organization
759      - resolve un-necessary dependancies within pkg/ecco and to pkg/ctrl
760        (rm includes of optim.h and ctrl.h, replace optimcycle with eccoiter,
761        mv relevant variables definition from ecco_cost.h to ecco.h,
762        make sure gencost routines only include ecco.h)
763      - throughout : add missing CCP switches, rm unused variables,
764        and rm un-necessary CPP switches
765      - throughout gencost routines : replace modelstartdate with
766        gencost_startdate when needed
767      - cost_bp_read.F : use arguments, instead of common blocs
768        so that it can be used also by (new) cost_gencost_bpv4.F
769      - ecco_init_varia.F : initialize RHOsumGlob_0, VOLsumGlob_0
770      - ecco_phys.F : compute etanFull
771      - ecco_readparms.F : rename using_topex as using_tpj, add
772        bpv4-grace to gencost list, initialize added parameters
773      - ecco_summary.F : include SIZE.h needed for augmented ecco.h
774    
775    checkpoint65e (2014/09/28)
776    o pkg/obcs:
777      - replaced the just-added CPP options with run-time variables
778        (see pkg/obcs/OBCS_PARAMS.h for details)
779    o pkg/obcs:
780      - add additional CPP options for sponge boundary layers
781        (see pkg/obcs/OBCS_OPTIONS.h for details)
782    o pkg/atm_phys:
783      - implement simple (obliquity only, assuming circular planet orbit)
784        seasonal cycle for incoming insolation ; used when run-time parameter
785        "select_incSW" is set to 1 ; by default (=0), uses old unchanged formula.
786    o pkg/exf, pkg/ecco, pkg/ctrl:
787      - add ctrlUseGen and .NOT.ctrlUseGen exclusive brackets
788      - activate gentim2d for xx_atemp,xx_aqh,xx_swdown,xx_lwdown,xx_precip
789      - implement gentim2d for xx_tauu, xx_tauv
790    o pkg/ctrl, pkg/ecco :
791      - fix and complement the generic controls implementation
792    o pkg/exf/exf_getclim.F, exf_getffields.F, exf_getsurfacefluxes.F,
793        pkg/shelfice/shelfice_thermodynamics.F,
794        verification/hs94.1x64x5/code_ad/ctrl_map_gentim2d.F,
795        verification/hs94.1x64x5/code_oad/ctrl_map_gentim2d.F :
796      - add weight in CTRL_GET_GEN calls
797    o pkg/ctrl :
798      - ctrl_get_gen.F : add weight as input parameter, and apply
799        it directly rather than using smooth_correl2Dw (to be retired).
800      - ctrl_map_gentim2d.F : add wgentim2d in CTRL_GET_GEN call
801    o pkg/ctrl :
802      - introduce run time switch ctrlUseGen (in ctrl.h, ctrl_check.F,
803        ctrl_init_variables.F, ctrl_readparms.F, ctrl_summary.F)
804      - re-activate ctrl_summary (call in ctrl_init.F)
805    o pkg/ctrl/ctrl_cost_gen.F :
806      - fix CCP brackets, remove un-necessary myiter, mytime
807    o pkg/ecco, pkg/ctrl :
808      - remove cost_genctrl.F (now pkg/ctrl/ctrl_cost_driver.F)
809      - remove cost_forcing_gen.F (now pkg/ctrl/ctrl_cost_gen2d.F)
810      - add ctrl_cost_driver.F (replaces pkg/ecco/cost_genctrl.F)
811      - add ctrl_cost_gen2d.F (replaces pkg/ecco/cost_forcing_gen.F)
812    
813    checkpoint65d (2014/09/15)
814    o pkg/ctrl/CTRL_GENARR.h, ctrl_readparms.F :
815      - add xx_genarr2d_bounds,xx_genarr3d_bounds,
816        xx_genarr2d_numsmooth, xx_genarr3d_numsmooth
817    o pkg/ctrl/ctrl_map_ini_genarr.F :
818      - remove compilation failure
819      - replace hard coded example
820      - use ctrl_map_ini_gen2D, 3D
821    o pkg/ctrl/ctrl_pack.F, ctrl_unpack.F :
822      - on/off switch based upon xx_genarr2d_weight,3d
823    o src/packages_init_variables.F :
824      - regroup pkg/estimation calls
825      - remove CTRL_MAP_INI, CTRL_MAP_INI_ECCO
826        (moved to ctrl_init_variables)
827    o cost/cost_init_varia.F :
828      - remove ecco_cost_init_varia
829        (moved to ecco_init_varia)
830    o ctrl/ctrl_init_variables.F :
831      - add CTRL_MAP_INI, CTRL_MAP_INI_ECCO
832      - add CTRL_MAP_INI_GENARR, SEAICE_CTRL_MAP_INI
833    o ctrl/ctrl_map_ini.F :
834      - remove ctrl_map_ini_genarr, seaice_ctrl_map_ini
835        (moved to ctrl_init_variables)
836    o ctrl/ctrl_map_ini_ecco.F :
837      - remove ECCO_PHYS (mv to ecco_init_varia)
838      - remove seaice_ctrl_map_ini (mv to ctrl_init_variables)
839    o ecco/ecco_ad_diff.list :
840      - add ecco_init_varia.f
841    o ecco/ecco_init_varia.F
842      - new routine
843    o pkg/streamice:
844      - move call to STREAMICE_INITIALIZE_PETSC from the_model_main.F
845        to streamice_init_fixed.F ; fix setting of STREAMICEisOn.
846      - from model/src, only call pkg/streamice routines if useStreamIce is TRUE.
847    o pkg/generic_advdiff:
848      - fix bug causing negatives in GAD_SMOLARKIEWICZ_HACK, introduced 8/8/2014.
849    o pkg/exf:
850      - exf_getffields.F : add xxg_atemp, xxg_aqh, xxg_swdown, xxg_lwdown,
851         xxg_precip capability
852      - exf_wind.F : no need for ALLOW_WSPEED_CONTROL cpp switch
853    o pkg/ctrl:
854      - ctrl_pack.F, ctrl_unpack.F : omit (un)packing of undefined xx_gentim2d
855    o model/src/load_fields_driver.F :
856      - move call to CTRL_MAP_GENTIM2D ahead of BULKF_FIELDS_LOAD, EXF_GETFORCING
857        so xx_gentim2d can be applied to e.g. exf fields in a timely manner.
858    o OpenAD verification experiments:
859      - Include explicitly AUTODIFF_OPTIONS.h, COST_OPTIONS.h, and CTRL_OPTIONS.h
860        in src files (to enable to skip the ECCO_CPPOPTIONS.h);
861        for now, only in pkgs used in OpenAD verification experiments.
862      - Change all except one (halfpipe_streamice) OpenAD experiments to use pkg
863        specific option file (AUTODIFF_OPTIONS.h, COST_OPTIONS.h & CTRL_OPTIONS.h)
864        instead of using ECCO_CPPOPTIONS.h (with all relevant options in it).
865        This applies to both TAF (*/code_ad/) and OpenAD (*/code_oad/) tests.
866    o OpenAD verification tests:
867      - finish removing ALLOW_AUTODIFF_OPENAD (replaced by ALLOW_OPENAD);
868      - finish replacing ALLOW_AUTODIFF_TAMC by ALLOW_AUTODIFF (except for
869        tape/storage which are specific to TAF/TAMC) in pkgs used in OpenAD exp.
870      - leave ALLOW_AUTODIFF_TAMC undef in OpenAD verification tests (*/code_oad/)
871        and remove local copy of "tamc.h" (needed only if ALLOW_AUTODIFF_TAMC).
872    o model/src & generic_advdiff:
873      - change hard-coded loop-range in S/R APPLY_FORCING_T/S to set T & S
874        forcing over 0:sNx+1, 0:sNy=1 (instead of just 1:sNx,1:sNy): Model
875        dynamics requires valid tracer forcing only over tile interior but, for
876        some diagnostics, may need to extend it over 1 point in tile halo region.
877      - in gad_calc_rhs.F, update calls to gmredi_x/ytransport to get valid
878        tendency over i,j_Min,Max range. This allows to simplfy i,j_Min,Max
879        setting in temp/salt/ptracer_integrate.F
880    o pkg/dic:
881      - multiply tracer tendencies by maskInC (if ussing OBCS) before updating
882        gchem tracers: this allows to skip the 2nd call to OBCS_APPLY_PTRACER
883        in gchem_forcing_sep.F
884    o pkg/autodiff & obcs:
885      - add storage of current OB values for U & V (was already done for T & S).
886    
887    checkpoint65c (2014/08/30)
888    o pkg/dic:
889      - take out of dic_atmos.F the initialisation part (corresponding to istate=0)
890        and move it to new S/R DIC_INI_ATMOS ; also simplify the dependencies for
891        AD compilers (but still a Pb with multi-threading and Ajoint dependencies).
892    o verification:
893      - new experiment testing OBCS and DIC pkgs, using params & output from
894        tutorial_global_oce_biogeo but limited to a sub-domain around Drake
895        passage: take OBCS from the last year of a 2 yrs simulation and initial
896        conditions from t=1.yr while keeping the same forcing.
897    o model/src:
898      - when allowFreezing=T, only reset below freezing initial Temp to Tfreezing
899        (at any k) if checkIniTemp is not set to FALSE (default checkIniTemp=T).
900    o pkg/diagnostics (Stats-Diags):
901      - re-write S/R DIAGSTATS_CALC (more similar to TARGET_NEC_SX part) to:
902        a) refine region where stats are computed, excluding where arrhFac=0 ;
903        b) fix missing interior mask (use with OBCS) in 3-D fields statistics;
904        c) extend regional stats over the region edges (for U or V pt location).
905    o pkg/gchem:
906      - add a (2nd) call to OBCS_APPLY_PTRACER in gchem_forcing_sep.F (needed since
907        pkg/dic is currently changing/updating ptracers values beyond the OB).
908    o verification (hs94):
909      - convert Held & Suarez external_forcing.F (from hs94.cs, with Sigma-coords
910        bits) to apply_forcing.F and undef USE_OLD_EXTERNAL_FORCING in experiments
911        hs94.cs-32x32x5 and tutorial_held_suarez_cs ; also use the same version of
912        apply_forcing.F in 2D hs94 (fwd, ad & oad) but keep LatLon hs94 unchanged.
913    o pkg/ptracers:
914      - implement Adams-Bashforth on pTracers (instead of on tracer tendency),
915        switched on by setting PTRACERS_doAB_onGpTr=F (default set to doAB_onGtGs)
916      - change exp4 secondary test (input.nlfs) to test AB on T & S & pTracer
917        with AB-2 code (so that it get tested).
918    o model/src:
919      - allow to apply Adams-Bashforth on Temp & Salt (instead of on gT,gS)
920        with AB-2 code (previously only available with AB-3 code).
921        Also move the code (call to ADAMS_BASHFORTH S/R) form thermodynamics.F
922        to temp/salt_integrate.F (since the 2nd part of gt/sNm1 update is done
923        there, by calling CYCLE_AB_TRACER).
924    o pkg/generic_advdiff:
925      - change Tracer argument (drop bi,bj indices) in S/R GAD_CALC_RHS,
926        GAD_C2_ADV_R, GAD_U3_ADV_R, GAD_C4_ADV_R, GAD_DIFF_R, GAD_BIHARM_R
927        + also in GMREDI_X/Y/RTRANSPORT ; and update corresponding calls in
928        S/R temp/salt/ptracers_integrate.F
929    o model/src & pkg/ptracers:
930      - remove common block variables gT,gS (in DYNVARS.h), except when
931         USE_OLD_EXTERNAL_FORCING is defined; update TAF storage accordingly.
932      - remove common block variable gPtr.
933    o model/src & pkgs:
934      - change gTracer (and/or tracer) argument (drop bi,bj indices) in S/R
935         ADAMS_BASHFORTH(2&3), CYCLE_(AB_)TRACER, FREESURF_RESCALE_G,
936         IMPLDIFF, SOLVE_TRIDIAGONAL & _PENTADIAGONAL, GAD_SOM_ADVECT,
937         GAD_ADVECTION, GAD_CALC_RHS, GAD_IMPLICIT_R, TIMEAVE_CUMUL_DIF_1T
938      + change accordingly all calling S/R.
939      - use local temperature/salinity/ptracer tendency array (without bi,bj)
940        in S/R temp/salt/ptracers_integrate.F
941    o pkg/seaice:
942      - move computation of stress contributions to rhsU/V in s/r seaice_lsr
943        to separate s/r seaice_lsr_rhsu/v in order to be able to re-use code
944      - make u/vIceC local variables if SEAICE_CGRID is defined only to be used
945        in seaice_lsr
946      - seaice_lsr.F: make local 4D arrays UXX, VYY, etc 2D
947        in s/r seaice_lsr_calc_coeffs
948    o pkg/mdsio:
949      - in MDS_READ/WRITE_FIELD, stop if file-name (+prefix) is too long
950        (e.g., > MAX_LEN_MBUF -90 ) or, in INI_MODEL_IO, if mdsioLocalDir is
951        too long (e.g., > MAX_LEN_FNAM/2 )
952    
953    checkpoint65b (2014/08/12)
954    o pkg/matrix:
955      - pass, as argument, updated tracer field to S/R MATRIX_STORE_TENDENCY_EXP
956    o model/src:
957      - fix initialisation of geothermalFile; compile geothermal-flux code in
958        natl_box verification experiment.
959    o model/src & pkg/down_slope:
960      - push the k loop inside S/R TIMESTEP_TRACER (now called outside the k loop).
961      - in dwnslp_apply.F, update tracer tendency instead of the future tracer
962        field and call S/R DWNSLP_APPLY before TIMESTEP_TRACER; this affects
963        results at machine truncation level: update output of experiments
964        global_ocean.90x40x15.dwnslp (FWD) and lab_sea.noseaicedyn (AD).
965    o pkg/diagnostics (Stats-Diags):
966      - do not cumulate the full volume when DIAGNOSTICS_FILL is
967        called with bibjFlg < 0 (no increment of the counter for 2D/3D diag);
968        This fix the mean statistics when DIAGNOSTICS_FILL is called multiple
969        times (but Min,Max and StD are still wrong).
970    o model/src:
971      - add geothermal flux forcing: read in ini_forcing.F as time-constant
972        field "geothermalFlux" applied in S/R APPLY_FORCING_T (apply_forcing.F)
973    o model/src:
974      - move CYCLE_TRACER calls from tracers_correction_step.F to temp/salt/ptracer
975        _integrate.F so that, when leaving S/R THERMODYANMICS, theta,salt and pTrac
976        arrays are already updated while adjustments (filters, conv.adjustment) are
977        still applied later, in S/R TRACERS_CORRECTION_STEP.
978    o model/src:
979      - store in common bloc array "rhoInSitu" the virtual potential temperature
980        anomaly that is used to compute geopotential: this make the atmos code
981        more similar to ocean code which already uses rhoInSitu in calc_phi_hyd.F
982    o pkg/seaice/seaice_lsr.F
983      - rename integer variable ilcall to ipass (that's what it is called
984        in the residual diagnostics
985      - change time stepping for NPSEUDOTIMESTEP > 2 (does not change the
986        default) for improved non-linear convergence of the first few steps
987      - adjust a few comments and add new ones to explain some of the store
988        directives
989    o pkg/generic_advdiff (& ptracers):
990      - re-work the code to check for valid advection scheme and for minimum
991        size of overlap (now stored in local common bloc in gad_advscheme.F)
992    o pkg/seaice: another attempt to make the adjoint work for sea ice dynamics
993      - re-initialize more variables in seaice_lsr: u/vIceC, u/vIceNm1
994      - add an auxilliary variable "bet" and fix store directives and keys in
995        seaice_lsr_tridiagu/v, this seems to do the trick (i.e. more or
996        less exact gradients in my tests); but there are still
997        recomputation warning (although gradients are sort of OK), when
998        SEAICE_LSR_VECTORIZE is not defined, so this flag and
999        SEAICE_LSR_VECTORIZE_ZEBRA are recommended for efficiency.
1000      - update verification experiments lab_sea.
1001      - change some comments in S/R seaice_calc_viscosities
1002    o model/src:
1003      - if staggerTimeStep=T, always apply exchange to velocity field in
1004        do_stagger_fields_exchanges.F instead of in do_fields_blocking_exchanges.F
1005        (independent of using multi-dim advection or not); no effect on FWD run
1006        but affects AD results (at machine truncation level): update output of
1007        experiment 1D_ocean_ice_column (ad: 12 digits), hs94.1x64x5 (ad,oad: 13.d)
1008        and isomip (oad: 12.d).
1009    o pkg/generic_advdiff:
1010      - stop if doAB_onGtGs is set to FALSE but ignored
1011      - refine warning related to stability of tracer time-stepping
1012        regarding internal wave dynamics.
1013      - setting of AdamsBashforth_T,S when doAB_onGtGs=F: remove condition
1014        on staggerTimeStep & implicitIntGravWave (will now get a warning
1015        if potentially unstable).
1016    o pkg/kl10:
1017      - add new pkg "kl10" for mixing due to internal wave breaking, from
1018        http://www.sciencedirect.com/science/article/pii/S1463500310000144
1019        (contribution from Jody Klymak), tested in verification experiment
1020        verification/internal_wave/input.kl10/
1021    o isomip experiment:
1022      - test pkg/shelfice with Non-Lin Free-Surf in one of the FWD set-up
1023        (input.htd) and update the output.
1024    o cd_code experiments:
1025      - use default cd_code options (#undef CD_CODE_NO_AB_MOMENTUM &
1026        #undef CD_CODE_NO_AB_CORIOLIS) in experiments: cfc_example (fwd)
1027        global_ocean.90x40x15 (ad & oad) and OpenAD (ad & oad) and
1028        update the corresponding output.
1029    o pkg/seaice:
1030      - reduce the number of include files and store directives in
1031        S/R seaice_lsr_tridiagu/v
1032      - change the order of loops in one case in S/R seaice_lsr_tridiagv
1033        (only for SEAICE_VECTORIZE_LSR_ZEBRA defined), which allows me to
1034        get rid off one store directive (a TAF bug?)
1035      - add one more instance of ifdef SEAICE_VECTORIZE_LSR_ZEBRA in
1036        S/R seaice_lsr_tridiagv to change the loop range for consistency
1037      - remove ilcall, m from parameter list of S/R seaice_lsr_tridiagu/v
1038      - fix a bug that affects the JFNK solver: replace sNx/y by i/jMax in
1039        S/R seaice_lsr_tridiagu/v (requires update of
1040        offline_exf_seaice/input.dyn_jfnk)
1041    
1042    checkpoint65a (2014/07/27)
1043    o model/src:
1044      - Non-Lin Free-Surf in p/z coords: allows hFacW,S to be larger than
1045        surrounding hFacC=1 @ edge of a step with different kSurfC on either side
1046        (topo in p-coords, ice-shelf in z-coords); update output of experiments
1047        tutorial_global_oce_in_p and isomip (both AD and OpenAD output).
1048    o model/src:
1049      - collect momentum forcing tendency into local 2-D array (passed as argument
1050        to apply_forcing S/R); this simplifies mom. Forcing diagnostics and CD_CODE
1051        parts in timestep.F (without CD_CODE_NO_AB_MOMENTUM defined = the default);
1052        affects results at machine truncation level (e.g., if using OBCS_SPONGE).
1053      - collect T & S forcing tendency into local 2-D array (passed as argument to
1054        apply_forcing S/R); add 3-D diagnostics for temp & salt forcing tendency.
1055        affects results at machine truncation level (e.g., ocean: if using
1056        SHORTWAVE_HEATING ; atmos: if using FrictionHeating or (atm_Rq<>0) moist
1057        correction due to vertical advection).
1058      - update output of experiments: fizhi-cs-32x32x40 (13 digits),
1059        global_ocean.cs32x15 (fwd: icedyn, seaice, thsice, all 3 @ 11d; adm & tml:
1060        seaice_dynmix & thsice, fwd grd @ 3 & 8), hs94.1x64x5 (ad grd @ 13),
1061        obcs_ctrl (ad & fwd grd @ 12 & 7).
1062    o pkg/ptracers & diagnostics:
1063      - use ptracers (short) name (instead of long one) to make ptracers diagnostics
1064        title (to avoid some unexpected truncation); sort out ptracers diags units.
1065      - collect ptracer forcing tendency into local 2-D array (passed as argument
1066        to apply_forcing S/R); add 3-D diagnostics for ptracers forcing tendency.
1067    
1068    checkpoint65 (2014/07/18)
1069    o pkg/fizhi:
1070      - add parenthesis around fizhi tendencies in fizhi_tendency_apply.F: this
1071        affects results at machine truncation level. Update output of experiments
1072        fizhi-cs-32x32x40 (12 digits for cg2d) & fizhi-cs-aqualev20 (13 digits).
1073    o pkg/seaice: more clean up
1074      - rename TAF common block tapes to be more consistent and remove
1075        unnecessary duplicates
1076      - add store directives to remove more recomputations, but use smaller
1077        tapes (and adjust keys) when SEAICE_LSR_ADJOINT_ITER is undefined.
1078        The idea behind this flag is to reduce the memory footprint when the
1079        adjoint of the LSR is not required. As of now, defining the flag
1080        SEAICE_LSR_ADJOINT_ITER increases 4 common block tapes for 2D field by
1081        a factor of SOLV_MAX_FIXED (=500 by default in SEAICE_SIZE.h).
1082        For experiment offline_exf_seaice, this means on a linux box with gfortran
1083        nearly a factor of 10 (but keep in mind there is mostly seaice code in
1084        this experiment):
1085        > size mitgcmuv_ad
1086        text    data        bss     dec        hex
1087        5100659 1216  220458952  225560827  d71c8fb
1088        5339425 1200 1868783272 1874123897 6fb4dc79 (SEAICE_LSR_ADJOINT_ITER)
1089        but only a moderate increase of 36% for global_ocean.cs32x15:
1090        text    data        bss     dec        hex
1091        6695027 1648 1014578664 1021275339 3cdf6ccb
1092        6695203 1648 1382505320 1389202171 52cd8afb (SEAICE_LSR_ADJOINT_ITER)
1093      - note: there are still recomputations in global_ocean.cs32x15 and
1094        offline_exf_seaice and the gradient agreement changes (gets a
1095        little worse) for global_ocean.cs32x15 (-> update output_adm.seaice.txt)
1096      - in general, the AD gradients still are wrong
1097    o OpenAD
1098      - clean up code_oad/ directories somewhat by moving files
1099        dontCompile, dontTransform, keepOriginal to OAD_support/
1100    o model/src:
1101      - using MOM fluxform and Non-Lin Free-Surf with momDissip_In_AB=F
1102        (not currently tested): add dissipation terms before NLFS rescaling of
1103        tendencies (previously done after).
1104    o pkg/diagnostics:
1105      - write stats-diags in ascii file with more digits (same as in monitor).
1106    o pkg/down_slope:
1107      - drop the bi,bj dimension of argument recip_hFac in S/R DWNSLP_APPLY; with
1108        NLFS (not tested), use new recip_hFac value in order to conserve tracer.
1109    o model/src:
1110      - new file "apply_forcing.F" containing all the code previously in
1111        external_forcing.F, but with new argument list: pass, as new argument,
1112        the current level tendency array to update (instead of a direct update
1113        of the common bloc array). Change the corresponding calls.
1114      - add CPP option USE_OLD_EXTERNAL_FORCING (default is undef) to use
1115        EXTERNAL_FORCING_U,V,T,S subroutines (for backward compatibility).
1116    o pkg/seaice/seaice_lsr, a little bit of clean up
1117      - rearrange some code blocks, so that now all calculations for
1118        setting up the right-hand-sides done within one single block
1119        (I find that easier to read and understand)
1120      - rearrange freedrift-code to reduce the number of ifdefs
1121      - adjust some indentations and comments
1122    
1123    checkpoint64z (2014/07/10)
1124    o model/src and several pkgs:
1125      - change argument list of all S/R called from external_forcing.F and
1126        called from ptracers_forcing.F (renamed to ptracers_apply_forcing.F)
1127        to pass, as argument, the current level tendency array to update
1128        (instead of a direct update of the common bloc array).
1129      - change also (in the same way) argument list of PTRACERS_APPLY_FORCING;
1130      - rename taueddy_external_forcing.f to taueddy_tendency_apply.F
1131    o pkg/seaice/seaice_lsr.F
1132      - always initialize local arrays in seaice_lsr_tridiagu/v
1133      - add more local tapes to seaice_lsr_tridiagu/v
1134      - move storing u/vice(:,:,bi,bj) out of seaice_lsr_tridiagu/v, but
1135        keep it in bi/bj loop; this seems to be essential
1136      - gradients are still wrong but only by 4-7 orders of magnitude
1137        instead of 15 orders of magnitude, lab_sea improves a little
1138    o pkg/seaice
1139      - (pkg/autodiff) remove storing/restoring of seaiceMaskU/V that
1140        generates unnecessary code in seaice_lsr_ad
1141      - add more store directives in seaice_lsr to avoid unnecessary code
1142        in seaice_lsr_ad
1143      - exclude some residual computations in seaice_lsr when
1144        ALLOW_AUTODIFF_TAMC is defined in order to avoid unnecessary code
1145        in seaice_lsr_ad
1146      - add more storing, a new tape (model/src/the_main_loop.F) and
1147        another key for SEAICE_LSR_VECTORIZE_ZEBRA (the local keys ilockey
1148        and klockey should be checked by a specialist)
1149      - modify ( define SEAICE_VECTORIZE_LSR and SEAICE_LSR_ADJOINT_ITER )
1150        and update lab_sea after previous changes in pkg/seaice below
1151    o pkg/autodiff:
1152      - introduce useSmoothCorrel2DinAdMode, SEAICEapproxLevInAd, and
1153        viscFacInAd : run time parameters allowing for adjoint switches
1154        note : logic for useSmoothCorrel2DinAdMode is in ctrl_readparms.F
1155    o pkg/ecco:
1156      - introduce cost_gencost_boxmean.F that computes a box mean
1157        temperature (for use in adjoint sensitivity studies).
1158    o model/src/set_defaults.F : initialize viscFacAdj to 1.
1159    o pkg/mom_common/mom_calc_visc.F:
1160      - ifdef ALLOW_AUTODIFF then include viscFacAdj factor.
1161    o pkg/seaice/seaice_summary.F:
1162      - statement for SEAICEadjMODE now in autodiff_readparms.F
1163    o pkg/seaice:
1164      - remove some store directives and add new ones in an effort to get
1165        finally rid off the recomputation warnings. This is successful
1166        when SEAICE_VECTORIZE_LSR ***and*** SEAICE_LSR_ADJOINT_ITER are
1167        defined (i.e. no extensive recomputation warnings left), but there
1168        are still too many recomputations on the solver iteration level
1169      - define SEAICE_VECTORISZE_LSR in offline_exf_seaice/code_ad/SEAICE_OPTIONS.h
1170      - move definition of MPSEUDOTIMESTEPS into TAMC-block in
1171        SEAICE_SIZE.h
1172      - add a store directive in S/R seaice_calc_viscosities
1173    o pkg/seaice (ITD code):
1174      - fix definition of Hlimit for multi-threaded case
1175      - use double precision arithmetic to compute Hlimit: this affects results;
1176        update output of experiment seaice_itd.
1177    o replace content of verification/seaice_itd
1178      - instead of a 1D column use the configuration of offline_exf_seaice
1179        to test the ice thickness distribution code with ridging
1180      - this is a first shot at this experiment
1181      - change of some defaults of ridging parameters SEAICEhStar (from
1182        100 to 25) and SEAICEmuRidging (from 5 to 3) in seaice_readparms.F
1183        and lot of new comments.
1184    
1185    checkpoint64y (2014/06/20)
1186    o pkg/seaice/seaice_reg_ridge.F:
1187      - modify the regularization of very small volumes of ice; only check
1188        total volume HEFF, and do not apply correction to individual ice
1189        classes because that leads to funny patterns in the heat and fw-fluxes
1190        into the ocean. Adjust seaice_itd/results/output.txt
1191      - replace nITD by SEAICE_multDim in loop-ranges
1192    o pkg/exf:
1193      - add code to process the case field period = -12. with UV interpolation.
1194      - move debug print (formerly active when exf_verbose=T) from EXF_getFFieldRec
1195        into S/R that calls it (i.e., exf_set_gen.F, exf_set_uv.F & obcs_exf_load.F)
1196    o verification/global_with_exf:
1197      - switch all fields period to -12. (was previously untested) in input/data.exf
1198        (but keep secondary test ".yearly" unchanged); update the reference output.
1199    o pkg/cal:
1200      - new calendar type "noLeapYear" for 365 days calendar without any leap year.
1201    o pkg/exf:
1202      - new integer parameter "exf_debugLev" (default set to main model debugLevel)
1203        to replace logical switch "exf_verbose"
1204      - report in STDOUT when loading a new record (if exf_debugLev >= 3)
1205    o pkg/sbo:
1206      - update from Katherine Quinn: evaluate mass directly from density and SSH
1207        (budget using Finite Volume method) instead of from bottom pressure.
1208      - allow testreport to collect few selected SBO output ; tested in exp.
1209        global_ocean.90x40x15 (after updating the results, to include SBO output).
1210      - fix some multi-threading issues (in output part).
1211    o model/src & most packages:
1212      - always call {PKG}_READPARMS even if corresponding use{PKG}=F;
1213      - in {PKG}_READPARMS, in case use{PKG}=F: add a call to new S/R
1214        PACKAGES_UNUSED_MSG to print a weak warning when parameter file
1215        "data.{pkg}" exist ; and leave the S/R (return) just after.
1216      - more standard LAND pkg interface (land_init_fixed.F, land_check.F).
1217        + call LAND_READPARMS from packages_readparms.F
1218    o pkg/seaice:
1219      - remove code that resets useThSice in S/R seaice_readparms and
1220        replace it by a warning in S/R seaice_check
1221      - remove parameter MULTDIM, replace with nITD and runtime
1222        parameter SEAICE_multDim (still hard-wired to nITD if
1223        SEAICE_ITD is defined)
1224    
1225    checkpoint64x (2014/05/24)
1226    o verification/lab_sea:
1227      - update adjoint and TLM output following changes to pkg/salt_plume
1228      - un-do the update after putting back local recip_Cp in few places.
1229    o pkg/salt_plume: modifications by An Nguyen:
1230      - add capability to do brine rejection (salt-plume) as function of
1231        volume+tracers (instead of only salinity tracer).
1232      - conserve volume by exchanging volume from each kLev to above to
1233        accommodate in-coming brine volume
1234      - store surface and klev exchanged fraction + volume in 4 new 3-d arrays
1235      - switch KPP surf buoyancy due to brine forcing to 3-d
1236        (3 more 3-d arrays, 2 for SPforcing[T,S], 1 for boplume)
1237      - add salt_plume_volfrac, salt_plume_apply, salt_plume_tendency_apply_t
1238      - unrelatedly, also add ad-hoc capability to vary salt_plume scheme
1239        in East/West Arctic.
1240    o pkg/sbo:
1241      - incorporate modifications from Katherine Quinn to enable the use of sbo
1242        pkg in ECCO-v4 set-up ; remove SBO-TimeAve output ; add monitor-like
1243        output for future testreport verification (unfinished).
1244    o pkg/atm_phys:
1245      - change diagnostics (AtPh_Trf & AtPh_Qrf) of DARGAN_BETTSMILLER S/R:
1246        skip the reseting of t_ref & q_ref to initial t & q ; this preserve the
1247        output of S/R CAPECALCNEW (Parcel temp & q) for diagnostics.
1248    o pkg/seaice
1249      seaice_calc_ice_strength.F: modify expression to avoid divisions
1250        (affects truncation)
1251      seaice_do_ridging.F: clean up the insectarium
1252      - fix a bug that was compensated by areaScaling (-> remove areaScaling code)
1253      - added SEAICEsnowFracRidge to redistributed snow (2nd bug)
1254      - set closing/openingRate to zero where no extra iteration is need (3rd bug)
1255      - add some debugging information and error messages (warnings)
1256    o model/src: modifications relatd to atmosphere p*:
1257      - Switch to more accurate p* coordinate slope term (calc_grad_phi_hyd.F)
1258      - With p* or Sigma-P, use constant reference Pot.Temp (thetaConst) instead
1259        of vertical profile tRef in geopotential background and anomaly.
1260      - Acount for true p* correction in theta <-> T conversion in pkg/aim_v23
1261        and pkg/atm_phys.
1262      - Update FWD output of experiments: aim.5l_cs (x2), fizhi-cs-32x32x40,
1263        fizhi-cs-aqualev20, fizhi-gridalt-hs, tutorial_held_suarez_cs, cpl_aim+ocn.
1264    o pkg/seaice: fix a bug in seaice_prepare_ridging.F, forgot a sqrt
1265    o pkg/ptracers: compute ptracer source/sink due to linear free surface.
1266        not used right now, but can be used in BGC packages to fix conservation.
1267    o pkg/dic, pkg/gchem: move tracer_meanarea to gchem, so it can be used by
1268        other packages too.
1269    o pkg/seaice/seaice_calc_ice_strength.F: replace SEAICE_rhoSnow by
1270        SEAICE_rhoIce in the Rothrock (1975)-type strength calculations (bug fix)
1271    o model/src:
1272      - since we have several heat capacity (even in model/src), define "recip_Cp"
1273        as local variable (no longer in common block) to avoid any confusion.
1274      - add thetaConst in PARAMS.h (to be used with pStar or sigma-P coords).
1275    o pkg/exf:
1276      - from Jeff Scott: add option (#define EXF_CALC_ATMRHO) to calculate local
1277        air density as function of air Temp, Humidity and atm pressure.
1278    
1279    checkpoint64w (2014/05/02)
1280    o verification:
1281      - update output_adm.txt files for experiment global_ocean.cs32x15 (seaice &
1282        seaice_dynmix) and lab_sea (primary test & noseaicedyn): moving/changing
1283        code from seaice_growth.F & seaice_advdiff.F to new ridging routines
1284        seaice_reg_ridge.F seaice_do_ridging.F affects AD gradient
1285        (down to 8-7 matching digits for global_ocean and 5-6 for lab_sea).
1286    o model/src: for atmosphere in p* coords:
1287      - store factor rStarFacC**atm_kappa (= pStarFacK) in common block
1288      - implement more accurate p* coordinate slope term (in calc_grad_phi_hyd.F),
1289        but not yet activated.
1290    o pkg/seaice: fix restart problem for ITD with new ice strength parameterisation:
1291      - move computation of opnWtrFrac = 1-AREA to before computing ice strength
1292      - this changes the results (but not for any verification experiment, because
1293        none tests this), but avoids having an extra field in the restart files
1294    o pkg/seaice: remove global variable TICE (not needed)
1295      - replace by TICES or local variable where necessary (cost_seaice_test,
1296        seaice_diagnostics_state)
1297      - move copying TICE to TICES from seaice_check_pickup to seaice_read_pickup
1298      - use specific read/write routines for reading and writing individual leves
1299        of a multilevel field
1300    o pkg/ctrl & model/inc:
1301      - move additional anomaly fields of control vars (related to options:
1302         ALLOW_KAPGM_CONTROL, ALLOW_KAPREDI_CONTROL and ALLOW_BOTTOMDRAG_CONTROL)
1303        from DYNVARS.h into new header file: CTRL_FIELDS.h
1304    o pkg/seaice: some small modifications to the ridging code
1305      - make fw2ObyRidge a global variable and add the freshwater flux to
1306        seaice_growth
1307      - pass actual thickness from seaice_prepare_ridging, so that it is
1308        computed only in one place and compute it in the same way as in
1309        seaice_growth
1310      - initialise more fields in seaice_do_ridging that where cause floating
1311        point exceptions over land
1312    o pkg/seaice: preparations for ridging code and first real ridging code
1313      - move most of "PART 1" of S/R seaice_growth into a new and separate
1314        S/R seaice_reg_ridge that will both regularize the state variable after
1315        advection call the actual ridging routine;
1316      - requires to make 5 fields global fields: d_HEFFbyNEG,d_HSNWbyNEG,
1317        d_AREAbyRLX,d_HEFFbyRLX,saltFluxAdjust;
1318      - remove ridging code from seaice_advdiff
1319      - clean up remaining part 1 of seaice_growth in an attempt to make it
1320        more readable (this is probably subjective)
1321      - call seaice_itd_redist once in the initialisation phase to have the initial
1322        conditions in the correct category
1323      - finally: add new ridging routine for ITD code
1324    
1325    checkpoint64v (2014/04/11)
1326    o pkg/ecco:
1327      - add runtime parameters mdt[start,end]date[1,2]
1328      - rename variable "tpmean" as "mdt" and "topexmeanfile" as "mdtdatfile"
1329    o pkg/seaice:
1330      - make deltaC a global variable, so that it can be used in ridging code
1331      - first step towards ridging: introduce new routines that compute
1332        ice strength based on ridging parameters
1333      - add diagnostic for HSNOWITD
1334      - add opnWtrFrac as a global variable (required for ridging scheme)
1335    o pkg/salt_plume + pkg/seaice/seaice_growth.F
1336      - add SALT_PLUME_IN_LEADS flag to activate pkg/salt_plume only when ice
1337        AREA exceeds a threshold (code contributed by I.Fenty in 2011)
1338    o verification/hs94.1x64x5:
1339      - leave ALLOW_AUTODIFF_TAMC undefined in code_oad/AUTODIFF_OPTIONS.h
1340      - do not use ECCO_CPPOPTIONS.h anymore for TAF & OpenAD Adjoint tests.
1341    o autodiff:
1342      - Start to include explicitly AUTODIFF_OPTIONS.h, COST_OPTIONS.h,
1343        and CTRL_OPTIONS.h in src files (to enable to skip the ECCO_CPPOPTIONS.h)
1344        For now, only in pkgs used in verification/hs94.1x64x5.
1345      - Replace ALLOW_AUTODIFF_TAMC by ALLOW_AUTODIFF (except for tape/storage
1346        which are specific to TAF/TAMC).
1347      - Replace ALLOW_AUTODIFF_OPENAD by ALLOW_OPENAD:
1348        since ALLOW_OPENAD is defined in PACKAGES_CONFIG.h (any time pkg/openad
1349        is compiled), this simplifies/reduces which *_OPTIONS.h file to include.
1350      - OpenAD: change Makefile to generate the appropriate AD_CONFIG.h when
1351        building mitgcmuv_ad (make adAll).
1352    o pkg/ecco:
1353      - cost_gencost_seaicev4.F:
1354         reformulate proxy cost as function of sst and local param SEAICE_freeze
1355         change cost names from siv4-[sst,vol] to siv4-[deconc,exconc]
1356      - add stop statement if old names siv4-[sst,vol] are used
1357      - add snapshots + cost reports for atmospheric longwave
1358      - remove factor 0.1 in front of wtau[u,v]
1359      - replace never used flag ALLOW_TMI_COST_CONTRIBUTION with
1360         ALLOW_TMI_SST_COST_CONTRIBUTION
1361    o pkg/atm_phys:
1362      - add some diagnostics for Short-wave and for convection S/R.
1363    o pkg/seaice/seaice_growth:
1364      - fix a bug in the lateral melt parameterization for SEAICE_ITD
1365        in seaice_growth; tempFrz needs to be computed inside the i/j-loop
1366      - rearrange loop order for better vector code in the same code block
1367      - rewrite the floeDiameter formula to have fewer divisions
1368      -  (miraculously) none of this changes the results of seaice_itd
1369    o pkg/smooth:
1370      - move param smooth2Ddiffnbt to pkg/ecco
1371    o pkg/salt_plume:
1372      - salt_plume_frac.F:
1373         clean up local param names
1374         reformulate (1-frac) to frac; original 1-frac was based on swfrac code
1375    o pkg/rw:
1376      - add RS version of S/R READ_MFLDS_LEV.
1377    o pkg/streamice:
1378      - fix the restart test by writing/reading pickup_streamice files.
1379    o pkg/seaice:
1380      - refine checks for jfnk-related parameters
1381      - comment out if statement with SEAICEuseIMEX parameter as long as there
1382        is no IMEX code to avoid confusion and surprises
1383    
1384    checkpoint64u (2014/03/07)
1385    o verification/MLAdjust:
1386      - rename secondary test suffix:
1387         1.leith  -> A4FlxF  + switch to flux-form & add side-drag
1388         0.leithD -> AhFlxF  + switch to flux-form
1389         0.smag   -> AhVrDv  (use Vorticity-Div. visc form) + add side-drag
1390         0.leith  -> AhStTn  (use Strain-Tension visc form) + add side-drag
1391    o pkg/mom_vecinv:
1392      - remove unused arguments from S/R MOM_VI_HDISSIP & MOM_HDISSIP (as it used
1393        to be before mom_calc_visc.F)
1394      - skip the call to MOM_CALC_TENSION & MOM_CALC_STRAIN if not needed.
1395      - add 2nd copy of vort3 & strain that knows about lateral BC (free/no slip):
1396        this is simpler for the adjoint and for diagnostics.
1397    o model/src + pkg/momentum:
1398      - add input files for  2-D additional Western and Southern cell-edge wall
1399         (e.g., to add "thin-wall" where it is =1).
1400      - fix sideDrag option for thin-walls with Non-Lin Free-Surf
1401        using 2nd hFacZ that is computed from initial (fix domain) hFac
1402      - known limitations of thin wall implementation: not yet coded for sigma
1403        coords; not working with CD-scheme neither.
1404    o pkg/seaice:
1405      - rename recently introduced parameters from (wrong name) AB to
1406        BDF (backward difference time discretisation)
1407      - retire runtime parameters SEAICEuseAB2, SEAICE_abEps
1408    o tools/adjoint_options:
1409      - remove setting of "OPENAD=true" (now set by command line "genmake2 -oad")
1410    
1411    checkpoint64t (2014/02/01)
1412    o pkg/ecco
1413      - add compile flag ALLOW_GENCOST_TIMEVARY_WEIGHT in ECCO_OPTIONS.h and
1414        runtime logical flag gencost_timevaryweight to read daily sea-ice sigma
1415      - replace hard-coded record number and period which only work for monthly
1416        with read-in runtime param that works for other periods (month,day,year)
1417    o pkg/thsice
1418      - corrected store directive fixes thsice adjoint gradient checks
1419    o genmake2 & testreport:
1420      - add genmake2 option "-oad" to generate a Makefile for OpenAD built and
1421        in this case, use tools/adjoint_options/adjoint_oad as default AD optfile.
1422        Update testreport accordingly. No need to set "export OPENAD=true"
1423        in adjoint_options/adjoint_oad anymore (will be removed later).
1424    o pkg/shelfice:
1425      - put T & S shelfice forcing into model surfaceForcing_T,_S (for now,
1426        only if SHELFICEboundaryLayer=F); Change model/src/external_forcing.F
1427        so that surface forcing applies to k=kSurf if using pkg/shelfice.
1428    o pkg/ctrl, pkg/grdchk, pkg/ecco:
1429      - Changes to make GENARR more modular (i.e. invisible if not used)
1430    o model/src/temp_integrate.F and salt_integrate.F
1431      - re-include store directives that were removed on Dec 27th.
1432    o model/src/external_forcing_surf.F
1433      - add storage directives for EmPmR and PmEpR to avoid recomputation of
1434        seaice_model in the adjoint that is problematic when seaice_model is
1435        turned off in the adjoint. The resolved issue dated back to July when
1436        EXTERNAL_FORCING_SURF call was moved.
1437        Update global_ocean.cs32x15/*/output_adm.seaice_dynmix.txt accordingly.
1438    o pkg/exf/exf_check.F
1439      - fix a small bug again (originally found by Wentao Liu, now found again)
1440      - streamline error output
1441    o pkg/streamice and aim_v23:
1442      - replace a few "_EXCH_XY_RL (" with "_EXCH_XY_RL(", so that
1443        Apple's /usr/bin/cpp knows what to do:
1444        Apple LLVM version 5.0 (clang-500.2.79) (based on LLVM 3.3svn)
1445        Target: x86_64-apple-darwin13.0.0
1446    
1447    checkpoint64s (2014/01/05)
1448    o tools/adjoint_options:
1449      - switch to fastopt.net TAF server (instead of default fastopt.de) for
1450        AD optfiles adjoint_diva & adjoint_f95 (similar to adjoint_default).
1451    o model/src:
1452      - remove some unnecessary TAF storage directives in forward_step.F and
1453        in dynamics.F (note: not always removed by TAF, e.g., double storage
1454        of kappaRU,kappaRV in former version of dynamics.F).
1455    o model/src & pkg/ptracers:
1456      - call directly GAD_IMPLICIT_R & IMPLDIFF + DWNSLP_APPLY from temp_integrate.F
1457        salt_integrate.F and ptracers_integrate.F (instead of from thermodynamics.F)
1458        and remove ptracers_dwnslp_apply.F & ptracers_implicit.F
1459      - call MATRIX_STORE_TENDENCY_EXP for each tracer (in ptracers_integrate.F)
1460      - add fZon & fMer as output argument of S/R GAD_CALC_RHS.
1461      - update TAF AD-output of experiments global_ocean.90x40x15 (13 for AD-grad).
1462    o useSingleCpuInput separates single-CPU input from single-CPU output;
1463        for now only implemented for in exf_interp_read.F
1464    o verification/advect_xy:
1465      - fix missing EXCH call in local version of ini_salt.F and update output.
1466    o momentum diagnostics:
1467      - fix which deltaT is used in Total-Tendency diagnostics.
1468      - fix typo in diagnostics for momentum tendency from AB.
1469    o pkg/seaice/seaice_lsr.F: fix an initialisation bug for the
1470        SEAICE_VECTORIZE_LSR_ZEBRA option that lead to NaNs on a NEC-SX8
1471    
1472    checkpoint64r (2013/12/08)
1473    o verification/*/results:
1474      - Update reference output of experiments that were passing with just 13 digits
1475         (make it easier to detect future changes in results)
1476    o model/src & pkg/ptracers:
1477      - move calls to GAD_ADVECTION (Multi-Dim advection) from thermodynamics.F to
1478        inside temp_integrate.F and salt_integrate.F and from ptracers_advection.F
1479        to inside ptracers_integrate.F ; remove ptracers_advection.F
1480    o coupling interface pkgs:
1481        [atm_compon_interf, ocn_compon_interf & atm_ocn_coupler]
1482      - change the config check to test the agreement of Ocean Depth
1483        with ATM land/sea mask (instead of ATM orography);
1484      - send to coupler the number of coupler time-steps to do for this run:
1485        this allows to check for consistency and don't need anymore to be
1486        specified in parameter file "data";
1487      in coupler:
1488      - check consistency of RunOff map versus Ocean Depth and ATM land/sea mask.
1489      - improve report to log-file of config setting (pass log-file unit to few S/R)
1490    o pkg/compon_communic:
1491      - add coupling send/receive for non-tiled integer vector;
1492      - add S/R to check and stop if any proc has an error (similar to
1493        eesupp/src/stop_if_error.F but single thread and across Comm_World).
1494    o pkg/exch2:
1495      - in exch2*_get_rx[1,2]: use new list "W2_tileIndex" to replace search
1496        through list of all tiles my proc owns.
1497    o model/src:
1498      - AUTODIFF only: in calc_adv_flow.F, recompute rTransKp (instead of copying
1499        from rTrans) to simplify dependencies (no need to store rTrans anymore in
1500        calling S/R); this affects AD results at machine truncation level:
1501        update AD-output (TAF) of experiments: 1D_ocean_ice_column,
1502        bottom_ctrl_5x5 & obcs_ctrl (12 digits for AD grad, same FWD grad).
1503    o tools/build_options:
1504      - simplify Warnings options (-ieee & -devel cases) in linux_amd64_gfortran
1505    o coupling interface pkgs:
1506        [compon_communic, atm_compon_interf & ocn_compon_interf]
1507      - move declaration of local array "ibuf" out of header file "CPLR_SIG.h"
1508        to each S/R that needs it; remove un-used variables.
1509      - change component tile registration (cpl_register.F in both compon_interf
1510        and mitcomponent_tile_register.F) to pass the full list of tiles
1511        information (including bi,bj) in 1 vector (instead of in a bi,bj matrix).
1512      - with pkg/exch2: adopt the same convention used for I/O to define mapping
1513        towards coupler global array (unless W2_useE2ioLayOut=F):
1514         a) can now use different tiling between atm & ocn comp.
1515         b) no needs to modify the run-Off map when changing tiling (was needed
1516            even if using the same tiling between atm & ocn).
1517         c) will allow to run with blank-tiles in 1 component (e.g., for ocean
1518            full land tiles); not yet tested.
1519      - check for valid mapping from comp. tile to coupler global array
1520      - improve report of tile registration results to log file.
1521    o pkg/exch2:
1522      - in eesupp/src/eeboot.F: move call to W2_EEBOOT before Coupler
1523        tile-registration (CPL_REGISTER);
1524      - activate (un-comment) definition and setting of "W2_tileIndex" list to
1525        store the local bi,bj indices of each tile;
1526      - also print bi,bj in local report to log file;
1527      - fix pkg/debug/debug_cs_corner_uv.F for the case nSy > 1 (left from
1528        Jun 2009 modif of pkg/exch2).
1529    o testing on baudelaire:
1530      - run 2 tests at a time: no significant slow down (since enough cpu) and
1531        get the full set of test done earlier
1532      - switch the ifort test to "-devel" ; run the OpenAD test everyday.
1533    o model/src/thermodynamics.F and routines called from it:
1534      - pkg/gmredi: gmredi_residual_flow.F (replacing gmredi_calc_uvflow.F &
1535        gmredi_calc_wflow.F) to update eulerian velocity (input) into residual
1536        velocity (outp) by adding bolus velocity.
1537      - model/src: calc_adv_flow.F (replacing calc_common_factors.F) to compute
1538        mass transport from velocity + lateral grid cell area
1539      - rename calc_gt.F to temp_integrate.F (includes call to TIMESTEP_TRACER)
1540      - rename calc_gs.F to salt_integrate.F (includes call to TIMESTEP_TRACER)
1541     in thermodynamics.F
1542      - remove k from thermodynamics.F and move it to temp_integrate.F
1543        salt_integrate.F and ptracers_integrate.F (now done inside the tracer
1544        loop).
1545      - compute locally (in thermodynamics.F) 3-D velocity field that is used to
1546        advect tracers; pass it as argument to GAD_ADVECTION, GAD_SOM_ADVECT,
1547        PTRACERS_ADVECTION, TEMP_INTEGRATE, SALT_INTEGRATE, PTRACERS_INTEGRATE,
1548        GAD_IMPLICIT_R and PTRACERS_IMPLICIT
1549      - update AD-output (TAF & OAD) of experiments: 1D_ocean_ice_column,
1550        global_ocean.90x40x15, tutorial_global_oce_biogeo and
1551        tutorial_tracer_adjsens (+ TLM output).
1552    o tools/OAD_support and (verification/*/) code_oad:
1553      - OAD_support/cb2mGetModules.csh: add PACKAGES_CONFIG.h in header file to
1554        module conversion ; remove unneeded CPP_EEOPTIONS.h.
1555      - code_oad/CPP_OPTIONS.h: remove PACKAGES_CONFIG.h and use a more standard
1556        version (closer to model/inc/CPP_OPTIONS.h).
1557    o model/src:
1558      - remove parameter "useOldFreezing" from PARAMS.h and push it to the
1559        retired list of parameters (routine FREEZE has been replace by surface
1560        freezing (10.yrs ago) and by pkg/frazil (interior freezing).
1561    o pkg/gmredi:
1562      - add option (GM_CALC_TRANSP_FROM_VEL) to compute transport directly from
1563        velocity (same scheme but affects machine truncation) for GM_AdvForm.
1564      - update output of FWD experiments: front_relax.bvp,
1565        global_ocean.90x40x15.dwnslp, global_ocean.cs32x15 and ideal_2D_oce.
1566    
1567    checkpoint64q (2013/11/17)
1568    o verification:
1569      - generate new output on baudelaire (gfortran, -ieee) for OpenAD experiments
1570        tutorial_global_oce_biogeo and global_ocean.90x40x15.
1571      - generate new output (growth & melt) for seaice_itd experiment after
1572        updating the input pickup_seaice files (previously wrong).
1573    o pkg/cost:
1574      - define a "final cost function" for each tile, and use GLOBAL_SUM_TILE_RL
1575        (instead of _GLOBAL_SUM_RL) to get the final cost from all procs & threads:
1576        o this fixes global-sum value if multi-threads (since GLOBAL_SUM_RL
1577          cannot be applied to var in common block).
1578        o allows to get results independent of tile-per-proc setting (if using
1579          slower GLOBAL_SUM_SEND_RECV option).
1580      - update accordingly: seaice_cost_final.F, shelfice_cost_final.F,
1581        thsice_cost_final.F and ecco_cost_final.F (this one affects lab_sea
1582        forward gradients: update output).
1583      - update */code_oad/externalDummies.F by adding dummy GLOBAL_SUM_TILE_RL
1584        S/R and, for most exp., also comment out GLOBAL_SUM_R8.
1585    o pkg/mom_common:
1586      - move to pkg/mom_common and model/src (previously in tutorial_deep_convection
1587        code) 2nd version of isotropic 3-D Smagorinsky code interface: strain and
1588        viscosity are locally declared in dynmics.F and pass as argument to CALC_GW;
1589        ensure that all field value that are used are set.
1590    o tutorial_deep_convection (smag3d):
1591      - add missing scaling in mom_calc_smag_3d.F;
1592      - set smag3D_coeff in input.smag3d such that results do not change.
1593    o pkg/dic:
1594      - change dic_cost.F to compute cost on each tile first and then apply
1595        GLOBAL_SUM_TILE_RL: this affects forward gradient of AD experiments
1596        tutorial_dic_adjoffline & tutorial_global_oce_biogeo; update output.
1597      - remove kLev argument and use GLOBAL_SUM_TILE_RL in tracer_meanarea.
1598    o eesupp/src & pkg/mdsio:
1599      - remove gather/scatter_vector.F (from eesupp) and mdsio_read/writevector.F
1600        (from pkg/mdsio) since they are no longer used for tape IO.
1601      - move simple C subroutine "setdir.c" from pkg/compon_communic to eesupp/src
1602        (+ keep a copy in pkg/atm_ocn_coupler).
1603    o verification/isomip:
1604      - split domain in 8 squared tiles (instead of just 2) for FWD, AD & OAD tests.
1605    o tools/build_options:
1606      - optfile linux_amd64_ifort11, fast (no ieee) case:
1607        to get a working restart for all experiments, add "-fp-model source"
1608        to FOPTIM (also remove "-opt-streaming-stores auto" <- this is the default).
1609    
1610    checkpoint64p (2013/10/20)
1611    o pkg/autodiff:
1612      - adread_adwrite.F: when type and length do not match ALLOW_AUTODIFF_WHTAPEIO
1613        criteria, return to simple (default) tape IO format.
1614    o pkg/mdsio (+ eesupp/src):
1615      - rewrite/simplify tape-IO S/R (new S/R MDS_READ/WRITE_TAPE replace
1616        previous MDSREAD/WRITEVECTOR) with 2 array argument from each type (R4/R8);
1617      - fix globalFile and singleCpuIO options using simpler global mapping.
1618      - new pairs of scatter/gather vector S/R (one for each type, generated from
1619        template) corresponding to simpler global mapping.
1620      - adread_write.F: switch to new S/R (but leave old calls commented) and write
1621        to globalFile when parameter globalFiles is set to True.
1622      - switch on useSingleCpuIO in AD experiments: global_ocean.90x40x15 & isomip.
1623    o pkg/autodiff:
1624      - adread_adwrite.F: add a hack for RS arrays (when RS=real*4);
1625        with ALLOW_AUTODIFF_WHTAPEIO defined, since corresponding (real*4) is
1626        missing, just add a STOP if array type do not match.
1627    o pkg/exf:
1628      - to allow to use seaice-fraction from pkg/exf in other pkgs than pkg/seaice:
1629         rename CPP option EXF_ALLOW_SEAICE_RELAX to EXF_SEAICE_FRACTION
1630         and rename array obsSIce to exf_iceFraction.
1631    o tutorial_deep_convection:
1632      - add 1rst version of isotropic 3-D Smagorinsky code (from Louis-Philippe),
1633        for now all in this exp. code dir.
1634      - add secondary test using Smag-3D viscosity (keep very low backgroud visc for
1635        testing) and flux-limter advection scheme for Temp. (no explicit diffusion).
1636    o eesupp/src:
1637      - added SINGLE_DISK_IO option because reading of parameter files on
1638        very large number of processors did not work with existing set-up
1639    
1640    checkpoint64o (2013/09/25)
1641    o pkg/atm_phys & atm_compon_interf:
1642      - allows for coupling of gray-atmosphere (atm_phys) with ocean.
1643    o tools/build_options:
1644      - switch from "-fPIC" to "-mcmodel=medium" in optfiles: linux_amd64_gfortran
1645        & linux_amd64_ifort11 and in linux_amd64_g77 & linux_amd64_open64 also
1646        remove CPP setting (was identical to genmake2 default).
1647    o pkg/gmredi & model/src: Some updating and work done on the residual model.
1648      - created new file model/src/calc_eddy_stress.F to calculate the eddy stress.
1649      - fixed up the calculation of the eddy stress and how it is added to the
1650        external forcing via taueddy_external_forcing.F
1651      - at the moment, it is very experimental and only works with the variable eddy
1652        diffusivity calculated in gmredi_k3d.F
1653    o pkg/seaice/seaice_check.F: add a check to catch the case of specifying
1654        lw/swfluxfile instead of lw/swdownfile in data.exf together with pkg/seaice
1655    o testreport (& tools/do_tst_2+2):
1656      - for MPI test, set default COMMAND to 'mpirun -v -np TR_NPROC ./{executable}'
1657    o tools/build_options: linux_amd64_gfortran & linux_amd64_ifort11:
1658      - remove CPP='cpp -traditional -P' (this is genmake2 default)
1659      - add switch (for big setups) to use 'medium' memory-model (but leave it
1660        commented out for now). Note: needed with FC 19 to compile big setups.
1661    o pkg/atm_compon_interf:
1662      - regroup per field origin (model & pkgs) the coupling storage routines
1663         (which accumalate in time each coupling field)
1664      - move bi,bj loops inside atm_store_my_data.F and store also wind-stress;
1665        update accordingly + simplify aim_do_physics.F
1666    
1667    checkpoint64n (2013/08/26)
1668    o pkg/bbl:
1669      - update formulation to reduce dispersion of tracer properties in bbl
1670      - replaced horizontal and vertical transport parameters with velocities
1671      - changes results for verification/global_with_exf.yearly
1672    o verification/halfpipe_streamice:
1673      - change to matrix construction; update both Fwd & AD output.
1674    o verification/tutorial_tracer_adjsens:
1675      - OpenAD test: switch to vector-invariant momentum since fluxform with
1676        rStar causes problems with OpenAD; update output.
1677    o tools:
1678      - genmake2: define a common prefix for all temp-file names ; move them
1679        to local /tmp disk (but would be easy to move them back);
1680      - xmakedepend: apply the same switch for temp-files.
1681    o pkg/offline:
1682      - changes for use with rStar (NLFS): assume that we continue to provide
1683        UVELMASS/hFacW_ini & VVELMASS/hFacS_ini (hFacWi,S_ini as written in grid
1684        output files) and apply r* scaling at each time-step (function of the time
1685        varying Eta field); use normal pickup files (needed for restart with NLFS).
1686    o adjoint with OpenAD:
1687      - move OpenAD-specific files from verification/OpenAD/code_oad_all to a new
1688        package openad.  This package has to be compiled for all runs with OpenAD
1689        instead of specifying code_oad_all as a modification directory.
1690      - link the fortran templates from tools/OAD_support to the build directory
1691        for preprocessing to avoid conflicts between different setups compiled
1692        simultaneously and simplify cleanup.
1693    o pkg/exf:
1694      - in exf_getforcing.F: comment out most of the EXCH calls (fields used by
1695        main model or other pkgs are exchanged in EXF_MAPFIELDS).
1696    o model/src:
1697      - do_stagger_fields_exchanges.F: skip EXCH calls when using pkg/offline
1698        (similar to do_fields_blocking_exchanges.F).
1699    o tools/genmake2:
1700      - remove TAF output src code just before calling staf (when not doing a fresh
1701        built, will stop if things go wrong with staf).
1702      - fix target "adobj" (left from TAF version-2 transition)
1703    o pkg/diagnostics:
1704      - add a parameter to track the status of pkg/diagnostics activation;
1705        this replace/extend the use of logical param "settingDiags" (to check
1706        when adding diag to the list) to also check any DIAGNOSTICS_[]FILL* call.
1707        New S/R to print error message and stop when pkgStatus is not right.
1708      - to try: add a warning when "data.diagnostics" exist but useDiagnostics=F.
1709    
1710    checkpoint64m (2013/08/13)
1711    o model/inc:
1712      - move FCORI_MACROS.h from PARAMS(_MACROS).h to GRID_MACROS.h (left from
1713        8 yrs ago modif when Coriolis arrays were moved from PARAMS.h to GRID.h)
1714    o pkg/kpp & aim_v23:
1715      - only call DIAGNOSTICS_FILL when useDiagnostics=TRUE.
1716    o pkg/seaice:
1717      - restore (last time on 2011/12/24) ability to compile pkg/seaice with
1718        undefined pkg/exf ALLOW_ATM_TEMP or ALLOW_RUNOFF CPP-options.
1719      - only call DIAGNOSTICS_FILL when useDiagnostics=TRUE.
1720    o eesupp/src:
1721      - fix check for overlap-size argument (myOLn.GT.MAX_OLY_EXCH)
1722        in exch1_rx[_ad].template (thanks to Francois Lefeuvre report).
1723    o switch to TAF version-2:
1724      - add flow directives to "freeze" naming convention for ad-routines that
1725        are used in I/O routines of adjoint state and associated common blocks
1726        that are used in adcommon.h (backward compatible with version-1)
1727      - update all ad-optfiles (in tools/adjoint_options + few local to some
1728        verification exp) to switch to latest TAF version (currently 2.5.5);
1729        merge "*_mpi" adoptfiles into the corresponding non-mpi (but commented
1730        out except for diva).
1731      - the major change with TAF version-2 is that both the differentiated
1732        routines and the forward routines (new) are returned as part of the TAF
1733        output source code. Update genmake2 accordingly.
1734      - new output for AD experiment tutorial_global_oce_biogeo (better AD gradient
1735        with version-2 when compared to TLM or FWD gradient); other experiments
1736        output show minor changes (machine truncation level); update the few AD &
1737        TLM output with 12 matching digits only (some prior to version-2 switch).
1738    
1739    checkpoint64l (2013/08/05)
1740    o model/src:
1741      - in dynamics.F, skip the call to CALC_VISCOSITY if momViscosity=F
1742      - main_do_loop.F: no longer includes additional (AUTODIFF) header files
1743        when using TAF but only if using OpenAD.
1744    o pkg/mom_common+fluxform+vecinv:
1745      - always set horiz. viscosity arrays to background value before calling
1746        MOM_CALC_VISC (in MOM_FLUXFORM & MOM_VECINV) and call S/R MOM_CALC_VISC
1747        only when using variable horiz. viscosity (useVariableVisc=T);
1748      - simplify mom_vecinv.F (only 1 block for momViscosity).
1749    o pkg/mom_common: variable horiz. viscosity in NH code
1750      - move horiz-viscosity 3-D arrays viscAh_W & viscA4_W (used in calc_gw.F)
1751        from model/inc/NH_VARS.h to pkg/mom_common/MOM_VISC.h
1752      - store in common block (in MOM_VISC.h) logical parameters: useHarmonicVisc,
1753        useBiharmonicVisc & useVariableVisc.
1754      - fix old bug (already in 1rst implementation of variable horizontal viscosity
1755        in calc_gw.F, version 1.27, 2006/06/20):
1756        horizontal bi-harmonic viscosity in gW was missing when wiscA4W=0
1757        even if variable bi-harmonic viscosity (e.g., viscA4Grid) was non-zero.
1758      - change background horiz viscosity in vertical momentum (gW) to always be
1759        viscAhW,viscA4W (instead of switching to viscAhD, viscA4D when using
1760        any type of variable viscosity, e.g., viscAh/4Grid)
1761      - change default value of viscAhW,viscA4W to viscAhD,viscA4D (instead of
1762        viscAh,viscA4) which default to viscAh,viscA4 :  this avoid missing
1763        horiz. viscosity in W eq when just setting viscAhD/Z,viscA4D/Z (since
1764        default viscAh,viscA4 is zero).
1765    o model/src:
1766      - extend length of drC & recip_drC from Nr to Nr+1.
1767  o Divided Adjoint (DIVA) with MPI:  o Divided Adjoint (DIVA) with MPI:
1768    - genmake2: do not create local ./mpi_headers dir when no file to copy into.    - genmake2: do not create local ./mpi_headers dir when no file to copy into.
1769    - remove option ALLOW_DIVIDED_ADJOINT_MPI (replaced by ALLOW_DIVIDED_ADJOINT    - remove option ALLOW_DIVIDED_ADJOINT_MPI (replaced by ALLOW_DIVIDED_ADJOINT

Legend:
Removed from v.1.1901  
changed lines
  Added in v.1.2218

  ViewVC Help
Powered by ViewVC 1.1.22