| 4 |
Notes on tags used in MITgcmUV |
Notes on tags used in MITgcmUV |
| 5 |
============================== |
============================== |
| 6 |
|
|
| 7 |
|
o eesupp/src/eeset_parms.F: |
| 8 |
|
- change default for opening scratch files to avoid STATUS='SCRATCH' |
| 9 |
|
- close scratch files with STATUS='DELELTE' |
| 10 |
|
- you can revert to old default by setting USE_FORTRAN_SCRATCH_FILES |
| 11 |
|
in CPP_EEOPTIONS.h |
| 12 |
|
o pkg/atm_phys: |
| 13 |
|
- fix unset arguments in (unused) S/R surface_flux_0d. |
| 14 |
|
o eesupp/src: |
| 15 |
|
- add argument "procId" to S/R EESET_PARMS to fix scratchFile1 & 2 setting |
| 16 |
|
(case TARGET_BGL or TARGET_CRAYXT) for early call (from eeboot_minimal.F): |
| 17 |
|
called with myProcId in eeboot.F and with mpiMyWId in eeboot_minimal.F |
| 18 |
|
o pkg/streamice: |
| 19 |
|
- remove blank between _EXCH_XY_RL and "()", which my Apple Xcode |
| 20 |
|
preprocessor /usr/bin/cpp cannot interpret; 3 instances in total in |
| 21 |
|
streamice_driving_stress_fd.F and streamice_advect_2dtracer.F |
| 22 |
|
o pkg/diagnostics: |
| 23 |
|
- new option to allow to cumulate thickness-factor (hFac) weighted field |
| 24 |
|
(if field permitted); implemented by changing sign of "jdiag" pointer |
| 25 |
|
(> 0: cumlulate field, < 0: cumulate hFac weighted field). |
| 26 |
|
a) restricted to 3-d (Nr levels), level centered diagnostics at U,V or Cell |
| 27 |
|
center position (gcode(2)='U','V','M' & gcode(3,5,9:10)='R',' ','MR') |
| 28 |
|
b) for now, activated by setting fileFlags 3rd character to 'h'. |
| 29 |
|
|
| 30 |
|
checkpoint66i (2017/07/18) |
| 31 |
|
o pkg/cheapaml: |
| 32 |
|
- add parameter "useRelativeWind", default set to False; this change the |
| 33 |
|
previous setting which was always using relative wind. |
| 34 |
|
o add hooks for the Parallel Data Assimilation Framework PDAF |
| 35 |
|
(http://pdaf.awi.de/) in eeboot_minimal.F and the_main_loop.F; |
| 36 |
|
to use set CPP-flag USE_PDAF in CPP_EEOPTIONS.h |
| 37 |
|
o pkg/exf: |
| 38 |
|
- interpolation of vector fields (exf_interp_uv.F): fix bug in calculation |
| 39 |
|
of South-Pole mean value. |
| 40 |
|
- interpolation near the poles, case where second additional row is at the |
| 41 |
|
pole (or beyond the pole and moved to the pole): change first addition row |
| 42 |
|
value to a linear interpolation between pole and 1rst (S.pole)/last (N.pole) |
| 43 |
|
row (instead of just a copy of it). |
| 44 |
|
o pkg/seaice: |
| 45 |
|
- prevent JFNK and KRYLOV solvers from trying to reduce a residual of 0 |
| 46 |
|
- add the option to compute no-slip du/dy, dv/dx (i.e. |
| 47 |
|
the offdiagonal strain rate e12) by a second order approximation |
| 48 |
|
on the boundary; works only with JFNK, KRYLOV, or EVP solvers, because |
| 49 |
|
it is too messy to implement for the implicit LSR matrix. |
| 50 |
|
SEAICE_2ndOrderBC = .FALSE. by default |
| 51 |
|
|
| 52 |
|
checkpoint66h (2017/06/02) |
| 53 |
|
o pkg/seaice: |
| 54 |
|
- add new routines to compute stress tensor components and stress tensor |
| 55 |
|
divergence to be reused in s/r seaice_lsr and s/r seaice_calc_lhs |
| 56 |
|
- change names of diagnostics SIsigI/II (commonly used for invariants) |
| 57 |
|
to SIsig1/sig2 (more common for principal components) to avoid confusion |
| 58 |
|
o pkf/exf: |
| 59 |
|
- add a stop if useRelativeWind with un-updated uwind/vwind (e.g., constant); |
| 60 |
|
similarly, stop if rotateStressOnAgrid with constant wind-stress. |
| 61 |
|
o pkg/seaice: |
| 62 |
|
- remove (comment out) diagnostics SIuwind,SIvwind,SIfu,SIfv (duplicate of |
| 63 |
|
EXFuwind,EXFvwind,oceTAUX,oceTAUY) and point them to their equivalent. |
| 64 |
|
- add diagnostics of wind-stress over seaice (SItaux,SItauy) and seaice |
| 65 |
|
fraction weighted wind stress over ocean+seaice (SIatmTx,SIatmTy). |
| 66 |
|
o pkg/diagnostics: |
| 67 |
|
- small piece of code to rename (old) diagnostics, when namelist is processed. |
| 68 |
|
o model/src: |
| 69 |
|
- new run-time param (useMin4hFacEdges) to select method for setting hFacW,S: |
| 70 |
|
originally, set as minimum of adjacent hFacC factor ; now (new default) |
| 71 |
|
computed from rSurfW,S and rLowW,S by applying same rules as for hFacC. |
| 72 |
|
Only matters when useShelfIce=T with particular ice-shelf cavity geometry. |
| 73 |
|
o pkg/seaice: |
| 74 |
|
- add momemtum advection, off by default, still in test phase |
| 75 |
|
most of the momentum advection code is adapted and reused from mom_vecinv |
| 76 |
|
o pkg/mom_vecinv: |
| 77 |
|
- pass these runtime flags: |
| 78 |
|
selectVortScheme, highOrderVorticity, upwindVorticity, useJamartMomAdv |
| 79 |
|
as formal parameters to s/r mom_vi_u/v_coriolis, mom_vi_u/v_coriolis_c4, |
| 80 |
|
so that these routines can also be used in pkg/seaice. |
| 81 |
|
|
| 82 |
|
checkpoint66g (2017/04/24) |
| 83 |
|
o model/src: |
| 84 |
|
- more robust ordering of column thickness integral (=Sum_k(drF*hFac) ) |
| 85 |
|
to get same expression (regarding machine truncation) in different places |
| 86 |
|
in ini_masks_etc.F (e.g., rSurfC,W,S is now exactly zero when it should). |
| 87 |
|
Update forward output of experiments: global_ocean.cs32x15 (all 5 except |
| 88 |
|
viscA4), isomip (x3), tutorial_global_oce_in_p & tutorial_plume_on_slope. |
| 89 |
|
o pkg/shelfice: |
| 90 |
|
- ALLOW_SHIFWFLX_CONTROL: move setting of maskSHI from shelfice_update_masks.F |
| 91 |
|
to shelfice_init_fixed.F |
| 92 |
|
- change S/R SHELFICE_UPDATE_MASKS to SHELFICE_INIT_DEPTHS (still called from |
| 93 |
|
ini_masks_etc.F for now) to update ocean upper boundary position according |
| 94 |
|
to ice-shelf topography (instead of directly updating hFacC). |
| 95 |
|
o model/src: |
| 96 |
|
- move call to CTRL_INIT & CTRL_ADMTLM from the middle to the bottom of |
| 97 |
|
packages_init_fixed.F to allow other pkgs to set mask and weight fields. |
| 98 |
|
|
| 99 |
|
checkpoint66f (2017/04/06) |
| 100 |
|
o model/src: |
| 101 |
|
- add specific run-time param to select level of printed plot-field-maps, |
| 102 |
|
set by default to debugLevel. Remove internal param "printDomain". |
| 103 |
|
o pkg/seaice: |
| 104 |
|
- add flag to add snow mass to seaiceMassC/U/V, the default is |
| 105 |
|
SEAICEaddSnowMass=.FALSE., not to change previous results |
| 106 |
|
o pkg/bling |
| 107 |
|
- Bug fix in bling_production regarding unit conversion for diagnostics |
| 108 |
|
being put in the wrong place |
| 109 |
|
o model/src: |
| 110 |
|
- add back recomputation of rSurfW & S to ensure consistent column thickness |
| 111 |
|
(needed for rStar) between Sum_k(hFac*drF) and rSurf-rLow, for now only |
| 112 |
|
when using pkg/shelfice; was initially added on 2012/06/01 (ini_masks_etc.F |
| 113 |
|
revision 1.51) but was removed accidentally on 2014/02/08 (v1.53). |
| 114 |
|
o pkg/autodiff: |
| 115 |
|
- clean-up "checkpoint.flow" |
| 116 |
|
o pkg/rw (Contribution from Jody Klymak): |
| 117 |
|
option to set mds file suffix as function of time in simulation: |
| 118 |
|
*) new input parameter "rwSuffixType" (read from PARM03 namelist) |
| 119 |
|
to select file suffix format; by default (=0), use iteration number; |
| 120 |
|
*) add simple routine to return file suffix according to rwSuffixType; |
| 121 |
|
*) in model/src and in most pkgs (except: atm2d, fizhi, regrid & streamice), |
| 122 |
|
use new S/R to get file suffix, except for debug output file (diagFreq) |
| 123 |
|
and pkgs offline & rbcs input files. |
| 124 |
|
o pkg/rw: |
| 125 |
|
- uniform processing of "I10" suffix across writing fld routines; used to |
| 126 |
|
simplify debug writing of cg2/3d_b/x in solve_for_pressure.F & post_cg3d.F |
| 127 |
|
(similar to cg3d.F, cg3d_ex0.F) |
| 128 |
|
o pkg/mom_vecinv: |
| 129 |
|
- highOrderVorticity in selectVortScheme=2 case: fix c4 coeff in splitted |
| 130 |
|
vorticity flux (keep same sum in case vBarXm=vBaXp, uBarYm=uBarYp). |
| 131 |
|
o pkg/bling: |
| 132 |
|
- Many small changes intended to clean the code. |
| 133 |
|
Unnecessary ADJOINT_SAFEs removed ; |
| 134 |
|
removed BLING_COST.h BLING_CTRL.h bling_cost.F ; |
| 135 |
|
diagnostics added. |
| 136 |
|
|
| 137 |
|
checkpoint66e (2017/03/14) |
| 138 |
|
o pkg/exf: |
| 139 |
|
- interpolation with #undef EXF_INTERP_USE_DYNALLOC: move buffer size |
| 140 |
|
definition outside EXF_PARAM.h in new header file: EXF_INTERP_SIZE.h; |
| 141 |
|
use fixed size buffer (passed to S/R EXF_INTERP & EXF_INTERP_UV) to |
| 142 |
|
avoid any dynamic allocation ; |
| 143 |
|
- S/R EXF_CHECK: add new check & stop when file-name is defined but not |
| 144 |
|
read-in ; add warning when file is read-in but not used within pkg/exf ; |
| 145 |
|
+ check for buffer-size (if #undef EXF_INTERP_USE_DYNALLOC). |
| 146 |
|
- update exf_summary.F (print {FLD}RepCycle). |
| 147 |
|
o verification/global_with_exf: |
| 148 |
|
- switch on exf interpolation in AD test (just like the forward test) |
| 149 |
|
o pkg/mom_vecinv: |
| 150 |
|
- add storage directives to avoid recomputations within mom_vecinv.F |
| 151 |
|
which were generating seg. fault with gfortran -devel |
| 152 |
|
o pkg/ctrl, pkg/smooth: |
| 153 |
|
- initialize array halos which were generating seg. fault with |
| 154 |
|
gfortran -devel in adjoint mode |
| 155 |
|
o pkg/exf: |
| 156 |
|
- for each input field, enable to specify a field specific repeat-cycle |
| 157 |
|
({FLD}RepCycle) which defaults to pkg/exf main "repeatPeriod". |
| 158 |
|
o verification/lab_sea: |
| 159 |
|
- update AD results of primary test and noseaicedyn test after switching |
| 160 |
|
to new version of TAF (5.3.13 vs 5.3.2 before); agreement with gradient |
| 161 |
|
check stays about the same. |
| 162 |
|
o pkg/exf: |
| 163 |
|
- fix bug in exf_zenithangle.F for cases select_ZenAlbedo > 0 with useCAL=T. |
| 164 |
|
- exf_check: MAX_LAT_INC need only be "loc_nlat-1", not equal to loc_nlat |
| 165 |
|
o pkg/bling, USE_EXFCO2 code: |
| 166 |
|
- add parameter "apco2RepCycle" (set to pkg/exf "repeatPeriod" by default); |
| 167 |
|
- update calls to EXF S/R (use new version: EXF_INIT_FLD & EXF_SET_FLD). |
| 168 |
|
o pkg/exf: |
| 169 |
|
- rename S/R EXF_INIT to EXF_INIT_VARIA ; |
| 170 |
|
- add arguments: fldName (for debug msg) and fldRepeatCycle (set to |
| 171 |
|
repeatPeriod) to S/R EXF_SET_UV and to S/R EXF_SET_GEN (renamed EXF_SET_FLD) |
| 172 |
|
and update calls in pkg/exf calling S/R (exf_getffields.F & exf_getclim.F) ; |
| 173 |
|
- add argument: fldName (for debug msg) to S/R EXF_INIT_GEN (renamed |
| 174 |
|
EXF_INIT_FLD) and update calls in exf_init_varia.F |
| 175 |
|
- For now, for backward compatibility, keep a simplified version of S/Rs |
| 176 |
|
EXF_SET_GEN & EXF_INIT_GEN in file exf_set_gen.F |
| 177 |
|
- add and pass new arguments: fldName (for debug msg) and fldRepeatCycle |
| 178 |
|
to S/R EXF_GetFFieldRec ; update calls in pkg/obcs/obcs_exf_load.F |
| 179 |
|
o tools/genmake2: |
| 180 |
|
- replace "bc -l" (only used once) by "expr" (already used). |
| 181 |
|
o verification/global_ocean.cs32x15: |
| 182 |
|
- turn off pkg/cal (useCAL=F) in secondary FWD exp. "icedyn". |
| 183 |
|
Note: exf setting (data.exf) can be compared to other exf secondary exp |
| 184 |
|
"seaice" (kept with useCAL=T) which has same time dependent forcing. |
| 185 |
|
|
| 186 |
|
checkpoint66d (2017/02/13) |
| 187 |
|
o pkg/exf: |
| 188 |
|
- remove setting of useCAL=T when using pkg/exf (useEXF=T); add warning |
| 189 |
|
early on (in packages_boot.F) to stress this change in pkg setting. |
| 190 |
|
- In (most) verification exp. that use pkg/exf, add useCAL=.TRUE. to data.pkg |
| 191 |
|
o model/src: |
| 192 |
|
- move call to ecco_phys to end of time step; this may induce minor |
| 193 |
|
cost function changes by shifting time averages by one time step |
| 194 |
|
for some variables; this revision resulted in changed adjoint results |
| 195 |
|
in MITgcm_contrib/verification_other/global_oce_cs32 |
| 196 |
|
o pkg/exf: |
| 197 |
|
- Change EXF_READ_EVAP to only activate code within #ifdef ALLOW_ATM_TEMP ; |
| 198 |
|
this prevents to read evap when ALLOW_ATM_TEMP is undef and other fields, |
| 199 |
|
e.g. precip, are not available. |
| 200 |
|
o pkg/flt: |
| 201 |
|
- flt_init_varia.F: use pickupSuff if specified |
| 202 |
|
- add code (within #ifdef DEVEL_FLT_EXCH2) and test case as a first, |
| 203 |
|
intermediate, step towards completing pkg/exch2 support within pkg/flt; |
| 204 |
|
ifdef DEVEL_FLT_EXCH2 then: |
| 205 |
|
- flt_init_fixed.F: comment out stop |
| 206 |
|
- flt_exch2.F: conserve ipart, jpart (grid coordinates) |
| 207 |
|
- exch2_recv_get_vec.F: transform ipart, jpart (grid coordinates) |
| 208 |
|
- flt_mapping.F: attempt to fix longitude diagnostic near date-line |
| 209 |
|
- flt_init_varia.F: hack initialization (for testing purposes w. LLC90) |
| 210 |
|
o tools/genmake2 & pkg/pkg_depend: |
| 211 |
|
- define new type of pkg dependency rule ("=pkg_x"), less strict than |
| 212 |
|
the "+" rule, that add the dependent pkg (pkg_x) unless it's disabled |
| 213 |
|
(-pkg_x in packages.conf). |
| 214 |
|
- change pkg/exf dependency rule from "exf +cal" to "exf =cal"; |
| 215 |
|
- add "+cal" to dependency list of pkg/ecco (needed to compile). |
| 216 |
|
- simplify FWD experiment "offline_exf_seaice" by removing pkg/cal. |
| 217 |
|
o utils/matlab: |
| 218 |
|
- adding ocean_basin routines for defining basin masks. |
| 219 |
|
o pkg/exf: |
| 220 |
|
- new S/R EXF_GETFFIELD_START replacing EXF_GETFIELD_START, but with more |
| 221 |
|
arguments, allowing to check (and stop) if parameter setting of |
| 222 |
|
{FLD}startdate1 & date2 and of {FLD}StartTime are consistent with |
| 223 |
|
useCAL= T or F. For now, kept a simplified version of EXF_GETFIELD_START |
| 224 |
|
for backward compatibility. |
| 225 |
|
- change accordingly calls in exf_init_fixed.F + default {FLD}StartTime in |
| 226 |
|
exf_readparms.F ; apply same changes to pkg/icefront (for SGRunOff field). |
| 227 |
|
o pkg/bling (USE_EXFCO2 code): |
| 228 |
|
- fix missing setting of apco2StartTime according to apco2startdate1 & date2 |
| 229 |
|
by adding a call to S/R EXF_GETFFIELD_START. |
| 230 |
|
o pkg/exf: |
| 231 |
|
- allows to compile without pkg/cal (but disabled by current dependency |
| 232 |
|
rules, i.e., default "pkg/pkg_depend"). Minimal changes to enable to |
| 233 |
|
run with useCAL=F ; this involves setting directly {FLD}StartTime instead |
| 234 |
|
of {FLD}startdate1 & date2 ; consistency check not yet coded. |
| 235 |
|
o verification/global_ocean.cs32x15: |
| 236 |
|
- fix all data.exf for a shift of 1 day in all field startdate1 so that it now |
| 237 |
|
corresponds to middle of 1rst month; update outputs (2 fwd + 3 adm + 3 tlm). |
| 238 |
|
o pkg/exf: |
| 239 |
|
- allow to use EXF_ZENITHANGLE without pkg/cal + simplify (saving some |
| 240 |
|
calculations); change FWD experiment global_ocean.cs32x15 |
| 241 |
|
(#define ALLOW_ZENITHANGLE) to test/check that this code compiles. |
| 242 |
|
o pkg/exf: |
| 243 |
|
- In preparation for addition to NAMELIST, rename internal (_RL) parameter |
| 244 |
|
{FIELD}startdate to {FIELD}StartTime |
| 245 |
|
Note: new name also fit better the content, i.e, a start time in second. |
| 246 |
|
o eesupp/src: |
| 247 |
|
- add 1 argument to S/R EEBOOT & EEBOOT_MINIMAL for interface with ESMF |
| 248 |
|
o pkg/exf: |
| 249 |
|
- add option ALLOW_READ_TURBFLUXES (and corresponding set of parameters) |
| 250 |
|
to allow to read-in Sensible & Latent Heat flux ; |
| 251 |
|
- simplify pkg/exf main options: |
| 252 |
|
1) move small piece of code (case ALLOW_ATM_TEMP undef) out of |
| 253 |
|
exf_bulkformulae.F into exf_wind.F so that exf_bulkformulae.F is |
| 254 |
|
compiled only when both ALLOW_ATM_TEMP & ALLOW_BULKFORMULAE are defined; |
| 255 |
|
2) make call to EXF_RADIATION and to EXF_WIND independent of CPP option |
| 256 |
|
ALLOW_BULKFORMULAE which now only applies to S/R EXF_BULKFORMULAE ; |
| 257 |
|
3) improve options documentation in EXF_OPTIONS.h. |
| 258 |
|
o pkg/ecco: |
| 259 |
|
- cost_gencost_customize.F,ecco.h,ecco_phys.F,ecco_readparms.F, and |
| 260 |
|
ecco_summary.F: add passive tracer cost functions to gencost; |
| 261 |
|
m_ptracer and m_boxmean_ptracer |
| 262 |
|
o pkg/ctrl: |
| 263 |
|
- ctrl_map_forcing.F: pass myIter and myTime to ctrl_map_forcing as input |
| 264 |
|
parameters; move myIter .EQ. nIter0 inside ctrl_map_forcing; add to list |
| 265 |
|
of implemented gentim2d contol parameters: xx_qnet, xx_empmr, xx_qsw, |
| 266 |
|
xx_sst, xx_sss, xx_pload, xx_saltflux, xx_fu, xx_fv, xx_fe, xx_fn |
| 267 |
|
o model/src: |
| 268 |
|
- forward_step.F: pass myIter and myTime to ctrl_map_forcing as input |
| 269 |
|
parameters; move myIter .EQ. nIter0 inside ctrl_map_forcing |
| 270 |
|
o pkg/exf: |
| 271 |
|
- exf_getffields.F: add to list of implemented gentim2d contol parameters: |
| 272 |
|
xx_lwflux, xx_swflux, xx_evap, xx_apressure, xx_areamask |
| 273 |
|
|
| 274 |
|
checkpoint66c (2017/01/19) |
| 275 |
|
o verification: |
| 276 |
|
- add new option "-src" to testreport to only produce source code (*.f), |
| 277 |
|
including taf output src code (if using '-adm'/'-tlm' option). |
| 278 |
|
o pkg/exf: |
| 279 |
|
- add saltflx :: Net upward salt flux in psu.kg/m^2/s |
| 280 |
|
o pkg/diagnostics: |
| 281 |
|
- add run-time variable diagMdsDir to specify a subdirectory for |
| 282 |
|
diagnostic output when mds is being used and mdsioLocalDir is not. |
| 283 |
|
o pkg/mnc: |
| 284 |
|
- mnc_utils.F: edit stop message |
| 285 |
|
o pkg/autodiff: |
| 286 |
|
- autodiff_ini_model_io.F: PRINT_MESSAGE, clean-up comments, add _*_MASTER, |
| 287 |
|
add HAVE_SYSTEM bracket around system call to mkdir |
| 288 |
|
o pkg/profiles: |
| 289 |
|
- profiles_findunit.F, profiles_init_fixed.F, profiles_interp.F, |
| 290 |
|
profiles_readparms.F: call ALL_PROC_DIE before 'stop' |
| 291 |
|
- profiles_ini_io.F: use PRINT_MESSAGE, clean-up comments, add _*_MASTER, |
| 292 |
|
add HAVE_SYSTEM bracket around system call to mkdir |
| 293 |
|
o pkg/smooth: |
| 294 |
|
- smooth_filtervar2d.F, smooth_filtervar3d.F: call ALL_PROC_DIE before 'stop' |
| 295 |
|
- smooth_init2d.F, smooth_init3d.F: move print statements to readparms |
| 296 |
|
- smooth_readparms.F: add cleaner print statements from smooth_init?d.F |
| 297 |
|
o pkg/exf: |
| 298 |
|
- check: count errors and stop cleanly at the end (call to ALL_PROC_DIE); |
| 299 |
|
issue error message when climsst_interpMethod.GT.0 and climsst_lon_inc > 500 |
| 300 |
|
generalize tests on interpMethod, nlat, and lon_inc to all exf variables. |
| 301 |
|
- summary: skip detailed field report if not used (empty file-name). |
| 302 |
|
o tools/xmakedepend: |
| 303 |
|
- In case line editor "ed" is missing, switch to "sed" command to clean-up |
| 304 |
|
Makefile from previous dependencies (anything after "# DO NOT DELETE" line). |
| 305 |
|
o pkg/exf: |
| 306 |
|
- change definition of "hflux" input file to always include Short-Wave; |
| 307 |
|
this is now consistent with hflux computation (if using bulk-formulae) |
| 308 |
|
and hflux diagnostic & documentation (in EXF_FIELDS.h). |
| 309 |
|
|
| 310 |
|
checkpoint66b (2016/12/01) |
| 311 |
o model & momentum pkgs: |
o model & momentum pkgs: |
| 312 |
- implement fully implicit bottom friction combined with implicit surf. |
- implement fully implicit bottom friction combined with implicit surf. |
| 313 |
pressure, for now, only in hydrostic formulation: |
pressure, for now, only in hydrostic formulation: |
Parent Directory
| 
Revision Log
| 
Revision Graph
| 
Patch