4 |
Notes on tags used in MITgcmUV |
Notes on tags used in MITgcmUV |
5 |
============================== |
============================== |
6 |
|
|
7 |
|
o pkg/seaice: turbulent flux term specification via run time params. |
8 |
|
- replace CPP switches with run time switches to facilitate testing |
9 |
|
- retired CPPs : MCPHEE_OCEAN_ICE_HEAT_FLUX, GRADIENT_MIXED_LAYER_TURBULENCE_FACTOR |
10 |
|
- added runtime parameter : SEAICEturbFluxFormula |
11 |
|
- move Mcphee constants to SEAICE_PARAMS.h |
12 |
|
- seaice_readparms.F : read turbulent flux term params (SEAICEturbFluxFormula; |
13 |
|
SEAICE_availHeatFrac/Frz, or SEAICE_gamma_t/_frz if apply); remove |
14 |
|
seaice_summary call (moved to seaice_init_fixed) |
15 |
|
- seaice_init_fixed.F : set SEAICE_availHeatFrac/Frz depending on |
16 |
|
SEAICEturbFluxFormula, and seaice_summary call (moved from seaice_readparms) |
17 |
|
- seaice_summary.F : add missing report of read turbulent flux term set up (and SITRACER). |
18 |
|
- seaice_check.F : check range; inform and stop if retired CPPs are used (incl. SEAICE_AGE). |
19 |
|
- seaice_growth.F : unified use of SEAICE_availHeatFrac/Frz, without |
20 |
|
CPP switch, same computation as before for the different options. |
21 |
|
- change results at the truncation level. |
22 |
|
o pkg/seaice: |
23 |
|
- remove un-used parameters LAD & MAX_TICE ; add new run-time parameters: |
24 |
|
useMaykutSatVapPoly (default=F), postSolvTempIter (default=2) and |
25 |
|
SEAICE_wetAlbTemp (default=-1e-3). Remove option SEAICE_SOLVE4TEMP_LEGACY. |
26 |
|
- update verification/*/input*/data.seaice: |
27 |
|
to reproduce previous results with former #defined SEAICE_SOLVE4TEMP_LEGACY |
28 |
|
code, set useMaykutSatVapPoly=T & postSolvTempIter=0 ; |
29 |
|
and to reproduce previous results with former non-SOLVE4TEMP_LEGACY code, |
30 |
|
set SEAICE_wetAlbTemp=0 & SEAICE_snowThick=0. |
31 |
|
o pkg/seaice/seaice_solve4temp.F (SOLVE4TEMP_LEGACY): |
32 |
|
- remove LEGACY code for solving for tsurf (A1,A2,A3) but maintain the same |
33 |
|
algorithm (same choice: useMaykutPolySatVap=T, postSolvTempIter=0); |
34 |
|
difference in results only due to machine truncation. |
35 |
|
- remove MAX_TICE (tsurf is always =< TMELT anyway); keep MIN_TICE if using |
36 |
|
MaykutPolySatVap; keep MIN_LWDOWN. |
37 |
|
- adapt SEAICE_MODIFY_GROWTH_ADJ code (untested) to non-legacy formulation. |
38 |
|
- update output of verification exp. lab_sea (4 fwd: 11 cg2d digits except hb87, |
39 |
|
+ 3 AD: 6 digits except evp) and offline_exf_seaice.seaice (12 digits). |
40 |
|
o pkg/salt_plume: |
41 |
|
- isolate saltPlumeFlux array exch into a specific S/R called from |
42 |
|
do_oceanic_phys.F |
43 |
|
- add interface to pkg/salt_plume (filling of saltPlumeFlux) in pkg/thsice. |
44 |
|
o verification: |
45 |
|
- move untested set-up to MITgcm_contrib/verification_other. |
46 |
|
o pkg/seaice: |
47 |
|
- retire old way of SEAICE_AGE. Now replaced with ALLOW_SITRACER. |
48 |
|
o pkg/seaice: |
49 |
|
- seaice_solve4temp.F (keeping results unchanged): |
50 |
|
* add 2 future run-time params to select which saturation vapor pressure |
51 |
|
formula is used and how post-iteration fluxes are set. |
52 |
|
Temporary set these 2 params according to option SOLVE4TEMP_LEGACY; |
53 |
|
* New piece of code (not used) to update surf. atmos. heat flux F_ia using |
54 |
|
the linearized expression to stay consistent with tsurf finding. |
55 |
|
- seaice_freedrift.F avoid floating exception in sqrt(y) since y=sqrt(x*x)-x |
56 |
|
can be < 0. |
57 |
|
o pkg/seaice/seaice_solve4temp.F (SOLVE4TEMP_LEGACY undef): |
58 |
|
- remove from F_ia (and from it's derivative dFiDTs1) the contribution of |
59 |
|
conductive heat flux F_c , and add it explicitly when updating tsurf as |
60 |
|
solution of: Fc = Fia + d/dT(Fia - Fc) *delta.tsurf |
61 |
|
so that now F_ia has a consistent meaning through the entire routine. |
62 |
|
This causes differences at truncation level: update output of fwd exp. |
63 |
|
global_ocean.cs32x15.seaice. |
64 |
|
o pkg/seaice: |
65 |
|
- lots of editing/cleaning in seaice_solve4temp.F + better documentation |
66 |
|
of arrays, sign/direction of fluxes; no effect on results. |
67 |
|
- replace hard coded 273.16 (=previous value of celsius2K) by celsius2K |
68 |
|
in seaice_budget_ocean.F & seaice_solve4temp.F (SOLVE4TEMP_LEGACY part); |
69 |
|
note: this should have been done before changing celsius2K default. |
70 |
|
- to keep results unchanged, add back old value of celsius2K in verification |
71 |
|
exp. input*/data : lab_sea (AD), offline_exf_seaice (fwd+AD) & seaice_obcs |
72 |
|
- replace hard coded seawater freezing temp in seaice_solve4temp.F (part |
73 |
|
SOLVE4TEMP_LEGACY) of 271.20 (=previous value of celsius2K + default |
74 |
|
value of SEAICE_freeze) by celsius2K+SEAICE_freeze so that seawater |
75 |
|
freezing temp is consistent with value in seaice_growth.F ; this causes |
76 |
|
differences at machine truncation level: update lab_sea AD output (3/4). |
77 |
|
o pkg/seaice: |
78 |
|
- mask (in exf_init_fixed.F) atemp,aqh,evap,precip,runoff,lwflx,areamask |
79 |
|
and climsst/sss even when using seaice (to prevent calculation that might |
80 |
|
use SST on land); does not affect any verification exp. |
81 |
|
- apply mask to taux,tauy (in seaice_get_dynforcing.F); update output |
82 |
|
of lab_sea.fd & lab_sea.hb87 and global_ocean.cs32x15.seaice_dynmix. |
83 |
|
o pkg/seaice/seaice_growth.F: add mask to avoid non-zero ice thickness |
84 |
|
over land (non-legacy code) |
85 |
|
o vectorize salt_plume package: |
86 |
|
- add extra code to salt_plume_frac and salt_plume_tendency_apply_s |
87 |
|
- this code computes plumebk everywhere (also over land), thus requires |
88 |
|
code to avoid divisions by zero and catch the case of kLev=Nr. |
89 |
|
- efficiency of salt_plume_frac is still sub-optimal |
90 |
|
o tools (genmake2): |
91 |
|
- fix makefile NAME specification (option: -makefile NAME) by adding |
92 |
|
"-f $MAKEFILE" in few places where it was missing including makedepend |
93 |
|
command (contribution from Paul). |
94 |
|
|
95 |
|
checkpoint63i (2012/01/24) |
96 |
|
o model/src: |
97 |
|
- add factorized versions of some EOS code to find_rho.F, |
98 |
|
define USE_FACTORIZED_EOS to turn it on (default for TARGET_NEC_SX) |
99 |
|
o model/src: |
100 |
|
- add celsius2K to namelist PARM01; remove unused recip_rhoNil from PARAMS.h; |
101 |
|
- change default celsius2K from 273.16 to 273.15 |
102 |
|
- to keep results unchanged, add back old value of celsius2K in verification |
103 |
|
exp. input*/data : aim.5l_cs, 1D_ocean_ice_column, lab_sea (fwd), |
104 |
|
global_ocean.cs32x15(seaice) & cpl_aim+ocn(input_atm). |
105 |
|
o model/src: add a little initialisation trick to find_rho.F and find_alpha.F |
106 |
|
to make TAF generate vectorizable code |
107 |
|
o pkg/seaice/seaice_evp.F: add code (copied from CICE) that avoids underflows. |
108 |
|
Turn on by defining SEAICE_EVP_ELIMINATE_UNDERFLOWS. Most compilers |
109 |
|
have flags that do this more efficiently. |
110 |
|
o pkg/diagnostics/diagstats_calc.F |
111 |
|
- for TARGET_NEC_SX fix the treatment of the scaling factor tmpFac=scaleFact |
112 |
|
o pkg/obcs (with exch2): |
113 |
|
- derive OB indices in overlap region from OB-InsideMask (in obcs_init_fixed.F) |
114 |
|
and remove code (in obcs_readparms.F) which was based on EXCH of indices |
115 |
|
(through buffer) and did not account for exch2 (e.g., CS-grid) topology. |
116 |
|
o pkg/exf and seaice exp: |
117 |
|
- change offline_exf_seaice.seaicetd test exp. to use default DIFF1 value (=0) |
118 |
|
so that switching off area & heff advection flags does not affect results. |
119 |
|
- change default EXF_LWDOWN_WITH_EMISSIVITY to #define in EXF_OPTIONS.h |
120 |
|
- keep exp. seaice_obcs & 1D_ocean_ice_column(ad) unchanged (using #undef |
121 |
|
EXF_LWDOWN_WITH_EMISSIVITY) and, using pkg/exf default emissivities, update |
122 |
|
results of verification experiments: 1D_ocean_ice_column(fwd), |
123 |
|
global_ocean.cs32x15.seaice(fwd+ad) & seaice_dynmix(ad), lab_sea (all 8) |
124 |
|
and offline_exf_seaice (all 4). |
125 |
|
o pkg/seaice: |
126 |
|
- remove array YNEG, RIVER, TMIX (replaced by local var) from common block; |
127 |
|
remove also areaNm1 & hEffNm1 when SEAICE_GROWTH_LEGACY is undef. |
128 |
|
- fix bug: areaNm1 & hEffNm1 are needed in seaice_growth (SEAICE_GROWTH_LEGACY) |
129 |
|
but were not filled when resp. SEAICEadvArea=F & SEAICEadvHeff=F and |
130 |
|
not multi-dim advection; |
131 |
|
- fix seaice_growth.F to compile with both SEAICE_GROWTH_LEGACY and |
132 |
|
SHORTWAVE_HEATING #undef. |
133 |
|
o optim: make Makefile more robust (?) |
134 |
|
o pkg/obcs: |
135 |
|
* fix treatment of obcs_read_pickup for TAF |
136 |
|
o pkg/shelfice: |
137 |
|
* add missing initialisation of num_shifwflx |
138 |
|
* new adjoint verification exp. for isomip |
139 |
|
* change Prandtl and Schmidt numbers from generic formulations |
140 |
|
(in terms of model diffus. and visc.) to separate runtime |
141 |
|
parameters, with Holland and Jenkins (1999) default values. |
142 |
|
o pkg/exf (interpolation): |
143 |
|
- extended input field (2 rows) near the N & S poles: |
144 |
|
* fill in with the symetric value (when even Nb of data in longitude) |
145 |
|
* add average value at the poles only for scalar quantities ; for vector |
146 |
|
component interpolation, skip the averaging and keep duplicated values, |
147 |
|
unless the 2 components have same location (uvInterp=T) in which case |
148 |
|
interpolate the 2 components together using S/R EXF_INTERP_UV. |
149 |
|
- new S/R EXF_INTERP_UV to interpolate the 2 components of a vector field |
150 |
|
together: this allows to account properly for local orientation when |
151 |
|
averaging at N & S pole. |
152 |
|
- add CPP option EXF_USE_OLD_INTERP_POLE to recover old results regarding |
153 |
|
exf-interpolation near N & S poles. Undef by default. |
154 |
|
- add debug check/print on 1rst iter if debugLevel >=2. |
155 |
|
o pkg/exf: |
156 |
|
- change masking flags definition (no longer "parameter"), put them in |
157 |
|
common block and set them in S/R EXF_INIT_FIXED. |
158 |
|
- change recognized masking flag from s,u,v to c,w,s since the mask |
159 |
|
to use (maskC,W,S) depends on position on model grid and has little to |
160 |
|
do with scalar/vector difference; fix masking if using P-coordinates. |
161 |
|
- fix masking of wind-stress (was wrong if interpolated or read on A-grid) |
162 |
|
and update results of exp. global_with_exf (x2). |
163 |
|
- fix setting of zenith-angle table when SHORTWAVE_HEATING is undef. |
164 |
|
o pkg/obcs |
165 |
|
- S/R obcs_calc_stevens: fix a small bug (gammat -> gammas where appropriate) |
166 |
|
o pkg/exf (interpolation): |
167 |
|
- assume periodicity in X only if input field cover full longitude range. |
168 |
|
- improve search for lat. index (supposed to be faster, in ~log2(ny) steps, |
169 |
|
and should vectorise). |
170 |
|
- fix input lat of the 2 added row (in case we provide N.pole data). |
171 |
|
|
172 |
|
checkpoint63h (2011/12/30) |
173 |
|
o pkg/seaice: |
174 |
|
- change declaration of UVM from _RL to _RS in order to get B-grid |
175 |
|
uIce,vIce monitor when _RS = real*4 |
176 |
|
o pkg/offline: |
177 |
|
- new S/R OFFLINE_RESET_PARMS for resetting main-model params (switch off flags); |
178 |
|
- compute vertical velocity if not read from file (switch on exactConserv |
179 |
|
& staggerTimeStep); |
180 |
|
- fix output of ptracer monitor iter & time for default PTRACERS_monitorFreq. |
181 |
|
o verification: |
182 |
|
- update grid-files (in tutorial_held_suarez_cs/input and fizhi-cs-32x32x40/input) |
183 |
|
with grid-angle generated using "utils/matlab/cs_grid/cubeCalcAngle.m": |
184 |
|
fix Pb in yG definition @ 2 missing corners (previously yG was averaged); |
185 |
|
- update output of exp. global_ocean.cs32x15.viscA4 after changing |
186 |
|
grid-file angles (used here for coriolis-3d); |
187 |
|
- remove (or gzip) few files not needed to run fizhi-cs experiments. |
188 |
|
o pkg/exf (vector interpolation): |
189 |
|
- rotate vector component toward local grid-axis orientation using grid-angles |
190 |
|
(stored in GRID.h) instead of locally computed rotation angle; keep old code |
191 |
|
available with exf option EXF_USE_OLD_VEC_ROTATION (undef by default). |
192 |
|
o pkg/seaice: |
193 |
|
- allow to compile with exf options ALLOW_ATM_TEMP or ALLOW_DOWNWARD_RADIATION |
194 |
|
undefined. Fix and remove the stop when ALLOW_RUNOFF is undefined. |
195 |
|
o pkg/PKG_OPTIONS.h files: |
196 |
|
- move #include "CPP_OPTIONS.h" just after #include "PACKAGES_CONFIG.h", |
197 |
|
outside of the #ifdef ALLOW_THISPKG / #endif block. |
198 |
|
- update verification/*/code/PKG_OPTIONS.h files. |
199 |
|
o add a verification experiment (offline_exf_seaice/input.seaice) that test |
200 |
|
the B-grid LSOR solver |
201 |
|
o pkg/seaice: sort out emissivity and long wave radiation step 2: |
202 |
|
- add emissivity for snow and ice as new run-time parameters |
203 |
|
(unfortunately) that default to the corresponding exf values; this |
204 |
|
changes results in most verification experiments so that for backward |
205 |
|
compatibility these parameter have to be set explicitly to inconsistent |
206 |
|
values (ugly); |
207 |
|
- the exf-flag EXF_LWDOWN_WITH_EMISSIVITY then gets rid off the hard-wired |
208 |
|
emissivities of 0.97 associated with lwdownloc in S/R seaice_solve4temp |
209 |
|
until we agree how to handle this bug properly |
210 |
|
o pkg/exf (interpolation): |
211 |
|
- add a set of run-time param ({inputfield}_interpMethod), one for |
212 |
|
each interpolated input field, to select the interpolation method |
213 |
|
with a value of zero switching off the interpolation; |
214 |
|
- print interpolation parameters to standard output; |
215 |
|
- refine exf_check.F accordingly ; stop if USE_NO_INTERP_RUNOFF is defined |
216 |
|
(to use instead runoff_interpMethod=0 in data.exf). |
217 |
|
- simplify default setting of interpolation parameters (for all fields, |
218 |
|
set position to match model grid cell-center position, leading to trivial |
219 |
|
interpolation in case of regular Lat-Lon grid) and fix for the case of |
220 |
|
non-uniform delY. |
221 |
|
o pkg/exf/exf_radiation.F: add the factor ocean_emissivity to lwdown, for |
222 |
|
within #ifdef EXF_LWDOWN_WITH_EMISSIVITY/#endif. Unless ocean_emissivity=1. |
223 |
|
this factor is absolutely required, because the lw exitance (= out-going |
224 |
|
long wave radiation) is emissivity*stefanBoltzmann*T^4 + rho*lwdown, |
225 |
|
where the reflectivity rho = 1-emissivity for conservation reasons. Once |
226 |
|
this is established, we can remove the CPP-Flag (if we want to). |
227 |
|
o pkg/seaice: |
228 |
|
- qualify a stop statement in S/R seaice_check: EXF_READ_EVAP and |
229 |
|
ALLOW_BULKFORMULAE are only required if SEAICE_EXTERNAL_FLUXES is defined |
230 |
|
- sort out emissivity and long wave radiation, step 1: make SEAICE_emissivity |
231 |
|
what the name implies (and not emissivity*BoltzmannConstant), this means |
232 |
|
the old default value of 5.5e-8 now means |
233 |
|
5.5e-8/5.670e-8 = 0.97001763668430343479 as ocean_emissivity in |
234 |
|
S/R exf_readparms |
235 |
|
- FV-discretization of the B-grid LSOR solver, turn on with |
236 |
|
SEAICE_LSRBNEW. This new solver also involves a slight re-organization |
237 |
|
of the calling routine dynsolver, so that B and C-grid code look a |
238 |
|
little more alike. |
239 |
|
- fix index bugs in ostres.F (B-grid code) |
240 |
o pkg/seaice/seaice_ocean_budget.F: change (unused) code to make it look better |
o pkg/seaice/seaice_ocean_budget.F: change (unused) code to make it look better |
241 |
o pkg/seaice/seaice_readparms.F: make ocean_emissivity*stefanBoltzmann the |
o pkg/seaice/seaice_readparms.F: make ocean_emissivity*stefanBoltzmann the |
242 |
default for SEAICE_emissivity, if useEXF; requires setting a wrong |
default for SEAICE_emissivity, if useEXF; requires setting a wrong |
254 |
o pkg/seaice/seaice_model.F: |
o pkg/seaice/seaice_model.F: |
255 |
Remove this patholigical case treatment in evolution branch, |
Remove this patholigical case treatment in evolution branch, |
256 |
where it is un-necessary and breaks conservation. |
where it is un-necessary and breaks conservation. |
257 |
Update global_ocean.cs32x15/results accordingly for |
Update global_ocean.cs32x15/results accordingly for |
258 |
output.seaice.txt output_adm.seaice.txt and output_adm.seaice_dynmix.txt |
output.seaice.txt output_adm.seaice.txt and output_adm.seaice_dynmix.txt |
259 |
o model/src: |
o model/src: |
260 |
useRealFreshWaterFlux: remove masking of EmPmP (using maskInC) in |
useRealFreshWaterFlux: remove masking of EmPmP (using maskInC) in |
261 |
external_forcing_surf.F and apply mask directly in S/R SOLVE_FOR_PRESSURE. |
external_forcing_surf.F and apply mask directly in S/R SOLVE_FOR_PRESSURE. |