/[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.2239 by jmc, Mon Mar 14 13:31:47 2016 UTC revision 1.2306 by jmc, Tue Feb 21 01:33:12 2017 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/exf:
8      - rename S/R EXF_INIT to EXF_INIT_VARIA ;
9      - add arguments: fldName (for debug msg) and fldRepeatCycle (set to
10        repeatPeriod) to S/R EXF_SET_UV and to S/R EXF_SET_GEN (renamed EXF_SET_FLD)
11        and update calls in pkg/exf calling S/R (exf_getffields.F & exf_getclim.F) ;
12      - add argument: fldName (for debug msg) to S/R EXF_INIT_GEN (renamed
13        EXF_INIT_FLD) and update calls in exf_init_varia.F
14      - For now, for backward compatibility, keep a simplified version of S/Rs
15        EXF_SET_GEN & EXF_INIT_GEN in file exf_set_gen.F
16      - add and pass new arguments: fldName (for debug msg) and fldRepeatCycle
17        to S/R EXF_GetFFieldRec ; update calls in pkg/obcs/obcs_exf_load.F
18    o tools/genmake2:
19      - replace "bc -l" (only used once) by "expr" (already used).
20    o verification/global_ocean.cs32x15:
21      - turn off pkg/cal (useCAL=F) in secondary FWD exp. "icedyn".
22        Note: exf setting (data.exf) can be compared to other exf secondary exp
23        "seaice" (kept with useCAL=T) which has same time dependent forcing.
24    
25    checkpoint66d (2017/02/13)
26    o pkg/exf:
27      - remove setting of useCAL=T when using pkg/exf (useEXF=T); add warning
28        early on (in packages_boot.F) to stress this change in pkg setting.
29      - In (most) verification exp. that use pkg/exf, add useCAL=.TRUE. to data.pkg
30    o model/src:
31      - move call to ecco_phys to end of time step; this may induce minor
32        cost function changes by shifting time averages by one time step
33        for some variables; this revision resulted in changed adjoint results
34        in MITgcm_contrib/verification_other/global_oce_cs32
35    o pkg/exf:
36      - Change EXF_READ_EVAP to only activate code within #ifdef ALLOW_ATM_TEMP ;
37        this prevents to read evap when ALLOW_ATM_TEMP is undef and other fields,
38        e.g. precip, are not available.
39    o pkg/flt:
40      - flt_init_varia.F: use pickupSuff if specified
41      - add code (within #ifdef DEVEL_FLT_EXCH2) and test case as a first,
42        intermediate, step towards completing pkg/exch2 support within pkg/flt;
43        ifdef DEVEL_FLT_EXCH2 then:
44        - flt_init_fixed.F: comment out stop
45        - flt_exch2.F: conserve ipart, jpart (grid coordinates)
46        - exch2_recv_get_vec.F: transform ipart, jpart (grid coordinates)
47        - flt_mapping.F: attempt to fix longitude diagnostic near date-line
48        - flt_init_varia.F: hack initialization (for testing purposes w. LLC90)
49    o tools/genmake2 & pkg/pkg_depend:
50      - define new type of pkg dependency rule ("=pkg_x"), less strict than
51        the "+" rule, that add the dependent pkg (pkg_x) unless it's disabled
52        (-pkg_x in packages.conf).
53      - change pkg/exf dependency rule from "exf +cal" to "exf =cal";
54      - add "+cal" to dependency list of pkg/ecco (needed to compile).
55      - simplify FWD experiment "offline_exf_seaice" by removing pkg/cal.
56    o utils/matlab:
57      - adding ocean_basin routines for defining basin masks.
58    o pkg/exf:
59      - new S/R EXF_GETFFIELD_START replacing EXF_GETFIELD_START, but with more
60        arguments, allowing to check (and stop) if parameter setting of
61         {FLD}startdate1 & date2 and of {FLD}StartTime are consistent with
62        useCAL= T or F. For now, kept a simplified version of EXF_GETFIELD_START
63        for backward compatibility.
64      - change accordingly calls in exf_init_fixed.F + default {FLD}StartTime in
65        exf_readparms.F ; apply same changes to pkg/icefront (for SGRunOff field).
66    o pkg/bling (USE_EXFCO2 code):
67      - fix missing setting of apco2StartTime according to apco2startdate1 & date2
68        by adding a call to S/R EXF_GETFFIELD_START.
69    o pkg/exf:
70      - allows to compile without pkg/cal (but disabled by current dependency
71        rules, i.e., default "pkg/pkg_depend"). Minimal changes to enable to
72        run with useCAL=F ; this involves setting directly {FLD}StartTime instead
73        of {FLD}startdate1 & date2 ; consistency check not yet coded.
74    o verification/global_ocean.cs32x15:
75      - fix all data.exf for a shift of 1 day in all field startdate1 so that it now
76        corresponds to middle of 1rst month; update outputs (2 fwd + 3 adm + 3 tlm).
77    o pkg/exf:
78      - allow to use EXF_ZENITHANGLE without pkg/cal + simplify (saving some
79        calculations); change FWD experiment global_ocean.cs32x15
80        (#define ALLOW_ZENITHANGLE) to test/check that this code compiles.
81    o pkg/exf:
82      - In preparation for addition to NAMELIST, rename internal (_RL) parameter
83         {FIELD}startdate to {FIELD}StartTime
84        Note: new name also fit better the content, i.e, a start time in second.
85    o eesupp/src:
86      - add 1 argument to S/R EEBOOT & EEBOOT_MINIMAL for interface with ESMF
87    o pkg/exf:
88      - add option ALLOW_READ_TURBFLUXES (and corresponding set of parameters)
89        to allow to read-in Sensible & Latent Heat flux ;
90      - simplify pkg/exf main options:
91        1) move small piece of code (case ALLOW_ATM_TEMP undef) out of
92           exf_bulkformulae.F into exf_wind.F so that exf_bulkformulae.F is
93           compiled only when both ALLOW_ATM_TEMP & ALLOW_BULKFORMULAE are defined;
94        2) make call to EXF_RADIATION and to EXF_WIND independent of CPP option
95           ALLOW_BULKFORMULAE which now only applies to S/R EXF_BULKFORMULAE ;
96        3) improve options documentation in EXF_OPTIONS.h.
97    o pkg/ecco:
98      - cost_gencost_customize.F,ecco.h,ecco_phys.F,ecco_readparms.F, and
99        ecco_summary.F: add passive tracer cost functions to gencost;
100        m_ptracer and m_boxmean_ptracer
101    o pkg/ctrl:
102      - ctrl_map_forcing.F: pass myIter and myTime to ctrl_map_forcing as input
103        parameters; move myIter .EQ. nIter0 inside ctrl_map_forcing; add to list
104        of implemented gentim2d contol parameters: xx_qnet, xx_empmr, xx_qsw,
105        xx_sst, xx_sss, xx_pload, xx_saltflux, xx_fu, xx_fv, xx_fe, xx_fn
106    o model/src:
107      - forward_step.F: pass myIter and myTime to ctrl_map_forcing as input
108        parameters; move myIter .EQ. nIter0 inside ctrl_map_forcing
109    o pkg/exf:
110      - exf_getffields.F: add to list of implemented gentim2d contol parameters:
111        xx_lwflux, xx_swflux, xx_evap, xx_apressure, xx_areamask
112    
113    checkpoint66c (2017/01/19)
114    o verification:
115      - add new option "-src" to testreport to only produce source code (*.f),
116        including taf output src code (if using '-adm'/'-tlm' option).
117    o pkg/exf:
118      - add saltflx :: Net upward salt flux in psu.kg/m^2/s
119    o pkg/diagnostics:
120      - add run-time variable diagMdsDir to specify a subdirectory for
121        diagnostic output when mds is being used and mdsioLocalDir is not.
122    o pkg/mnc:
123      - mnc_utils.F: edit stop message
124    o pkg/autodiff:
125      - autodiff_ini_model_io.F: PRINT_MESSAGE, clean-up comments, add _*_MASTER,
126        add HAVE_SYSTEM bracket around system call to mkdir
127    o pkg/profiles:
128      - profiles_findunit.F, profiles_init_fixed.F, profiles_interp.F,
129        profiles_readparms.F: call ALL_PROC_DIE before 'stop'
130      - profiles_ini_io.F: use PRINT_MESSAGE, clean-up comments, add _*_MASTER,
131        add HAVE_SYSTEM bracket around system call to mkdir
132    o pkg/smooth:
133      - smooth_filtervar2d.F, smooth_filtervar3d.F: call ALL_PROC_DIE before 'stop'
134      - smooth_init2d.F, smooth_init3d.F: move print statements to readparms
135      - smooth_readparms.F: add cleaner print statements from smooth_init?d.F
136    o pkg/exf:
137      - check: count errors and stop cleanly at the end (call to ALL_PROC_DIE);
138        issue error message when climsst_interpMethod.GT.0 and climsst_lon_inc > 500
139        generalize tests on interpMethod, nlat, and lon_inc to all exf variables.
140      - summary: skip detailed field report if not used (empty file-name).
141    o tools/xmakedepend:
142      - In case line editor "ed" is missing, switch to "sed" command to clean-up
143        Makefile from previous dependencies (anything after "# DO NOT DELETE" line).
144    o pkg/exf:
145      - change definition of "hflux" input file to always include Short-Wave;
146        this is now consistent with hflux computation (if using bulk-formulae)
147        and hflux diagnostic & documentation (in EXF_FIELDS.h).
148    
149    checkpoint66b (2016/12/01)
150    o model & momentum pkgs:
151      - implement fully implicit bottom friction combined with implicit surf.
152        pressure, for now, only in hydrostic formulation:
153        + to use: compile with #define ALLOW_SOLVE4_PS_AND_DRAG in CPP_OPTIONS.h
154          and run with selectImplicitDrag=2 ;
155        + currently missing diagnostics of bottom drag and vert. viscosity tendency;
156      - partial implicit time-stepping (bot. friction + vert. visc first, then
157        surf. press) corresponding to selectImplicitDrag=1 should be applicable
158        to NH formulation but not available until we solve for surf. pressure
159        increment (instead of full etaN).
160      - change exp. global_ocean.cs32x15.thsice to test implicit bottom drag
161        with implicit vertical viscosity.
162    o pkg/seaice: add linear remapping scheme (Lipscomb 2001) to ITD model
163      - this is a first version that includes many regularisations that may
164        not all be necessary, to be sorted out,
165      - turned on by runtime parameter SEAICEuseLinRemapITD (true by default)
166      - change one verification experiment in seaice_itd to use and test new code
167      - seaice_growth: catch a case where the argument of log can be zero
168        or smaller (important for code stability)
169    o model/src:
170      - modify SOLVE_DIAGONAL_LOWMEMORY version of solve_tridiagonal.F
171        & solve_pentadiagonal.F to enable to re-used inverse matrix for solving
172        similar A.X'=Y' system (with same matrix A) in subsequent calls;
173        switch based on errCode (In/Out) argument value; in calling routines,
174        initialise errCode before first call.
175    
176    checkpoint66a (2016/10/18)
177    o pkg/bling:
178      - BLING package now loads in atmospheric pCO2 file using exf package routines
179        Enable with #define USE_EXFCO2 in BLING_OPTIONS.h
180    o model/src & pkg/ptracers:
181      - with INCLUDE_IMPLVERTADV_CODE defined, also call MOM_U,V_IMPLICIT_R &
182        GAD_IMPLICIT_R (instead of IMPLDIFF) when just implicitViscosity and
183        implicitDiffusion (respectively) are used (even without momImplVertAdv
184        or temp,salt,PTRACERS_ImplVertAdv).
185    o model/src & generic_advdiff:
186      - add parenthesis in main diagonal calculation of implicit vertical
187        diffusion matrix (impldiff.F & gad_implicit_r.F).
188        This affects results at machine truncation level; update output of many
189        verification experiments (31 fwd ; 10 adm ; 8 tlm ; 3 oad).
190    o pkg/mom_commom & generic_advdiff:
191      - add deep atmosphere and anelastic scaling factor in implicit vertical
192        advection routines (mom_u,v_implicit_r.F & gad*_impl*_r.F).
193    o model/src:
194      - remove few unnecessary temp array copies in solve_tridiagonal.F
195        & solve_pentadiagonal.F
196    
197    checkpoint65z (2016/09/28)
198    o pkg/seaice: fix multithreading for seaice_fgmres.F
199      - remove unecessary variables from common blocks
200      - use extra dimension MAX_NO_THREADS for all variables of the Krylov space
201        basis, that are stored in commom blocks (including integer variable i1)
202      - clean up code a little by removing commented lines that refer to
203        original code
204      - turn on multi-threaded test for experiment offline_exf_seaice.dyn_jfnk.
205    o MITgcm manual:
206      - add uptodate pkg/ecco documentation to the manual (section 8.1; ecco.tex),
207        preliminary documentation for generic controls (8.3; ctrl.tex),
208        a placeholder for smooth (8.4; smooth.tex), and comment out the deprecated
209        ecco_costfunction.tex
210    o pkg/ecco:
211      - update and cleanup list of CCP options
212      - re-assign gencost_mask to specify masks rather than gencost_errfile; 'c'
213        is now always passed to cost_generic; gencost_mask is now MAX_LEN_FNAM
214      - add checks that retired run-time options are not used, and in relation
215        to gencost_mask and gencost_errfile
216      - finish deprecating gencost_scalefile, gencost_smooth2Ddiffnbt, and
217        gencost_nrecperiod
218      - fix m_eta computation for virtual salt flux case
219      - add m_horflux_vol case (selected via gencost_barfile) that computes
220        transports via cost_gencost_boxmean (gencost_flag=-3)
221      - use gencost_flag more systematically (i.e., avoid using gencost_name)
222        for code switches (aside from physical variable selection)
223    o pkg/seaice: make seaice_fgmres.F fit for multithreading; this first
224      attempt appears to be a bit of a hack and my need some repair down the road
225    o pkg/exf:
226      - interpolation near South Pole: fix criteria on input field latitude.
227    o pkg/icefront & pkg/exf:
228      - move setting of icefront Sub-Glacial RunOff forcing (currently unused)
229        from pkg/exf (read from data.exf) to pkg/icefront (read from data.icefront)
230    o pkg/exf:
231      - replace CPP option ALLOW_EXF_OUTPUT_INTERP with run-time parameter
232        "exf_output_interp" (in namelist: EXF_NML_04); change output file name
233        (add suffix "_out" instead of a prefix); keep same record number as in
234        input file but always write record 1 first (to avoid a STOP in I/O S/R).
235        Change output file content by writing interpolated field before applying
236        land-sea mask (helpful for debug).
237      - 2 compon. vector interpolation with rotation: apply scaling factor on
238        each compon. (Eastward and Northward) just before rotation.
239    o pkg/bling:
240      - Cleaned package. Removed not needed code and comments.
241      - adjoint example now works
242        (MITgcm_contrib/verification_other/global_oce_biogeo_bling/code_ad)
243    o pkg/ptracers:
244      - add Bruno Deremble's code to complete the linear surface correction
245        for tracer conservation;
246      - enabled for individual ptracers by PTRACERS_linFSConserve(iTr)=.TRUE.
247    
248    checkpoint65y (2016/07/29)
249    o pkg/debug (stats):
250      - change GLOBAL_SUM to GLOBAL_SUM_TILE (result independent of tile to
251        proc/thread mapping);
252      - fix Min & Max for case where 1 thread has only empty tiles;
253      - use RL variable to count number of wet grid points (with big domain,
254        can be too large to fit into integer*4).
255    o pkg/monitor:
256      - use RL variable to count number of wet grid points (but used only for del2)
257      - add new routine to compute Advective CFL within tracer time-stepping with
258        writing delayed until next monitor output.
259    o pkg/obcs:
260      - fix bug in OBCS_BALANCE_FLOW (OBCS_balanceFacN misspelled OBCS_balanceFacW)
261    o pkg/cal:
262      - calandar-dump: treat case myTime < timePhase in the same way as in
263        eesupp/src/diff_phase_multiple.F (when not using calandar-dump).
264    o pkg/dic & seaice:
265      - fix compilation of ocean component for coupled atm+ocn model with
266        seaice dynamics & dic.
267    
268    checkpoint65x (2016/06/11)
269    o add a license text file in main MITgcm tree.
270    o added pkg/bling:
271      - intermediate complexity biogeochemical model
272      - see bling_description.txt for details
273      - verification experiment is global_oce_biogeo_bling (for now, in
274        Contrib/verification_other/); tested daily on baudelaire with gfortran.
275      - add entry point in pkg/gchem for new pkg "bling".
276    o pkg/seaice: fix tensile stength computation
277      - replace global field tensileStrength by tensileStrFac
278      - tensileStrFac can be computed once in S/R seaice_init_varia
279      - fortunately that does not affect any verification results
280    
281    checkpoint65w (2016/05/12)
282    o pkg/ctrl/ctrl.h: fix a comma in common block list, so that code compiles
283         with ECCO_CTRL_DEPRECATED defined
284    o verification/global_ocean.cs32x15:
285      - change secondary test "viscA4" to also test "selectP_inEOS_Zc=3"
286        with "selectNHfreeSurf=1".
287    o model/src (non-hydrostatic free-surface):
288      - More "natural" expression of NH free-surface term (case selectNHfreeSurf=1):
289        was: tmpSurf/(1+tmpSurf); changed to: 1/(1+Gamma) with Gamma=1/tmpSurf.
290      - Calculate surface vertical velocity after 2-D solver adjustment (accounts
291        for EmPmR if RealFreshWaterFlux); used in RHS (cg3d_b) if exactConserv
292        and used to compute dPhiNH (in post_cg3d.F) if selectNHfreeSurf=1.
293        This fixes EmPmR contribution when selectNHfreeSurf=1 & RealFreshWaterFlux.
294      - Update output (changes at machine truncation level) of verification exp:
295        exp4 (11 digits for cg2d), global_ocean.cs32x15.viscA4 (11.d),
296        short_surf_wave (13.d) and tutorial_deep_convection.smag3d (12.d).
297    o pkg/seaice: ITD code
298      - fix picking up from a single category model by initialising
299        heff/area/hsnowITD = 0. in seaice_itd_pickup.F
300      - split a long warning message in seaice_check_pickup.F into two lines,
301        because NEC SX-ACE cannot deal with the long line.
302    o model/src:
303      - fix missing dPhiNH in pressure_for_eos.F (case: selectP_inEOS_Zc=3)
304    o pkg/seaice:
305      - add missing checks for SEAICE_ALLOW_KRYLOV and SEAICE_ALLOW_BOTTOMDRAG
306    o pkg/seaice:
307      - add basal stress as parameterisation for grounding ice
308        following Lemieux et al. (2015)
309      - turn on by setting new parameter SEAICEbasalDragK2 to a value
310        larger than 0. Lemieux et al. (2015) recommend 15.
311      - The adjoint complains with extra recomputations so there is also a
312        new cpp-flag SEAICE_ALLOW_BOTTOMDRAG that is undefined by default in
313        order to postpone the problem
314      - compile the new code in lab_sea
315    o verification/halfpipe_streamice:
316      - update both TAF and OpenAD adm output (machine truncation differences)
317    
318    checkpoint65v (2016/04/08)
319    o verification/advect_xz:
320      - increase overlap size from 3 to 4 and add new secondary test for PQM
321        advection scheme (with mono & wino limiter).
322      - change main exp. to test PPM (with weno limiter) adv.scheme on Temp.
323    o model/src:
324      - new parameters "top_Pres" & "seaLev_Z" (replacing Ro_SeaLevel and recently
325        added phi0Ref) to set vertical axis origin and phiRef origin;
326        keep Ro_SeaLevel for backward compatibility (with a warning).
327       According to coordinate and fluid type:
328        OCN in Z: top_Pres(Ref) (=rhoConst*PhiRef(1)), seaLev_Z (=rF(1), @ the top)
329        ATM in Z: top_Pres(Ref) (=rhoConst*PhiRef(1)), seaLev_Z (=rF(Nr+1) @ bottom)
330        OCN in P: top_Pres (=rF(Nr+1)), seaLev_Z (= PhiRef(Nr+1)/g, @ the top)
331        ATM in P: top_Pres (=rF(Nr+1)), seaLev_Z (= PhiRef(1)/g, @ the bottom)
332      - remove Ro_SeaLevel from ATM experiment parameter files;
333      - in tutorial_global_oce_in_p, remove Ro_SeaLevel and set top_Pres to the
334        complement; update output.txt (changes at machine truncation level).
335    o pkg/seaice/seaice_evp.F
336      - simplify computation of deltaZ and zetaZ to simple averaging following
337        Bouillon et al. (2013). This removes a lot of code, but also changes
338        verification experiment lab_sea.hb87 -> updated
339    
340  checkpoint65u (2016/03/14)  checkpoint65u (2016/03/14)
341  o pkg/generic_advdiff:  o pkg/generic_advdiff:
342    - from Darren: add PPM and PQM advection schemes (number 40-42 and 50-52)    - from Darren: add PPM and PQM advection schemes (number 40-42 and 50-52)
# Line 180  o pkg/atm_phys: Line 513  o pkg/atm_phys:
513    - add diagnostics for 3-D, Nr+1 levels diagnostics of radiative fluxes    - add diagnostics for 3-D, Nr+1 levels diagnostics of radiative fluxes
514      (shortwave & longwave, net & downward) and diagnostics of temp. tendency      (shortwave & longwave, net & downward) and diagnostics of temp. tendency
515      for individual contribution (convection, LSC cond, radiation)      for individual contribution (convection, LSC cond, radiation)
516    - add Ruth Geen etal, GRL 2016, radiation optionis (see paper supp.    - add Ruth Geen etal, GRL 2016, radiation options (see paper supp.
517      information); activated with: solar_exponent=0. and wv_exponent=-1.      information); activated with: solar_exponent=0. and wv_exponent=-1.
518  o pkg/ggl90:  o pkg/ggl90:
519    - within IDEMIX add upper limit for horizontal group velocity to    - within IDEMIX add upper limit for horizontal group velocity to
# Line 703  o model/src & mom pkgs: Line 1036  o model/src & mom pkgs:
1036      just copy level Nr value to level Nr+1.      just copy level Nr value to level Nr+1.
1037  o doc:  o doc:
1038    - add notes form Abhisek Chakraborty on how to close Heat & Salt budgets.    - add notes form Abhisek Chakraborty on how to close Heat & Salt budgets.
1039  o pkg/streamice:  o pkg/shelfice:
1040    - shelfice_init_varia.F, shelfice_init_fixed.F, shelfice_readparms.F,    - shelfice_init_varia.F, shelfice_init_fixed.F, shelfice_readparms.F,
1041      SHELFICE.h: move array shelficemass to init_varia, initialise      SHELFICE.h: move array shelficemass to init_varia, initialise
1042      from array shelficemassinit, which is set in init_fixed and      from array shelficemassinit, which is set in init_fixed and

Legend:
Removed from v.1.2239  
changed lines
  Added in v.1.2306

  ViewVC Help
Powered by ViewVC 1.1.22