| 4 |
Notes on tags used in MITgcmUV |
Notes on tags used in MITgcmUV |
| 5 |
============================== |
============================== |
| 6 |
|
|
| 7 |
|
o pkg/exf: |
| 8 |
|
- change CPP option EXF_VERBOSE to run-time logical param exf_verbose. |
| 9 |
|
o pkg/seaice: |
| 10 |
|
- seaice_ocean_stress: split a loop for better vectorization of the |
| 11 |
|
adjoint code |
| 12 |
|
- seaice_growth.F: fix bug in conservation of freshwater connected to |
| 13 |
|
capping of heff, put contribution into d_HEFFbyNEG |
| 14 |
|
- replace irritating parameters SEAICE_latentWater/Ice and SEAICE_sensHeat |
| 15 |
|
by something more sensible (parameters that are what their name implies) |
| 16 |
|
- change some defaults, so that by default exf-parameters are used for |
| 17 |
|
things like rhoAir, cpAir,latent/sensible heat parameters, in order |
| 18 |
|
to reproduce the old results, many data.seaice now contain funny values |
| 19 |
|
for cpAir and latent heat of sublimation |
| 20 |
|
o packages_readparms.F: move exf_readparms up in line so that |
| 21 |
|
exf-parameters are visible for other packages (e.g. seaice) |
| 22 |
|
o debugMode & debugLevel=2: |
| 23 |
|
- differentiate between debugMode & debugLevel=2: |
| 24 |
|
debugMode: controls printing of debug messages (sequence of S/R calls). |
| 25 |
|
debugLevel: controls printing of algorithm intermediate results and stats. |
| 26 |
|
- remove "if debugLevel=2 => debugMode" but keep "debugMode => debugLevel=2"; |
| 27 |
|
=> allows to print debug-stats without all sequence of call messages. |
| 28 |
|
- switch control of debug print from debugLevel to debugMode in many S/R. |
| 29 |
|
o pkg/obcs (obcs-sponge): |
| 30 |
|
fix bug that was introduced on Oct 25 (in dynamics.F v1.151): put back the |
| 31 |
|
call to OBCS_PRESCRIBE_EXCHANGES (need to exch gU,gV when using obcs-sponge) |
| 32 |
|
o pkg/generic_advdiff: |
| 33 |
|
- record overlap minimum size for each advection scheme; |
| 34 |
|
- refine criteria on overlap minimum size; |
| 35 |
|
- check and stop (in gad_check) if overlap size is too small. |
| 36 |
|
o pkg/obcs: |
| 37 |
|
- with ptracers: remove multiple calls to obcs_apply_ptracer (only done |
| 38 |
|
once, in ptracers_implicit.F) |
| 39 |
|
- with seaice: remove test on empty file name in obcs_apply_seaice (always |
| 40 |
|
apply OB values when tile has OB) |
| 41 |
|
o model/src, coriolis setting: |
| 42 |
|
- integer parameter "selectCoriMap" (=0,1,2) replaces 3 logical |
| 43 |
|
useConstantF, useBetaPlaneF, useSphereF ; can now read coriolis from |
| 44 |
|
files (selectCoriMap=3) with any grid. |
| 45 |
|
- add parameter "fPrime" for constant second Coriolis coeff (default=0). |
| 46 |
|
o pkg/seaice/seaice_growth.F: |
| 47 |
|
a few cosmetic changes that reduce the number of lines of code |
| 48 |
|
o pkg/obcs: add boundary conditions following Stevens (1990) |
| 49 |
|
- the code follows old MOM/NAOSIM code |
| 50 |
|
- so far it is only implemented for the eastern and western boundaries |
| 51 |
|
and NOT for pTracers |
| 52 |
|
o pkg/rbcs: |
| 53 |
|
- replace rbcsInIter by rbcsForcingOffset, the time in seconds at the |
| 54 |
|
beginning of the first rbcs forcing period. |
| 55 |
|
- add option rbcsSingleTimeFiles that makes rbcs read forcing data like the |
| 56 |
|
offline package, i.e., one file per time, labeled by iteration number; |
| 57 |
|
deltaTrbcs sets the timestep with which the data was generated; |
| 58 |
|
rbcsIter0 is the forcing iteration corresponding to rbcsForcingOffset. |
| 59 |
|
- rbcsForcingCycle=0 makes forcing non-cyclic. |
| 60 |
|
- make arithmetic safe for negative times and odd forcing periods. |
| 61 |
|
|
| 62 |
|
checkpoint62n (2010/11/09) |
| 63 |
|
o pkg/seaice: |
| 64 |
|
fix masking in free-drift S/R ; update results of exp. lab_sea.fd |
| 65 |
|
o pkg/obcs: |
| 66 |
|
New S/R to copy tracer value from the OB location to narrow band region |
| 67 |
|
(width = same as overlap) beyond the OB: preserve OB value (needed for |
| 68 |
|
high-order scheme) which were overwritten by EXCH call if in overlap |
| 69 |
|
region. Applied to theta, salt, ptracer and advected seaice variables. |
| 70 |
|
With seaice: use maskInC in similar way as in gad_advection.F, |
| 71 |
|
in seaice_advection.F and advect.F. |
| 72 |
|
Update output of experiment seaice_obcs and change exp4 to test OBCS with |
| 73 |
|
4th order Adv.Scheme. for pasive salt and ptracer. |
| 74 |
|
o tools/genmake2: |
| 75 |
|
- when looking for an optfile (not specified), only search for Fortran compiler |
| 76 |
|
(remove sym-link test + setting of CPP + makedepend check + C-compiler check) |
| 77 |
|
- in get_fortran_c_namemangling: use "$CC $CFLAG" to compile C test programm |
| 78 |
|
(instead of "$MAKE genmake_test.o" since an existing Makefile can be wrong) |
| 79 |
|
- set default for CPP to "cpp -traditional -P" (was the case without specifying |
| 80 |
|
an optfile, but otherwise default was just "cpp". |
| 81 |
|
- comment out PLATFORM=$p_PLATFORM (no idea where p_PLATFORM comes from) |
| 82 |
|
- when "CC" is not set in the optfile, look for possible C compiler |
| 83 |
|
(instead of just setting CC=cc) |
| 84 |
|
- put back version v.169 modif (from 2008/02/15), was dropped in v.173 changes: |
| 85 |
|
=> add a ".F" to ".o" rule for source files with no "#include" (such as |
| 86 |
|
port_rand.F); otherwise, default ignores FOPTIM and just uses FFLAGS. |
| 87 |
|
- move gfortran before g77 in list of possible Fortran compiler (consistent |
| 88 |
|
with reference compiler switch from g77 to gfortran) |
| 89 |
|
o pkg/seaice: |
| 90 |
|
o remove SEAICE_OLD_AND_BAD_DISCRETIZATION-code, add a test to |
| 91 |
|
seaice_check that stops the model, when the CPP flag is used. |
| 92 |
|
o seaice_growth.F: make capping of ice volume conserving by returning the |
| 93 |
|
capped ice as freshwater to EmPmR. This does not change the verification |
| 94 |
|
experiments but will change runs where the capping is acutally active |
| 95 |
|
o change reference platform+compiler from faulks+g77 to baudelaire+gfortran |
| 96 |
|
(except the 2 fizhi test exp.); update output of exp.: bottom_ctrl_5x5, |
| 97 |
|
global_ocean.cs32x15 (icedyn, thsice, AD thsice), global_ocean_ebm (AD), |
| 98 |
|
lab_sea (fd, hb87, salt_plume), MLAdjust (3/5) and vermix (dd) |
| 99 |
|
o tools/genmake2: |
| 100 |
|
- merge genmake_warnings & genmake_errors into 1 log file: "genmake.log") |
| 101 |
|
- change DUMPSTATE default to false (can use "-ds" option to switch it to T) |
| 102 |
|
- clean previous genmake log files before anything else. |
| 103 |
|
- change Makefile to remove testreport log files (*.tr_log) and genmake log |
| 104 |
|
files only with "CLEAN" target (instead of "Clean"); |
| 105 |
|
o pkg/generic_advdiff: |
| 106 |
|
Change OBCS in multiDim advection (gad_advection.F): |
| 107 |
|
Use maskInC to prevent intermediate update of tracer-field in OB regions, |
| 108 |
|
thus keeping current-time-step OB values; and remove the call to OBCS_APPLY |
| 109 |
|
which were applying future time-step OB values. |
| 110 |
|
This way, all explicit calculations use current-time-step OB values |
| 111 |
|
(simpler and more consistent). |
| 112 |
|
Affects results when set-up uses time-varying OBC and multi-dim advection; |
| 113 |
|
update output of experiment seaice_obcs. |
| 114 |
|
o pkg/seaice: |
| 115 |
|
move OPTIONS (formerly locally defined) to SEAICE_OPTIONS.h: |
| 116 |
|
this includes SEAICE_GROWTH_LEGACY (+ SEAICE_DO_OPEN_WATER_GROWTH & |
| 117 |
|
SEAICE_OCN_MELT_ACT_ON_AREA ) and SEAICE_SOLVE4TEMP_LEGACY. |
| 118 |
|
Default (pkg/seaice/SEAICE_OPTIONS.h) is to define SEAICE_SOLVE4TEMP_LEGACY |
| 119 |
|
but leave SEAICE_GROWTH_LEGACY undef ; For now, keep verification exp |
| 120 |
|
unchanged (SEAICE_GROWTH_LEGACY defined in */code*/SEAICE_OPTIONS.h) |
| 121 |
|
o pkg aim (2010/10/26): |
| 122 |
|
- Introduce ALLOW_INSOLATION, moving toward a more general incoming solar radiation |
| 123 |
|
formulation with obliquity, eccentricity, ... as run-time parameters, |
| 124 |
|
- Introduce diagnostics for top-of-the-atmaophere incoming solar radiation and |
| 125 |
|
upward shortwave radition at the surface (all-sky and clear-sky). |
| 126 |
|
o pkg/obcs: |
| 127 |
|
- writing sections with globalFiles=T does not work: switch to tiled-files |
| 128 |
|
when writing sections for OBCS (change pkg/rw/write_rec.F accordingly). |
| 129 |
|
- fix index bug (OB_Ie -> OB_Iw_) in obcs_apply_uvice.F |
| 130 |
|
- apply OBCS_SEAICE_COMPUTE_UVICE to both uice and vice at all obcs |
| 131 |
|
|
| 132 |
|
checkpoint62m (2010/10/21) |
| 133 |
|
o pkg/seaice: vectorize seaice_solve4temp.F |
| 134 |
|
- move iterations loops outside of i/j-loops |
| 135 |
|
- requires 2D arrays for TB and effConduct |
| 136 |
|
- add 2D iceOrNot to replace HICE_ACTUAL.GT.0, as HICE_ACTUAL is |
| 137 |
|
modified in this routine |
| 138 |
|
- a little bit of clean up, adjusting indentation, etc. |
| 139 |
|
- replaced a few TEN**a by exp(a*log(10.)) in new code for better |
| 140 |
|
performance and '**TWO' by '**2' (because TWO is a float), |
| 141 |
|
replaced ONE, ZERO |
| 142 |
|
o eesupp/src: |
| 143 |
|
fix flow dir for exch1_z_RX_cube, exch1_uv_RX_cube & exch1_bg_RX_cube |
| 144 |
|
o pkg/seaice/seaice_growth.F |
| 145 |
|
Revision 1.89 of seaice_growth.F completes the overall october 2010 revision and |
| 146 |
|
merging process. The merged routine has two branches, and one activates the 'evolution' |
| 147 |
|
branch by setting SEAICE_GROWTH_LEGACY to undef (at the top of the routine for now). |
| 148 |
|
In summary, here is what the '10/10 revision' did consist of |
| 149 |
|
part 1: seaice_growth.F revisions 1.71 to 1.75 |
| 150 |
|
- Preliminary seaice_growth.F clean-up, keeping test results strictly unchanged. |
| 151 |
|
The emphasis here was on improving readability (e.g. by trying to use meaningful |
| 152 |
|
variable names) and modularity (e.g. by adding arrays to store heff etc. updates). |
| 153 |
|
part 1.5: |
| 154 |
|
- revising the lab_sea experiment to make it a more useful (i.e. stable |
| 155 |
|
and representative of an actual model run). This was done by generating a |
| 156 |
|
(winter) pickup to start from, switching back the main experiment dynamic |
| 157 |
|
solver from evp to lsr, having one of the experiments use the free drift solution. |
| 158 |
|
part 2: seaice_growth.F revisions 1.76 to 1.85 |
| 159 |
|
- Sorting out hard-coded constants that prevented heat and fresh water conservation. |
| 160 |
|
- Sorting out the various fields units and sign (set early on and reset at the end) |
| 161 |
|
to avoid numerous scalings/re-scalings. By v1.85 the basic unit for ice, heat and |
| 162 |
|
fresh water stock is 'effective ice meters', and >0 implies more ice/snow. |
| 163 |
|
- Using tendency terms arrays (d_HEFF* etc.) to alleviate remaining code locks, |
| 164 |
|
and simplifying logical expressions to further improve readibility. |
| 165 |
|
part 3: seaice_growth.F revisions 1.86 to 1.89 |
| 166 |
|
- Re-organize the blocks of code more logically. |
| 167 |
|
- Merging the '_if.F' pieces that add something new. |
| 168 |
|
o pkg/thsice: |
| 169 |
|
- vectorize thsice_solve4temp and thsice_get_exf. |
| 170 |
|
Problem: thsice_solve4temp has an unvectorizable statement that |
| 171 |
|
might also be problematic for TAF |
| 172 |
|
- thsice_get_exf: add the ALLOW_BULK_LARGEYEAGER04 CPP-flag. This |
| 173 |
|
does not change the verifcation experiment, but will change all |
| 174 |
|
experiments that have this flag undefined (not tested in verification); |
| 175 |
|
a little reorganization to save a few 2D fields and recomputations |
| 176 |
|
- 1st step of revisiting thsice adjoint (major recomp. sorted out) |
| 177 |
|
- 2nd step: fix some store dirs |
| 178 |
|
o seems to work somewhat, i.e. using ifort but not g77 |
| 179 |
|
o likely cause are incomplete init. or recomputation |
| 180 |
|
o start verification/global_ocean.cs32x15/input_ad.thsice |
| 181 |
|
o pkg/obcs: add support for exch2 |
| 182 |
|
- the position of the boundary and prescribed values are specified using |
| 183 |
|
a global domain with exch2 facets stacked |
| 184 |
|
- in x for N,S boundaries (like W2_mapIO=-1) |
| 185 |
|
- in y for E,W boundaries (so E,W boundaries do not overlap) |
| 186 |
|
o pkg/mdsio: add support for writing global sections with exch2 |
| 187 |
|
file layout is as for obcs described above: |
| 188 |
|
- for x-z sections, facets are stacked in x (like W2_mapIO=-1) |
| 189 |
|
- for y-z sections, facets are stacked in y |
| 190 |
|
o pkg/thsice: |
| 191 |
|
- change a few routines for better vectorization: thsice_albedo.F, |
| 192 |
|
thsice_step_temp.F, and in thsice_calc_thickn.F. Results are |
| 193 |
|
not affected, but in particular the latter routine has changed |
| 194 |
|
dramatically (not necessarily easier to read now). |
| 195 |
|
- re-arrange calculation in THSICE_SOLVE4TEMP: move outside of i,j loops |
| 196 |
|
iteration loop and call to S/R THSICE_GET_BULKF & THSICE_GET_EXF. |
| 197 |
|
o verification/lab_sea: |
| 198 |
|
- overhaul of the forward model experiments. The main motivation |
| 199 |
|
for this revision is that lab_sea has proven quite fragile (when |
| 200 |
|
changing the sea-ice code, and switching platforms) to a point |
| 201 |
|
when failures were very hard to attribute to specific code problems. |
| 202 |
|
- the suspected reason for this fragility is noise amplification by evp so, |
| 203 |
|
to start with, we decided to replace evp with lsr in the main experiment. |
| 204 |
|
- the input.lsr experiment thus became obsolete and was removed. |
| 205 |
|
- it was replaced with the input.fd experiment that uses an |
| 206 |
|
analytical "free drift" solution as the ice velocity field. |
| 207 |
|
- Taken together, input (lsr), input.fd (free drift) and input.hb87 (evp) |
| 208 |
|
will hopefully allow us to discriminate problems due to dynamic solvers |
| 209 |
|
from problems due to the thermodynamic code. input.salt_plume (lsr) allows |
| 210 |
|
us to test additional options, along with the salt plume package. |
| 211 |
|
- Finally a pickup was generated (at the end of a one year run) to |
| 212 |
|
make the tests more representative of an actual model run. Previously |
| 213 |
|
the tests starting point was a 1m thickness of ice everywhere. |
| 214 |
|
o pkg/seaice: |
| 215 |
|
- introducing S\R seaice_freedrift.F that compute the |
| 216 |
|
analytical solution to an approximate ice momentum |
| 217 |
|
equation (i.e. the simple stress/coriolis balance). |
| 218 |
|
- define SEAICE_ALLOW_FREEDRIFT to trigger the computation |
| 219 |
|
of the free drift velocity field, and enable its use. |
| 220 |
|
To actually use the free drift solution as the model ice |
| 221 |
|
velocity field set SEAICEuseFREEDRIFT to .TRUE. in data.seaice. |
| 222 |
|
o move "useOASIS" from PARAMS.h to EEPARAMS.h and read it from "eedata" |
| 223 |
|
|
| 224 |
|
checkpoint62l (2010/10/04) |
| 225 |
|
o pkg/seaice: |
| 226 |
|
-fix the USE_ORIGINAL_SBI version (for variable freezing point); |
| 227 |
|
-use "celsius2K" in SEAICE_VARIABLE_FREEZING_POINT and in new |
| 228 |
|
version (with USE_ORIGINAL_SBI undef); |
| 229 |
|
o add hooks for new packages OASIS, the package will follow |
| 230 |
|
(hooks exclude the seaice pkg for now) |
| 231 |
|
o pkg/autodiff: ALLOW_AUTODIFF_WHTAPEIO |
| 232 |
|
Option to use mdsio_read_whalos.F/mdsio_write_whalos.F, |
| 233 |
|
rather than mdsio_readvector.F/mdsio_writevector.F, within |
| 234 |
|
adread_adwrite.F to read/write adjoint-related tapes to disk. |
| 235 |
|
o eesupp and pkg/mdsio: ALLOW_WHIO |
| 236 |
|
Option to write/read 2D fields to files including tiles halos. |
| 237 |
|
The main purpose is for adjoint related "tape I/O". |
| 238 |
|
The secondary purpose is for debugging phases. |
| 239 |
|
A word on those rather specifically intended purposes. |
| 240 |
|
The code was meant to be stripped down to the bare minimum. |
| 241 |
|
Typically, there is a unique and basic mapping to the global |
| 242 |
|
buffer (tile by tile, then proc by proc, then level by level), and |
| 243 |
|
byteswaps and meta-files are omitted. Indeed the (*_WH*) code is not |
| 244 |
|
meant to generate user friendly outputs of various shapes and forms. |
| 245 |
|
Rather it is intended, for the knowledgeabale developers, |
| 246 |
|
to be largely independent of the many mdsio options, to allow |
| 247 |
|
outputs of tiles+halos in debugging phases and in adjoint runs, |
| 248 |
|
and to allow some flexibility in tuning (adoint) I/O depending on each |
| 249 |
|
file system behavior. With regard to tuning, most of the potential knobs |
| 250 |
|
(to leave files open, to allocate the I/O indep. of usesinglecpuio, |
| 251 |
|
to specify directories, to specify the typical size of I/O calls, etc.) |
| 252 |
|
are not yet included, and will be added if they prove useful. |
| 253 |
|
o pkg/seaice: |
| 254 |
|
fix uninitialised arrays in USE_ORIGINAL_SBI version of seaice_solve4temp.F |
| 255 |
|
o pkg/seaice: |
| 256 |
|
new S/R seaice_solve4temp.F: this is the merged version of Ian Fenty |
| 257 |
|
code (seaice_budget_ice_if.F) which enable to recover old standard |
| 258 |
|
code (seaice_budget_ice.F) when option USE_ORIGINAL_SBI is defined. |
| 259 |
|
temporary: add "#define USE_ORIGINAL_SBI" at the top of seaice_solve4temp.F. |
| 260 |
|
o model/src (rStar): |
| 261 |
|
use simple average (not area weighted) of rStarFac at U,V point when using |
| 262 |
|
vectorInvariant and selectKEscheme=1,3 (consistent with mom. vertical advection) |
| 263 |
|
update output of exp. fizhi-cs-32x32x40 and fizhi-cs-aqualev20. |
| 264 |
|
|
| 265 |
|
checkpoint62k (2010/09/17) |
| 266 |
|
o adjoint |
| 267 |
|
* changed verification/global_ocean.cs32x15 ; adjoint now tests |
| 268 |
|
Adams-Bashforth 3 + NLFS + RSTAR |
| 269 |
|
* some more modifs required for ECCO-GODAE v4 |
| 270 |
|
o pkg/seaice |
| 271 |
|
add SEAICE_AGE_VOL option to use volume instead of area for |
| 272 |
|
integrating SEAICE_AGE |
| 273 |
|
o model/src: |
| 274 |
|
first check-in of sigma & hybrid-sigma coordinate code ; also includes |
| 275 |
|
non-linear free-surface parts ; but pressure-gradient not yet coded. |
| 276 |
|
o pkg/ptracers: |
| 277 |
|
option for ptracer to convert Salt Relax into additional EmP. |
| 278 |
|
tested in exp. global_ocean.90x40x15.dwnslp (update output) |
| 279 |
|
|
| 280 |
|
checkpoint62j (2010/08/25) |
| 281 |
|
o pkg/ggl90: |
| 282 |
|
other minor changes: remove 3-D temp array gTKE (+ add argument myIter) |
| 283 |
|
o pkg/dic: car_flux.F, phos_flux.F |
| 284 |
|
- reduce number of exp-calls in order to improve performance |
| 285 |
|
- clean up a little (replace fields by their macros, etc., fix |
| 286 |
|
typo in CPP-flag) |
| 287 |
o pkg/ggl90: minor changes |
o pkg/ggl90: minor changes |
| 288 |
- GGL90diffKrS was removed --> always use GGL90diffKr |
- GGL90diffKrS was removed --> always use GGL90diffKr |
| 289 |
- GGL90viscAr was removed --> replaced with GGL90viscArU, GGL90viscArV |
- GGL90viscAr was removed --> replaced with GGL90viscArU, GGL90viscArV |
| 290 |
- hack of mxlMaxFlag=2 --> ensure mixing between first and second level (commented out for now) |
- hack of mxlMaxFlag=2 --> ensure mixing between first and second level |
| 291 |
|
(commented out for now) |
| 292 |
- change in max/min operations to ensure that smoothing is ok |
- change in max/min operations to ensure that smoothing is ok |
| 293 |
- smoothing of GGL90viscAr was moved to ggl90_calc.F (as done for GGL90diffKr) |
- smoothing of GGL90viscAr was moved to ggl90_calc.F (as done for GGL90diffKr) |
| 294 |
- always use diffKrNrT as background profile (i.e. never use diffKr field) |
- always use diffKrNrT as background profile (i.e. never use diffKr field) |
| 539 |
but keep the former optfile for few weeks for smooth transition |
but keep the former optfile for few weeks for smooth transition |
| 540 |
o pkg/ecco |
o pkg/ecco |
| 541 |
- allow user defined cost function contributions |
- allow user defined cost function contributions |
| 542 |
CPP: ALLOW_USERCOST_CONTRIBUTION |
CPP: ALLOW_USERCOST_CONTRIBUTION |
| 543 |
USAGE: compute contributions in cost_usercost_all.F |
USAGE: compute contributions in cost_usercost_all.F |
| 544 |
- note: this is identical to what ALLOW_GENCOST_CONTRIBUTION once was. |
- note: this is identical to what ALLOW_GENCOST_CONTRIBUTION once was. |
| 545 |
the two options are complementary. |
the two options are complementary. |
| 546 |
o pkg/smooth |
o pkg/smooth |
Parent Directory
| 
Revision Log
| 
Revision Graph
| 
Patch