/[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.889 by jmc, Tue Oct 9 02:43:45 2007 UTC revision 1.998 by gforget, Fri May 30 02:53:14 2008 UTC
# Line 4  $Name$ Line 4  $Name$
4      Notes on tags used in MITgcmUV      Notes on tags used in MITgcmUV
5      ==============================      ==============================
6    
7  o add missing cvs $Header$ or $Name$ in eesupp/*, pkg/* & verification/code*  o bridging the gap between eddy stress and GM.
8      -> eddyTau is replaced with eddyPsi (eddyTau = f x rho0 x eddyPsi)
9          along with a change in CPP option (now ALLOW_EDDYPSI).
10      -> when using GM w/ GM_AdvForm:
11          The total eddy streamfunction (Psi = eddyPsi + K x Slope)
12          is applied either in the tracer Eq. or in momentum Eq.
13          depending on data.gmredi (intro. GM_InMomAsStress).
14      -> ALLOW_EDDYPSI_CONTROL for estimation purpose.
15      The key modifications are in model/src/taueddy_external_forcing.F
16      pkg/gmredi/gmredi_calc_*F pkg/gmredi/gmredi_*transport.F
17    checkpoint59r
18    o new S/R (pkg/mdsio/mdsio_facef_read.F) reading of sNx+1 x sNy+1 array
19      from per-face file (take S/R READSYMTILE_RS out of ini_curvilinear_grid.F);
20      fix option to read coriolis(@ cell-corner) from files with CS-grid.
21    o pkg/mnc: add some attributes to standard 1D-coordinate variables
22    o pkg/diagnostics: enforce missing_value attribute for scalar variables at
23      mass points, when using mnc for output
24      - add runtime parameter (missing_value, missing_value_int) to override
25        default (which is the value of getcon('UNDEF'))
26    o pkg/mnc: prepare mnc for the actual use of missing values with the
27      diagnostics package: small fix in mnc_cw_readwrite.template and more
28      initialisation of never used fields
29      - replace mnc_common.h and mnc_id_header.h with corresponding upper case
30      versions
31    o pkg/thsice/thsice_ini_vars.F added default initial values so that
32      thermodynamics sea ice solver does not blow up when some initial fields
33      are missing.
34    o move from external_forcing_surf.F to ini_forcing.F
35      the p-coord. hack consisting in using pLoad to set phi0surf ;
36      update output of tutorial_global_oce_in_p (affected @ truncation level).
37    o Freshen up a bit hs94.1x64x5, notably:
38      remove rotationPeriod and tRef=5*0. (adjoint only), and add
39      exactConserv=.TRUE.
40    o pkg/generic_advdiff:
41      change option GAD_ALLOW_SOM_ADVECT to GAD_ALLOW_TS_SOM_ADV which only
42      applies to files where Temperature & Salinity 2nd Order moments are used.
43    o pkg/ptracers: add second-order moment advection schemes (80 and 81);
44      this uses a dynamically allocated internal state data structure
45      (#define PTRACERS_ALLOW_DYN_STATE in PTRACERS_OPTIONS.h)
46      and requires a fortran 90 compiler
47    
48    checkpoint59q
49    o pkg/mom_vecinv: Add energy & enstrophy conserving scheme (selectVortScheme=3)
50       (from Sadourny, described by Burridge & Haseler, ECMWF Rep.4, 1977)
51    o Refresh tutorial_global_oce_biogeo, notably:
52      - change bathymetry (put back seamounts in ACC, use hFacs)
53      - change EOS (POLY3 --> JMD95Z)
54      - use Bryan-Lewis vertical diffusivity
55      - use multidimensional advection
56      - remove old virtual virtual in dic pkg, now done through ptracer pkg
57      - change a couple of parameters in dic pkg
58    o pkg/ctrl: change formula in adctrl_bound.F and add a parameter to ctrl_map_ini_gen.F
59    o pkg/obcs: change default to OBCSfixTopo = .true.,
60      - set OBCSfixTopo=.false. in exp4/input/data.obcs to reproduce old result
61      - replace "debugMode" with "debugLevel .GE. debLevB"
62    o implementation of TAF directives for gchem,cfc,dic
63    o remove "exp5" (replaced by tutorial_deep_convection).
64    o pkg/obcs: add code to fix topography gradients normal to open boundaries;
65      this requires computing the index fields OB_Jn/Js/Ie/Iw in obcs_readparms;
66      the code can be turned on by setting OBCSfixTopo = .true. in data.obcs
67      --> changes results in exp4, seaice_obcs
68    o tutorial_deep_convection :
69      update the set-up and increase resolution and domain size ; start
70      from pseudo initial conditions = output at t=120mn in order to see
71      something happening when running testreport.
72    o pkg/seaice: add os7mp as an advection scheme
73                  add check for advection schemes
74                  add a flag for restoring T and S underneath sea ice
75    o pkg/my82: add netcdf-support and diagnostics
76    o thsice pkg:
77      - Now hsMax limits snow height by turning it into ice following
78        flooding scheme (and now conserving energy)
79      - Slight rewriting of the formula in thsice_calc_thick.F
80      - Parameter rhowi eliminated to be replaced by floodFac = (rhosw-rhoi)/rhos
81      --> changes results of global_ocean.cs32x15.icedyn and global_ocean.cs32x15.thsice
82    
83    checkpoint59p
84    o gchem / dic / cfc :
85      - add useDIC, useCFC , read from "data.gchem" (& hold in GCHEM.h);
86      - add new parameter files: "data.dic" & "data.cfc" ;
87      - various re-arrangement in initialisation & header file ;
88      - fix tutorial_global_oce_biogeo for multi-threaded test.
89    o pkg/dic: test for "pickup_dic" file when restarting ;
90      if no pickup-file, can restart with a re-initialised pH (same as it did
91      before) providing pickupStrictlyMatch is set to False.
92    o change argument list of S/R PTRACERS_WRITE_PICKUP & MYPACKAGE_WRITE_PICKUP
93      + fix call to S/R GGL90_WRITE_PICKUP & DIC_WRITE_PICKUP
94    o add a "warning" (to Error msg file) when an Active Tracer is not using AB-2
95      and staggerTimeStep is off (needed for stability of Internal-wave dynamics).
96    o move out of PARAMS.h & data the last pieces of old-ptracer code: tauTr1ClimRelax,
97     & lambdaTr1ClimRelax ; put those 2 params in PTRACERS_PARAMS.h & data.ptracers
98       (note: not clear to me what lambdaTr1ClimRelax is still used for ...)
99    o pkg/mom_vecinv: - new parameter "selectVortScheme" to select which
100       scheme to use for vorticty-term ;
101     - compute upwindVorticity=T case within mom_vi_u/v_coriolis_c4.F
102       (with default selectVortScheme, return to original discretisation)
103     - remove weird combination (e.g.: upwindVorticity & highOrderVorticity)
104    o pkg/seaice: add a line to the summary to indicate grid type (B/C)
105    o in mom_calc_visc, fix average value of viscAh_W & viscA4_W next to the
106      bottom ; only used with variable horizontal viscosity and non-hydrostatic.
107      also fix diagnostics VISCAHW & VISCA4W.
108    
109    checkpoint59o
110    o dome/code/obcs_calc.F: avoid division by zero (detected using gfortran).
111    o change the loop ordering in most gad_*_adv_x.F to improve vectorization:
112      move a few statemens out the main loop into separate loops
113    o pkg/shelfice:
114      - sort out freshwater flux; convert freshwater fluxes to mass fluxes
115        (kg/m^2/s), does not break tests, because in verification/isomip,
116        rhoConstFresh=rhoConst (by accident)
117      - rearrange computation of tLoc, sLoc, pLoc to make code more efficient
118      - move S/R find_rho_scalar, pkg/ecco/sw_ptmp.F, pkg/ecco/sw_adtg.F into
119        new file model/src/seawater.F, so that they are available for all pkgs.
120      - convert potential temperature into in-situ temperature. This changes the
121        isomip tests => update tests
122    o add a flag writePickupAtEnd (default=true) to be able to suppress
123      writing a pickup at the last timestep
124    o tools/mpack-1.6 :
125      - disable automake (not working) and autoconf (not needed).
126      - update to version 1.6.4 which fix MD5 code on some 64 bits platforms
127        also cleaner with much less compilation warnings.
128    o pkg/profiles:
129      rename profiles_interp_mean_genericgrid as profiles_interp_mean_gg
130      (for "less than 32 characters name" compiler requirement)
131    o pkg/obcs and pkg/exf: added capability to specify seaice open boundary
132      conditions that have a different sampling frequency than S/T/U/V obcs
133    o pkg/diagnostics (stats-diags):
134      - fix global Min/Max in case 1 processor get only empty tiles
135    o genmake2: replace (4 times)
136         make genmake_tc_1.o >> genmake_warnings 2>&1
137      with
138         COMM="$CC $CFLAGS -c genmake_tc_1.c"
139         echo $COMM >> genmake_warnings
140         $COMM >> genmake_warnings 2>&1
141      to make genmake2 always see the value of CC as specified in the optfile.
142    o generic_advdiff: - prather advection scheme (SOM) coded for CS-grid.
143      - add diagnostics for 1srt & 2nd Order moments and sub-grid variance.
144      - modify verification advect_cs test to test SOM-advection on CS-grid.
145    o pkg/ctrl:
146      - Rewrite of ctrl_map_ini_ecco.F,
147        introducing a generic routine (ctrl_map_ini_gen.F).
148      - Modification of ctrl_bound/adctrl_bound handling control vector bounds.
149    
150    checkpoint59n
151    o pkg/diagnostics: for large number of diagnostics, store diagnostic mate
152      number in dedicate array "hdiag":
153      - new version of S/R DIAGNOSTICS_ADD2LIST : DIAGNOSTICS_ADDTOLIST
154        with 1 more argument (mate number); modify old version DIAGNOSTICS_ADD2LIST.
155      - many small changes (integer format) for large number of diagnostics
156      - start to use DIAGNOSTICS_ADDTOLIST (necessary for diagnostics with
157        a counter mate) in pkg diagnostics, ptracers, thsice & aim_v23.
158    o add parameter rotateGrid and Euler angles EulerPhi/Theta/Psi. For
159      usingSphericalGrid, this allows to define the rotated grid coordinates
160      via phiMin/thetaMin/dxSpacing/dySpacing, etc., but then re-compute the
161      geographical coordinates according to the inverse of the rotation defined
162      by the Euler angles, so that Coriolis parameter and online-interpolation by
163      exf works with the geographical coordinates on XC/YC/XG/YG.
164      Naturally, this feature does not work with all packages, so some
165      combinations are prohibited in config_summary (flt, flt_zonal, ecco,
166      profiles), because there the coordinates are assumed to be regular
167      spherical grid coordinates.
168    o pkg/gmredi,ctrl,ecco,autodiff,grdchk and model/src,inc:
169      - introduce isopycnal diffusion coefficient control.
170    o tools/adjoint_options:
171      - additional control vector components.
172    o pkg/mnc: have mnc create marginally meaning full coordinate variables
173      (that is the grid indices) if usingCurvilinearGrid and NOT EXCH2
174    o pkg/mypackage:
175      - add example of read/write pickup for state-var ;
176      - add entry points to the main code for state-vars diags & write-pickup.
177    o pkg/exf: rewrite of exf_getffieldrec.F to properly deal with year
178      transitions for useExfYearlyFields
179      - add new subroutine that determines the file to read from for
180        use*YearlyFields = .TRUE. and .FALSE.
181      - add a verification experiment to global_with_exf that tests
182        useExfYearlyFields with USE_EXF_INTERPOLATION defined
183    o pkg/obcs/exf: add useOBCSYearlyFields (=.FALSE.) to obcs with exf in
184      analogy to useExfYearlyFields; rearrange obcs_prescribe_read: two new
185      subroutines (which could be generated from a template, because they are
186      almost identical), for now they are included in obcs_prescribe_read.F for
187      simplicity
188    o pkg/exf:
189      - add a little more diagnostic to exf_interp_read (in analogy to
190        mds_read_field, can be turned off with debugLevel < debugLevA=1)
191      - improve vectorizability of exf_interp for TARGET_NEC_SX, makes code
192        ugly but fast by unrolling short inner loops, inserting a unroll=8
193        directive in routine lagran, and splitting a loop and making do while the
194        outermost loop (the latter requires the intoduction of index arrays)
195    o pkg/obcs: replace obcs_apply_area/heff/hsalt/hsnow with obcs_apply_seaice
196    o pkg/seaice: moved DIFFERENT_MULTIPLE from seaice_model to seaice_dynsolver
197      http://forge.csail.mit.edu/pipermail/mitgcm-devel/2008-January/003173.html
198    o verification/seaice_obcs: updated for restart test and latest options
199    o pkg/seaice: add a new flag SEAICEuseTEM to use a slightly different
200      ice rheology (so-called truncated ellipse, that gets rid of tensile stress);
201      for now this is only available for the C-grid code and also within
202      #ifdef SEAICE_ALLOW_TEM, because this option may slow down the EVP code
203    
204    checkpoint59m
205    o pkg/seaice: use different time constant for melting (SEAICE_gamma_t)
206      and freezing (SEAICE_gamma_t_frz) ice due to mixed layer temperature
207    o gad_som : fix flux output (& diagnostics) to have same units as other  
208      advection scheme fluxes (was previously multiplied by deltaT).  
209    o added verification/seaice_obcs both to test seaice open boundaries
210      and to provide an example matlab scrpt for generating them
211    o added verification/lab_sea/input.salt_plume for testing pkg/salt_plume
212    o pkg/salt_plume: clean up salt_plume_frac.F to
213      remove redundancy in PlumeMethod 1 and 4
214    o pkg/kpp: added saltplume diagnostics
215    o pkg/obcs and pkg/seaice:
216      - do not set uice and vice to zero when OB*icefile are unspecified
217      - OBCS_SEAICE_AVOID_CONVERGENCE is undefined by default
218      - moved seaice tracer obcs after call to seaice_growth
219    o pkg/salt_plume: added various options for salt plume depth
220      criterion and for vertical distribution of the salt
221    
222    checkpoint59l
223    o pkg/ptracers: new version of ptracers pickup:
224      read meta file and write only fields which are needed to restart.
225      ( same logic as main pickup file ; also using pickupStrictlyMatch )
226    o pkg/seaice:
227      - add timescale for melting due to warm mixed layer as a means of
228        setting SEAICE_availHeatFrac more conveniently
229      - add a CPP-flag/runtime parameter check for flooding algorithm
230      - reformulated availHeat in seaice_growth.F to be independent of AREA
231    o change units attribute of EmPmR netcdf variables to kg/m^2/s to reflect recent
232      unit changes
233    o pkg/obcs: added OBCS_SEAICE_AVOID_CONVERGENCE constraint
234    o cg2d.F: add 3 compiler directives that speed up this routine by 30% on a NEC
235      SX vector computer.
236    o pkg/seaice:
237      - removed SEAICE_FFIELDS.h and seaice_get_forcing.F
238        seaice forcing fields can now be read only through pkg/exf
239      - removed some unused halos
240    o no longer write pickup from THE_MODEL_MAIN but always from FORWARD_STEP
241    o pkg/exf: added useRelativeWind EXF_PARAM.h option for subtracting U/VVEL
242      or U/VICE from U/VWIND before computing U/VSTRESS
243    
244    checkpoint59k
245    o pkg/seaice: ICE2WATR=SEAICE_rhoIce/rhoConst for consistency between
246      dynamics and thermodynamics. Set ICE2WATR=0.92 to reproduce older results.
247    o fix un-initialised variable problem (in mom_vecinv & shap_filt):
248      all experiments pass when compile with un-initialised var. checking option.
249    o added pkg/salt_plume
250    o script to test restart (for now, in MITgcm_contrib/jmc_script)
251    o pkg/seaice: new read/write pickup version.
252      read meta file and write only fields which are needed to restart.
253      ( same logic as main pickup file ; also using pickupStrictlyMatch )
254    o pkg/seaice: fix bug in seaice_ocean_stress (call of seaice_calc_strainrates)
255    o lab_sea.hb87: modify the domain & update output.hb87.txt :
256      lat-long grid & no-slip BC in seaice-dynamics produce different sigma12
257      at j=1 & j=Ny+1 : this case is not treated correctly in the restart
258      process. Fixed here by closing the domain at the Northern boundary.
259    o pkg/rw: cleaning-up: call directly new MDSIO S/R MDS_READ/WRITE_FIELD.
260    o pkg/mdsio: add new arguments to MDS_READ/WRITE_FIELD for reading/writing
261      a set of consecutive levels in/from a 3-D array.
262    o pkg/ptracers:
263      use a 2 characters string ioLabel to identify tracer (if more than 99 tracers).
264      to-do: fix pkg/diagnostics when large number of diagnostics are defined.
265    
266    checkpoint59j
267    o in pkgs: dic, obcs, offline, rbcs:
268      standard way to compute coeff. for time interpolation between 2 time reccords
269      which retains full precision (& make results less dependent on compiler).
270      update output of exp: tutorial_cfc_offline & tutorial_global_oce_biogeo.
271    o pkg/cfc: if compiled with exf and seaice, cfc now can use fields from those
272      packages instead of reading ice cover and wind speed separately
273    o split PTRACERS.h in 2 header files: PTRACERS_FIELDS.h & PTRACERS_PARAMS.h
274     (keep a temporary version of PTRACERS.h in verification/OpenAD/code_ad_openad
275      to allow to compile customized code before the update)
276    o cleaning-up:
277      - fix CPP instruction syntax in pkg/obcs
278      - replace (some) call to MDSIO S/R with call to RW interface S/R ; and
279        add #ifdef ALLOW_MDSIO elsewhere (allows to compile without pkg/mdsio)
280      - fix some threads issue in IO parts.
281    o pkg/dic:
282      - add tons of "_d 0" (--> much better testreports !)
283       and then update outputs of tutorial_global_oce_biogeo
284    o pkg/mom_fluxform:
285      add a special version of momentum advection intended to conserve momentum
286      next to a bathymetry step or a coastline edge. (default = off = #undef)
287    o new read/write pickup version:
288      - for now, only implemented for main (mdsio) pickup file.
289      - write out only what is needed to restart; merge pickup_nh , pickup_ph
290        and main pickup together.
291      - read meta file; read only what is needed to restart; stop if a field
292        is missing (if pickupStrictlyMatch=T, = the default) or try to restart
293        if it make sense (even if the restart is not perfect).
294      - if no meta file, assume that pickup to read corresponds exactly to
295        a pickup that would currently be written.
296      - read pickup written in the old format (until checkpoint59i) if it
297        recognizes an old meta file (no field-list).
298      - add a meta file in exp. which starts from a pickup: 2 cases:
299        a) minimal meta file (with just file precision) + pickupStrictlyMatch=F
300         e.g.: global_ocean.90x40x15/input/pickup.0000036000.meta
301        b) a meta file describing the content of the associated pickup file
302         e.g.: tutorial_global_oce_biogeo/input/pickup.0004248000.meta
303    o pkg/mdsio & pkg/rw:
304      - new routine to read a meta file ; new set of routine to read
305        Multiple-fields file (with meta file).
306    o added open boundary conditions capability for seaice
307        HSNOW, HSALT, UICE, and VICE
308    
309    checkpoint59i
310    o adjoint:
311      * fix multiDimAdvection adjoint
312        (partial recomputation problem by TAF for fVerT(:,:,kDown)
313        and comlev1 size definition (maxpass vs. max. number of tracers)
314      * verification/global_ocean.90x45x15 adjoint now tests
315        NLFS and multiDimAdvection using DST3 (=30)
316      * verification/lab_sea now tests multiDimAdvection using DST3 (=30)
317    o pkg/kpp: add "_d 0" to real constant (if missing);
318      update output of exp: natl_box (10.digits); vermix (std, 7.digits)
319      and lab_sea, 3.FW (only 6,4,6 digits match) & AD (8.digits).
320    o prepare for "clever pickup" implementation: add new header file "RESTART.h"
321      for internal parameters related to restart process (formerly from PARAMS.h)
322      and add startAB parameter to argument list of S/R ADAMS_BASHFORTH2.
323    o more standard interface to {PKG}_WRITE_PICKUP with pickup suffix passed
324      as argument. (only atm2d & obcs write_pickup have not yet been updated)
325    o pkg/monitor:
326      - use GLOBAL_SUM_TILE instead of _GLOBAL_SUM
327      - fix mon_stats_rs (statistics over the full domain, even where field is zero)
328      - account for deep Atmosphere factor and density factor (anelastic)
329    o added open boundary conditions capability for seaice HEFF and AREA
330    o pkg/shelfice: add option for convservative form of Hellmer&Olbers (1989)
331      thermodynamics
332      - requires a little reorganization, which affects the testreport results
333        of isomip.htd (only 7 digits of cg2d agree) => update/modify experiment,
334        so that now the conservative form is tested
335      - add a few comments
336    o add missing cvs Header: or Name: in eesupp/*, pkg/* & verification/code*
337  o add a little bit of code to gad_os7mp_adv_?.F to help vectorization  o add a little bit of code to gad_os7mp_adv_?.F to help vectorization
338  o add new diagnostics to seaice: advective, diffusive fluxes (only for  o add new diagnostics to seaice: advective, diffusive fluxes (only for
339    multidim-advection, for scheme 2 they are not filled) and transports,    multidim-advection, for scheme 2 they are not filled) and transports,
340    thermodynamic growth rates    thermodynamic growth rates
341  o change units of EmPmR (inside the code) from m/s to kg/m2/s (mass flux) but  o change units of EmPmR (inside the code, + within coupling interface)
342    leave input file unchanged. Affects results @ truncation level (cg2d match)    from m/s to kg/m2/s (mass flux) but leave input file unchanged.
343    and update output of experiments: lab_sea(6), global_ocean.90x40x15(10),    Affects results @ truncation level (cg2d match) and update output of
344       experiments: lab_sea(6), global_ocean.90x40x15(10),
345    global_ocean.cs32x15(11x3,10), natl_box(11), tutorial_global_oce_latlon(11)    global_ocean.cs32x15(11x3,10), natl_box(11), tutorial_global_oce_latlon(11)
346    + adjoint results: global_ocean_ebm(11) and lab_sea (12).    + adjoint results: global_ocean_ebm(11) and lab_sea (12).
347      Coupled set-up: allow to restart from previous pickups (cpl_oldPickup=T).
348    Next: will retire convertEmP2rUnit (simply using mass2rUnit instead).    Next: will retire convertEmP2rUnit (simply using mass2rUnit instead).
349    
350  checkpoint59h  checkpoint59h

Legend:
Removed from v.1.889  
changed lines
  Added in v.1.998

  ViewVC Help
Powered by ViewVC 1.1.22