/[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.1573 by jmc, Sat Jan 14 16:41:36 2012 UTC revision 1.1693 by mlosch, Thu Jul 19 11:28:51 2012 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/mom_common (mom_u/v_bottomdrag), pkg/shelfice (shelfice_u/v_drag)
8      - replace if statements KE.ne.0 with KE.gt.0 to avoid sqrt of negative numbers
9        of KE that can occur with aggressive optimization
10    o model/src: CG2D_NSA
11      - clean-up:  stop if cg2dNormaliseRHS=T and AUTODIFF
12         and replace GLOBAL_SUM calls with GLOBAL_SUM_TILE.
13      - in test-exp that uses CG2D_NSA (bottom_ctrl & tutorial_tracer_adjsens),
14         change cg2d residual target to be expressed in Wunits (=> do not normalise
15         RHS ; this fix global_max Pb with TAF); update output.
16    o verification/tutorial_tracer_adjsens:
17       improve parameter consistency (and get rid of warnings):
18       - use deltaTFreeSurf=deltaTtracer (better with NonLin FreeSurf);
19       - switch Temp Adv Scheme from 81 to 80 (no limiter since theta < 0 is physical)
20       - use staggerTimeStep (for stability) in som81; use default rotation period.
21    o pkg/exch2:
22      - with empty facet: fix compact-format (W2_mapIO=1) definition (was previously
23        reset to 0 = 1 long line in X)
24    o pkg/mdsio:
25      - fix reading of dimensions from meta file for large-size domain
26    o model/src:
27      - fix saltIsActiveTr setting for IdealGas eosType (eosType is 6 character long);
28      - to refine CS-grid check, add logical flag "hasWetCSCorners": true if using
29        Cubed-Sphere Exch with CS-corners inside the domain;
30        make new S/R INI_GLOBAL_DOMAIN from code in ini_linear_phisurf.F to calculate
31        globalArea and to set hasWetCSCorners.
32      - add warning if usingCurvilinearGrid and momAdvection in flux-form (missing
33        metric terms); stop if hasWetCSCorners=T and momAdvection in flux-form.
34      - re-activate the stop if useCDscheme and hasWetCSCorners=T (previously if
35        useCDscheme and useCubedSphereExchange).
36    o pkg/seaice/seaice_growth.F :
37      - compute the SEAICE_DISABLE_HEATCONSFIX term accordingly
38        for the (.NOT.useRealFreshWaterFlux).OR.(nonlinFreeSurf.EQ.0)
39        when the previous code was not correct.
40      - in all cases diagnoze the boundary condition mismatch to SIaaflux
41      - in the case of useRealFreshWaterFlux.AND.(nonlinFreeSurf.GT.0) add
42        that term to QNET (essentially to set the melt/freeze water to 0degC).
43        when SEAICEheatConsFix is true, so that the ocean+ice budget heat is closed.
44    o verification/global_ocean.cs32x15/input.seaice :
45      - add SEAICEheatConsFix in data.seaice, ensuring closed ocean+ice heat budget.
46      - add diagnostics (commented out) for budget test using my matlab codes (gcmfaces).
47      - update results (output.seaice.txt) accordingly.
48    o verification/lab_sea/input/data.seaice :
49      - remove SEAICEheatConsFix, which is now be tested
50        in global_ocean.cs32x15. The presently coded fix
51        is only consistent with real fresh water + nlfs.
52      - update results (output.txt) accordingly.
53    o pkg/salt_plume: added diagnotic for salt tendency (oceSPtnd).
54    o AD_CONFIG.h file:
55      - in genmake2: remove "#undef ALLOW_ECCO_OPTIMIZATION" from AD_CONFIG.h;
56      - remove #include "AD_CONFIG.h" from all included OPTIONS files and
57        add it explicitly in each fortran src file where it is needed.
58        motivation: header file AD_CONFIG.h is generated/modified after "make depend"
59        thus introducing potentially wrong dependency; therefore, better to include
60        it only where it's really needed, and after any other included OPTIONS file
61        (less tempting to bring conditional includes according to ALLOW_ADJOINT_RUN
62        or ALLOW_TANGENTLINEAR_RUN).
63    
64    checkpoint63p (2012/07/06)
65    o pkg/autodiff:
66      - rename S/R INI_AUTODIFF to AUTODIFF_INIT_VARIA ;
67      - create new header file "AUTODIFF_PARAMS.h" for pkg/autodiff parameters
68        which are now read from new parameter file "data.autodiff" (inAdExact
69        previously in "data", use{KPP/GMRedi/SEAICE}inAdMode previously in data.pkg)
70      - add file "data.autodiff" in all verification/*/input_ad/ directories.
71      - add run-time parameter to turn On/Off SEAICEuseFREEDRIFT in adjoint/forward
72        mode (used in global_ocean.cs32x15.seaice_dynmix test exp.)
73    o verification/tutorial_tracer_adjsens/
74      - add extra sub-verification which uses "SOM" advection scheme
75        (2nd Order-Moment Advection Scheme, Prather Limiter) with
76          #define GAD_ALLOW_TS_SOM_ADV in GAD_OPTIONS.h
77        and in data:
78          multiDimAdvection=.TRUE.,
79          tempAdvScheme=81,
80          saltAdvScheme=81,
81    o model/src:
82      - introduce ALLOW_BALANCE_RELAX which allow the removal
83       of the global mean of relaxation terms by setting
84       balanceThetaClimRelax and balanceSaltClimRelax
85      - disable balanceEmPmR and balanceQnet in the case when useSeaice.
86       This case is now treated appropriately in seaice_growth.F
87    o pkg/seaice:
88      - do balanceEmPmR and balanceQnet based on the net fluxes
89        (SItflux) that enter the ocean+ice system rather than QNET
90        and EMPMR. Works best in real fresh water.
91      - SIatmFW, SIatmQnet, and SItflux computations had to be moved
92        out of the diagnotics bloc, and stored in global arrays.
93    
94    checkpoint63o (2012/06/29)
95    o vertical mixing schemes:
96      - remove unused S/R CALC_BUOYANCY (left from branch-atmos merging)
97      - replace computation of density (in Function STATE1, opps_calc.F) by a call
98        to S/R FIND_RHO_SCALAR
99      - pass sigmaR to S/R PP81_CALC, MY82_CALC (but not yet used) and to GGL90_CALC
100        and use it for N^2 calculation in ggl90_calc.F (save 2 density computations);
101        affects output (vermix.ggl90) at truncation level.
102    o testreport:
103      - change adjustment of SIZE.h for mpi+mth testing: preserve enough tiles
104        (nSx,nSy) for the number of threads (from eedata.mth)
105    o model/src:
106      - remove 2nd set of calls at the top of initialise_varia.F (Adjoint part)
107        related to Non_Lin Free-Surf or Bottom-Control (but not longer necessary).
108    o verification/tutorial_tracer_adjsens/
109      - compile with ALLOW_CG2D_NSA
110      - run with nonlinFreeSurf=3
111      - update reference output_adm.txt
112    o tools/genmake2:
113      - add "-DHAVE_NETCDF" to the DEFINES list when NetCDF is available ;
114        refine usePROFILES switching off (only when NetCDF is not available).
115    o verification (atmospheric set-up):
116      - change eosType='IDEALGAS' to eosType='IDEALG' to match variable declaration
117    o pkg/profiles : refine profiles and files handling.
118    o model/src and pkg/ecco : introduce run-time switch usePROFILES.
119    o model/src/the_main_loop.F, forward_step.F and pkg/exf/EXF_OPTIONS.h :
120      - changes to use model/src/the_main_loop.F rather than the ecco version
121        in ecco type adjoint runs.
122    o model/src:
123      - move computation of recip of grid distance & area from INI_MASKS_ETC to INI_GRID
124      - move setting of h0Fac[C,W,S] from INI_LINEAR_PHISURF to INI_MASKS_ETC
125      - update_masks_etc.F: rename SMOOTH*_R4,R8 function to the corresponding type (RS,RL)
126    o model/src:
127      - fix S/R UPDATE_CG2D for ALLOW_DEPTH_CONTROL case (was empty before);
128        update output of test experiment bottom_ctrl_5x5.
129    o pkg/generic_advdiff:
130      - implement vertical bi-harmonic diffusion (for now, only for T & S and
131        only explicitly).
132    o verification/bottom_ctrl_5x5/
133      update reference output (results changed quite some time ago,
134      not sure when; but new reference results look ok in terms of grdchk)
135    o verification/1D_ocean_ice_column/
136      For verification purposes, the exact adjoint rather than an approx.
137      should be used (e.g., to comare against F.D. or TLM).
138      removed autodiff_inadmode*_ad.F routines in code_ad/
139      Update results/ accordingly.
140    o pkg/cal:
141      - change cal_getdate.F so that output date is function of input time only
142        (less ambiguous, not mixed up with input iteration number).
143      - fix calendarDumps for non-zero phase-lag (S/R CAL_TIME2DUMP).
144    o pkg/diagnostics:
145      - implement calendarDumps also for stats-diags
146      - implement calendarDumps also for snap-shot output (negative freq)
147      - for now, ignores calendarDumps if non-zero phase-lag.
148    
149    checkpoint63n (2012/06/04)
150    o model/src:
151      - recompute rSurfW & S to ensure consistent column thickness (needed for rStar)
152        between Sum_k(hFac*drF) and rSurf-rLow, for now only when using pkg/shelfice;
153      - use h0FacC, W & S to compute hFac_surfC, W & S in calc_surf_dr.F (more
154        similar to calc_r_star.F); update results of experiment internal_wave and
155        tutorial_global_oce_in_p (affected @ truncation level).
156    o pkg/shelfice:
157      - add parameterisation of advective-diffusive flux into the ice shelf
158        according to Holland and Jenkins (1999), eq.22-33, as suggested by Jan De Ryd
159      - simply eps3/3a computation
160    o eesupp:
161     - add new CPP option (DISCONNECTED_TILES) to disconnect tiles (no exchange
162       between tiles, just fill-in edges assuming locally periodic subdomain) and
163       add corresponding exchange subroutines (EXCH0);
164     - new CG-solver version (_EX0) for disconnected-tiles special case.
165    o model/src (CG-solvers):
166     - modify Single-Reduction version (CG2D_SR) in case cg2dMaxIters is reached
167       (similar final residual output and max-Iter number as with standard version);
168     - allows to store and use lowest-residual solution (standard & _SR versions);
169     - cleaning up (remove old, commented out code, LETS_MAKE_JAM ...).
170     - by default, also compile CG2D_SR version (define ALLOW_SRCG in CPP_OPTIONS.h)
171    o eesup/src:
172     - global_vec_sum.F cleaning: add a BARRIER ; update comments ; remove ndef
173       ALWAYS_USE_MPI (no longer needed after fixing usingMPI settings - March 2012)
174    o pkg/salt_plume added to lab_sea/input_ad.noseaicedyn
175    
176    checkpoint63m (2012/04/27)
177    o pkg/shelfice:
178     - account for partical cells in surface level below ice-shelf for hydrostatic
179       pressure calculion (set uniformFreeSurfLev to F); update isomip experiments.
180    o ad test experiments:
181     - update and rename to "ad_optfile.local" local AD-optfile specific to a
182       particular adjoint verification experiment (in verification/*/code_ad/)
183    o pkg/seaice & pkg/exf:
184     - Part two of ECCO-CLIVAR code merges.
185       Completes merge of seaice area relax. code.
186       Requires unified CPP option EXF_ALLOW_SEAICE_RELAX
187       to be set in EXF_OPTIONS.h since this pkg controls its I/O
188       (and avoids second CPP option in SEAICE_OPTIONS.h)
189     - change default value of costIceStart & costIceEnd to a valid date.
190     - add snowPrecip to HSNOW in seaice_growth
191    o pkg/ptracers:
192     - move ptracers summary and setup check into separated S/R ; add a check for
193       valid PTRACERS_Iter0 value (error+stop or just warning).
194    o pkg/cal (+ pkg/ecco):
195     - avoid calling a S/R with 2 times the same arg (FWD: unless both are only used
196       as input; and for AD, unless both are not differentiable (e.g., k index)).
197    o model/src:
198     - define internal flag "uniformFreeSurfLev" (=T when free-surface level-index
199       is everywhere k=1) to speed-up some calculations (by pass kSurf reference);
200       temporary set to usingZCoords value (to be changed to F when using shelfice).
201     - hydrostatic pressure: implement partial cell near the surface also for
202       Z-coordinates (for the case where uniformFreeSurfLev=F); replace test on
203       usingZCoords with test on uniformFreeSurfLev where needed (in NonHyd code).
204    o pkg/ctrl/ctrl_init.F:
205     - add a formal parameter to s/r ctrl_init_rec to print
206       xx_$(ctrl_valiable)_file for easier debugging
207     - move call of cal_* routines into the if-block where they are really
208       needed so that xx_$(ctrl_variable)_period can be 0 or -12 without having
209       to specify a startdate
210    o pkg/seaice:
211     - update comments in SEAICE_OPTIONS.h (+ similar update of lab_sea/code and
212       global_ocean.cs32x15/code versions).
213     - turn on seaice Multi-category (in data.seaice, SEAICE_multDim=7) for
214       verification experiment global_ocean.cs32x15.seaice and update results.
215    o pkg/exf:
216     - new S/R EXF_GETFIELD_START to return starting-time of a forcing field
217       (according to useExfYearlyFields).
218    o pkg/cal:
219     - move calendar setting & summary (previously in cal_readparams.F) into new
220       S/R CAL_INIT_FIXED to be called later in the initialisation process, once
221       length of the simulation is set (after SET_PARMS call); This is an attempt
222       to fix Pb when, e.g.: pkg/longstep, modifies the length of the run.
223     - For safety: keep a record of pkg/cal parameter settings status
224               to allow to STOP if one pkg/cal S/R is called too early.
225     - add a stop in all basic pkg/cal subroutines if called before setting is done.
226     - modify cal_getdate.F: stop when nothing was returned;
227       if called with myIter=-1, simply retrun modelBaseDate (1,2 = startDate_1,_2);
228       this allows to remove "cal.h" from seaice_read_parms.F & init_mnc_vars.F.
229    
230    checkpoint63l (2012/04/04)
231    o pkg/bbl:
232      - fix call to FIND_RHO_2D in bbl_calc_rho.F (case multi-tiles per proc);
233        update global_with_exf output.yearly.txt file.
234    o pkg/cal:
235      - start to clean-up cal_set.F ; fix for the case where baseTime is non-zero.
236      - remove 2 unsused and very short (1 line only) functions ;
237      - remove unsused subroutines from AD-Diff list.
238    o model/src:
239      - start to implement clean wait to stop in initialization S/R (config_check.F,
240         packages_check.F, ini_parms.F and pkg/obcs/obcs_check.F + pkg/mypackage)
241    o folowing PRINT_MESSAGE changes:
242      - remove reminder multiple print to the same file (STDOUT) when multi-threads.
243    o pkg/bbl:
244      - modification so it can work with z*
245      - replace deltaT with dTtracerLev(k) for asynchronous time stepping
246      - global_with_exf/input.yearly verification; changes output.yearly.txt
247    o eesupp/src:
248      - PRINT_MESSAGE: use OpenMP critical instruction (similar to PRINT_ERROR);
249        writing to unit 0 (if unit=errorMessageUnit) extended to the case myThid=1
250      - CHECK_THREADS: specific code if using OpenMP threading: improve checking of
251        # of threads across processors (e.g., different env OMP_NUM_THREADS setting)
252      - improve special preliminary call to EESET_PARMS (if eedata is read 2 times).
253      - when using MPI, always set usingMPI=T ; set default accordingly and stop
254        if not consistent.
255      - ALL_PROC_DIE: add a BARRIER after MPI_FINALIZE call ; skip this when thread
256        argument is zero (in case called within single-thread section).
257    o pkg/fizhi:
258        clean-up turbulence cold-start switch: decided in fizhi_init_vars.F, stored
259        in common bloc (fizhi_coms.h) and then passed as argument up to S/R TURBIO.
260    o pkg/exch2:
261      - add argument "updateCorners" to S/R exch2_get_uv_bounds (enable to
262        activate EXCH_IGNORE_CORNERS in vector EXCH S/R).
263      - switch 1rst EXCH call to IGNORE_CORNERS (instead of UPDATE_CORNERS)
264        but keep the 2nd with UPDATE_CORNERS: this prevents overwriting good data
265        with bad ones coming from a not-yet-updated halo.
266        This should fix the problem when sNx <> sNy and GCD(sNx,sNy) < 2*Olx.
267    o pkg/frazil:
268        move FrzForcT diag from frazil_diagnostics_state.F to frazil_calc_rhs.F
269        http://mitgcm.org/pipermail/mitgcm-devel/2012-March/005384.html
270    o model/src/config_check.F: add a check for OLx>sNx/OLy>sNy
271    o verification/lab_sea
272      * #undef SEAICE_EXCLUDE_FOR_EXACT_AD_TESTING
273      * #define ALLOW_SST_CONTROL & ALLOW_SST_CONTROL
274      * nTimeSteps 3 -> 4
275      * changed reference output accordingly
276    o pkg/ctrl:
277      * fix ctrl_get_gen for xx_sst, xx_sss
278    o pkg/fizhi:
279      - fix 2 calls to S/R GRD2MSC (argument igrd) in update_earth_exports.F
280        update results of exp. fizhi-cs-32x32x40 (fail with only 6 digits for cg2d)
281      - by default, use new version of S/R GETPWHERE (#define TRY_NEW_GETPWHERE);
282        fix few out-of-bounds indices in referencing vars (initialise igrd to 1);
283        clean-up fizhi_turb.F (remove unused & uninitialised qdiaglsm array).
284    o pkg/gmredi:
285      - add diagnostic of Redi (main diagnonal) vertical diffusive flux of Temp
286    o pkg/fizhi:
287      - fix few initialisation and multi-tile Pb: aqualev & gridalt now pass the
288        (old)aces open64 tuv test.
289    o pkg/icefront: fix bug and reorder loop in icefront_init_varia.F
290    o pkg/mom_vecinv:
291      - fix 1 loop range in mom_vecinv.F to be like all the other loops which
292        set/update gu,gv/Diss (fix Pb of uninitialised fVerUkp in admom_vecinv
293        with non-lin free-surf).
294    o model/src: move k-loop outside of i/j-loops when (re-)computing R_low
295      in ini/update_masks_etc.F in order to avoid -O3 optimization problems with
296      some compilers (gfortran 4.6.0 on MacOS)
297    o momentum:
298      - separate fVer?(:,:,kUp) & fVer?(:,:,kDown) in argument list of MOM_FLUXFORM
299        & MOM_VECINV subroutines (to help TAF). This fixes Pb of uninitialised
300        fVer?(kUp) in admom_fluxform with non-lin free-surf or bottom control.
301    
302    checkpoint63k (2012/03/17)
303    o model/src:
304       - selectAddFluid (ALLOW_ADDFLUID): add missing term in horizontal momentum
305         flux-form (mom_fluxform.F) and vertical momentum (calc_gw.F) equations.
306       - SOLVE_DIAGONAL: switch default to use adjoinable & vectorized version
307         (#undef SOLVE_DIAGONAL_LOWMEMORY); update output of exp. front_relax.bvp.
308    o model/src: solve_*diagonal.F
309       - replace division with multiplication by inverse (similar to original version)
310         update output of AD exp. global_ocean.90x40x15.
311       - fix pkg/gmredi/gmredi_calc_psi_bvp.F & pkg/ggl90/ggl90_calc.F
312         to enable the use of the vectorized & differentiable solve_tridiagonal.F
313       - test exp. global_ocean.90x40x15/input_ad: switch to advection scheme 20 for
314         vertical advection (to get solve_tridiagonal tested in AD mode).
315    o pkg/seaice: ECCO-CLIVAR merge:
316      1. seaice AREA relaxation
317         * CPP option: SEAICE_ALLOW_AREA_RELAXATION
318         * runtime flag: SEAICE_tauAreaObsRelax
319      2. modified global mean cost imbalance code: CPP option
320          ALLOW_SSH_GLOBMEAN_COST_CONTRIBUTION
321    o another iteration on solve_*diagonal.F
322       Make choices independent of AUTODIFF
323       Default will be the adjoinable vectorized version.
324       Alternative choices are:
325       * non-adjoinable original version with low memory footprint:
326         #define SOLVE_DIAGONAL_LOWMEMORY
327       * still adjoinable but does not vectorize (k as inner-most loop):
328         #define SOLVE_DIAGONAL_KINNER (keeping SOLVE_DIAGONAL_LOWMEMORY undef)
329    o testreport
330     - add option to use a home made wrapper around "make"
331     - remove MITGCM_IEEE env. variable (no longer active)
332    o pkg/shelfice
333     - improve computation of friction velocity for velocity dependent
334       exchange coefficients: include velocities into SHELFICEBoundaryLayer
335       block to average velocities vertically
336     - add TAF store directives for SHI_ALLOW_GAMMAFRICT
337    o Modify diagonal solvers, now three versions (upon request):
338      #ifndef SOLVE_DIAGONAL_AUTODIFF
339        1. default version (dating back a while ago)
340      #else /* def SOLVE_DIAGONAL_AUTODIFF */
341      # ifdef SOLVE_DIAGONAL_KINNER
342        2. adjoinable version with k-innermost loop (G. Forget)
343      # else
344        3. adjoinable vectorized version of 2.
345      # endif
346      #endif /* SOLVE_DIAGONAL_AUTODIFF */
347      All flags are currently set within routines, but could/should be moved to CPP-options.
348      Array bounds for 1. are as before, for 2.,3. cover the entire domain
349      (could be changed for 1. too).
350    o verification/lab_sea (fwd):
351      - update the 4 fwd lab_sea test experiment: no longer SEAICE_GROWTH_LEGACY,
352        use 7 categories (except hb87), new solve4temp params (except salt_plume),
353        constant salinity (=4) or variable salinity (salt_plume) done through
354        SItracer.
355    o pkg/seaice:
356      - rename parameters: SIsalFrac to SEAICE_saltFrac & SIsal0 to SEAICE_salt0;
357      - remove old parameters ( SEAICE_freeze, SEAICEturbFluxFormula, SEAICE_gamma_t,
358         SEAICE_gamma_t_frz, SEAICE_availHeatTaper & SEAICE_availHeatFracFrz)
359        from SEAICE_PARMS.h ; still need to fix seaice_cost_sst.F (broken when
360        SEAICE_freeze got retired) but already better than previously with
361        SEAICE_freeze=123456.7 deg.C;
362      - move setting of facOpenGrow/Melt from SEAICE_INIT_FIXED to SEAICE_READPARMS
363        (safer multi-threaded setting); always set SEAICEuseEVP;
364      - setting of ocean-ice turb. flux coeff: moved from SEAICE_CHECK to
365        SEAICE_READPARMS & SEAICE_INIT_FIXED (this fixes wrong summary report);
366        stop if multiple specifications for the same coeff; make sure default
367        SEAICE_mcPheePiston is compatible with drF(1) & deltaT.
368    o pkg/obcs:
369      - allow to switch to upwind 1rst order advection scheme for the advective
370        flux computation at the open-boundary; disabled for adjoint built.
371    o pkg/ptracers:
372      - rename PTRACERS_RESTART.h -> PTRACERS_START.h
373      - rename ptracers_fields_blocking_exchanges.F -> ptracers_fields_blocking_exch.F
374      - add parameter to decide when to start a tracer; use internal flag to
375        know which tracer to step-forward; switch this internal flag at the top
376        of forward_step.F (new S/R PTRACERS_SWITCH_ONOFF); for now, not enabled
377        for adjoint built.
378    o pkg/seaice:
379      - add SEAICE_SIZE.h anywhere in the code where SEAICE.h is included ;
380      - move MULTDIM declaration and setting from SEAICE.h to SEAICE_SIZE.h ;
381      - keep experiment offline_exf_seaice truly single category (set MULTDIM=1).
382    o pkg/ecco:
383      - fix writing of output file DiagnosCost_ClimSalt/Theta
384        and DiagnosCost_DriftSalt/Theta (if multi-tiles per proc).
385    o pkg/seaice:
386      - add missing initialisation of COR_ICE array in dynsolver.F
387      - merging SEAICE_MULTICATEGORY define and undef cases. Now the same code is
388        compiled either way, and is tested in all exps (multidim was only tested
389        in lab_sea ad before).
390      - cosmetic change to prepare for future addition of ITD. no change to results.
391        no defaults change.
392      - added run time param SEAICE_multDim (7 for SEAICE_MULTICATEGORY, 1 otherwise).
393      - by lack of adequate verification experiments, I further used custom versions
394        of global_ocean.cs32x15 to test multicat or not, with pickup or not. All
395        should be correct.
396      - avoid recomputations in ad.
397    o array initialisation in adjoint mode:
398      1) pkg/mom_common/mom_calc_ke.F:
399        add full array initialisation of KE inside mom_calc_ke.F (ALLOW_AUTODIFF_TAMC):
400        The S/R which calls MOM_CALC_KE initialises KE but in some recomputation
401        part this initialisation is gone, resulting in Floating Point Exception
402        (caught by open64 compiler with debug option).
403      2) model/src/convective_weights.F
404        set output convectCount over the full array range (instead of doing
405        an update): this fix a similar issue when called within recomputation (adjoint)
406        which could by-pass the initialisation (normally done in the caller S/R).
407    o pkg/seaice:
408      - final version of turbulent flux params, as agreed at MIT ice meet:
409           SEAICE_mcPheePiston (default is ~ 0.000875)
410           SEAICE_mcPheeTaper (default is 0.)
411           SEAICE_frazilFrac (defualt is 1.)
412           SEAICE_mcPheeStepFunc (default is false)
413      - changes results at trunction error level
414      - ifdef SEAICE_EXTERNAL_FLUXES, disallow SEAICE_waterAlbedo
415    o added pkg/frazil:
416      - see frazil_description.tex for details
417      - verification experiment is global_with_exf/input.yearly; changes output.yearly.txt
418    o pkg/shelfice/shelfice_thermodynamics.F
419      - fix exponents for velocity dependent exchange coefficients: change
420        from 2/3(=0) to 0.66666666666666667
421      - move computation of velocity dependent exchange coefficients into
422        separate loop, so that it applies to both thermodynamics
423      - move some divisions by constants out of loops
424    
425    checkpoint63j (2012/02/16)
426    o pkg/seaice:
427      - overhaul of seaice_summary.F after feb 2012 clean-up of seaice_growth.F etc.
428      - SItracer:  added run time params, and allow coupling to ocn salinity.
429    o pkg/seaice: remove (almost) all divisions by constants within loops
430      in seaice_growth.F and seaice_solve4temp.F, this changes (only) the cg2d
431      results of global_ocean.cs32x15.seaice from 16 to 11 digits (but only
432      those, caused by 1/QI -> recip_QI) -> update output.seaice.txt,
433      output_adm.seaice_dynmix.txt and also lab_sea: output_adm.evp.txt
434    o pkg/seaice :
435      - simplify McPhee tapering, and allow to use it with SEAICEturbFluxFormula
436        = 1 or 2, using newly added run time parameter SEAICE_availHeatTaper.
437      - fix d_AREAbyATM, d_AREAbyOCN, d_AREAbyICE diags I broke in r1.148.
438      - add permanent SItflux diag that corresponds to TFLUX but includes
439        ice+snow. Hence SItflux-TFLUX should match the ice+snow heat budget.
440      - allow activation/testing of a fix for suspected missing term in
441        ocn-ice heat budget (to be confirmed). To test this, you want to
442        undef SEAICE_DISABLE_HEATCONSFIX, and then set the run time param
443        SEAICEheatConsFix to .TRUE. that also allows the 'SIaaflux' diagnostic.
444      - no change in results, fwd or ad.
445    o global_ocean.cs32x15/results: 3 changes following from the pkg/seaice commit below:
446      - switch to variable freezing point.
447           Results change : cg2d -> 1 digits; ad -> 3-6-6 digits.
448      - bug fix : the sublimation term that was missing is now activated.
449           Results change : cg2d -> 2 digits; ad -> 8-6-6 digits.
450      - bug fix : flooding sign term for SIsal0.NE.0.
451           Result change : cg2d -> 8 digits; ad -> 11-12-9 digits.
452    o pkg/seaice:
453      - unified freezing point treatment : the old SEAICE_VARIABLE_FREEZING_POINT
454        is now the default, and the old default constant freezing point is recovered
455        with SEAICE_tempFrz0    = -1.96,
456             SEAICE_dTempFrz_dS = 0.,
457      - retire SEAICE_freeze (= the old way of specifycing the constant freezing point)
458      - remove ALLOW_SEAICE_FLOODING brackets; run time switch is already there.
459      - bug fix (thanks to M. Losch) : the sublimation term that was missing is now
460        activated. To reproduce old results with this bug define SEAICE_DISABLE_SUBLIM.
461      - bug fix (silly me) : flooding sign term (seaice_growth.F r 1.149line 1211)
462        was wrong for SIsal0.NE.0. Changes cs32x15 results (see above item for detail).
463      - bug fix (thanks to O. Jahn) : area loss for melting  got messed up in
464        seaice_growth r149 for legacy branch (no results change).
465      - introduce SEAICE_CAP_SUBLIM : caps sublimation heat flux in solve4temp (code
466        from I. Fenty).
467      - results did not change except for global_ocean.cs32x15, mostly due to the
468        switch to variable freezing point (see above item for detail).
469    o pkg/thsice:
470      - fix and simplify interface to salt_plume pkg ; diagnose directly amount of
471        seawater freezing in thsice_calc_thickn (not used).
472    o pkg/seaice: turbulent flux term specification via run time params.
473      - replace CPP switches with run time switches to facilitate testing
474      - retired CPPs : MCPHEE_OCEAN_ICE_HEAT_FLUX,
475                       GRADIENT_MIXED_LAYER_TURBULENCE_FACTOR
476      - added runtime parameter : SEAICEturbFluxFormula
477      - move Mcphee constants to SEAICE_PARAMS.h
478      - seaice_readparms.F : read turbulent flux term params (SEAICEturbFluxFormula;
479                 SEAICE_availHeatFrac/Frz, or SEAICE_gamma_t/_frz if apply);
480                 remove seaice_summary call (moved to seaice_init_fixed)
481      - seaice_init_fixed.F : set SEAICE_availHeatFrac/Frz depending on
482        SEAICEturbFluxFormula, and seaice_summary call (moved from seaice_readparms)
483      - seaice_summary.F : add missing report of read turbulent flux term set up
484                           and SITRACER.
485      - seaice_check.F : check range; inform and stop if retired CPPs are used
486                         (incl. SEAICE_AGE).
487      - seaice_growth.F : unified use of SEAICE_availHeatFrac/Frz, without
488             CPP switch, same computation as before for the different options.
489      - change results at the truncation level.
490    o pkg/seaice:
491      - remove un-used parameters LAD & MAX_TICE ; add new run-time parameters:
492        useMaykutSatVapPoly (default=F), postSolvTempIter (default=2) and
493        SEAICE_wetAlbTemp (default=-1e-3). Remove option SEAICE_SOLVE4TEMP_LEGACY.
494      - update verification/*/input*/data.seaice:
495        to reproduce previous results with former #defined SEAICE_SOLVE4TEMP_LEGACY
496        code, set useMaykutSatVapPoly=T & postSolvTempIter=0 ;
497        and to reproduce previous results with former non-SOLVE4TEMP_LEGACY code,
498        set SEAICE_wetAlbTemp=0 & SEAICE_snowThick=0.
499    o pkg/seaice/seaice_solve4temp.F (SOLVE4TEMP_LEGACY):
500      - remove LEGACY code for solving for tsurf (A1,A2,A3) but maintain the same
501        algorithm (same choice: useMaykutPolySatVap=T, postSolvTempIter=0);
502        difference in results only due to machine truncation.
503      - remove MAX_TICE (tsurf is always =< TMELT anyway); keep MIN_TICE if using
504        MaykutPolySatVap; keep MIN_LWDOWN.
505      - adapt SEAICE_MODIFY_GROWTH_ADJ code (untested) to non-legacy formulation.
506      - update output of verification exp. lab_sea (4 fwd: 11 cg2d digits except hb87,
507        + 3 AD: 6 digits except evp) and offline_exf_seaice.seaice (12 digits).
508    o pkg/salt_plume:
509      - isolate saltPlumeFlux array exch into a specific S/R called from
510        do_oceanic_phys.F
511      - add interface to pkg/salt_plume (filling of saltPlumeFlux) in pkg/thsice.
512    o verification:
513      - move untested set-up to MITgcm_contrib/verification_other.
514    o pkg/seaice:
515      - retire old way of SEAICE_AGE. Now replaced with ALLOW_SITRACER.
516    o pkg/seaice:
517      - seaice_solve4temp.F (keeping results unchanged):
518        * add 2 future run-time params to select which saturation vapor pressure
519          formula is used and how post-iteration fluxes are set.
520          Temporary set these 2 params according to option SOLVE4TEMP_LEGACY;
521        * New piece of code (not used) to update surf. atmos. heat flux F_ia using
522          the linearized expression to stay consistent with tsurf finding.
523      - seaice_freedrift.F avoid floating exception in sqrt(y) since y=sqrt(x*x)-x
524        can be < 0.
525    o pkg/seaice/seaice_solve4temp.F (SOLVE4TEMP_LEGACY undef):
526      - remove from F_ia (and from it's derivative dFiDTs1) the contribution of
527        conductive heat flux F_c , and add it explicitly when updating tsurf as
528        solution of: Fc = Fia + d/dT(Fia - Fc) *delta.tsurf
529        so that now F_ia has a consistent meaning through the entire routine.
530        This causes differences at truncation level: update output of fwd exp.
531        global_ocean.cs32x15.seaice.
532    o pkg/seaice:
533      - lots of editing/cleaning in seaice_solve4temp.F + better documentation
534        of arrays, sign/direction of fluxes; no effect on results.
535      - replace hard coded 273.16 (=previous value of celsius2K) by celsius2K
536        in seaice_budget_ocean.F & seaice_solve4temp.F (SOLVE4TEMP_LEGACY part);
537        note: this should have been done before changing celsius2K default.
538      - to keep results unchanged, add back old value of celsius2K in verification
539        exp. input*/data : lab_sea (AD), offline_exf_seaice (fwd+AD) & seaice_obcs
540      - replace hard coded seawater freezing temp in seaice_solve4temp.F (part
541        SOLVE4TEMP_LEGACY) of 271.20 (=previous value of celsius2K + default
542        value of SEAICE_freeze) by celsius2K+SEAICE_freeze so that seawater
543        freezing temp is consistent with value in seaice_growth.F ; this causes
544        differences at machine truncation level: update lab_sea AD output (3/4).
545    o pkg/seaice:
546      - mask (in exf_init_fixed.F) atemp,aqh,evap,precip,runoff,lwflx,areamask
547        and climsst/sss even when using seaice (to prevent calculation that might
548        use SST on land); does not affect any verification exp.
549      - apply mask to taux,tauy (in seaice_get_dynforcing.F); update output
550        of lab_sea.fd & lab_sea.hb87 and global_ocean.cs32x15.seaice_dynmix.
551    o pkg/seaice/seaice_growth.F: add mask to avoid non-zero ice thickness
552      over land (non-legacy code)
553    o vectorize salt_plume package:
554      - add extra code to salt_plume_frac and salt_plume_tendency_apply_s
555      - this code computes plumebk everywhere (also over land), thus requires
556        code to avoid divisions by zero and catch the case of kLev=Nr.
557      - efficiency of salt_plume_frac is still sub-optimal
558    o tools (genmake2):
559      - fix makefile NAME specification (option: -makefile NAME) by adding
560        "-f $MAKEFILE" in few places where it was missing including makedepend
561        command (contribution from Paul).
562    
563    checkpoint63i (2012/01/24)
564    o model/src:
565      - add factorized versions of some EOS code to find_rho.F,
566        define USE_FACTORIZED_EOS to turn it on (default for TARGET_NEC_SX)
567    o model/src:
568      - add celsius2K to namelist PARM01; remove unused recip_rhoNil from PARAMS.h;
569      - change default celsius2K from 273.16 to 273.15
570      - to keep results unchanged, add back old value of celsius2K in verification
571        exp. input*/data : aim.5l_cs, 1D_ocean_ice_column, lab_sea (fwd),
572         global_ocean.cs32x15(seaice) & cpl_aim+ocn(input_atm).
573    o model/src: add a little initialisation trick to find_rho.F and find_alpha.F
574      to make TAF generate vectorizable code
575    o pkg/seaice/seaice_evp.F: add code (copied from CICE) that avoids underflows.
576       Turn on by defining SEAICE_EVP_ELIMINATE_UNDERFLOWS. Most compilers
577       have flags that do this more efficiently.
578    o pkg/diagnostics/diagstats_calc.F
579      - for TARGET_NEC_SX fix the treatment of the scaling factor tmpFac=scaleFact
580    o pkg/obcs (with exch2):
581      - derive OB indices in overlap region from OB-InsideMask (in obcs_init_fixed.F)
582        and remove code (in obcs_readparms.F) which was based on EXCH of indices
583        (through buffer) and did not account for exch2 (e.g., CS-grid) topology.
584    o pkg/exf and seaice exp:
585      - change offline_exf_seaice.seaicetd test exp. to use default DIFF1 value (=0)
586        so that switching off area & heff advection flags does not affect results.
587      - change default EXF_LWDOWN_WITH_EMISSIVITY to #define in EXF_OPTIONS.h
588      - keep exp. seaice_obcs & 1D_ocean_ice_column(ad) unchanged (using #undef
589        EXF_LWDOWN_WITH_EMISSIVITY) and, using pkg/exf default emissivities, update
590        results of verification experiments: 1D_ocean_ice_column(fwd),
591        global_ocean.cs32x15.seaice(fwd+ad) & seaice_dynmix(ad), lab_sea (all 8)
592        and offline_exf_seaice (all 4).
593  o pkg/seaice:  o pkg/seaice:
594    - remove array YNEG, RIVER, TMIX (replaced by local var) from common block;    - remove array YNEG, RIVER, TMIX (replaced by local var) from common block;
595      remove also areaNm1 & hEffNm1 when SEAICE_GROWTH_LEGACY is undef.      remove also areaNm1 & hEffNm1 when SEAICE_GROWTH_LEGACY is undef.

Legend:
Removed from v.1.1573  
changed lines
  Added in v.1.1693

  ViewVC Help
Powered by ViewVC 1.1.22