| 4 |
Notes on tags used in MITgcmUV |
Notes on tags used in MITgcmUV |
| 5 |
============================== |
============================== |
| 6 |
|
|
| 7 |
|
o model/src: |
| 8 |
|
- fix wrong truncation (single prec) from "FLOAT" function in expressions |
| 9 |
|
like: deltaT*FLOAT(myIter) when myIter is large: |
| 10 |
|
a) replaced by DFLOAT (if not seen by TAF); |
| 11 |
|
b) remove "FLOAT" and use implicit type conversion (if seen by TAF). |
| 12 |
|
o pkg/aim_v23: |
| 13 |
|
- write/read the expected CO2 pickups (from S/R AIM_DO_CO2): fix reading |
| 14 |
|
when pickupSuff is set ; do write rolling pickups + at the end of the run. |
| 15 |
|
o pkg/atm_ocn_coupler + ocn_compon_interf: |
| 16 |
|
- in prep for using pkg/seaice Dyn in coupled set-up, implement sequential |
| 17 |
|
coupling option-1: ATM -(cpl)-> OCN and then OCN -(cpl)-> ATM ; |
| 18 |
|
add corresponding call in DO_OCEANIC_PHYS. |
| 19 |
|
o coupler pkgs: |
| 20 |
|
Start a new way to set-up optionally-exchanged variables (previously, only |
| 21 |
|
there for exchange_DIC): switch on/off from 1 place, at run-time, in coupler |
| 22 |
|
data.cpl (new) instead of at compile time in ATMIDS.h & OCNIDS.h ; |
| 23 |
|
send switch to ATM & OCN compon before reading their own "data.cpl" (so that |
| 24 |
|
compononent param default can be set accordingly). |
| 25 |
|
Note: this new switch (cpl_exchange_[xxx]) is not a per variable switch |
| 26 |
|
but rather applies to a group a fields (going both ways like for DIC) |
| 27 |
|
and corresponds to an option of coupling config. |
| 28 |
|
coupler (pkg/atm_ocn_coupler): |
| 29 |
|
- change parameter file from "data" to "data.cpl" (in cpl_read_params.F), |
| 30 |
|
and read namelist directly (without eessup S/R calls) instead of |
| 31 |
|
in the very un-flexible old way, 1 param per line, in fixed order; |
| 32 |
|
- add error-counter to track errors (e.g., missing "data.cpl") and to stop |
| 33 |
|
cleanly in CPL_CHECK_CPLCONFIG |
| 34 |
|
- add new coupling-exchange selectors (some not yet active) including |
| 35 |
|
cpl_exchange_DIC (to set to 3 to replace atmCpl_exchange_DIC=T in ATMIDS.h |
| 36 |
|
and ocnCpl_exchange_DIC=T in OCNIDS.h); |
| 37 |
|
- add 2 new S/R (CPL_SEND_ATM/OCN_CPLPARMS) to send coupler-params to each |
| 38 |
|
component ; called directly from coupler.F, after comp. registrations; |
| 39 |
|
- rename few variable-ID names (in ATMIDS.h & OCNIDS.h): |
| 40 |
|
atm/ocnSeaIceName --> atm/ocnSIceMassName ; atm/ocnFCO2Name -> |
| 41 |
|
-> atm/ocnCO2FluxName ; atm/ocnWSpdName --> atm/ocnWindSpdName |
| 42 |
|
components (pkg/atm_ & ocn_compon_interf): |
| 43 |
|
- add ATM/OCN_CPL_OPTIONS.h in component pkgs and include the corresponding |
| 44 |
|
CPP header file in all pkg source files. |
| 45 |
|
- move checking of comp. configs out of cpl_exch_configs.F into new S/R |
| 46 |
|
ATM/OCN_CHECK_CPLCONFIG; |
| 47 |
|
- add error-counter to track errors (e.g., in "data.cpl") and to stop |
| 48 |
|
cleanly in ATM/OCN_CHECK_CPLCONFIG; |
| 49 |
|
- add new S/R CPL_IMPORT_CPLPARMS to import coupling-exchange selectors |
| 50 |
|
from coupler ; called from initialise_fixed.F, after PACKAGES_BOOT and |
| 51 |
|
before PACKAGES_READPARMS; |
| 52 |
|
verification/cpl_aim+ocn/: |
| 53 |
|
- update ATMIDS.h & OCNIDS.h (in shared_code) and use new parameter file |
| 54 |
|
"data.cpl" for coupler (in input_cpl). |
| 55 |
|
o eesupp/inc: |
| 56 |
|
- change the MPI-global-sum default (in CPP_EEOPTIONS.h) to: |
| 57 |
|
#define GLOBAL_SUM_ORDER_TILES (only affects MPI built of global_sum_tile.F) |
| 58 |
|
to always cumulate tile local-sum in the same order (still uses |
| 59 |
|
MPI_Allreduce like standard code). |
| 60 |
|
- in verification experiment code, remove local CPP_EEOPTIONS.h_mpi files |
| 61 |
|
that are now identical to standard version (in eesupp/inc). |
| 62 |
|
o pkg/shelfice: |
| 63 |
|
- add SHELFICETransCoeffTFile for initializing spatially varying |
| 64 |
|
heat and salt transfer coefficients |
| 65 |
|
o pkg/atm_compon_interf & ocn_compon_interf: |
| 66 |
|
- combine into 1 (new) S/R CPL_EXPORT_IMPORT_DATA the two previous |
| 67 |
|
S/R CPL_EXPORT_MY_DATA & CPL_IMPORT_EXTERNAL_DATA |
| 68 |
|
- move bi,bj loops inside S/R OCN_STORE_MY_DATA |
| 69 |
|
o pkg/atm_ocn_coupler: |
| 70 |
|
- initialise to zero ATMVARS.h & OCNVARS.h arrays. |
| 71 |
|
o pkg/rbcs: |
| 72 |
|
- select RBCS-mask for Temp & Salt the same way as for pTracer ; this allows |
| 73 |
|
to compile with maskLEN=1 when all tracers use the same RBCS-mask. |
| 74 |
|
- add a short report (to STDOUT) about RBCS-mask settings. |
| 75 |
|
|
| 76 |
|
checkpoint65p (2015/10/23) |
| 77 |
|
o pkg/seaice/seaice_evp.F: fix store directives and key computations, since |
| 78 |
|
there is no adjoint test for EVP, we don't know what it does to the adjoint |
| 79 |
|
solution, but at least there are no more recomputation warnings left |
| 80 |
|
o pkg/seaice/seaice_evp.F: slight modification of averaging so that EVP stands |
| 81 |
|
a chance of giving the same results as a fully converged VP (JFNK) solver |
| 82 |
|
o tools/adjoint_options/adjoint_diva: |
| 83 |
|
- fix bug (typo) in Tang-Linear FLAGS setting for MPI + DIVA |
| 84 |
|
o pkg/streamice: |
| 85 |
|
- spotted bug in streamice_driving_stress using dyG where should have been dxG |
| 86 |
|
o pkg/exf: |
| 87 |
|
- remove STOP statement that prevented to use wind or (wind-)stress |
| 88 |
|
interpolation for constant-in-time forcing fields (wind/stress period = 0). |
| 89 |
|
o pkg/seaice: |
| 90 |
|
- replace SEAICE_EVP_USE_ADAPTATION by run time parameters, requires |
| 91 |
|
5 additionals 2D fields and 6 new store directives |
| 92 |
|
- change logic in seaice_readparms.F: EVP code can now be turned on in |
| 93 |
|
various ways, setting SEAICE_deltaTev is no longer required, |
| 94 |
|
alternatively set SEAICE_evpAlpha/Beta, SEAICEuseEVPstar, SEAICEuseEVPrev, |
| 95 |
|
or SEAICEaEVPcoeff |
| 96 |
|
o pkg/shelfice/shelfice_thermodynamics.F |
| 97 |
|
- redefining uLoc/vLoc to u/v, instead of 2u/v |
| 98 |
|
o pkg/seaice/seaice_evp.F: introduce "adaptive EVP" by Madlen Kimmritz |
| 99 |
|
- this is an intermediate state of a truely converging EVP that has |
| 100 |
|
the potential of outperforming implicit VP methods, I do not recommend |
| 101 |
|
using it yet. |
| 102 |
|
- for now, "adaptive EVP" is turned on by setting SEAICE_EVP_USE_ADAPTATION |
| 103 |
|
and all parameters are hardwired |
| 104 |
|
- for convergence it still requires very smooth regularisations, that means, |
| 105 |
|
if SEAICE_DELTA_SMOOTHREG is defined, deltaCreg=deltaC+deltaMin, which is |
| 106 |
|
different from the VP case with deltaCreg=sqrt(deltaC**2+deltaMin**2); also |
| 107 |
|
specific averaging appears to be required, still subject to tuning |
| 108 |
|
- still needs cleaning and I need to turn parameter into runtime parameters |
| 109 |
|
- add code to compute and print residuals of iteration, compile with |
| 110 |
|
defining ALLOW_SEAICE_EVP_RESIDUAL to enable it |
| 111 |
|
o pkg/seaice/seaice_evp.F: fix a bug (factor of four in front of e12Csq) |
| 112 |
|
that entered with r1.54 on Sep04, 2015, -> update results |
| 113 |
|
|
| 114 |
|
checkpoint65o (2015/09/14) |
| 115 |
|
o pkg/mom_vecinv & mom_common: |
| 116 |
|
- add deep-atmosphere geometry factor in mom_calc_visc.F + in routines |
| 117 |
|
called from there. |
| 118 |
|
- add anelastic and deep-atmosphere geometry factor in pkg/mom_vecinv ; this |
| 119 |
|
allows to use Vector-Invariant form in deep atmos and anelastic formulation |
| 120 |
|
o pkg/seaice: introduce fast ice parameterisation following Itkin et al. (2015) |
| 121 |
|
and Koenig-Beatty+Holland (2012) |
| 122 |
|
- two new parameters SEAICE_tensilFac and SEAICE_tensilDepth |
| 123 |
|
- global 2D field tensileStrength, computed in seaice_calc_ice_strength |
| 124 |
|
- requires an extra input argument for S/R seaice_calc_viscosities |
| 125 |
|
- tensileStrength's depth dependence is different from Itkin et al. (2015) |
| 126 |
|
(to be changed and played with, for now exponential) |
| 127 |
|
o pkg/seaice: introduce new parameter SEAICEscaleSurfStress (default = .FALSE.) |
| 128 |
|
- if TRUE scale ice-ocean and ice-atmosphere stress acting on sea ice |
| 129 |
|
by AREA according to Connelly et al. (2004), JPO. |
| 130 |
|
- For EVP and the LSR solver, the implicit part of the drag term is |
| 131 |
|
the only non-zero term in the denominator when there is no ice (which |
| 132 |
|
prevented running the model with zero ice-ocean drag). If |
| 133 |
|
SEAICEscaleSurfStress = .TRUE., this results in a division by zero |
| 134 |
|
(or zero main diagonals BU/BV) which need to be caught. A practical |
| 135 |
|
consequence is that for open water, the momentum equation reduce |
| 136 |
|
to trivially 0 = 0 + 0 (for EVP). For LSR, BU/BV are reset to 1, if |
| 137 |
|
they happen to be zero, often leading to a non-zero solution over |
| 138 |
|
open water. |
| 139 |
|
o pkg/seaice: revise EVP code (seaice_evp.F) in preparation for a more |
| 140 |
|
efficient EVP method. |
| 141 |
|
- introduce area-weighted averages for e12 (analogously to |
| 142 |
|
seaice_calc_viscosities.F); this totally changes lab_sea.hb87 (2 digits |
| 143 |
|
remain, but also changing the order of terms in the previous average |
| 144 |
|
changed the results as much) -> update experiment |
| 145 |
|
- add SEAICE_DELTA_SMOOTHREG code |
| 146 |
|
- disentangle computation of zetaC/deltaC and zetaZ/deltaZ, also for |
| 147 |
|
TEM-code |
| 148 |
|
- adjust loop bounds so that only required fields are computed |
| 149 |
|
- add new averaging code for zetaZ/deltaZ (again similar to |
| 150 |
|
seaice_calc_viscosities.F), inactive by default for now (will change |
| 151 |
|
results again), but will replace old code eventually |
| 152 |
|
o eesupp/src: |
| 153 |
|
- add an other alternative for multi-proc GLOBAL_SUM (in global_sum_tile.F) |
| 154 |
|
to always cumulate tile local-sum in the same order |
| 155 |
|
(option #define GLOBAL_SUM_ORDER_TILES in CPP_EEOPTIONS.h). |
| 156 |
|
Still uses MPI_Allreduce (like standard code) but on array of tiles |
| 157 |
|
and should be faster than GLOBAL_SUM_SEND_RECV code. |
| 158 |
|
- switch almost all verification experiments that use GLOBAL_SUM_SEND_RECV |
| 159 |
|
(defined in CPP_EEOPTIONS.h_mpi) to GLOBAL_SUM_ORDER_TILES instead. |
| 160 |
|
- add CPP_EEOPTIONS.h_mpi with GLOBAL_SUM_ORDER_TILES defined in 14 more exp.: |
| 161 |
|
aim.5l_cs, cheapAML_box, deep_anelastic, dome, fizhi-cs-32x32x40, |
| 162 |
|
fizhi-cs-aqualev20, fizhi-gridalt-hs, global_ocean_ebm, matrix_example, |
| 163 |
|
natl_box, solid-body.cs-32x32x1, tutorial_advection_in_gyre, |
| 164 |
|
tutorial_baroclinic_gyre and tutorial_held_suarez_cs. |
| 165 |
|
|
| 166 |
|
checkpoint65n (2015/07/29) |
| 167 |
|
o pkg/thsice: |
| 168 |
|
- add a warning when used with pkg/aim but without updating SST |
| 169 |
|
(stepFwd_oceMxL=F & useCoupler=F & tauRelax_MxL<>-1 ). |
| 170 |
|
o pkg/offline: |
| 171 |
|
- change where Offline-Fields are loaded, from load_fields_driver.F to |
| 172 |
|
directly within FORWARD_STEP, just after updating iter number and time; |
| 173 |
|
- move setting of GM and KPP diffusivity out of OFFLINE_FIELDS_LOAD into new |
| 174 |
|
S/R OFFLINE_GET_DIFFUS that is called towards the end of DO_OCEANIC_PHYS; |
| 175 |
|
These changes allow: |
| 176 |
|
a) to recover exactly on-line results using deltaToffline=deltaTClock, |
| 177 |
|
tested (using offlineIter0= nIter0 -1 and offlineTimeOffset= -deltaT/2) |
| 178 |
|
both with Lin & Non-Lin Free-Surf, both with staggerTimeStep & synchronous |
| 179 |
|
time-step, both with GM & KPP files and with recomputing these fields; |
| 180 |
|
b) no needs to switch on staggerTimeStep anymore; |
| 181 |
|
c) simplify rescaling of offline horiz. velocity with Non-Lin Free-Surf. |
| 182 |
|
- update output of experiment tutorial_dic_adjoffline (only 3 digits left). |
| 183 |
|
o pkg/offline: |
| 184 |
|
- change (rarely used) offset-iteration parameter to an offset time (in s): |
| 185 |
|
can easily recover previous offset-iter effect by setting offset-time |
| 186 |
|
(offlineTimeOffset) to offset-iter x deltaToffline; |
| 187 |
|
- do not turn-off Temp & Salinity surface relaxation when using KPP (used |
| 188 |
|
in KPP as part of surface buoyancy forcing) in offline run. |
| 189 |
|
- fix ptracers KPP non-local term in the case where KPP is re-computed. |
| 190 |
|
o OpenAD |
| 191 |
|
- Adding preliminary ggl90 test to OpenAD verification. |
| 192 |
|
Config. with ggl90 currently diverges after 64 time steps |
| 193 |
|
so will need more work to become more stable |
| 194 |
|
- Adding preliminary kpp test to OpenAD verification. |
| 195 |
|
required small tweakes in kpp_routines.F |
| 196 |
|
- Merge and update from Krishna Narayanan's contrib area: |
| 197 |
|
* Add one variable for preliminary OpenAD DIVA |
| 198 |
|
* Add replacement time-stepping for OpenAD DIVA |
| 199 |
|
* genmake2 flag -diva (but only for OpenAD; preliminary) |
| 200 |
|
* required modifs for OAD_support |
| 201 |
|
successful preliminary test for tutorial_global_oce_biogeo/ |
| 202 |
|
o pkg/seaice: |
| 203 |
|
- initialise deltaC in seaice_lsr, cosmetic changes in seaice_lsr |
| 204 |
|
- add cpp-flag SEAICE_DELTA_SMOOTHREG for option of regularising |
| 205 |
|
delta with a smooth function in s/r seaice_calc_viscosity |
| 206 |
|
(no effect on EVP) |
| 207 |
|
- rename local suffix "sqr" into "sq" for more consistent variable names |
| 208 |
|
o pkg/seaice: |
| 209 |
|
add new parameter SEAICE_deltaMin that is used ***only*** |
| 210 |
|
for regularizing Delta (and nothing else, like the parameter |
| 211 |
|
which is also used for all sorts of things SEAICE_EPS). |
| 212 |
|
Defaults to SEAICE_EPS for backward compatibility only. |
| 213 |
|
o pkg/seaice: replace erroneously storing e12Csqr on the wrong tape with |
| 214 |
|
the wrong key by inialising it before use -> fixes a recomputation |
| 215 |
|
problem but does not fix the gradient |
| 216 |
|
o pkg/layers: |
| 217 |
|
- move resetting of flux arrays to outside the iLa loop |
| 218 |
|
(this caused layers_diapycnal to not work with more than one layer coord.) |
| 219 |
|
- fix bug in calculation of layers_recip_delta in layers_init_fixed.F |
| 220 |
|
o pkg/layers: |
| 221 |
|
- remove from common block 3D layers fields (used to diagnose transport |
| 222 |
|
in tracer coords) and declare them as local arrays in layers_calc.F |
| 223 |
|
o pkg/seaice: |
| 224 |
|
- Rename SEAICE_VECTORIZE_LSR_ZEBRA to SEAICE_LSR_ZEBRA and define it |
| 225 |
|
in lab_sea forward experiment (changes results -> updated) |
| 226 |
|
- update adjoint experiment lab_sea after cleaning up seaice_lsr_tridiagu/v |
| 227 |
|
o pkg/seaice: modify seaice_lsr.F in order to improve the gradient |
| 228 |
|
computations; for SEAICE_VECTORIZE_LSR |
| 229 |
|
- move the loops over which the tridiagonal solvers (seaice_lsr_tridiagu/v) |
| 230 |
|
sweep to the outside, |
| 231 |
|
- remove store directives and add "CADJ loop sequential" directives |
| 232 |
|
in analogy to model/src/solve_tridiagonal.F |
| 233 |
|
- replace many "#ifdef SEAICE_VECTORIZE_LSR_ZEBRA" by variable loop |
| 234 |
|
boundaries to yield more readable code. This has also the charming side |
| 235 |
|
effect that your can use SEAICE_VECTORIZE_LSR_ZEBRA without |
| 236 |
|
SEAICE_VECTORIZE_LSR (i.e. adjoint without recomputations in |
| 237 |
|
seaice_lsr_tridiagu/v now requires either of these flags, vectorization |
| 238 |
|
still requires SEAICE_VECTORIZE_LSR with SEAICE_VECTORIZE_LSR_ZEBRA as |
| 239 |
|
an additional option) |
| 240 |
|
The tridiagonal solvers are now completely analoguous to solve_tridiagonal.F |
| 241 |
|
but the adjoint gradients (which are affected by this change) still explode. |
| 242 |
|
o coupler (atm & ocn _compon_interf): |
| 243 |
|
- avoid using Exch2 IO mapping if not suitable. |
| 244 |
|
|
| 245 |
|
checkpoint65m (2015/06/15) |
| 246 |
|
o pkg/layers: |
| 247 |
|
- clean-up old parameters setting (from Sep 2012): |
| 248 |
|
+ remove old parameters setting from common block (declared locally); |
| 249 |
|
+ stop if any old parameter is mixed with new parameters; |
| 250 |
|
+ check for valid or consistent parameter setting (e.g., layers_name) |
| 251 |
|
- check that layers_bounds for Pot.Density are in the right range; |
| 252 |
|
this is supposed to catch un-updated setting after recently shifting |
| 253 |
|
potential density field "prho" by -1000 (now in "sigma" scale). |
| 254 |
o pkg/layers: |
o pkg/layers: |
| 255 |
- Added missing call to layers_fill for keeping track of tottend in |
- Added missing call to layers_fill for keeping track of tottend in |
| 256 |
pkg/diagnostics/diagnostics_fill_state.F |
pkg/diagnostics/diagnostics_fill_state.F |
| 268 |
thermodynamics.F, impldiff.F) and gad to save the necessary fields |
thermodynamics.F, impldiff.F) and gad to save the necessary fields |
| 269 |
for layers_thermodynamics calculations |
for layers_thermodynamics calculations |
| 270 |
o pkg/ptracers: |
o pkg/ptracers: |
| 271 |
- add capability of stepping a passive tracer forward |
- add capability of stepping a passive tracer forward without advection |
| 272 |
without advection by setting PTRACERS_advScheme to 0. |
by setting PTRACERS_advScheme to 0. |
| 273 |
o pkg/diagnostics: |
o pkg/diagnostics: |
| 274 |
- add few (threads) _BARRIER around any update of "diag_pkgStatus". |
- add few (threads) _BARRIER around any update of "diag_pkgStatus". |
| 275 |
o pkg/layers: |
o pkg/layers: |
Parent Directory
| 
Revision Log
| 
Revision Graph
| 
Patch