/[MITgcm]/MITgcm/doc/tag-index
ViewVC logotype

Diff of /MITgcm/doc/tag-index

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph | View Patch Patch

revision 1.1753 by jmc, Fri Oct 19 18:52:53 2012 UTC revision 1.1807 by mlosch, Wed Jan 16 21:20:56 2013 UTC
# Line 4  $Name$ Line 4  $Name$
4      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
5      ==============================      ==============================
6    
7    o pkg/seaice: add a line search option to the JFNK solver
8    o pkg/mdsio:
9      - write missing value (corresponding to undefined array value) to meta files;
10        skip this if missing value is one (UNSET_RL would be a better value for the
11        case of undefined missing value but it's current the default missing-value);
12        Also update mdsio_read_meta.F (reading timeInterval & missing-value).
13    o pkg/exf & thsice:
14      - for diagnostics purpose, fill-up and update Qsw array (+ fill the diagnostics)
15        even when SHORTWAVE_HEATING is #undef;
16    o verification/cfc_example:
17      - turn on pkg/layers with pkg/diagnostics (to test pkg/layers and to illustrate
18        how to use it).
19    o verification/offline_exf_seaice:
20      in input: add SEAICErestoreUnderIce=.TRUE., and reduce size of forcing
21        files to only one time-record.
22      in input.thermo: narrow the 2 bands of low initial ice-concentration near
23        N & S edges; switch on SEAICErestoreUnderIce=T; use pkg/diagnostics for
24        snapshot output; same mcPheePiston value as in thsice with surf-current=0.2m/s.
25      in input.thsice: similar set-up as in input.thermo (channel with same seaice
26        initial conditions).
27    o verification/cfc_example:
28      - update file "data" with more standard choice (default rotationPeriod,
29        exactConserv=T, reduce ivdc_kappa to 10, remove multiDimAdvection=F,
30        set deltaTFreeSurf to deltaTtracer) and update the output.
31    o pkg/layers:
32      - fix bolus part so that it compiles with #undef GM_BOLUS_ADVEC;
33      - ensure that "layers_bolus" is switched to False when useGMRedi=False.
34    o verification/offline_exf_seaice:
35      - set all {field}period to zero for constant-in-time forcing (not tested
36        anywhere else).
37    o verification/offline_exf_seaice:
38      - dyn_lsr  : use pkg/seaice S/R (instead of pkg/thsice) to advect sea-ice;
39      - dyn_jfnk : use pkg/thsice S/R (instead of pkg/seaice) to advect sea-ice.
40    o model/src:
41      - implement Finite-Volume method for (hydrostatic) presure gradient
42        from S.-J. Lin (QJRMS 1997), for atmosphere using sigma-coordinate.
43    o pkg/seaice: implement EVP* by Lemieux et al. (2012).
44      - In order to be compatible with the default EVP code, this requires changing
45        the EVP code around a little; and because any small change immediately
46        breaks the lab_sea.hb87 verification experiment, the reference output is
47        updated two times (each time the remaining aggrement was only 2 digits):
48        - after replacing 1/dt by 1*recip_dt with a precomputed recip_dt
49        - after replacing 1/(1+0.5*dt/tau) by a/(a+1), with a=2*tau/dt
50        The adjoint test lab_sea.evp also needed to be updated.
51      - Turn on EVP* by setting SEAICE_deltaTevp as before, and setting
52        SEAICEuseEVPstar=.true.; for EVP* SEAICE_deltaTevp does not need to be
53        a factor of SEAICE_deltaTdyn, and you can set the number of EVP steps
54        explicitly with SEAICEnEVPstarSteps (thereby overriding the default of
55        INT(SEAICE_deltaTdyn/SEAICE_deltaTevp)). Controlling EVP* is deliberately
56        kept obscure, because I need to test it a little more.
57    o pkg/cheapaml:
58      - fix few incorrect type (_RL/_RS) in subroutine calls.
59    o pkg/seaice:
60      - new S/R SEAICE_MAP_RS2VEC (similar to SEAICE_MAP2VEC) to map _RS arrays
61        to _RL vector; this fixes JFNK code when compiling with "-use_r4" option.
62    o model/src:
63      - add a warning if using select_rStar=2 with nonlinFreeSurf <> 4;
64        change (in input_ad*/data) select_rStar from 2 to 1 for AD verification
65        experiments global_ocean.cs32x15 & tutorial_tracer_adjsens (+ update output)
66    o pkg/cheapaml:
67      - replace "273.1 _d 0" by celsius2K in pkg/cheapaml/cheapaml.F and
68        update output of experiment cheapAML_box.
69      - store in CHEAPAML.h coeffs ssq[0:2] for saturation specific humidity,
70        and set them only in one place (cheapaml_readparms.F).
71      - replace "273.16 _d 0" by celsius2K & replace "3.14159 _d 0" by constant "PI"
72      - remove re-setting of main-model parameter "celsius2K" (in cheapaml_readparms)
73        and re-setting of cheapAML params "lath" & "p0" (in cheapaml_init_varia).
74    o model/src/the_main_loop.F:
75      - fix revision 129 : need both ALLOW_ECCO and ALLOW_ECCO_EVOLUTION.
76    o pkg/seaice:
77      - remove legacy branch code.
78      - retire SEAICE_GROWTH_LEGACY and SEAICE_CAP_HEFF accordingly.
79    o verification/*/code*/SEAICE_OPTIONS.h:
80      - remove documentation for retired CPP flags (SEAICE_GROWTH_LEGACY,
81        SEAICE_CAP_HEFF).
82    o pkg/cheapaml:
83      - use standard routine (S/R GET_PERIODIC_INTERVAL) to decide when it is time
84        to load new forcing fields.
85      - add missing "_d 0" where it's needed; + some editing (improve indentation).
86      - remove switch to "-r8" compiler option (no longer needed) in verification
87        cheapAML_box, keep same output (small trucation error differences).
88    o verification/offline_exf_seaice:
89      - add thermodynamics only test.
90    o verification/cheapAML_box:
91      - split the domain in 8 (2x4) tiles; add MPI and multi-threaded test;
92        keep same output (same 14 digits for cg2d).
93      - switch on "-r8" compiler option (some numerical values are missing
94        the "_d 0") and update output (only 6 digits for cg2d were preserved).
95    
96    checkpoint64b (2012/12/24)
97    o pkg/cheapaml:
98      - remove un-used variables (Qnet,EmPmR) from pickup files.
99      - store tendency of advected variables into cheapaml pickup file
100        and fix the AB-2 restart.
101    o verification/offline_exf_seaice and lab_sea adjoint:
102      - switch to new code (#undef SEAICE_GROWTH_LEGACY).
103      - switch to 4 time steps in offline, consistent with lab_sea.
104      - match parameters from SEAICE_GROWTH_LEGACY branch in data.seaice.
105      - update results after change of experiment seaice.
106    o pkg/seaice:
107      - remove option SEAICE_MULTICATEGORY; has been replaced with run-time
108        parameter SEAICE_multDim. Issue a warning if SEAICE_MULTICATEGORY is
109        still defined since SEAICE_multDim needs to be set to MULTDIM value (from
110        SEAICE_SIZE.h) to recover previous #define SEAICE_MULTICATEGORY default.
111    o model/src:
112      - add run-time parameter to select CG2D solver minimum-residual solution
113        (in case of a poor convergence).
114    o pkg/seaice/seaice_lsr.F
115      - move calculation of matrix coefficients into new
116        S/R SEAICE_CALC_LSR_COEFFS; for now this routine remains in the same
117        file; the main purpose of this change is to be able to reuse the code
118        in S/R SEAICE_PRECONDITIONER
119      - modify the computation of the residual so that the mass of sea-ice
120        is not used twice; this simplifies the calculations, but since
121        the residual is never used except when LSR_mixIniGuess.ge.4---and this is
122        not tested in testreport---this does not affect the testreport results.
123    o verification/seaice_obcs:
124      - disable SEAICE_GROWTH_LEGACY; reset input files to match those of
125        verification/lab_sea/input.salt_plume; changes results/output.txt*
126    o model/src:
127      - adapt quasi-hydrostatic formulation to work with p or p* coordinate.
128    o pkg/seaice:
129      - improve description of parameters in seaice_fgmres.F and start
130        cleaning up the code
131      - change name of SCALPROD to SEAICE_SCALPROD and modify meaning of
132        second argument
133      - add a metric based on grid cell area to SEAICE_SCALPROD; update
134        results of offline_exf_seaice.dyn_jfnk
135      - compute initial residual norm in seaice_jfnk based on SEAICE_SCALPROD
136    o pkg/aim_v23:
137      - fix an other bug in dissipation heating (grid-cell area was missing).
138    o model/src + pkg/seaice:
139      - add global (multi-tile) linear solver for pair of tri-diagonal system
140        along X and Y lines, respectively for U and V component.
141        Note: 1) MPI and cube-exchange not yet coded.
142            2) probably not accurate for poorly conditioned / large size problem.
143      - add option for SEAICE_LSR to use global (multi-tile) tri-diagonal solver;
144        default: not compiled and not used.
145    o pkg/seaice:
146      - first attempt at a multi-threaded fgmres solver for the JFNK solver:
147        introduce bi/bj loops and use global_sum_tile_rl instead of
148        mpi_allreduce in seaice_fgmres.F
149      - improve diagnostics output for fgmres solver (seaice_fgmres.F)
150      - replace a few unnecessary goto statements by if-blocks  (seaice_fgmres.F)
151      - add a verification experiment for JFNK in offline_exf_seaice
152    o verification:
153      - change (for now, only fwd test) offline_exf_seaice experiment:
154        use a re-entrant channel with idealized coastline (trapezoidal shape)
155        at southern boundary to explore seaice dynamics and thermodynamics
156        with simple forcing. Main set-up has dynamics+thermo and SST relaxation;
157        secondary test (input.thsice) use thermodynamics only with SST relaxation.
158      - add seaice-dynamics only secondary test using LSR and pkg/thsice advection.
159    o pkg/exf:
160      - disable "sstExtrapol" when Nr=1
161    o verification:
162      - add new experiment "cheapAML_box" (simple 1 layer set-up from Bruno Deremble)
163        to test pkg/cheapaml.
164    o pkg/aim_v23 & pkg/shap_filt:
165      - fix dissipation heating (erroneous gravity multiplication factor).
166    o pkg/seaice:
167      - remove unused field pressPre from jfnk solver
168      - rename two subroutines in seaice_preconditioner.F
169    o eesupp/src:
170       - S/R MDSFINDUNIT avoids reserved unit numbers (scrUnit1, eeDataUnit ...)
171    o pkg/seaice/seaice_preconditioner.F: fix preconditioner once again
172       - remove wrong parts of the rhs and the lhs (were in there
173         because I did not understand the concept of this preconditioner)
174       - add an exchange between u- and v-sweep. This increases communication
175         by a factor of two but improves the convergence of jfnk. Ideally,
176         one would like the u- and v-sweep to be independent. So far within
177         undocumented ifdefs
178       - reorganize the extra computations for printing the residuals
179    o tools/genmake2:
180      - comment out the "mpif.h" include in NetCDF test programm (for MPI built)
181        since it's not necessary (and was preventing to use MNC in some cases).
182    
183    checkpoint64a (2012/11/16)
184    o pkg/autodiff:
185      - improve pkg-internal logical parameter switch (inAd/inFwd mode) so that
186        autodiff_readparms.F no longer depends on calling order (within
187        packages_readparms.F) and no longer requires to include ${PKG}_PARMS.h):
188        rename param turnFreeDriftInAdMode to SEAICEuseFREEDRIFTswitchInAd
189        and change param SEAICEuseDYNAMICSinAdMode to SEAICEuseDYNAMICSswitchInAd.
190    o pkg/obcs:
191      - adding tidal velocity forcing capability to obcs
192        for usage example, see verification/seaice_obcs/input.tides
193    o pkg/seaice:
194      - turn the LSR-relaxation parameters WFAU/V into runtime parameters
195        SEAICE_LSRrelaxU/V
196      - introduce runtime parameter SEAICEetaZmethod (=0 by default)
197    o pkg/aim_v23:
198      - implement heating from friction (bottom friction and stratospheric drag).
199    o pkg/shap_filt:
200      - fix diagnostic "SHAP_dKE" (was 2 time smaller); implement heating from
201        dissipation but only for Shap_funct=2, active when addFrictionHeating=T.
202    o model/src:
203      - move AddMass common block from DYNVARS.h to FFIELDS.h; allow to read-in
204        time-constant addMass field from file (addMassFile);
205      - support for heating due to friction (and Kinetic Energy dissipation):
206        add option, run-time switch and 3-D field array + support code ; each pkg
207        or S/R can add heating contribution (if there is a sink of KE); the sum is
208        accounted for as a Temperature tendency term (EXTERNAL_FORCING_T).
209    o pkg/seaice:
210      - complete merge of ITD code into seaice_growth.F
211        from MITgcm_contrib/torge/itd/code/
212        no verification so far, but Torge Martin tested
213        "1-D test case and Beaufort set up;
214        deliver okay results after 1 model year."
215      - complete merge of SEAICE_SIZE.h into all relevant routines
216      - move computation of eta at Z-points into calc_viscosities
217        + introduce global field etaZ
218        + add different methods for computing etaZ, for now the old
219          method (simple averages of eta to Z-points) is hardwired
220        + replace etaMeanZ by etaZ in seaice_lsr, seaice_calc_residual,
221          seaice_preconditioner
222      - simplify computations for SEAICE_ZETA_SMOOTHREG
223      - seaice_preconditioner:
224        + replace one remaining press by pressLoc (mistake)
225        + adjust printing of residuals
226      - improve I/O of diagnostics of JFNK in seaice_jfnk.F:
227        + add (SEAICE.h) and rename some counters (initiliased in
228          seaice_init_fixed.F)
229        + add _BEGIN/END_MASTER (myThid)  around print statements
230        + print total number of iterations and failures over SEAICE_monFreq
231          interval to STDOUT
232      - move control over output-messages by fgmres to seaice_jfnk to save
233        some operations
234      - move resetting initial guess for fgmres outside of seaice_fgmres_driver
235        in order to make restarts with sol .ne. zero (fgmres with restarts)
236        (seaice_jfnk.F, seaice_fgmres.F)
237      - seaice_calc_l/rhs.F: replace maskW/S by maskInW/S; this fixes
238        a serious convergence problem when open boundaries are involved
239    o pkg/ggl90: fix computation of control volumes for the case of
240      ALLOW_GGL90_HORIZDIFF (probably not used very often): move control volumes
241      up half a grid cell from C-centered to W-centered (pointed out by C. Eden)
242    o pkg/seaice: simplify seaice_evp by avoiding use of extra fields u/vIceC
243    o pkg/autodiff
244      - Add inAdMode switch for SEAICEuseDYNAMICS:
245        SEAICEuseDYNAMICSinAdMode
246        (extend logic in ADAUTODIFF_INADMODE_SET)
247    o pkg/seaice
248      - Step 1 of merging ice-thickness distribution (ITD) code from
249        MITgcm_contrib/torge/itd/ (author: Torge Martin)
250        The code implements concept laid out in Thorndike et al. (1975);
251        code is enabled via CPP flag SEAICE_ITD
252        nITD (in SEAICE_SIZE.h) defines number of ice thickness categories;
253        code is not complete yet!!
254      - SEAICE_SIZE.h now included in almost all seaice routines
255    o verification (using seaice):
256      - switch back seaice-dynamics (+ lower SOLV_MAX_ITERS) in ADM exp.
257        global_ocean.cs32x15.seaice ; update results.
258      - compile B-grid dynamics in FW test exp 1D_ocean_ice_column ;
259      - compile C-grid dynamics with #define SEAICE_ALLOW_JFNK in FW test exp
260        offline_exf_seaice (previously compiling B-grid).
261    o pkg/exf:
262      - fix some STOP conditions in exf_check.F (from Aug 28, modifs did not allow
263        to specify neither just 1 comp of wind or wind-stress, nor no surface momentum
264        forcing): just replace CPP option ALLOW_ATM_WIND with run-time param useAtmWind.
265  o pkg/layers (adjust changes from Sept 19):  o pkg/layers (adjust changes from Sept 19):
266    - do snap-shot output and fill diagnostics from inside iLa loop (layers_calc.F)    - do snap-shot output and fill diagnostics from inside iLa loop (layers_calc.F)
267      this allows to remove "layers_maxNum" dimension from all layers arrays.      this allows to remove "layers_maxNum" dimension from all layers arrays.

Legend:
Removed from v.1.1753  
changed lines
  Added in v.1.1807

  ViewVC Help
Powered by ViewVC 1.1.22