4 |
Notes on tags used in MITgcmUV |
Notes on tags used in MITgcmUV |
5 |
============================== |
============================== |
6 |
|
|
7 |
|
o pkg/seaice: add a line search option to the JFNK solver |
8 |
|
o pkg/mdsio: |
9 |
|
- write missing value (corresponding to undefined array value) to meta files; |
10 |
|
skip this if missing value is one (UNSET_RL would be a better value for the |
11 |
|
case of undefined missing value but it's current the default missing-value); |
12 |
|
Also update mdsio_read_meta.F (reading timeInterval & missing-value). |
13 |
|
o pkg/exf & thsice: |
14 |
|
- for diagnostics purpose, fill-up and update Qsw array (+ fill the diagnostics) |
15 |
|
even when SHORTWAVE_HEATING is #undef; |
16 |
|
o verification/cfc_example: |
17 |
|
- turn on pkg/layers with pkg/diagnostics (to test pkg/layers and to illustrate |
18 |
|
how to use it). |
19 |
|
o verification/offline_exf_seaice: |
20 |
|
in input: add SEAICErestoreUnderIce=.TRUE., and reduce size of forcing |
21 |
|
files to only one time-record. |
22 |
|
in input.thermo: narrow the 2 bands of low initial ice-concentration near |
23 |
|
N & S edges; switch on SEAICErestoreUnderIce=T; use pkg/diagnostics for |
24 |
|
snapshot output; same mcPheePiston value as in thsice with surf-current=0.2m/s. |
25 |
|
in input.thsice: similar set-up as in input.thermo (channel with same seaice |
26 |
|
initial conditions). |
27 |
|
o verification/cfc_example: |
28 |
|
- update file "data" with more standard choice (default rotationPeriod, |
29 |
|
exactConserv=T, reduce ivdc_kappa to 10, remove multiDimAdvection=F, |
30 |
|
set deltaTFreeSurf to deltaTtracer) and update the output. |
31 |
|
o pkg/layers: |
32 |
|
- fix bolus part so that it compiles with #undef GM_BOLUS_ADVEC; |
33 |
|
- ensure that "layers_bolus" is switched to False when useGMRedi=False. |
34 |
|
o verification/offline_exf_seaice: |
35 |
|
- set all {field}period to zero for constant-in-time forcing (not tested |
36 |
|
anywhere else). |
37 |
|
o verification/offline_exf_seaice: |
38 |
|
- dyn_lsr : use pkg/seaice S/R (instead of pkg/thsice) to advect sea-ice; |
39 |
|
- dyn_jfnk : use pkg/thsice S/R (instead of pkg/seaice) to advect sea-ice. |
40 |
|
o model/src: |
41 |
|
- implement Finite-Volume method for (hydrostatic) presure gradient |
42 |
|
from S.-J. Lin (QJRMS 1997), for atmosphere using sigma-coordinate. |
43 |
|
o pkg/seaice: implement EVP* by Lemieux et al. (2012). |
44 |
|
- In order to be compatible with the default EVP code, this requires changing |
45 |
|
the EVP code around a little; and because any small change immediately |
46 |
|
breaks the lab_sea.hb87 verification experiment, the reference output is |
47 |
|
updated two times (each time the remaining aggrement was only 2 digits): |
48 |
|
- after replacing 1/dt by 1*recip_dt with a precomputed recip_dt |
49 |
|
- after replacing 1/(1+0.5*dt/tau) by a/(a+1), with a=2*tau/dt |
50 |
|
The adjoint test lab_sea.evp also needed to be updated. |
51 |
|
- Turn on EVP* by setting SEAICE_deltaTevp as before, and setting |
52 |
|
SEAICEuseEVPstar=.true.; for EVP* SEAICE_deltaTevp does not need to be |
53 |
|
a factor of SEAICE_deltaTdyn, and you can set the number of EVP steps |
54 |
|
explicitly with SEAICEnEVPstarSteps (thereby overriding the default of |
55 |
|
INT(SEAICE_deltaTdyn/SEAICE_deltaTevp)). Controlling EVP* is deliberately |
56 |
|
kept obscure, because I need to test it a little more. |
57 |
|
o pkg/cheapaml: |
58 |
|
- fix few incorrect type (_RL/_RS) in subroutine calls. |
59 |
o pkg/seaice: |
o pkg/seaice: |
60 |
|
- new S/R SEAICE_MAP_RS2VEC (similar to SEAICE_MAP2VEC) to map _RS arrays |
61 |
|
to _RL vector; this fixes JFNK code when compiling with "-use_r4" option. |
62 |
|
o model/src: |
63 |
|
- add a warning if using select_rStar=2 with nonlinFreeSurf <> 4; |
64 |
|
change (in input_ad*/data) select_rStar from 2 to 1 for AD verification |
65 |
|
experiments global_ocean.cs32x15 & tutorial_tracer_adjsens (+ update output) |
66 |
|
o pkg/cheapaml: |
67 |
|
- replace "273.1 _d 0" by celsius2K in pkg/cheapaml/cheapaml.F and |
68 |
|
update output of experiment cheapAML_box. |
69 |
|
- store in CHEAPAML.h coeffs ssq[0:2] for saturation specific humidity, |
70 |
|
and set them only in one place (cheapaml_readparms.F). |
71 |
|
- replace "273.16 _d 0" by celsius2K & replace "3.14159 _d 0" by constant "PI" |
72 |
|
- remove re-setting of main-model parameter "celsius2K" (in cheapaml_readparms) |
73 |
|
and re-setting of cheapAML params "lath" & "p0" (in cheapaml_init_varia). |
74 |
|
o model/src/the_main_loop.F: |
75 |
|
- fix revision 129 : need both ALLOW_ECCO and ALLOW_ECCO_EVOLUTION. |
76 |
|
o pkg/seaice: |
77 |
|
- remove legacy branch code. |
78 |
|
- retire SEAICE_GROWTH_LEGACY and SEAICE_CAP_HEFF accordingly. |
79 |
|
o verification/*/code*/SEAICE_OPTIONS.h: |
80 |
|
- remove documentation for retired CPP flags (SEAICE_GROWTH_LEGACY, |
81 |
|
SEAICE_CAP_HEFF). |
82 |
|
o pkg/cheapaml: |
83 |
|
- use standard routine (S/R GET_PERIODIC_INTERVAL) to decide when it is time |
84 |
|
to load new forcing fields. |
85 |
|
- add missing "_d 0" where it's needed; + some editing (improve indentation). |
86 |
|
- remove switch to "-r8" compiler option (no longer needed) in verification |
87 |
|
cheapAML_box, keep same output (small trucation error differences). |
88 |
|
o verification/offline_exf_seaice: |
89 |
|
- add thermodynamics only test. |
90 |
|
o verification/cheapAML_box: |
91 |
|
- split the domain in 8 (2x4) tiles; add MPI and multi-threaded test; |
92 |
|
keep same output (same 14 digits for cg2d). |
93 |
|
- switch on "-r8" compiler option (some numerical values are missing |
94 |
|
the "_d 0") and update output (only 6 digits for cg2d were preserved). |
95 |
|
|
96 |
|
checkpoint64b (2012/12/24) |
97 |
|
o pkg/cheapaml: |
98 |
|
- remove un-used variables (Qnet,EmPmR) from pickup files. |
99 |
|
- store tendency of advected variables into cheapaml pickup file |
100 |
|
and fix the AB-2 restart. |
101 |
|
o verification/offline_exf_seaice and lab_sea adjoint: |
102 |
|
- switch to new code (#undef SEAICE_GROWTH_LEGACY). |
103 |
|
- switch to 4 time steps in offline, consistent with lab_sea. |
104 |
|
- match parameters from SEAICE_GROWTH_LEGACY branch in data.seaice. |
105 |
|
- update results after change of experiment seaice. |
106 |
|
o pkg/seaice: |
107 |
|
- remove option SEAICE_MULTICATEGORY; has been replaced with run-time |
108 |
|
parameter SEAICE_multDim. Issue a warning if SEAICE_MULTICATEGORY is |
109 |
|
still defined since SEAICE_multDim needs to be set to MULTDIM value (from |
110 |
|
SEAICE_SIZE.h) to recover previous #define SEAICE_MULTICATEGORY default. |
111 |
|
o model/src: |
112 |
|
- add run-time parameter to select CG2D solver minimum-residual solution |
113 |
|
(in case of a poor convergence). |
114 |
|
o pkg/seaice/seaice_lsr.F |
115 |
|
- move calculation of matrix coefficients into new |
116 |
|
S/R SEAICE_CALC_LSR_COEFFS; for now this routine remains in the same |
117 |
|
file; the main purpose of this change is to be able to reuse the code |
118 |
|
in S/R SEAICE_PRECONDITIONER |
119 |
|
- modify the computation of the residual so that the mass of sea-ice |
120 |
|
is not used twice; this simplifies the calculations, but since |
121 |
|
the residual is never used except when LSR_mixIniGuess.ge.4---and this is |
122 |
|
not tested in testreport---this does not affect the testreport results. |
123 |
|
o verification/seaice_obcs: |
124 |
|
- disable SEAICE_GROWTH_LEGACY; reset input files to match those of |
125 |
|
verification/lab_sea/input.salt_plume; changes results/output.txt* |
126 |
|
o model/src: |
127 |
|
- adapt quasi-hydrostatic formulation to work with p or p* coordinate. |
128 |
|
o pkg/seaice: |
129 |
|
- improve description of parameters in seaice_fgmres.F and start |
130 |
|
cleaning up the code |
131 |
|
- change name of SCALPROD to SEAICE_SCALPROD and modify meaning of |
132 |
|
second argument |
133 |
|
- add a metric based on grid cell area to SEAICE_SCALPROD; update |
134 |
|
results of offline_exf_seaice.dyn_jfnk |
135 |
|
- compute initial residual norm in seaice_jfnk based on SEAICE_SCALPROD |
136 |
|
o pkg/aim_v23: |
137 |
|
- fix an other bug in dissipation heating (grid-cell area was missing). |
138 |
|
o model/src + pkg/seaice: |
139 |
|
- add global (multi-tile) linear solver for pair of tri-diagonal system |
140 |
|
along X and Y lines, respectively for U and V component. |
141 |
|
Note: 1) MPI and cube-exchange not yet coded. |
142 |
|
2) probably not accurate for poorly conditioned / large size problem. |
143 |
|
- add option for SEAICE_LSR to use global (multi-tile) tri-diagonal solver; |
144 |
|
default: not compiled and not used. |
145 |
|
o pkg/seaice: |
146 |
|
- first attempt at a multi-threaded fgmres solver for the JFNK solver: |
147 |
|
introduce bi/bj loops and use global_sum_tile_rl instead of |
148 |
|
mpi_allreduce in seaice_fgmres.F |
149 |
|
- improve diagnostics output for fgmres solver (seaice_fgmres.F) |
150 |
|
- replace a few unnecessary goto statements by if-blocks (seaice_fgmres.F) |
151 |
|
- add a verification experiment for JFNK in offline_exf_seaice |
152 |
|
o verification: |
153 |
|
- change (for now, only fwd test) offline_exf_seaice experiment: |
154 |
|
use a re-entrant channel with idealized coastline (trapezoidal shape) |
155 |
|
at southern boundary to explore seaice dynamics and thermodynamics |
156 |
|
with simple forcing. Main set-up has dynamics+thermo and SST relaxation; |
157 |
|
secondary test (input.thsice) use thermodynamics only with SST relaxation. |
158 |
|
- add seaice-dynamics only secondary test using LSR and pkg/thsice advection. |
159 |
|
o pkg/exf: |
160 |
|
- disable "sstExtrapol" when Nr=1 |
161 |
|
o verification: |
162 |
|
- add new experiment "cheapAML_box" (simple 1 layer set-up from Bruno Deremble) |
163 |
|
to test pkg/cheapaml. |
164 |
|
o pkg/aim_v23 & pkg/shap_filt: |
165 |
|
- fix dissipation heating (erroneous gravity multiplication factor). |
166 |
|
o pkg/seaice: |
167 |
|
- remove unused field pressPre from jfnk solver |
168 |
|
- rename two subroutines in seaice_preconditioner.F |
169 |
|
o eesupp/src: |
170 |
|
- S/R MDSFINDUNIT avoids reserved unit numbers (scrUnit1, eeDataUnit ...) |
171 |
|
o pkg/seaice/seaice_preconditioner.F: fix preconditioner once again |
172 |
|
- remove wrong parts of the rhs and the lhs (were in there |
173 |
|
because I did not understand the concept of this preconditioner) |
174 |
|
- add an exchange between u- and v-sweep. This increases communication |
175 |
|
by a factor of two but improves the convergence of jfnk. Ideally, |
176 |
|
one would like the u- and v-sweep to be independent. So far within |
177 |
|
undocumented ifdefs |
178 |
|
- reorganize the extra computations for printing the residuals |
179 |
|
o tools/genmake2: |
180 |
|
- comment out the "mpif.h" include in NetCDF test programm (for MPI built) |
181 |
|
since it's not necessary (and was preventing to use MNC in some cases). |
182 |
|
|
183 |
|
checkpoint64a (2012/11/16) |
184 |
|
o pkg/autodiff: |
185 |
|
- improve pkg-internal logical parameter switch (inAd/inFwd mode) so that |
186 |
|
autodiff_readparms.F no longer depends on calling order (within |
187 |
|
packages_readparms.F) and no longer requires to include ${PKG}_PARMS.h): |
188 |
|
rename param turnFreeDriftInAdMode to SEAICEuseFREEDRIFTswitchInAd |
189 |
|
and change param SEAICEuseDYNAMICSinAdMode to SEAICEuseDYNAMICSswitchInAd. |
190 |
|
o pkg/obcs: |
191 |
|
- adding tidal velocity forcing capability to obcs |
192 |
|
for usage example, see verification/seaice_obcs/input.tides |
193 |
|
o pkg/seaice: |
194 |
|
- turn the LSR-relaxation parameters WFAU/V into runtime parameters |
195 |
|
SEAICE_LSRrelaxU/V |
196 |
|
- introduce runtime parameter SEAICEetaZmethod (=0 by default) |
197 |
|
o pkg/aim_v23: |
198 |
|
- implement heating from friction (bottom friction and stratospheric drag). |
199 |
|
o pkg/shap_filt: |
200 |
|
- fix diagnostic "SHAP_dKE" (was 2 time smaller); implement heating from |
201 |
|
dissipation but only for Shap_funct=2, active when addFrictionHeating=T. |
202 |
|
o model/src: |
203 |
|
- move AddMass common block from DYNVARS.h to FFIELDS.h; allow to read-in |
204 |
|
time-constant addMass field from file (addMassFile); |
205 |
|
- support for heating due to friction (and Kinetic Energy dissipation): |
206 |
|
add option, run-time switch and 3-D field array + support code ; each pkg |
207 |
|
or S/R can add heating contribution (if there is a sink of KE); the sum is |
208 |
|
accounted for as a Temperature tendency term (EXTERNAL_FORCING_T). |
209 |
|
o pkg/seaice: |
210 |
|
- complete merge of ITD code into seaice_growth.F |
211 |
|
from MITgcm_contrib/torge/itd/code/ |
212 |
|
no verification so far, but Torge Martin tested |
213 |
|
"1-D test case and Beaufort set up; |
214 |
|
deliver okay results after 1 model year." |
215 |
|
- complete merge of SEAICE_SIZE.h into all relevant routines |
216 |
|
- move computation of eta at Z-points into calc_viscosities |
217 |
|
+ introduce global field etaZ |
218 |
|
+ add different methods for computing etaZ, for now the old |
219 |
|
method (simple averages of eta to Z-points) is hardwired |
220 |
|
+ replace etaMeanZ by etaZ in seaice_lsr, seaice_calc_residual, |
221 |
|
seaice_preconditioner |
222 |
|
- simplify computations for SEAICE_ZETA_SMOOTHREG |
223 |
|
- seaice_preconditioner: |
224 |
|
+ replace one remaining press by pressLoc (mistake) |
225 |
|
+ adjust printing of residuals |
226 |
- improve I/O of diagnostics of JFNK in seaice_jfnk.F: |
- improve I/O of diagnostics of JFNK in seaice_jfnk.F: |
227 |
+ add (SEAICE.h) and rename some counters (initiliased in |
+ add (SEAICE.h) and rename some counters (initiliased in |
228 |
seaice_init_fixed.F) |
seaice_init_fixed.F) |
229 |
+ add _BEGIN/END_MASTER (myThid) around print statements |
+ add _BEGIN/END_MASTER (myThid) around print statements |
230 |
+ print total number of iterations and failures over SEAICE_monFreq |
+ print total number of iterations and failures over SEAICE_monFreq |
236 |
(seaice_jfnk.F, seaice_fgmres.F) |
(seaice_jfnk.F, seaice_fgmres.F) |
237 |
- seaice_calc_l/rhs.F: replace maskW/S by maskInW/S; this fixes |
- seaice_calc_l/rhs.F: replace maskW/S by maskInW/S; this fixes |
238 |
a serious convergence problem when open boundaries are involved |
a serious convergence problem when open boundaries are involved |
239 |
o pkg/ggl90: fix computation of control volumes for the case of |
o pkg/ggl90: fix computation of control volumes for the case of |
240 |
ALLOW_GGL90_HORIZDIFF (probably not used very often): move control volumes |
ALLOW_GGL90_HORIZDIFF (probably not used very often): move control volumes |
241 |
up half a grid cell from C-centered to W-centered (pointed out by C. Eden) |
up half a grid cell from C-centered to W-centered (pointed out by C. Eden) |
242 |
o pkg/seaice: simplify seaice_evp by avoiding use of extra fields u/vIceC |
o pkg/seaice: simplify seaice_evp by avoiding use of extra fields u/vIceC |
243 |
o pkg/autodiff |
o pkg/autodiff |
244 |
- Add inAdMode switch for SEAICEuseDYNAMICS: |
- Add inAdMode switch for SEAICEuseDYNAMICS: |
245 |
SEAICEuseDYNAMICSinAdMode |
SEAICEuseDYNAMICSinAdMode |
246 |
(extend logic in ADAUTODIFF_INADMODE_SET) |
(extend logic in ADAUTODIFF_INADMODE_SET) |
247 |
o pkg/seaice |
o pkg/seaice |
248 |
- Step 1 of merging ice-thickness distribution (ITD) code from |
- Step 1 of merging ice-thickness distribution (ITD) code from |