4 |
Notes on tags used in MITgcmUV |
Notes on tags used in MITgcmUV |
5 |
============================== |
============================== |
6 |
|
|
7 |
|
o eesupp/inc: |
8 |
|
- in EEPARAMS.h, add real-type constant for some frequently used simple number |
9 |
|
(0,1,2,1/2), with name explicitly referring to RS/RL type. |
10 |
|
o model/src: |
11 |
|
- move balancing of relaxation terms to new S/R balance_relax.F. |
12 |
|
o pkg/autodiff: |
13 |
|
re-write active I/O high-level (control) S/R: |
14 |
|
- rename S/R ACTIVE_READ/WRITE_RL to ACTIVE_READ/WRITE_3D_RL |
15 |
|
- add 1 more argument (useCurrentDir) to replace the "_LOC" 2nd set of S/R. |
16 |
|
- use standard pkg/mdsio I/O routines (MDS_READ/WRITE_SEC_XZ/YZ and |
17 |
|
MDS_READ/WRITE_FIELD); change loops to multi-threads. |
18 |
|
- update and merge active_file_control_slice.flow into active_file_control.flow |
19 |
|
- update the calls in lower level S/R (active_file.F, active_file_g.F and |
20 |
|
active_file_ad.F) keeping the argument list and function unchanged. |
21 |
|
- also update lower-level "_LOC" version (call same S/R with "useCurrentDir |
22 |
|
=.TRUE.") and remove high-level (control) _loc version (not called anymore). |
23 |
|
- new low-level active I/O routines, one for each type (RL/RS), for active var |
24 |
|
of various (XY,XZ,YZ) shape and level number (arguments: arrShape, myNr); |
25 |
|
fix ctrl_init_wet.F & ecco_cost_weights.F by calling the new S/R with the |
26 |
|
right type. |
27 |
|
o autodiff and RS=real*4: |
28 |
|
- call the right type (_RS instead of _RL) of S/R in few output S/R (pkg/exf |
29 |
|
ad-monitor and snapshots); disable arrType='RS' in mdsio_gl*.F ; |
30 |
|
- change argument type of 3-D mask argument to _RS to match type in the call |
31 |
|
(in seaice_cost*.F, ctrl_*_gen.F and *ctrl_bound.F); to be continued. |
32 |
|
o pkg/thsice: |
33 |
|
- re-anable balanceEmPmR when useSEAICE=T with useThSIce=T. |
34 |
|
- option to correct ocean fresh-water flux for imbalance of Atmos+Land |
35 |
|
fresh-water flux: uniform correction or proportional to local precip. |
36 |
|
o pkg/ctrl: |
37 |
|
- new header file CTRL_SIZE.h for parameters maxCtrlArr2D, maxCtrlArr3D |
38 |
|
- redefine CPP option ALLOW_BOTTOMDRAG_CONTROL to |
39 |
|
ALLOW_BOTTOMDRAG_CONTROL_NONGENERIC |
40 |
|
- verification/hs94.1x64x5/ tests ALLOW_GENARR{2D,3D}_CONTROL |
41 |
|
|
42 |
|
checkpoint63q (2012/07/30) |
43 |
|
o pkg/autodiff: |
44 |
|
note about monitor and snap-shot of ad-variables: |
45 |
|
a) need to apply ADEXCH before monitor or output of ad-vars to include |
46 |
|
overlap contributions (was done for adjDump but missing for monitor). |
47 |
|
b) since ADEXCH implies adding overlap values to interior array, machine |
48 |
|
truncation error is expected when adding an ADEXCH call in the middle of |
49 |
|
the time-stepping (although mathematically identical). |
50 |
|
modifs: |
51 |
|
- fix some incorrect type (RL/RS, UV/scalar) in ADEXCH calls and ad-vars |
52 |
|
declaration (adEddyPsiX,adEddyPsiY in adcommon.h). |
53 |
|
- add new run-time params (dumpAdVarExch & mon_AdVarExch) to select how to |
54 |
|
apply ADEXCH before monitor or snap-shot of ad-variables: |
55 |
|
=0 : no ADEXCH ; =1 : do ADEXCH ; =2 : apply ADEXCH on a local copy. |
56 |
|
- implement new method (copy+adexch) for snap-shot and monitor of main model |
57 |
|
ad-vars (initially not used by default -> output unchanged). |
58 |
|
- change default (set to 2) to use new method and update few output_adm.txt |
59 |
|
with accurate ad-monitor (global_ocean.90x40x15, tutorial_global_oce_biogeo |
60 |
|
and both tutorial_tracer_adjsens tests). |
61 |
|
- switch 2 global_ocean.cs32x15 AD-tests to AB-2 (seaice_dynmix & thsice) |
62 |
|
and turn off momDissip_In_AB in the 2 other (needed for stable AB-3). |
63 |
|
o pkg/ctrl: |
64 |
|
enable the use of a variable number (maxCtrlArr2D, maxCtrlArr3D) of |
65 |
|
generic control variables via |
66 |
|
#define ALLOW_GENARR2D_CONTROL and/or #define ALLOW_GENARR3D_CONTROL |
67 |
|
Only required customization should be S/R ctrl_map_ini_genarr.F |
68 |
|
(routine in repository contains example) |
69 |
|
o pkg/exf: |
70 |
|
- fix and refine checking of surface-relaxation setting when using EXF |
71 |
|
o verification (adjoint exp): |
72 |
|
- reduce length of simulation by half for experiment global_ocean.cs32x15 |
73 |
|
(std, seaice & seaice_dynmix) and exp tutorial_dic_adjoffline; update output. |
74 |
|
o pkg/mom_common (mom_u/v_bottomdrag), pkg/shelfice (shelfice_u/v_drag) |
75 |
|
- replace if statements KE.ne.0 with KE.gt.0 to avoid sqrt of negative numbers |
76 |
|
of KE that can occur with aggressive optimization |
77 |
|
+ put quadratic bottom drag calculation in separated loops (only done if |
78 |
|
using bottomDragQuadratic) |
79 |
|
o model/src: CG2D_NSA |
80 |
|
- clean-up: stop if cg2dNormaliseRHS=T and AUTODIFF |
81 |
|
and replace GLOBAL_SUM calls with GLOBAL_SUM_TILE. |
82 |
|
- in test-exp that uses CG2D_NSA (bottom_ctrl & tutorial_tracer_adjsens), |
83 |
|
change cg2d residual target to be expressed in Wunits (=> do not normalise |
84 |
|
RHS ; this fix global_max Pb with TAF); update output. |
85 |
|
o verification/tutorial_tracer_adjsens: |
86 |
|
improve parameter consistency (and get rid of warnings): |
87 |
|
- use deltaTFreeSurf=deltaTtracer (better with NonLin FreeSurf); |
88 |
|
- switch Temp Adv Scheme from 81 to 80 (no limiter since theta < 0 is physical) |
89 |
|
- use staggerTimeStep (for stability) in som81; use default rotation period. |
90 |
|
o pkg/exch2: |
91 |
|
- with empty facet: fix compact-format (W2_mapIO=1) definition (was previously |
92 |
|
reset to 0 = 1 long line in X) |
93 |
|
o pkg/mdsio: |
94 |
|
- fix reading of dimensions from meta file for large-size domain |
95 |
|
o model/src: |
96 |
|
- fix saltIsActiveTr setting for IdealGas eosType (eosType is 6 character long); |
97 |
|
- to refine CS-grid check, add logical flag "hasWetCSCorners": true if using |
98 |
|
Cubed-Sphere Exch with CS-corners inside the domain; |
99 |
|
make new S/R INI_GLOBAL_DOMAIN from code in ini_linear_phisurf.F to calculate |
100 |
|
globalArea and to set hasWetCSCorners. |
101 |
|
- add warning if usingCurvilinearGrid and momAdvection in flux-form (missing |
102 |
|
metric terms); stop if hasWetCSCorners=T and momAdvection in flux-form. |
103 |
|
- re-activate the stop if useCDscheme and hasWetCSCorners=T (previously if |
104 |
|
useCDscheme and useCubedSphereExchange). |
105 |
|
o pkg/seaice/seaice_growth.F : |
106 |
|
- compute the SEAICE_DISABLE_HEATCONSFIX term accordingly |
107 |
|
for the (.NOT.useRealFreshWaterFlux).OR.(nonlinFreeSurf.EQ.0) |
108 |
|
when the previous code was not correct. |
109 |
|
- in all cases diagnoze the boundary condition mismatch to SIaaflux |
110 |
|
- in the case of useRealFreshWaterFlux.AND.(nonlinFreeSurf.GT.0) add |
111 |
|
that term to QNET (essentially to set the melt/freeze water to 0degC). |
112 |
|
when SEAICEheatConsFix is true, so that the ocean+ice budget heat is closed. |
113 |
|
o verification/global_ocean.cs32x15/input.seaice : |
114 |
|
- add SEAICEheatConsFix in data.seaice, ensuring closed ocean+ice heat budget. |
115 |
|
- add diagnostics (commented out) for budget test using my matlab codes (gcmfaces). |
116 |
|
- update results (output.seaice.txt) accordingly. |
117 |
|
o verification/lab_sea/input/data.seaice : |
118 |
|
- remove SEAICEheatConsFix, which is now be tested |
119 |
|
in global_ocean.cs32x15. The presently coded fix |
120 |
|
is only consistent with real fresh water + nlfs. |
121 |
|
- update results (output.txt) accordingly. |
122 |
|
o pkg/salt_plume: added diagnotic for salt tendency (oceSPtnd). |
123 |
|
o AD_CONFIG.h file: |
124 |
|
- in genmake2: remove "#undef ALLOW_ECCO_OPTIMIZATION" from AD_CONFIG.h; |
125 |
|
- remove #include "AD_CONFIG.h" from all included OPTIONS files and |
126 |
|
add it explicitly in each fortran src file where it is needed. |
127 |
|
motivation: header file AD_CONFIG.h is generated/modified after "make depend" |
128 |
|
thus introducing potentially wrong dependency; therefore, better to include |
129 |
|
it only where it's really needed, and after any other included OPTIONS file |
130 |
|
(less tempting to bring conditional includes according to ALLOW_ADJOINT_RUN |
131 |
|
or ALLOW_TANGENTLINEAR_RUN). |
132 |
|
|
133 |
|
checkpoint63p (2012/07/06) |
134 |
|
o pkg/autodiff: |
135 |
|
- rename S/R INI_AUTODIFF to AUTODIFF_INIT_VARIA ; |
136 |
|
- create new header file "AUTODIFF_PARAMS.h" for pkg/autodiff parameters |
137 |
|
which are now read from new parameter file "data.autodiff" (inAdExact |
138 |
|
previously in "data", use{KPP/GMRedi/SEAICE}inAdMode previously in data.pkg) |
139 |
|
- add file "data.autodiff" in all verification/*/input_ad/ directories. |
140 |
|
- add run-time parameter to turn On/Off SEAICEuseFREEDRIFT in adjoint/forward |
141 |
|
mode (used in global_ocean.cs32x15.seaice_dynmix test exp.) |
142 |
|
o verification/tutorial_tracer_adjsens/ |
143 |
|
- add extra sub-verification which uses "SOM" advection scheme |
144 |
|
(2nd Order-Moment Advection Scheme, Prather Limiter) with |
145 |
|
#define GAD_ALLOW_TS_SOM_ADV in GAD_OPTIONS.h |
146 |
|
and in data: |
147 |
|
multiDimAdvection=.TRUE., |
148 |
|
tempAdvScheme=81, |
149 |
|
saltAdvScheme=81, |
150 |
|
o model/src: |
151 |
|
- introduce ALLOW_BALANCE_RELAX which allow the removal |
152 |
|
of the global mean of relaxation terms by setting |
153 |
|
balanceThetaClimRelax and balanceSaltClimRelax |
154 |
|
- disable balanceEmPmR and balanceQnet in the case when useSeaice. |
155 |
|
This case is now treated appropriately in seaice_growth.F |
156 |
|
o pkg/seaice: |
157 |
|
- do balanceEmPmR and balanceQnet based on the net fluxes |
158 |
|
(SItflux) that enter the ocean+ice system rather than QNET |
159 |
|
and EMPMR. Works best in real fresh water. |
160 |
|
- SIatmFW, SIatmQnet, and SItflux computations had to be moved |
161 |
|
out of the diagnotics bloc, and stored in global arrays. |
162 |
|
|
163 |
|
checkpoint63o (2012/06/29) |
164 |
|
o vertical mixing schemes: |
165 |
|
- remove unused S/R CALC_BUOYANCY (left from branch-atmos merging) |
166 |
|
- replace computation of density (in Function STATE1, opps_calc.F) by a call |
167 |
|
to S/R FIND_RHO_SCALAR |
168 |
|
- pass sigmaR to S/R PP81_CALC, MY82_CALC (but not yet used) and to GGL90_CALC |
169 |
|
and use it for N^2 calculation in ggl90_calc.F (save 2 density computations); |
170 |
|
affects output (vermix.ggl90) at truncation level. |
171 |
|
o testreport: |
172 |
|
- change adjustment of SIZE.h for mpi+mth testing: preserve enough tiles |
173 |
|
(nSx,nSy) for the number of threads (from eedata.mth) |
174 |
|
o model/src: |
175 |
|
- remove 2nd set of calls at the top of initialise_varia.F (Adjoint part) |
176 |
|
related to Non_Lin Free-Surf or Bottom-Control (but not longer necessary). |
177 |
|
o verification/tutorial_tracer_adjsens/ |
178 |
|
- compile with ALLOW_CG2D_NSA |
179 |
|
- run with nonlinFreeSurf=3 |
180 |
|
- update reference output_adm.txt |
181 |
|
o tools/genmake2: |
182 |
|
- add "-DHAVE_NETCDF" to the DEFINES list when NetCDF is available ; |
183 |
|
refine usePROFILES switching off (only when NetCDF is not available). |
184 |
|
o verification (atmospheric set-up): |
185 |
|
- change eosType='IDEALGAS' to eosType='IDEALG' to match variable declaration |
186 |
|
o pkg/profiles : refine profiles and files handling. |
187 |
|
o model/src and pkg/ecco : introduce run-time switch usePROFILES. |
188 |
|
o model/src/the_main_loop.F, forward_step.F and pkg/exf/EXF_OPTIONS.h : |
189 |
|
- changes to use model/src/the_main_loop.F rather than the ecco version |
190 |
|
in ecco type adjoint runs. |
191 |
|
o model/src: |
192 |
|
- move computation of recip of grid distance & area from INI_MASKS_ETC to INI_GRID |
193 |
|
- move setting of h0Fac[C,W,S] from INI_LINEAR_PHISURF to INI_MASKS_ETC |
194 |
|
- update_masks_etc.F: rename SMOOTH*_R4,R8 function to the corresponding type (RS,RL) |
195 |
|
o model/src: |
196 |
|
- fix S/R UPDATE_CG2D for ALLOW_DEPTH_CONTROL case (was empty before); |
197 |
|
update output of test experiment bottom_ctrl_5x5. |
198 |
|
o pkg/generic_advdiff: |
199 |
|
- implement vertical bi-harmonic diffusion (for now, only for T & S and |
200 |
|
only explicitly). |
201 |
|
o verification/bottom_ctrl_5x5/ |
202 |
|
update reference output (results changed quite some time ago, |
203 |
|
not sure when; but new reference results look ok in terms of grdchk) |
204 |
|
o verification/1D_ocean_ice_column/ |
205 |
|
For verification purposes, the exact adjoint rather than an approx. |
206 |
|
should be used (e.g., to comare against F.D. or TLM). |
207 |
|
removed autodiff_inadmode*_ad.F routines in code_ad/ |
208 |
|
Update results/ accordingly. |
209 |
|
o pkg/cal: |
210 |
|
- change cal_getdate.F so that output date is function of input time only |
211 |
|
(less ambiguous, not mixed up with input iteration number). |
212 |
|
- fix calendarDumps for non-zero phase-lag (S/R CAL_TIME2DUMP). |
213 |
|
o pkg/diagnostics: |
214 |
|
- implement calendarDumps also for stats-diags |
215 |
|
- implement calendarDumps also for snap-shot output (negative freq) |
216 |
|
- for now, ignores calendarDumps if non-zero phase-lag. |
217 |
|
|
218 |
|
checkpoint63n (2012/06/04) |
219 |
|
o model/src: |
220 |
|
- recompute rSurfW & S to ensure consistent column thickness (needed for rStar) |
221 |
|
between Sum_k(hFac*drF) and rSurf-rLow, for now only when using pkg/shelfice; |
222 |
|
- use h0FacC, W & S to compute hFac_surfC, W & S in calc_surf_dr.F (more |
223 |
|
similar to calc_r_star.F); update results of experiment internal_wave and |
224 |
|
tutorial_global_oce_in_p (affected @ truncation level). |
225 |
|
o pkg/shelfice: |
226 |
|
- add parameterisation of advective-diffusive flux into the ice shelf |
227 |
|
according to Holland and Jenkins (1999), eq.22-33, as suggested by Jan De Ryd |
228 |
|
- simply eps3/3a computation |
229 |
|
o eesupp: |
230 |
|
- add new CPP option (DISCONNECTED_TILES) to disconnect tiles (no exchange |
231 |
|
between tiles, just fill-in edges assuming locally periodic subdomain) and |
232 |
|
add corresponding exchange subroutines (EXCH0); |
233 |
|
- new CG-solver version (_EX0) for disconnected-tiles special case. |
234 |
|
o model/src (CG-solvers): |
235 |
|
- modify Single-Reduction version (CG2D_SR) in case cg2dMaxIters is reached |
236 |
|
(similar final residual output and max-Iter number as with standard version); |
237 |
|
- allows to store and use lowest-residual solution (standard & _SR versions); |
238 |
|
- cleaning up (remove old, commented out code, LETS_MAKE_JAM ...). |
239 |
|
- by default, also compile CG2D_SR version (define ALLOW_SRCG in CPP_OPTIONS.h) |
240 |
|
o eesup/src: |
241 |
|
- global_vec_sum.F cleaning: add a BARRIER ; update comments ; remove ndef |
242 |
|
ALWAYS_USE_MPI (no longer needed after fixing usingMPI settings - March 2012) |
243 |
|
o pkg/salt_plume added to lab_sea/input_ad.noseaicedyn |
244 |
|
|
245 |
|
checkpoint63m (2012/04/27) |
246 |
|
o pkg/shelfice: |
247 |
|
- account for partical cells in surface level below ice-shelf for hydrostatic |
248 |
|
pressure calculion (set uniformFreeSurfLev to F); update isomip experiments. |
249 |
|
o ad test experiments: |
250 |
|
- update and rename to "ad_optfile.local" local AD-optfile specific to a |
251 |
|
particular adjoint verification experiment (in verification/*/code_ad/) |
252 |
|
o pkg/seaice & pkg/exf: |
253 |
|
- Part two of ECCO-CLIVAR code merges. |
254 |
|
Completes merge of seaice area relax. code. |
255 |
|
Requires unified CPP option EXF_ALLOW_SEAICE_RELAX |
256 |
|
to be set in EXF_OPTIONS.h since this pkg controls its I/O |
257 |
|
(and avoids second CPP option in SEAICE_OPTIONS.h) |
258 |
|
- change default value of costIceStart & costIceEnd to a valid date. |
259 |
|
- add snowPrecip to HSNOW in seaice_growth |
260 |
|
o pkg/ptracers: |
261 |
|
- move ptracers summary and setup check into separated S/R ; add a check for |
262 |
|
valid PTRACERS_Iter0 value (error+stop or just warning). |
263 |
|
o pkg/cal (+ pkg/ecco): |
264 |
|
- avoid calling a S/R with 2 times the same arg (FWD: unless both are only used |
265 |
|
as input; and for AD, unless both are not differentiable (e.g., k index)). |
266 |
|
o model/src: |
267 |
|
- define internal flag "uniformFreeSurfLev" (=T when free-surface level-index |
268 |
|
is everywhere k=1) to speed-up some calculations (by pass kSurf reference); |
269 |
|
temporary set to usingZCoords value (to be changed to F when using shelfice). |
270 |
|
- hydrostatic pressure: implement partial cell near the surface also for |
271 |
|
Z-coordinates (for the case where uniformFreeSurfLev=F); replace test on |
272 |
|
usingZCoords with test on uniformFreeSurfLev where needed (in NonHyd code). |
273 |
|
o pkg/ctrl/ctrl_init.F: |
274 |
|
- add a formal parameter to s/r ctrl_init_rec to print |
275 |
|
xx_$(ctrl_valiable)_file for easier debugging |
276 |
|
- move call of cal_* routines into the if-block where they are really |
277 |
|
needed so that xx_$(ctrl_variable)_period can be 0 or -12 without having |
278 |
|
to specify a startdate |
279 |
|
o pkg/seaice: |
280 |
|
- update comments in SEAICE_OPTIONS.h (+ similar update of lab_sea/code and |
281 |
|
global_ocean.cs32x15/code versions). |
282 |
|
- turn on seaice Multi-category (in data.seaice, SEAICE_multDim=7) for |
283 |
|
verification experiment global_ocean.cs32x15.seaice and update results. |
284 |
|
o pkg/exf: |
285 |
|
- new S/R EXF_GETFIELD_START to return starting-time of a forcing field |
286 |
|
(according to useExfYearlyFields). |
287 |
|
o pkg/cal: |
288 |
|
- move calendar setting & summary (previously in cal_readparams.F) into new |
289 |
|
S/R CAL_INIT_FIXED to be called later in the initialisation process, once |
290 |
|
length of the simulation is set (after SET_PARMS call); This is an attempt |
291 |
|
to fix Pb when, e.g.: pkg/longstep, modifies the length of the run. |
292 |
|
- For safety: keep a record of pkg/cal parameter settings status |
293 |
|
to allow to STOP if one pkg/cal S/R is called too early. |
294 |
|
- add a stop in all basic pkg/cal subroutines if called before setting is done. |
295 |
|
- modify cal_getdate.F: stop when nothing was returned; |
296 |
|
if called with myIter=-1, simply retrun modelBaseDate (1,2 = startDate_1,_2); |
297 |
|
this allows to remove "cal.h" from seaice_read_parms.F & init_mnc_vars.F. |
298 |
|
|
299 |
|
checkpoint63l (2012/04/04) |
300 |
|
o pkg/bbl: |
301 |
|
- fix call to FIND_RHO_2D in bbl_calc_rho.F (case multi-tiles per proc); |
302 |
|
update global_with_exf output.yearly.txt file. |
303 |
|
o pkg/cal: |
304 |
|
- start to clean-up cal_set.F ; fix for the case where baseTime is non-zero. |
305 |
|
- remove 2 unsused and very short (1 line only) functions ; |
306 |
|
- remove unsused subroutines from AD-Diff list. |
307 |
|
o model/src: |
308 |
|
- start to implement clean wait to stop in initialization S/R (config_check.F, |
309 |
|
packages_check.F, ini_parms.F and pkg/obcs/obcs_check.F + pkg/mypackage) |
310 |
|
o folowing PRINT_MESSAGE changes: |
311 |
|
- remove reminder multiple print to the same file (STDOUT) when multi-threads. |
312 |
o pkg/bbl: |
o pkg/bbl: |
313 |
- modification so it can work with z* |
- modification so it can work with z* |
314 |
- replace deltaT with dTtracerLev(k) for asynchronous time stepping |
- replace deltaT with dTtracerLev(k) for asynchronous time stepping |