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

Legend:
Removed from v.1.1756  
changed lines
  Added in v.1.1806

  ViewVC Help
Powered by ViewVC 1.1.22