4 |
Notes on tags used in MITgcmUV |
Notes on tags used in MITgcmUV |
5 |
============================== |
============================== |
6 |
|
|
7 |
o model/src: |
o add another hook (S/R PDF_FINALIZE) for the Parallel Data Assimilation |
8 |
|
Framework PDAF (http://pdaf.awi.de/) in the_main_loop.F |
9 |
|
o pkg/autodiff: |
10 |
|
- fix pkg/exf AD variable output (mainly ADJprecip), left from pkg/exf modif |
11 |
|
on Jan 27, 2017. Try also to fix ADJrunoff and TLM output (but less clear). |
12 |
|
o pkg/obcs: |
13 |
|
- add simpler setting (single value) of OB indices for the case where |
14 |
|
indices are uniform over the full section (Bruno Deremble contribution). |
15 |
|
o pkg/rbcs: |
16 |
|
- increase size of "relaxMaskFile" to read-in from namelist and save it |
17 |
|
(+check) into new (renamed) "relaxMaskTrFile" array. |
18 |
|
o model/src: |
19 |
|
- option (interViscAr_pCell, interDiffKr_pCell) to account for true vertical |
20 |
|
distance (including hFac) in vertical viscous flux and diffusive flux ; |
21 |
|
- add option to increase vertical mixing (for both momentum and tracers) |
22 |
|
near surface and/or bottom where partial cell is too thin ; |
23 |
|
- for now, both additions above are within: #ifndef EXCLUDE_PCELL_MIX_CODE ; |
24 |
|
|
25 |
|
checkpoint66l (2017/10/24) |
26 |
|
o pkg/kpp, ggl90 & ebm: |
27 |
|
- read namelist without IOSTAT=errIO to force to stop if there is an error |
28 |
|
in the parameter file namelist. |
29 |
|
o pkg/cheapaml: major changes to relaxation coefficient setting: |
30 |
|
- rename parameters cheapaml_taurelax & cheapaml_taurelaxocean (in days) |
31 |
|
to cheap_tauRelax & cheap_tauRelaxOce (now in seconds); |
32 |
|
- if using cheapMaskFile, set relaxation coeff to: cheapMask/tauRelax |
33 |
|
(instead of 1/cheapMask over ocean and 1/tauRelax over land); |
34 |
|
- with cheapMaskFile unset: set relaxation coeff according to land/ocean mask |
35 |
|
(unchanged) but skip increase near domain edges for periodic domain (in X |
36 |
|
or Y dir) when cheapamlX/Yperiodic=T ; also fix linear increase (over |
37 |
|
Cheapaml_mask_width grid points) of coeff towards domain edges (previously |
38 |
|
was increasing away from edges). Update output of experiment "cheapAML_box". |
39 |
|
o pkg/cheapaml: |
40 |
|
- move setting of (fixed in time) relaxation coefficient |
41 |
|
from cheapaml_init_varia.F to cheapaml_init_fixed.F |
42 |
|
o pkg/exf: |
43 |
|
- add specific forcing field for tides to feed model new geopotential anomaly |
44 |
|
forcing, for now within #ifdef EXF_ALLOW_TIDES. |
45 |
|
- remove from common block unused params: exf_inscal_sst & exf_inscal_sss. |
46 |
|
o model: |
47 |
|
- add new 2-d forcing field for time-dependent geopotential anomaly (e.g., |
48 |
|
tidal forcing), in m^2/s^2 ; add run-time param to allow to turn it off. |
49 |
|
o eesupp/src: |
50 |
|
- shift standardMessageUnit in eeboot.F and I/O units in mdsfindunit.F |
51 |
|
for coupling to GEOS AGCM: HACK_FOR_GMAO_CPL option in CPP_EEOPTIONS.h |
52 |
|
|
53 |
|
checkpoint66k (2017/09/20) |
54 |
|
o model/src: |
55 |
|
- add missing CPP brackets (ALLOW_COST, ALLOW_CTRL in load_fields_driver.F |
56 |
|
and the_model_main.F) |
57 |
|
o ctrl: |
58 |
|
- use zeroRL in place of fc when ALLOW_COST is not compiled (in ctrl_pack.F) |
59 |
|
- call MDS_READ_FIELD / MDS_WRITE_FIELD instead of deprecated |
60 |
|
mdsreadfield / mdswritefield (in ctrl_get_gen.F, ctrl_map_ini_gen.F, |
61 |
|
ctrl_map_ini_genarr.F, and ctrl_map_ini_gentim2d.F ) |
62 |
|
o eesupp: |
63 |
|
- add CPP option to activate some pieces of code for coupling to GEOS AGCM; |
64 |
|
- shift commonly used IO unit (in eeboot.F) for coupling to GEOS AGCM. |
65 |
|
o pkg/bling: |
66 |
|
- bling_production: Fix typo in calcium carbonate uptake. Also rearranging |
67 |
|
and cleaning |
68 |
|
o model/src: |
69 |
|
- move k loop inside correction_step.F (+ update calling S/R) |
70 |
|
- collect implicit pressure gradient tendencies in local 2-D array; |
71 |
|
affect results (at machine truncation level) when using 3-D solver; update |
72 |
|
output of exp.: exp4 (x1), global_ocean.cs32x15 (x2),hs94.cs-32x32x5.impIGW, |
73 |
|
rotating_tank, short_surf_wave,tutorial_deep_convection (x2) |
74 |
|
& tutorial_plume_on_slope. |
75 |
|
|
76 |
|
checkpoint66j (2017/08/15) |
77 |
|
o pkg/ptracers: |
78 |
|
- fix surface forcing under ice-shelf (useShelfIce=T). |
79 |
|
o pkg/atm_phys: |
80 |
|
- use hFac weighted average when applying A-grid atm-phys momentum tendency |
81 |
|
to C-grid dynamics; this ensures wind-stress match mom tendency. |
82 |
|
o eesupp/src: |
83 |
|
- change default for opening scratch files to avoid STATUS='SCRATCH' |
84 |
|
- close scratch files with STATUS='DELETE' |
85 |
|
- changes affect eeset_parms.F and open_copy_data_file.F and many routines |
86 |
|
that read namelists (because they close the scratch files) |
87 |
|
- you can revert to old default by setting USE_FORTRAN_SCRATCH_FILES |
88 |
|
in CPP_EEOPTIONS.h (tested in ideal_2D_oce/code & lab_sea/code_ad) |
89 |
|
o pkg/atm_phys: |
90 |
|
- fix unset arguments in (unused) S/R surface_flux_0d. |
91 |
|
o eesupp/src: |
92 |
|
- add argument "procId" to S/R EESET_PARMS to fix scratchFile1 & 2 setting |
93 |
|
(case TARGET_BGL or TARGET_CRAYXT) for early call (from eeboot_minimal.F): |
94 |
|
called with myProcId in eeboot.F and with mpiMyWId in eeboot_minimal.F |
95 |
|
o pkg/streamice: |
96 |
|
- remove blank between _EXCH_XY_RL and "()", which my Apple Xcode |
97 |
|
preprocessor /usr/bin/cpp cannot interpret; 3 instances in total in |
98 |
|
streamice_driving_stress_fd.F and streamice_advect_2dtracer.F |
99 |
|
o pkg/diagnostics: |
100 |
|
- new option to allow to cumulate thickness-factor (hFac) weighted field |
101 |
|
(if field permitted); implemented by changing sign of "jdiag" pointer |
102 |
|
(> 0: cumlulate field, < 0: cumulate hFac weighted field). |
103 |
|
a) restricted to 3-d (Nr levels), level centered diagnostics at U,V or Cell |
104 |
|
center position (gcode(2)='U','V','M' & gcode(3,5,9:10)='R',' ','MR') |
105 |
|
b) for now, activated by setting fileFlags 3rd character to 'h'. |
106 |
|
|
107 |
|
checkpoint66i (2017/07/18) |
108 |
|
o pkg/cheapaml: |
109 |
|
- add parameter "useRelativeWind", default set to False; this change the |
110 |
|
previous setting which was always using relative wind. |
111 |
|
o add hooks for the Parallel Data Assimilation Framework PDAF |
112 |
|
(http://pdaf.awi.de/) in eeboot_minimal.F and the_main_loop.F; |
113 |
|
to use set CPP-flag USE_PDAF in CPP_EEOPTIONS.h |
114 |
|
o pkg/exf: |
115 |
|
- interpolation of vector fields (exf_interp_uv.F): fix bug in calculation |
116 |
|
of South-Pole mean value. |
117 |
|
- interpolation near the poles, case where second additional row is at the |
118 |
|
pole (or beyond the pole and moved to the pole): change first addition row |
119 |
|
value to a linear interpolation between pole and 1rst (S.pole)/last (N.pole) |
120 |
|
row (instead of just a copy of it). |
121 |
|
o pkg/seaice: |
122 |
|
- prevent JFNK and KRYLOV solvers from trying to reduce a residual of 0 |
123 |
|
- add the option to compute no-slip du/dy, dv/dx (i.e. |
124 |
|
the offdiagonal strain rate e12) by a second order approximation |
125 |
|
on the boundary; works only with JFNK, KRYLOV, or EVP solvers, because |
126 |
|
it is too messy to implement for the implicit LSR matrix. |
127 |
|
SEAICE_2ndOrderBC = .FALSE. by default |
128 |
|
|
129 |
|
checkpoint66h (2017/06/02) |
130 |
|
o pkg/seaice: |
131 |
|
- add new routines to compute stress tensor components and stress tensor |
132 |
|
divergence to be reused in s/r seaice_lsr and s/r seaice_calc_lhs |
133 |
|
- change names of diagnostics SIsigI/II (commonly used for invariants) |
134 |
|
to SIsig1/sig2 (more common for principal components) to avoid confusion |
135 |
|
o pkf/exf: |
136 |
|
- add a stop if useRelativeWind with un-updated uwind/vwind (e.g., constant); |
137 |
|
similarly, stop if rotateStressOnAgrid with constant wind-stress. |
138 |
|
o pkg/seaice: |
139 |
|
- remove (comment out) diagnostics SIuwind,SIvwind,SIfu,SIfv (duplicate of |
140 |
|
EXFuwind,EXFvwind,oceTAUX,oceTAUY) and point them to their equivalent. |
141 |
|
- add diagnostics of wind-stress over seaice (SItaux,SItauy) and seaice |
142 |
|
fraction weighted wind stress over ocean+seaice (SIatmTx,SIatmTy). |
143 |
|
o pkg/diagnostics: |
144 |
|
- small piece of code to rename (old) diagnostics, when namelist is processed. |
145 |
|
o model/src: |
146 |
|
- new run-time param (useMin4hFacEdges) to select method for setting hFacW,S: |
147 |
|
originally, set as minimum of adjacent hFacC factor ; now (new default) |
148 |
|
computed from rSurfW,S and rLowW,S by applying same rules as for hFacC. |
149 |
|
Only matters when useShelfIce=T with particular ice-shelf cavity geometry. |
150 |
|
o pkg/seaice: |
151 |
|
- add momemtum advection, off by default, still in test phase |
152 |
|
most of the momentum advection code is adapted and reused from mom_vecinv |
153 |
|
o pkg/mom_vecinv: |
154 |
|
- pass these runtime flags: |
155 |
|
selectVortScheme, highOrderVorticity, upwindVorticity, useJamartMomAdv |
156 |
|
as formal parameters to s/r mom_vi_u/v_coriolis, mom_vi_u/v_coriolis_c4, |
157 |
|
so that these routines can also be used in pkg/seaice. |
158 |
|
|
159 |
|
checkpoint66g (2017/04/24) |
160 |
|
o model/src: |
161 |
|
- more robust ordering of column thickness integral (=Sum_k(drF*hFac) ) |
162 |
|
to get same expression (regarding machine truncation) in different places |
163 |
|
in ini_masks_etc.F (e.g., rSurfC,W,S is now exactly zero when it should). |
164 |
|
Update forward output of experiments: global_ocean.cs32x15 (all 5 except |
165 |
|
viscA4), isomip (x3), tutorial_global_oce_in_p & tutorial_plume_on_slope. |
166 |
|
o pkg/shelfice: |
167 |
|
- ALLOW_SHIFWFLX_CONTROL: move setting of maskSHI from shelfice_update_masks.F |
168 |
|
to shelfice_init_fixed.F |
169 |
|
- change S/R SHELFICE_UPDATE_MASKS to SHELFICE_INIT_DEPTHS (still called from |
170 |
|
ini_masks_etc.F for now) to update ocean upper boundary position according |
171 |
|
to ice-shelf topography (instead of directly updating hFacC). |
172 |
|
o model/src: |
173 |
|
- move call to CTRL_INIT & CTRL_ADMTLM from the middle to the bottom of |
174 |
|
packages_init_fixed.F to allow other pkgs to set mask and weight fields. |
175 |
|
|
176 |
|
checkpoint66f (2017/04/06) |
177 |
|
o model/src: |
178 |
|
- add specific run-time param to select level of printed plot-field-maps, |
179 |
|
set by default to debugLevel. Remove internal param "printDomain". |
180 |
|
o pkg/seaice: |
181 |
|
- add flag to add snow mass to seaiceMassC/U/V, the default is |
182 |
|
SEAICEaddSnowMass=.FALSE., not to change previous results |
183 |
|
o pkg/bling |
184 |
|
- Bug fix in bling_production regarding unit conversion for diagnostics |
185 |
|
being put in the wrong place |
186 |
|
o model/src: |
187 |
|
- add back recomputation of rSurfW & S to ensure consistent column thickness |
188 |
|
(needed for rStar) between Sum_k(hFac*drF) and rSurf-rLow, for now only |
189 |
|
when using pkg/shelfice; was initially added on 2012/06/01 (ini_masks_etc.F |
190 |
|
revision 1.51) but was removed accidentally on 2014/02/08 (v1.53). |
191 |
|
o pkg/autodiff: |
192 |
|
- clean-up "checkpoint.flow" |
193 |
|
o pkg/rw (Contribution from Jody Klymak): |
194 |
|
option to set mds file suffix as function of time in simulation: |
195 |
|
*) new input parameter "rwSuffixType" (read from PARM03 namelist) |
196 |
|
to select file suffix format; by default (=0), use iteration number; |
197 |
|
*) add simple routine to return file suffix according to rwSuffixType; |
198 |
|
*) in model/src and in most pkgs (except: atm2d, fizhi, regrid & streamice), |
199 |
|
use new S/R to get file suffix, except for debug output file (diagFreq) |
200 |
|
and pkgs offline & rbcs input files. |
201 |
|
o pkg/rw: |
202 |
|
- uniform processing of "I10" suffix across writing fld routines; used to |
203 |
|
simplify debug writing of cg2/3d_b/x in solve_for_pressure.F & post_cg3d.F |
204 |
|
(similar to cg3d.F, cg3d_ex0.F) |
205 |
|
o pkg/mom_vecinv: |
206 |
|
- highOrderVorticity in selectVortScheme=2 case: fix c4 coeff in splitted |
207 |
|
vorticity flux (keep same sum in case vBarXm=vBaXp, uBarYm=uBarYp). |
208 |
|
o pkg/bling: |
209 |
|
- Many small changes intended to clean the code. |
210 |
|
Unnecessary ADJOINT_SAFEs removed ; |
211 |
|
removed BLING_COST.h BLING_CTRL.h bling_cost.F ; |
212 |
|
diagnostics added. |
213 |
|
|
214 |
|
checkpoint66e (2017/03/14) |
215 |
|
o pkg/exf: |
216 |
|
- interpolation with #undef EXF_INTERP_USE_DYNALLOC: move buffer size |
217 |
|
definition outside EXF_PARAM.h in new header file: EXF_INTERP_SIZE.h; |
218 |
|
use fixed size buffer (passed to S/R EXF_INTERP & EXF_INTERP_UV) to |
219 |
|
avoid any dynamic allocation ; |
220 |
|
- S/R EXF_CHECK: add new check & stop when file-name is defined but not |
221 |
|
read-in ; add warning when file is read-in but not used within pkg/exf ; |
222 |
|
+ check for buffer-size (if #undef EXF_INTERP_USE_DYNALLOC). |
223 |
|
- update exf_summary.F (print {FLD}RepCycle). |
224 |
|
o verification/global_with_exf: |
225 |
|
- switch on exf interpolation in AD test (just like the forward test) |
226 |
|
o pkg/mom_vecinv: |
227 |
|
- add storage directives to avoid recomputations within mom_vecinv.F |
228 |
|
which were generating seg. fault with gfortran -devel |
229 |
|
o pkg/ctrl, pkg/smooth: |
230 |
|
- initialize array halos which were generating seg. fault with |
231 |
|
gfortran -devel in adjoint mode |
232 |
|
o pkg/exf: |
233 |
|
- for each input field, enable to specify a field specific repeat-cycle |
234 |
|
({FLD}RepCycle) which defaults to pkg/exf main "repeatPeriod". |
235 |
|
o verification/lab_sea: |
236 |
|
- update AD results of primary test and noseaicedyn test after switching |
237 |
|
to new version of TAF (5.3.13 vs 5.3.2 before); agreement with gradient |
238 |
|
check stays about the same. |
239 |
|
o pkg/exf: |
240 |
|
- fix bug in exf_zenithangle.F for cases select_ZenAlbedo > 0 with useCAL=T. |
241 |
|
- exf_check: MAX_LAT_INC need only be "loc_nlat-1", not equal to loc_nlat |
242 |
|
o pkg/bling, USE_EXFCO2 code: |
243 |
|
- add parameter "apco2RepCycle" (set to pkg/exf "repeatPeriod" by default); |
244 |
|
- update calls to EXF S/R (use new version: EXF_INIT_FLD & EXF_SET_FLD). |
245 |
|
o pkg/exf: |
246 |
|
- rename S/R EXF_INIT to EXF_INIT_VARIA ; |
247 |
|
- add arguments: fldName (for debug msg) and fldRepeatCycle (set to |
248 |
|
repeatPeriod) to S/R EXF_SET_UV and to S/R EXF_SET_GEN (renamed EXF_SET_FLD) |
249 |
|
and update calls in pkg/exf calling S/R (exf_getffields.F & exf_getclim.F) ; |
250 |
|
- add argument: fldName (for debug msg) to S/R EXF_INIT_GEN (renamed |
251 |
|
EXF_INIT_FLD) and update calls in exf_init_varia.F |
252 |
|
- For now, for backward compatibility, keep a simplified version of S/Rs |
253 |
|
EXF_SET_GEN & EXF_INIT_GEN in file exf_set_gen.F |
254 |
|
- add and pass new arguments: fldName (for debug msg) and fldRepeatCycle |
255 |
|
to S/R EXF_GetFFieldRec ; update calls in pkg/obcs/obcs_exf_load.F |
256 |
|
o tools/genmake2: |
257 |
|
- replace "bc -l" (only used once) by "expr" (already used). |
258 |
|
o verification/global_ocean.cs32x15: |
259 |
|
- turn off pkg/cal (useCAL=F) in secondary FWD exp. "icedyn". |
260 |
|
Note: exf setting (data.exf) can be compared to other exf secondary exp |
261 |
|
"seaice" (kept with useCAL=T) which has same time dependent forcing. |
262 |
|
|
263 |
|
checkpoint66d (2017/02/13) |
264 |
|
o pkg/exf: |
265 |
|
- remove setting of useCAL=T when using pkg/exf (useEXF=T); add warning |
266 |
|
early on (in packages_boot.F) to stress this change in pkg setting. |
267 |
|
- In (most) verification exp. that use pkg/exf, add useCAL=.TRUE. to data.pkg |
268 |
|
o model/src: |
269 |
- move call to ecco_phys to end of time step; this may induce minor |
- move call to ecco_phys to end of time step; this may induce minor |
270 |
cost function changes by shifting time averages by one time step |
cost function changes by shifting time averages by one time step |
271 |
for some variables; this revision resulted in changed adjoint results |
for some variables; this revision resulted in changed adjoint results |
272 |
in MITgcm_contrib/verification_other/global_oce_cs32 |
in MITgcm_contrib/verification_other/global_oce_cs32 |
273 |
o pkg/flt/flt_init_varia.F: |
o pkg/exf: |
274 |
- use pickupSuff if specified |
- Change EXF_READ_EVAP to only activate code within #ifdef ALLOW_ATM_TEMP ; |
275 |
o pkg/flt: ifdef DEVEL_FLT_EXCH2 then add code and test case as a first, |
this prevents to read evap when ALLOW_ATM_TEMP is undef and other fields, |
276 |
intermediate, step towards completing pkg/exch2 support within pkg/flt; |
e.g. precip, are not available. |
277 |
ifdef DEVEL_FLT_EXCH2 then: |
o pkg/flt: |
278 |
- flt_init_fixed.F: comment out stop |
- flt_init_varia.F: use pickupSuff if specified |
279 |
- flt_exch2.F: conserve ipart, jpart (grid coordinates) |
- add code (within #ifdef DEVEL_FLT_EXCH2) and test case as a first, |
280 |
- exch2_recv_get_vec.F: transform ipart, jpart (grid coordinates) |
intermediate, step towards completing pkg/exch2 support within pkg/flt; |
281 |
- flt_mapping.F: attempt to fix longitude diagnostic near date-line |
ifdef DEVEL_FLT_EXCH2 then: |
282 |
- flt_init_varia.F: hack initialization (for testing purposes w. LLC90) |
- flt_init_fixed.F: comment out stop |
283 |
|
- flt_exch2.F: conserve ipart, jpart (grid coordinates) |
284 |
|
- exch2_recv_get_vec.F: transform ipart, jpart (grid coordinates) |
285 |
|
- flt_mapping.F: attempt to fix longitude diagnostic near date-line |
286 |
|
- flt_init_varia.F: hack initialization (for testing purposes w. LLC90) |
287 |
o tools/genmake2 & pkg/pkg_depend: |
o tools/genmake2 & pkg/pkg_depend: |
288 |
- define new type of pkg dependency rule ("=pkg_x"), less strict than |
- define new type of pkg dependency rule ("=pkg_x"), less strict than |
289 |
the "+" rule, that add the dependent pkg (pkg_x) unless it's disabled |
the "+" rule, that add the dependent pkg (pkg_x) unless it's disabled |