/[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.2262 by mlosch, Mon Aug 22 14:38:37 2016 UTC revision 1.2335 by mlosch, Thu Jun 8 15:35:52 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/ptracers: add Bruno Deremble's code to complete the linear surface  o pkg/seaice:
8    correction for tracer conservation    - prevent JFNK and KRYLOV solvers from trying to reduce a residual of 0
9      - add the option to compute no-slip du/dy, dv/dx (i.e.
10        the offdiagonal strain rate e12) by a second order approximation
11        on the boundary; works only with JFNK, KRYLOV, or EVP solvers, because
12        it is too messy to implement for the implicit LSR matrix.
13        SEAICE_2ndOrderBC = .FALSE. by default
14    
15    checkpoint66h (2017/06/02)
16    o pkg/seaice:
17      - add new routines to compute stress tensor components and stress tensor
18        divergence to be reused in s/r seaice_lsr and s/r seaice_calc_lhs
19      - change names of diagnostics SIsigI/II (commonly used for invariants)
20        to SIsig1/sig2 (more common for principal components) to avoid confusion
21    o pkf/exf:
22      - add a stop if useRelativeWind with un-updated uwind/vwind (e.g., constant);
23        similarly, stop if rotateStressOnAgrid with constant wind-stress.
24    o pkg/seaice:
25      - remove (comment out) diagnostics SIuwind,SIvwind,SIfu,SIfv (duplicate of
26        EXFuwind,EXFvwind,oceTAUX,oceTAUY) and point them to their equivalent.
27      - add diagnostics of wind-stress over seaice (SItaux,SItauy) and seaice
28        fraction weighted wind stress over ocean+seaice (SIatmTx,SIatmTy).
29    o pkg/diagnostics:
30      - small piece of code to rename (old) diagnostics, when namelist is processed.
31    o model/src:
32      - new run-time param (useMin4hFacEdges) to select method for setting hFacW,S:
33        originally, set as minimum of adjacent hFacC factor ; now (new default)
34        computed from rSurfW,S and rLowW,S by applying same rules as for hFacC.
35        Only matters when useShelfIce=T with particular ice-shelf cavity geometry.
36    o pkg/seaice:
37      - add momemtum advection, off by default, still in test phase
38        most of the momentum advection code is adapted and reused from mom_vecinv
39    o pkg/mom_vecinv:
40      - pass these runtime flags:
41        selectVortScheme, highOrderVorticity, upwindVorticity, useJamartMomAdv
42        as formal parameters to s/r mom_vi_u/v_coriolis, mom_vi_u/v_coriolis_c4,
43        so that these routines can also be used in pkg/seaice.
44    
45    checkpoint66g (2017/04/24)
46    o model/src:
47      - more robust ordering of column thickness integral (=Sum_k(drF*hFac) )
48        to get same expression (regarding machine truncation) in different places
49        in ini_masks_etc.F (e.g., rSurfC,W,S is now exactly zero when it should).
50        Update forward output of experiments: global_ocean.cs32x15 (all 5 except
51        viscA4), isomip (x3), tutorial_global_oce_in_p & tutorial_plume_on_slope.
52    o pkg/shelfice:
53      - ALLOW_SHIFWFLX_CONTROL: move setting of maskSHI from shelfice_update_masks.F
54        to shelfice_init_fixed.F
55      - change S/R SHELFICE_UPDATE_MASKS to SHELFICE_INIT_DEPTHS (still called from
56        ini_masks_etc.F for now) to update ocean upper boundary position according
57        to ice-shelf topography (instead of directly updating hFacC).
58    o model/src:
59      - move call to CTRL_INIT & CTRL_ADMTLM from the middle to the bottom of
60        packages_init_fixed.F to allow other pkgs to set mask and weight fields.
61    
62    checkpoint66f (2017/04/06)
63    o model/src:
64      - add specific run-time param to select level of printed plot-field-maps,
65        set by default to debugLevel. Remove internal param "printDomain".
66    o pkg/seaice:
67      - add flag to add snow mass to seaiceMassC/U/V, the default is
68        SEAICEaddSnowMass=.FALSE., not to change previous results
69    o pkg/bling
70      - Bug fix in bling_production regarding unit conversion for diagnostics
71        being put in the wrong place
72    o model/src:
73      - add back recomputation of rSurfW & S to ensure consistent column thickness
74        (needed for rStar) between Sum_k(hFac*drF) and rSurf-rLow, for now only
75        when using pkg/shelfice; was initially added on 2012/06/01 (ini_masks_etc.F
76        revision 1.51) but was removed accidentally on 2014/02/08 (v1.53).
77    o pkg/autodiff:
78      - clean-up "checkpoint.flow"
79    o pkg/rw (Contribution from Jody Klymak):
80        option to set mds file suffix as function of time in simulation:
81        *) new input parameter "rwSuffixType" (read from PARM03 namelist)
82           to select file suffix format; by default (=0), use iteration number;
83        *) add simple routine to return file suffix according to rwSuffixType;
84        *) in model/src and in most pkgs (except: atm2d, fizhi, regrid & streamice),
85           use new S/R to get file suffix, except for debug output file (diagFreq)
86           and pkgs offline & rbcs input files.
87    o pkg/rw:
88      - uniform processing of "I10" suffix across writing fld routines; used to
89        simplify debug writing of cg2/3d_b/x in solve_for_pressure.F & post_cg3d.F
90        (similar to cg3d.F, cg3d_ex0.F)
91    o pkg/mom_vecinv:
92      - highOrderVorticity in selectVortScheme=2 case: fix c4 coeff in splitted
93        vorticity flux (keep same sum in case vBarXm=vBaXp, uBarYm=uBarYp).
94    o pkg/bling:
95      - Many small changes intended to clean the code.
96        Unnecessary ADJOINT_SAFEs removed ;
97        removed BLING_COST.h BLING_CTRL.h bling_cost.F ;
98        diagnostics added.
99    
100    checkpoint66e (2017/03/14)
101    o pkg/exf:
102      - interpolation with #undef EXF_INTERP_USE_DYNALLOC: move buffer size
103        definition outside EXF_PARAM.h in new header file: EXF_INTERP_SIZE.h;
104        use fixed size buffer (passed to S/R EXF_INTERP & EXF_INTERP_UV) to
105        avoid any dynamic allocation ;
106      - S/R EXF_CHECK: add new check & stop when file-name is defined but not
107        read-in ; add warning when file is read-in but not used within pkg/exf ;
108        + check for buffer-size (if #undef EXF_INTERP_USE_DYNALLOC).
109      - update exf_summary.F (print {FLD}RepCycle).
110    o verification/global_with_exf:
111      - switch on exf interpolation in AD test (just like the forward test)
112    o pkg/mom_vecinv:
113      - add storage directives to avoid recomputations within mom_vecinv.F
114        which were generating seg. fault with gfortran -devel
115    o pkg/ctrl, pkg/smooth:
116      - initialize array halos which were generating seg. fault with
117        gfortran -devel in adjoint mode
118    o pkg/exf:
119      - for each input field, enable to specify a field specific repeat-cycle
120        ({FLD}RepCycle) which defaults to pkg/exf main "repeatPeriod".
121    o verification/lab_sea:
122      - update AD results of primary test and noseaicedyn test after switching
123        to new version of TAF (5.3.13 vs 5.3.2 before); agreement with gradient
124        check stays about the same.
125    o pkg/exf:
126      - fix bug in exf_zenithangle.F for cases select_ZenAlbedo > 0 with useCAL=T.
127      - exf_check: MAX_LAT_INC need only be "loc_nlat-1", not equal to loc_nlat
128    o pkg/bling, USE_EXFCO2 code:
129      - add parameter "apco2RepCycle" (set to pkg/exf "repeatPeriod" by default);
130      - update calls to EXF S/R (use new version: EXF_INIT_FLD & EXF_SET_FLD).
131    o pkg/exf:
132      - rename S/R EXF_INIT to EXF_INIT_VARIA ;
133      - add arguments: fldName (for debug msg) and fldRepeatCycle (set to
134        repeatPeriod) to S/R EXF_SET_UV and to S/R EXF_SET_GEN (renamed EXF_SET_FLD)
135        and update calls in pkg/exf calling S/R (exf_getffields.F & exf_getclim.F) ;
136      - add argument: fldName (for debug msg) to S/R EXF_INIT_GEN (renamed
137        EXF_INIT_FLD) and update calls in exf_init_varia.F
138      - For now, for backward compatibility, keep a simplified version of S/Rs
139        EXF_SET_GEN & EXF_INIT_GEN in file exf_set_gen.F
140      - add and pass new arguments: fldName (for debug msg) and fldRepeatCycle
141        to S/R EXF_GetFFieldRec ; update calls in pkg/obcs/obcs_exf_load.F
142    o tools/genmake2:
143      - replace "bc -l" (only used once) by "expr" (already used).
144    o verification/global_ocean.cs32x15:
145      - turn off pkg/cal (useCAL=F) in secondary FWD exp. "icedyn".
146        Note: exf setting (data.exf) can be compared to other exf secondary exp
147        "seaice" (kept with useCAL=T) which has same time dependent forcing.
148    
149    checkpoint66d (2017/02/13)
150    o pkg/exf:
151      - remove setting of useCAL=T when using pkg/exf (useEXF=T); add warning
152        early on (in packages_boot.F) to stress this change in pkg setting.
153      - In (most) verification exp. that use pkg/exf, add useCAL=.TRUE. to data.pkg
154    o model/src:
155      - move call to ecco_phys to end of time step; this may induce minor
156        cost function changes by shifting time averages by one time step
157        for some variables; this revision resulted in changed adjoint results
158        in MITgcm_contrib/verification_other/global_oce_cs32
159    o pkg/exf:
160      - Change EXF_READ_EVAP to only activate code within #ifdef ALLOW_ATM_TEMP ;
161        this prevents to read evap when ALLOW_ATM_TEMP is undef and other fields,
162        e.g. precip, are not available.
163    o pkg/flt:
164      - flt_init_varia.F: use pickupSuff if specified
165      - add code (within #ifdef DEVEL_FLT_EXCH2) and test case as a first,
166        intermediate, step towards completing pkg/exch2 support within pkg/flt;
167        ifdef DEVEL_FLT_EXCH2 then:
168        - flt_init_fixed.F: comment out stop
169        - flt_exch2.F: conserve ipart, jpart (grid coordinates)
170        - exch2_recv_get_vec.F: transform ipart, jpart (grid coordinates)
171        - flt_mapping.F: attempt to fix longitude diagnostic near date-line
172        - flt_init_varia.F: hack initialization (for testing purposes w. LLC90)
173    o tools/genmake2 & pkg/pkg_depend:
174      - define new type of pkg dependency rule ("=pkg_x"), less strict than
175        the "+" rule, that add the dependent pkg (pkg_x) unless it's disabled
176        (-pkg_x in packages.conf).
177      - change pkg/exf dependency rule from "exf +cal" to "exf =cal";
178      - add "+cal" to dependency list of pkg/ecco (needed to compile).
179      - simplify FWD experiment "offline_exf_seaice" by removing pkg/cal.
180    o utils/matlab:
181      - adding ocean_basin routines for defining basin masks.
182    o pkg/exf:
183      - new S/R EXF_GETFFIELD_START replacing EXF_GETFIELD_START, but with more
184        arguments, allowing to check (and stop) if parameter setting of
185         {FLD}startdate1 & date2 and of {FLD}StartTime are consistent with
186        useCAL= T or F. For now, kept a simplified version of EXF_GETFIELD_START
187        for backward compatibility.
188      - change accordingly calls in exf_init_fixed.F + default {FLD}StartTime in
189        exf_readparms.F ; apply same changes to pkg/icefront (for SGRunOff field).
190    o pkg/bling (USE_EXFCO2 code):
191      - fix missing setting of apco2StartTime according to apco2startdate1 & date2
192        by adding a call to S/R EXF_GETFFIELD_START.
193    o pkg/exf:
194      - allows to compile without pkg/cal (but disabled by current dependency
195        rules, i.e., default "pkg/pkg_depend"). Minimal changes to enable to
196        run with useCAL=F ; this involves setting directly {FLD}StartTime instead
197        of {FLD}startdate1 & date2 ; consistency check not yet coded.
198    o verification/global_ocean.cs32x15:
199      - fix all data.exf for a shift of 1 day in all field startdate1 so that it now
200        corresponds to middle of 1rst month; update outputs (2 fwd + 3 adm + 3 tlm).
201    o pkg/exf:
202      - allow to use EXF_ZENITHANGLE without pkg/cal + simplify (saving some
203        calculations); change FWD experiment global_ocean.cs32x15
204        (#define ALLOW_ZENITHANGLE) to test/check that this code compiles.
205    o pkg/exf:
206      - In preparation for addition to NAMELIST, rename internal (_RL) parameter
207         {FIELD}startdate to {FIELD}StartTime
208        Note: new name also fit better the content, i.e, a start time in second.
209    o eesupp/src:
210      - add 1 argument to S/R EEBOOT & EEBOOT_MINIMAL for interface with ESMF
211    o pkg/exf:
212      - add option ALLOW_READ_TURBFLUXES (and corresponding set of parameters)
213        to allow to read-in Sensible & Latent Heat flux ;
214      - simplify pkg/exf main options:
215        1) move small piece of code (case ALLOW_ATM_TEMP undef) out of
216           exf_bulkformulae.F into exf_wind.F so that exf_bulkformulae.F is
217           compiled only when both ALLOW_ATM_TEMP & ALLOW_BULKFORMULAE are defined;
218        2) make call to EXF_RADIATION and to EXF_WIND independent of CPP option
219           ALLOW_BULKFORMULAE which now only applies to S/R EXF_BULKFORMULAE ;
220        3) improve options documentation in EXF_OPTIONS.h.
221    o pkg/ecco:
222      - cost_gencost_customize.F,ecco.h,ecco_phys.F,ecco_readparms.F, and
223        ecco_summary.F: add passive tracer cost functions to gencost;
224        m_ptracer and m_boxmean_ptracer
225    o pkg/ctrl:
226      - ctrl_map_forcing.F: pass myIter and myTime to ctrl_map_forcing as input
227        parameters; move myIter .EQ. nIter0 inside ctrl_map_forcing; add to list
228        of implemented gentim2d contol parameters: xx_qnet, xx_empmr, xx_qsw,
229        xx_sst, xx_sss, xx_pload, xx_saltflux, xx_fu, xx_fv, xx_fe, xx_fn
230    o model/src:
231      - forward_step.F: pass myIter and myTime to ctrl_map_forcing as input
232        parameters; move myIter .EQ. nIter0 inside ctrl_map_forcing
233    o pkg/exf:
234      - exf_getffields.F: add to list of implemented gentim2d contol parameters:
235        xx_lwflux, xx_swflux, xx_evap, xx_apressure, xx_areamask
236    
237    checkpoint66c (2017/01/19)
238    o verification:
239      - add new option "-src" to testreport to only produce source code (*.f),
240        including taf output src code (if using '-adm'/'-tlm' option).
241    o pkg/exf:
242      - add saltflx :: Net upward salt flux in psu.kg/m^2/s
243    o pkg/diagnostics:
244      - add run-time variable diagMdsDir to specify a subdirectory for
245        diagnostic output when mds is being used and mdsioLocalDir is not.
246    o pkg/mnc:
247      - mnc_utils.F: edit stop message
248    o pkg/autodiff:
249      - autodiff_ini_model_io.F: PRINT_MESSAGE, clean-up comments, add _*_MASTER,
250        add HAVE_SYSTEM bracket around system call to mkdir
251    o pkg/profiles:
252      - profiles_findunit.F, profiles_init_fixed.F, profiles_interp.F,
253        profiles_readparms.F: call ALL_PROC_DIE before 'stop'
254      - profiles_ini_io.F: use PRINT_MESSAGE, clean-up comments, add _*_MASTER,
255        add HAVE_SYSTEM bracket around system call to mkdir
256    o pkg/smooth:
257      - smooth_filtervar2d.F, smooth_filtervar3d.F: call ALL_PROC_DIE before 'stop'
258      - smooth_init2d.F, smooth_init3d.F: move print statements to readparms
259      - smooth_readparms.F: add cleaner print statements from smooth_init?d.F
260    o pkg/exf:
261      - check: count errors and stop cleanly at the end (call to ALL_PROC_DIE);
262        issue error message when climsst_interpMethod.GT.0 and climsst_lon_inc > 500
263        generalize tests on interpMethod, nlat, and lon_inc to all exf variables.
264      - summary: skip detailed field report if not used (empty file-name).
265    o tools/xmakedepend:
266      - In case line editor "ed" is missing, switch to "sed" command to clean-up
267        Makefile from previous dependencies (anything after "# DO NOT DELETE" line).
268    o pkg/exf:
269      - change definition of "hflux" input file to always include Short-Wave;
270        this is now consistent with hflux computation (if using bulk-formulae)
271        and hflux diagnostic & documentation (in EXF_FIELDS.h).
272    
273    checkpoint66b (2016/12/01)
274    o model & momentum pkgs:
275      - implement fully implicit bottom friction combined with implicit surf.
276        pressure, for now, only in hydrostic formulation:
277        + to use: compile with #define ALLOW_SOLVE4_PS_AND_DRAG in CPP_OPTIONS.h
278          and run with selectImplicitDrag=2 ;
279        + currently missing diagnostics of bottom drag and vert. viscosity tendency;
280      - partial implicit time-stepping (bot. friction + vert. visc first, then
281        surf. press) corresponding to selectImplicitDrag=1 should be applicable
282        to NH formulation but not available until we solve for surf. pressure
283        increment (instead of full etaN).
284      - change exp. global_ocean.cs32x15.thsice to test implicit bottom drag
285        with implicit vertical viscosity.
286    o pkg/seaice: add linear remapping scheme (Lipscomb 2001) to ITD model
287      - this is a first version that includes many regularisations that may
288        not all be necessary, to be sorted out,
289      - turned on by runtime parameter SEAICEuseLinRemapITD (true by default)
290      - change one verification experiment in seaice_itd to use and test new code
291      - seaice_growth: catch a case where the argument of log can be zero
292        or smaller (important for code stability)
293    o model/src:
294      - modify SOLVE_DIAGONAL_LOWMEMORY version of solve_tridiagonal.F
295        & solve_pentadiagonal.F to enable to re-used inverse matrix for solving
296        similar A.X'=Y' system (with same matrix A) in subsequent calls;
297        switch based on errCode (In/Out) argument value; in calling routines,
298        initialise errCode before first call.
299    
300    checkpoint66a (2016/10/18)
301    o pkg/bling:
302      - BLING package now loads in atmospheric pCO2 file using exf package routines
303        Enable with #define USE_EXFCO2 in BLING_OPTIONS.h
304    o model/src & pkg/ptracers:
305      - with INCLUDE_IMPLVERTADV_CODE defined, also call MOM_U,V_IMPLICIT_R &
306        GAD_IMPLICIT_R (instead of IMPLDIFF) when just implicitViscosity and
307        implicitDiffusion (respectively) are used (even without momImplVertAdv
308        or temp,salt,PTRACERS_ImplVertAdv).
309    o model/src & generic_advdiff:
310      - add parenthesis in main diagonal calculation of implicit vertical
311        diffusion matrix (impldiff.F & gad_implicit_r.F).
312        This affects results at machine truncation level; update output of many
313        verification experiments (31 fwd ; 10 adm ; 8 tlm ; 3 oad).
314    o pkg/mom_commom & generic_advdiff:
315      - add deep atmosphere and anelastic scaling factor in implicit vertical
316        advection routines (mom_u,v_implicit_r.F & gad*_impl*_r.F).
317    o model/src:
318      - remove few unnecessary temp array copies in solve_tridiagonal.F
319        & solve_pentadiagonal.F
320    
321    checkpoint65z (2016/09/28)
322    o pkg/seaice: fix multithreading for seaice_fgmres.F
323      - remove unecessary variables from common blocks
324      - use extra dimension MAX_NO_THREADS for all variables of the Krylov space
325        basis, that are stored in commom blocks (including integer variable i1)
326      - clean up code a little by removing commented lines that refer to
327        original code
328      - turn on multi-threaded test for experiment offline_exf_seaice.dyn_jfnk.
329    o MITgcm manual:
330      - add uptodate pkg/ecco documentation to the manual (section 8.1; ecco.tex),
331        preliminary documentation for generic controls (8.3; ctrl.tex),
332        a placeholder for smooth (8.4; smooth.tex), and comment out the deprecated
333        ecco_costfunction.tex
334    o pkg/ecco:
335      - update and cleanup list of CCP options
336      - re-assign gencost_mask to specify masks rather than gencost_errfile; 'c'
337        is now always passed to cost_generic; gencost_mask is now MAX_LEN_FNAM
338      - add checks that retired run-time options are not used, and in relation
339        to gencost_mask and gencost_errfile
340      - finish deprecating gencost_scalefile, gencost_smooth2Ddiffnbt, and
341        gencost_nrecperiod
342      - fix m_eta computation for virtual salt flux case
343      - add m_horflux_vol case (selected via gencost_barfile) that computes
344        transports via cost_gencost_boxmean (gencost_flag=-3)
345      - use gencost_flag more systematically (i.e., avoid using gencost_name)
346        for code switches (aside from physical variable selection)
347    o pkg/seaice: make seaice_fgmres.F fit for multithreading; this first
348      attempt appears to be a bit of a hack and my need some repair down the road
349    o pkg/exf:
350      - interpolation near South Pole: fix criteria on input field latitude.
351    o pkg/icefront & pkg/exf:
352      - move setting of icefront Sub-Glacial RunOff forcing (currently unused)
353        from pkg/exf (read from data.exf) to pkg/icefront (read from data.icefront)
354    o pkg/exf:
355      - replace CPP option ALLOW_EXF_OUTPUT_INTERP with run-time parameter
356        "exf_output_interp" (in namelist: EXF_NML_04); change output file name
357        (add suffix "_out" instead of a prefix); keep same record number as in
358        input file but always write record 1 first (to avoid a STOP in I/O S/R).
359        Change output file content by writing interpolated field before applying
360        land-sea mask (helpful for debug).
361      - 2 compon. vector interpolation with rotation: apply scaling factor on
362        each compon. (Eastward and Northward) just before rotation.
363    o pkg/bling:
364      - Cleaned package. Removed not needed code and comments.
365      - adjoint example now works
366        (MITgcm_contrib/verification_other/global_oce_biogeo_bling/code_ad)
367    o pkg/ptracers:
368      - add Bruno Deremble's code to complete the linear surface correction
369        for tracer conservation;
370      - enabled for individual ptracers by PTRACERS_linFSConserve(iTr)=.TRUE.
371    
372  checkpoint65y (2016/07/29)  checkpoint65y (2016/07/29)
373  o pkg/debug (stats):  o pkg/debug (stats):
# Line 20  o pkg/monitor: Line 382  o pkg/monitor:
382      writing delayed until next monitor output.      writing delayed until next monitor output.
383  o pkg/obcs:  o pkg/obcs:
384    - fix bug in OBCS_BALANCE_FLOW (OBCS_balanceFacN misspelled OBCS_balanceFacW)    - fix bug in OBCS_BALANCE_FLOW (OBCS_balanceFacN misspelled OBCS_balanceFacW)
385    o pkg/cal:
386      - calandar-dump: treat case myTime < timePhase in the same way as in
387        eesupp/src/diff_phase_multiple.F (when not using calandar-dump).
388  o pkg/dic & seaice:  o pkg/dic & seaice:
389    - fix compilation of ocean component for coupled atm+ocn model with    - fix compilation of ocean component for coupled atm+ocn model with
390      seaice dynamics & dic.      seaice dynamics & dic.

Legend:
Removed from v.1.2262  
changed lines
  Added in v.1.2335

  ViewVC Help
Powered by ViewVC 1.1.22