4 |
Notes on tags used in MITgcmUV |
Notes on tags used in MITgcmUV |
5 |
============================== |
============================== |
6 |
|
|
7 |
|
o ECCO-CLIVAR merge: |
8 |
|
1. seaice AREA relaxation |
9 |
|
* CPP option: SEAICE_ALLOW_AREA_RELAXATION |
10 |
|
* runtime flag: SEAICE_tauAreaObsRelax |
11 |
|
2. modified global mean cost imbalance code: CPP option ALLOW_SSH_GLOBMEAN_COST_CONTRIBUTION |
12 |
|
o another iteration on solve_*diagonal.F |
13 |
|
Make choices independent of AUTODIFF |
14 |
|
Default is now the adjoinable vectorized version |
15 |
|
Alternative choices are: |
16 |
|
* still adjoinable but lower memory (k as inner-most loop) |
17 |
|
SOLVE_DIAGONAL_KINNER |
18 |
|
* non-adjoinable legacy version with low memory footprint |
19 |
|
SOLVE_DIAGONAL_LOWMEMORY |
20 |
|
o testreport |
21 |
|
- add option to use a home made wrapper around "make" |
22 |
|
- remove MITGCM_IEEE env. variable (no longer active) |
23 |
|
o pkg/shelfice |
24 |
|
- improve computation of friction velocity for velocity dependent |
25 |
|
exchange coefficients: include velocities into SHELFICEBoundaryLayer |
26 |
|
block to average velocities vertically |
27 |
|
- add TAF store directives for SHI_ALLOW_GAMMAFRICT |
28 |
|
o Modify diagonal solvers, now three versions (upon request): |
29 |
|
#ifndef SOLVE_DIAGONAL_AUTODIFF |
30 |
|
1. default version (dating back a while ago) |
31 |
|
#else /* def SOLVE_DIAGONAL_AUTODIFF */ |
32 |
|
# ifdef SOLVE_DIAGONAL_KINNER |
33 |
|
2. adjoinable version with k-innermost loop (G. Forget) |
34 |
|
# else |
35 |
|
3. adjoinable vectorized version of 2. |
36 |
|
# endif |
37 |
|
#endif /* SOLVE_DIAGONAL_AUTODIFF */ |
38 |
|
All flags are currently set within routines, but could/should be moved to CPP-options. |
39 |
|
Array bounds for 1. are as before, for 2.,3. cover the entire domain |
40 |
|
(could be changed for 1. too). |
41 |
|
o verification/lab_sea (fwd): |
42 |
|
- update the 4 fwd lab_sea test experiment: no longer SEAICE_GROWTH_LEGACY, |
43 |
|
use 7 categories (except hb87), new solve4temp params (except salt_plume), |
44 |
|
constant salinity (=4) or variable salinity (salt_plume) done through |
45 |
|
SItracer. |
46 |
|
o pkg/seaice: |
47 |
|
- rename parameters: SIsalFrac to SEAICE_saltFrac & SIsal0 to SEAICE_salt0; |
48 |
|
- remove old parameters ( SEAICE_freeze, SEAICEturbFluxFormula, SEAICE_gamma_t, |
49 |
|
SEAICE_gamma_t_frz, SEAICE_availHeatTaper & SEAICE_availHeatFracFrz) |
50 |
|
from SEAICE_PARMS.h ; still need to fix seaice_cost_sst.F (broken when |
51 |
|
SEAICE_freeze got retired) but already better than previously with |
52 |
|
SEAICE_freeze=123456.7 deg.C; |
53 |
|
- move setting of facOpenGrow/Melt from SEAICE_INIT_FIXED to SEAICE_READPARMS |
54 |
|
(safer multi-threaded setting); always set SEAICEuseEVP; |
55 |
|
- setting of ocean-ice turb. flux coeff: moved from SEAICE_CHECK to |
56 |
|
SEAICE_READPARMS & SEAICE_INIT_FIXED (this fixes wrong summary report); |
57 |
|
stop if multiple specifications for the same coeff; make sure default |
58 |
|
SEAICE_mcPheePiston is compatible with drF(1) & deltaT. |
59 |
|
o pkg/obcs: |
60 |
|
- allow to switch to upwind 1rst order advection scheme for the advective |
61 |
|
flux computation at the open-boundary; disabled for adjoint built. |
62 |
|
o pkg/ptracers: |
63 |
|
- rename PTRACERS_RESTART.h -> PTRACERS_START.h |
64 |
|
- rename ptracers_fields_blocking_exchanges.F -> ptracers_fields_blocking_exch.F |
65 |
|
- add parameter to decide when to start a tracer; use internal flag to |
66 |
|
know which tracer to step-forward; switch this internal flag at the top |
67 |
|
of forward_step.F (new S/R PTRACERS_SWITCH_ONOFF); for now, not enabled |
68 |
|
for adjoint built. |
69 |
|
o pkg/seaice: |
70 |
|
- add SEAICE_SIZE.h anywhere in the code where SEAICE.h is included ; |
71 |
|
- move MULTDIM declaration and setting from SEAICE.h to SEAICE_SIZE.h ; |
72 |
|
- keep experiment offline_exf_seaice truly single category (set MULTDIM=1). |
73 |
|
o pkg/ecco: |
74 |
|
- fix writing of output file DiagnosCost_ClimSalt/Theta |
75 |
|
and DiagnosCost_DriftSalt/Theta (if multi-tiles per proc). |
76 |
|
o pkg/seaice: |
77 |
|
- add missing initialisation of COR_ICE array in dynsolver.F |
78 |
|
- merging SEAICE_MULTICATEGORY define and undef cases. Now the same code is |
79 |
|
compiled either way, and is tested in all exps (multidim was only tested |
80 |
|
in lab_sea ad before). |
81 |
|
- cosmetic change to prepare for future addition of ITD. no change to results. |
82 |
|
no defaults change. |
83 |
|
- added run time param SEAICE_multDim (7 for SEAICE_MULTICATEGORY, 1 otherwise). |
84 |
|
- by lack of adequate verification experiments, I further used custom versions |
85 |
|
of global_ocean.cs32x15 to test multicat or not, with pickup or not. All |
86 |
|
should be correct. |
87 |
|
- avoid recomputations in ad. |
88 |
|
o array initialisation in adjoint mode: |
89 |
|
1) pkg/mom_common/mom_calc_ke.F: |
90 |
|
add full array initialisation of KE inside mom_calc_ke.F (ALLOW_AUTODIFF_TAMC): |
91 |
|
The S/R which calls MOM_CALC_KE initialises KE but in some recomputation |
92 |
|
part this initialisation is gone, resulting in Floating Point Exception |
93 |
|
(caught by open64 compiler with debug option). |
94 |
|
2) model/src/convective_weights.F |
95 |
|
set output convectCount over the full array range (instead of doing |
96 |
|
an update): this fix a similar issue when called within recomputation (adjoint) |
97 |
|
which could by-pass the initialisation (normally done in the caller S/R). |
98 |
|
o pkg/seaice: |
99 |
|
- final version of turbulent flux params, as agreed at MIT ice meet: |
100 |
|
SEAICE_mcPheePiston (default is ~ 0.000875) |
101 |
|
SEAICE_mcPheeTaper (default is 0.) |
102 |
|
SEAICE_frazilFrac (defualt is 1.) |
103 |
|
SEAICE_mcPheeStepFunc (default is false) |
104 |
|
- changes results at trunction error level |
105 |
|
- ifdef SEAICE_EXTERNAL_FLUXES, disallow SEAICE_waterAlbedo |
106 |
|
o added pkg/frazil: |
107 |
|
- see frazil_description.tex for details |
108 |
|
- verification experiment is global_with_exf/input.yearly; changes output.yearly.txt |
109 |
|
o pkg/shelfice/shelfice_thermodynamics.F |
110 |
|
- fix exponents for velocity dependent exchange coefficients: change |
111 |
|
from 2/3(=0) to 0.66666666666666667 |
112 |
|
- move computation of velocity dependent exchange coefficients into |
113 |
|
separate loop, so that it applies to both thermodynamics |
114 |
|
- move some divisions by constants out of loops |
115 |
|
|
116 |
|
checkpoint63j (2012/02/16) |
117 |
|
o pkg/seaice: |
118 |
|
- overhaul of seaice_summary.F after feb 2012 clean-up of seaice_growth.F etc. |
119 |
|
- SItracer: added run time params, and allow coupling to ocn salinity. |
120 |
|
o pkg/seaice: remove (almost) all divisions by constants within loops |
121 |
|
in seaice_growth.F and seaice_solve4temp.F, this changes (only) the cg2d |
122 |
|
results of global_ocean.cs32x15.seaice from 16 to 11 digits (but only |
123 |
|
those, caused by 1/QI -> recip_QI) -> update output.seaice.txt, |
124 |
|
output_adm.seaice_dynmix.txt and also lab_sea: output_adm.evp.txt |
125 |
|
o pkg/seaice : |
126 |
|
- simplify McPhee tapering, and allow to use it with SEAICEturbFluxFormula |
127 |
|
= 1 or 2, using newly added run time parameter SEAICE_availHeatTaper. |
128 |
|
- fix d_AREAbyATM, d_AREAbyOCN, d_AREAbyICE diags I broke in r1.148. |
129 |
|
- add permanent SItflux diag that corresponds to TFLUX but includes |
130 |
|
ice+snow. Hence SItflux-TFLUX should match the ice+snow heat budget. |
131 |
|
- allow activation/testing of a fix for suspected missing term in |
132 |
|
ocn-ice heat budget (to be confirmed). To test this, you want to |
133 |
|
undef SEAICE_DISABLE_HEATCONSFIX, and then set the run time param |
134 |
|
SEAICEheatConsFix to .TRUE. that also allows the 'SIaaflux' diagnostic. |
135 |
|
- no change in results, fwd or ad. |
136 |
|
o global_ocean.cs32x15/results: 3 changes following from the pkg/seaice commit below: |
137 |
|
- switch to variable freezing point. |
138 |
|
Results change : cg2d -> 1 digits; ad -> 3-6-6 digits. |
139 |
|
- bug fix : the sublimation term that was missing is now activated. |
140 |
|
Results change : cg2d -> 2 digits; ad -> 8-6-6 digits. |
141 |
|
- bug fix : flooding sign term for SIsal0.NE.0. |
142 |
|
Result change : cg2d -> 8 digits; ad -> 11-12-9 digits. |
143 |
|
o pkg/seaice: |
144 |
|
- unified freezing point treatment : the old SEAICE_VARIABLE_FREEZING_POINT |
145 |
|
is now the default, and the old default constant freezing point is recovered |
146 |
|
with SEAICE_tempFrz0 = -1.96, |
147 |
|
SEAICE_dTempFrz_dS = 0., |
148 |
|
- retire SEAICE_freeze (= the old way of specifycing the constant freezing point) |
149 |
|
- remove ALLOW_SEAICE_FLOODING brackets; run time switch is already there. |
150 |
|
- bug fix (thanks to M. Losch) : the sublimation term that was missing is now |
151 |
|
activated. To reproduce old results with this bug define SEAICE_DISABLE_SUBLIM. |
152 |
|
- bug fix (silly me) : flooding sign term (seaice_growth.F r 1.149line 1211) |
153 |
|
was wrong for SIsal0.NE.0. Changes cs32x15 results (see above item for detail). |
154 |
|
- bug fix (thanks to O. Jahn) : area loss for melting got messed up in |
155 |
|
seaice_growth r149 for legacy branch (no results change). |
156 |
|
- introduce SEAICE_CAP_SUBLIM : caps sublimation heat flux in solve4temp (code |
157 |
|
from I. Fenty). |
158 |
|
- results did not change except for global_ocean.cs32x15, mostly due to the |
159 |
|
switch to variable freezing point (see above item for detail). |
160 |
|
o pkg/thsice: |
161 |
|
- fix and simplify interface to salt_plume pkg ; diagnose directly amount of |
162 |
|
seawater freezing in thsice_calc_thickn (not used). |
163 |
|
o pkg/seaice: turbulent flux term specification via run time params. |
164 |
|
- replace CPP switches with run time switches to facilitate testing |
165 |
|
- retired CPPs : MCPHEE_OCEAN_ICE_HEAT_FLUX, |
166 |
|
GRADIENT_MIXED_LAYER_TURBULENCE_FACTOR |
167 |
|
- added runtime parameter : SEAICEturbFluxFormula |
168 |
|
- move Mcphee constants to SEAICE_PARAMS.h |
169 |
|
- seaice_readparms.F : read turbulent flux term params (SEAICEturbFluxFormula; |
170 |
|
SEAICE_availHeatFrac/Frz, or SEAICE_gamma_t/_frz if apply); |
171 |
|
remove seaice_summary call (moved to seaice_init_fixed) |
172 |
|
- seaice_init_fixed.F : set SEAICE_availHeatFrac/Frz depending on |
173 |
|
SEAICEturbFluxFormula, and seaice_summary call (moved from seaice_readparms) |
174 |
|
- seaice_summary.F : add missing report of read turbulent flux term set up |
175 |
|
and SITRACER. |
176 |
|
- seaice_check.F : check range; inform and stop if retired CPPs are used |
177 |
|
(incl. SEAICE_AGE). |
178 |
|
- seaice_growth.F : unified use of SEAICE_availHeatFrac/Frz, without |
179 |
|
CPP switch, same computation as before for the different options. |
180 |
|
- change results at the truncation level. |
181 |
|
o pkg/seaice: |
182 |
|
- remove un-used parameters LAD & MAX_TICE ; add new run-time parameters: |
183 |
|
useMaykutSatVapPoly (default=F), postSolvTempIter (default=2) and |
184 |
|
SEAICE_wetAlbTemp (default=-1e-3). Remove option SEAICE_SOLVE4TEMP_LEGACY. |
185 |
|
- update verification/*/input*/data.seaice: |
186 |
|
to reproduce previous results with former #defined SEAICE_SOLVE4TEMP_LEGACY |
187 |
|
code, set useMaykutSatVapPoly=T & postSolvTempIter=0 ; |
188 |
|
and to reproduce previous results with former non-SOLVE4TEMP_LEGACY code, |
189 |
|
set SEAICE_wetAlbTemp=0 & SEAICE_snowThick=0. |
190 |
|
o pkg/seaice/seaice_solve4temp.F (SOLVE4TEMP_LEGACY): |
191 |
|
- remove LEGACY code for solving for tsurf (A1,A2,A3) but maintain the same |
192 |
|
algorithm (same choice: useMaykutPolySatVap=T, postSolvTempIter=0); |
193 |
|
difference in results only due to machine truncation. |
194 |
|
- remove MAX_TICE (tsurf is always =< TMELT anyway); keep MIN_TICE if using |
195 |
|
MaykutPolySatVap; keep MIN_LWDOWN. |
196 |
|
- adapt SEAICE_MODIFY_GROWTH_ADJ code (untested) to non-legacy formulation. |
197 |
|
- update output of verification exp. lab_sea (4 fwd: 11 cg2d digits except hb87, |
198 |
|
+ 3 AD: 6 digits except evp) and offline_exf_seaice.seaice (12 digits). |
199 |
|
o pkg/salt_plume: |
200 |
|
- isolate saltPlumeFlux array exch into a specific S/R called from |
201 |
|
do_oceanic_phys.F |
202 |
|
- add interface to pkg/salt_plume (filling of saltPlumeFlux) in pkg/thsice. |
203 |
|
o verification: |
204 |
|
- move untested set-up to MITgcm_contrib/verification_other. |
205 |
|
o pkg/seaice: |
206 |
|
- retire old way of SEAICE_AGE. Now replaced with ALLOW_SITRACER. |
207 |
|
o pkg/seaice: |
208 |
|
- seaice_solve4temp.F (keeping results unchanged): |
209 |
|
* add 2 future run-time params to select which saturation vapor pressure |
210 |
|
formula is used and how post-iteration fluxes are set. |
211 |
|
Temporary set these 2 params according to option SOLVE4TEMP_LEGACY; |
212 |
|
* New piece of code (not used) to update surf. atmos. heat flux F_ia using |
213 |
|
the linearized expression to stay consistent with tsurf finding. |
214 |
|
- seaice_freedrift.F avoid floating exception in sqrt(y) since y=sqrt(x*x)-x |
215 |
|
can be < 0. |
216 |
|
o pkg/seaice/seaice_solve4temp.F (SOLVE4TEMP_LEGACY undef): |
217 |
|
- remove from F_ia (and from it's derivative dFiDTs1) the contribution of |
218 |
|
conductive heat flux F_c , and add it explicitly when updating tsurf as |
219 |
|
solution of: Fc = Fia + d/dT(Fia - Fc) *delta.tsurf |
220 |
|
so that now F_ia has a consistent meaning through the entire routine. |
221 |
|
This causes differences at truncation level: update output of fwd exp. |
222 |
|
global_ocean.cs32x15.seaice. |
223 |
|
o pkg/seaice: |
224 |
|
- lots of editing/cleaning in seaice_solve4temp.F + better documentation |
225 |
|
of arrays, sign/direction of fluxes; no effect on results. |
226 |
|
- replace hard coded 273.16 (=previous value of celsius2K) by celsius2K |
227 |
|
in seaice_budget_ocean.F & seaice_solve4temp.F (SOLVE4TEMP_LEGACY part); |
228 |
|
note: this should have been done before changing celsius2K default. |
229 |
|
- to keep results unchanged, add back old value of celsius2K in verification |
230 |
|
exp. input*/data : lab_sea (AD), offline_exf_seaice (fwd+AD) & seaice_obcs |
231 |
|
- replace hard coded seawater freezing temp in seaice_solve4temp.F (part |
232 |
|
SOLVE4TEMP_LEGACY) of 271.20 (=previous value of celsius2K + default |
233 |
|
value of SEAICE_freeze) by celsius2K+SEAICE_freeze so that seawater |
234 |
|
freezing temp is consistent with value in seaice_growth.F ; this causes |
235 |
|
differences at machine truncation level: update lab_sea AD output (3/4). |
236 |
o pkg/seaice: |
o pkg/seaice: |
237 |
- mask (in exf_init_fixed.F) atemp,aqh,evap,precip,runoff,lwflx,areamask |
- mask (in exf_init_fixed.F) atemp,aqh,evap,precip,runoff,lwflx,areamask |
238 |
and climsst/sss even when using seaice (to prevent calculation that might |
and climsst/sss even when using seaice (to prevent calculation that might |