/[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.2281 by mlosch, Mon Nov 28 15:53:11 2016 UTC revision 1.2350 by jmc, Tue Aug 22 03:02:30 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 model/src:
8      - move k loop inside correction_step.F (+ update calling S/R)
9      - collect implicit pressure gradient tendencies in local 2-D array;
10        affect results (at machine truncation level) when using 3-D solver; update
11        output of exp.: exp4 (x1), global_ocean.cs32x15 (x2),hs94.cs-32x32x5.impIGW,
12                        rotating_tank, short_surf_wave,tutorial_deep_convection (x2)
13                        & tutorial_plume_on_slope.
14    
15    checkpoint66j (2017/08/15)
16    o pkg/ptracers:
17      - fix surface forcing under ice-shelf (useShelfIce=T).
18    o pkg/atm_phys:
19      - use hFac weighted average when applying A-grid atm-phys momentum tendency
20        to C-grid dynamics; this ensures wind-stress match mom tendency.
21    o eesupp/src:
22      - change default for opening scratch files to avoid STATUS='SCRATCH'
23      - close scratch files with STATUS='DELETE'
24      - changes affect eeset_parms.F and open_copy_data_file.F and many routines
25        that read namelists (because they close the scratch files)
26      - you can revert to old default by setting USE_FORTRAN_SCRATCH_FILES
27        in CPP_EEOPTIONS.h (tested in ideal_2D_oce/code & lab_sea/code_ad)
28    o pkg/atm_phys:
29      - fix unset arguments in (unused) S/R surface_flux_0d.
30    o eesupp/src:
31      - add argument "procId" to S/R EESET_PARMS to fix  scratchFile1 & 2 setting
32        (case TARGET_BGL or TARGET_CRAYXT) for early call (from eeboot_minimal.F):
33        called with myProcId in eeboot.F and with mpiMyWId in eeboot_minimal.F
34    o pkg/streamice:
35      - remove blank between _EXCH_XY_RL and "()", which my Apple Xcode
36        preprocessor /usr/bin/cpp cannot interpret; 3 instances in total in
37        streamice_driving_stress_fd.F and streamice_advect_2dtracer.F
38    o pkg/diagnostics:
39      - new option to allow to cumulate thickness-factor (hFac) weighted field
40        (if field permitted); implemented by changing sign of "jdiag" pointer
41        (> 0: cumlulate field, < 0: cumulate hFac weighted field).
42        a) restricted to 3-d (Nr levels), level centered diagnostics at U,V or Cell
43           center position (gcode(2)='U','V','M' & gcode(3,5,9:10)='R',' ','MR')
44        b) for now, activated by setting fileFlags 3rd character to 'h'.
45    
46    checkpoint66i (2017/07/18)
47    o pkg/cheapaml:
48      - add parameter "useRelativeWind", default set to False; this change the
49        previous setting which was always using relative wind.
50    o add hooks for the Parallel Data Assimilation Framework PDAF
51        (http://pdaf.awi.de/) in eeboot_minimal.F and the_main_loop.F;
52        to use set CPP-flag USE_PDAF in CPP_EEOPTIONS.h
53    o pkg/exf:
54      - interpolation of vector fields (exf_interp_uv.F): fix bug in calculation
55        of South-Pole mean value.  
56      - interpolation near the poles, case where second additional row is at the
57        pole (or beyond the pole and moved to the pole): change first addition row
58        value to a linear interpolation between pole and 1rst (S.pole)/last (N.pole)
59        row (instead of just a copy of it).
60    o pkg/seaice:
61      - prevent JFNK and KRYLOV solvers from trying to reduce a residual of 0
62      - add the option to compute no-slip du/dy, dv/dx (i.e.
63        the offdiagonal strain rate e12) by a second order approximation
64        on the boundary; works only with JFNK, KRYLOV, or EVP solvers, because
65        it is too messy to implement for the implicit LSR matrix.
66        SEAICE_2ndOrderBC = .FALSE. by default
67    
68    checkpoint66h (2017/06/02)
69    o pkg/seaice:
70      - add new routines to compute stress tensor components and stress tensor
71        divergence to be reused in s/r seaice_lsr and s/r seaice_calc_lhs
72      - change names of diagnostics SIsigI/II (commonly used for invariants)
73        to SIsig1/sig2 (more common for principal components) to avoid confusion
74    o pkf/exf:
75      - add a stop if useRelativeWind with un-updated uwind/vwind (e.g., constant);
76        similarly, stop if rotateStressOnAgrid with constant wind-stress.
77    o pkg/seaice:
78      - remove (comment out) diagnostics SIuwind,SIvwind,SIfu,SIfv (duplicate of
79        EXFuwind,EXFvwind,oceTAUX,oceTAUY) and point them to their equivalent.
80      - add diagnostics of wind-stress over seaice (SItaux,SItauy) and seaice
81        fraction weighted wind stress over ocean+seaice (SIatmTx,SIatmTy).
82    o pkg/diagnostics:
83      - small piece of code to rename (old) diagnostics, when namelist is processed.
84    o model/src:
85      - new run-time param (useMin4hFacEdges) to select method for setting hFacW,S:
86        originally, set as minimum of adjacent hFacC factor ; now (new default)
87        computed from rSurfW,S and rLowW,S by applying same rules as for hFacC.
88        Only matters when useShelfIce=T with particular ice-shelf cavity geometry.
89    o pkg/seaice:
90      - add momemtum advection, off by default, still in test phase
91        most of the momentum advection code is adapted and reused from mom_vecinv
92    o pkg/mom_vecinv:
93      - pass these runtime flags:
94        selectVortScheme, highOrderVorticity, upwindVorticity, useJamartMomAdv
95        as formal parameters to s/r mom_vi_u/v_coriolis, mom_vi_u/v_coriolis_c4,
96        so that these routines can also be used in pkg/seaice.
97    
98    checkpoint66g (2017/04/24)
99    o model/src:
100      - more robust ordering of column thickness integral (=Sum_k(drF*hFac) )
101        to get same expression (regarding machine truncation) in different places
102        in ini_masks_etc.F (e.g., rSurfC,W,S is now exactly zero when it should).
103        Update forward output of experiments: global_ocean.cs32x15 (all 5 except
104        viscA4), isomip (x3), tutorial_global_oce_in_p & tutorial_plume_on_slope.
105    o pkg/shelfice:
106      - ALLOW_SHIFWFLX_CONTROL: move setting of maskSHI from shelfice_update_masks.F
107        to shelfice_init_fixed.F
108      - change S/R SHELFICE_UPDATE_MASKS to SHELFICE_INIT_DEPTHS (still called from
109        ini_masks_etc.F for now) to update ocean upper boundary position according
110        to ice-shelf topography (instead of directly updating hFacC).
111    o model/src:
112      - move call to CTRL_INIT & CTRL_ADMTLM from the middle to the bottom of
113        packages_init_fixed.F to allow other pkgs to set mask and weight fields.
114    
115    checkpoint66f (2017/04/06)
116    o model/src:
117      - add specific run-time param to select level of printed plot-field-maps,
118        set by default to debugLevel. Remove internal param "printDomain".
119    o pkg/seaice:
120      - add flag to add snow mass to seaiceMassC/U/V, the default is
121        SEAICEaddSnowMass=.FALSE., not to change previous results
122    o pkg/bling
123      - Bug fix in bling_production regarding unit conversion for diagnostics
124        being put in the wrong place
125    o model/src:
126      - add back recomputation of rSurfW & S to ensure consistent column thickness
127        (needed for rStar) between Sum_k(hFac*drF) and rSurf-rLow, for now only
128        when using pkg/shelfice; was initially added on 2012/06/01 (ini_masks_etc.F
129        revision 1.51) but was removed accidentally on 2014/02/08 (v1.53).
130    o pkg/autodiff:
131      - clean-up "checkpoint.flow"
132    o pkg/rw (Contribution from Jody Klymak):
133        option to set mds file suffix as function of time in simulation:
134        *) new input parameter "rwSuffixType" (read from PARM03 namelist)
135           to select file suffix format; by default (=0), use iteration number;
136        *) add simple routine to return file suffix according to rwSuffixType;
137        *) in model/src and in most pkgs (except: atm2d, fizhi, regrid & streamice),
138           use new S/R to get file suffix, except for debug output file (diagFreq)
139           and pkgs offline & rbcs input files.
140    o pkg/rw:
141      - uniform processing of "I10" suffix across writing fld routines; used to
142        simplify debug writing of cg2/3d_b/x in solve_for_pressure.F & post_cg3d.F
143        (similar to cg3d.F, cg3d_ex0.F)
144    o pkg/mom_vecinv:
145      - highOrderVorticity in selectVortScheme=2 case: fix c4 coeff in splitted
146        vorticity flux (keep same sum in case vBarXm=vBaXp, uBarYm=uBarYp).
147    o pkg/bling:
148      - Many small changes intended to clean the code.
149        Unnecessary ADJOINT_SAFEs removed ;
150        removed BLING_COST.h BLING_CTRL.h bling_cost.F ;
151        diagnostics added.
152    
153    checkpoint66e (2017/03/14)
154    o pkg/exf:
155      - interpolation with #undef EXF_INTERP_USE_DYNALLOC: move buffer size
156        definition outside EXF_PARAM.h in new header file: EXF_INTERP_SIZE.h;
157        use fixed size buffer (passed to S/R EXF_INTERP & EXF_INTERP_UV) to
158        avoid any dynamic allocation ;
159      - S/R EXF_CHECK: add new check & stop when file-name is defined but not
160        read-in ; add warning when file is read-in but not used within pkg/exf ;
161        + check for buffer-size (if #undef EXF_INTERP_USE_DYNALLOC).
162      - update exf_summary.F (print {FLD}RepCycle).
163    o verification/global_with_exf:
164      - switch on exf interpolation in AD test (just like the forward test)
165    o pkg/mom_vecinv:
166      - add storage directives to avoid recomputations within mom_vecinv.F
167        which were generating seg. fault with gfortran -devel
168    o pkg/ctrl, pkg/smooth:
169      - initialize array halos which were generating seg. fault with
170        gfortran -devel in adjoint mode
171    o pkg/exf:
172      - for each input field, enable to specify a field specific repeat-cycle
173        ({FLD}RepCycle) which defaults to pkg/exf main "repeatPeriod".
174    o verification/lab_sea:
175      - update AD results of primary test and noseaicedyn test after switching
176        to new version of TAF (5.3.13 vs 5.3.2 before); agreement with gradient
177        check stays about the same.
178    o pkg/exf:
179      - fix bug in exf_zenithangle.F for cases select_ZenAlbedo > 0 with useCAL=T.
180      - exf_check: MAX_LAT_INC need only be "loc_nlat-1", not equal to loc_nlat
181    o pkg/bling, USE_EXFCO2 code:
182      - add parameter "apco2RepCycle" (set to pkg/exf "repeatPeriod" by default);
183      - update calls to EXF S/R (use new version: EXF_INIT_FLD & EXF_SET_FLD).
184    o pkg/exf:
185      - rename S/R EXF_INIT to EXF_INIT_VARIA ;
186      - add arguments: fldName (for debug msg) and fldRepeatCycle (set to
187        repeatPeriod) to S/R EXF_SET_UV and to S/R EXF_SET_GEN (renamed EXF_SET_FLD)
188        and update calls in pkg/exf calling S/R (exf_getffields.F & exf_getclim.F) ;
189      - add argument: fldName (for debug msg) to S/R EXF_INIT_GEN (renamed
190        EXF_INIT_FLD) and update calls in exf_init_varia.F
191      - For now, for backward compatibility, keep a simplified version of S/Rs
192        EXF_SET_GEN & EXF_INIT_GEN in file exf_set_gen.F
193      - add and pass new arguments: fldName (for debug msg) and fldRepeatCycle
194        to S/R EXF_GetFFieldRec ; update calls in pkg/obcs/obcs_exf_load.F
195    o tools/genmake2:
196      - replace "bc -l" (only used once) by "expr" (already used).
197    o verification/global_ocean.cs32x15:
198      - turn off pkg/cal (useCAL=F) in secondary FWD exp. "icedyn".
199        Note: exf setting (data.exf) can be compared to other exf secondary exp
200        "seaice" (kept with useCAL=T) which has same time dependent forcing.
201    
202    checkpoint66d (2017/02/13)
203    o pkg/exf:
204      - remove setting of useCAL=T when using pkg/exf (useEXF=T); add warning
205        early on (in packages_boot.F) to stress this change in pkg setting.
206      - In (most) verification exp. that use pkg/exf, add useCAL=.TRUE. to data.pkg
207    o model/src:
208      - move call to ecco_phys to end of time step; this may induce minor
209        cost function changes by shifting time averages by one time step
210        for some variables; this revision resulted in changed adjoint results
211        in MITgcm_contrib/verification_other/global_oce_cs32
212    o pkg/exf:
213      - Change EXF_READ_EVAP to only activate code within #ifdef ALLOW_ATM_TEMP ;
214        this prevents to read evap when ALLOW_ATM_TEMP is undef and other fields,
215        e.g. precip, are not available.
216    o pkg/flt:
217      - flt_init_varia.F: use pickupSuff if specified
218      - add code (within #ifdef DEVEL_FLT_EXCH2) and test case as a first,
219        intermediate, step towards completing pkg/exch2 support within pkg/flt;
220        ifdef DEVEL_FLT_EXCH2 then:
221        - flt_init_fixed.F: comment out stop
222        - flt_exch2.F: conserve ipart, jpart (grid coordinates)
223        - exch2_recv_get_vec.F: transform ipart, jpart (grid coordinates)
224        - flt_mapping.F: attempt to fix longitude diagnostic near date-line
225        - flt_init_varia.F: hack initialization (for testing purposes w. LLC90)
226    o tools/genmake2 & pkg/pkg_depend:
227      - define new type of pkg dependency rule ("=pkg_x"), less strict than
228        the "+" rule, that add the dependent pkg (pkg_x) unless it's disabled
229        (-pkg_x in packages.conf).
230      - change pkg/exf dependency rule from "exf +cal" to "exf =cal";
231      - add "+cal" to dependency list of pkg/ecco (needed to compile).
232      - simplify FWD experiment "offline_exf_seaice" by removing pkg/cal.
233    o utils/matlab:
234      - adding ocean_basin routines for defining basin masks.
235    o pkg/exf:
236      - new S/R EXF_GETFFIELD_START replacing EXF_GETFIELD_START, but with more
237        arguments, allowing to check (and stop) if parameter setting of
238         {FLD}startdate1 & date2 and of {FLD}StartTime are consistent with
239        useCAL= T or F. For now, kept a simplified version of EXF_GETFIELD_START
240        for backward compatibility.
241      - change accordingly calls in exf_init_fixed.F + default {FLD}StartTime in
242        exf_readparms.F ; apply same changes to pkg/icefront (for SGRunOff field).
243    o pkg/bling (USE_EXFCO2 code):
244      - fix missing setting of apco2StartTime according to apco2startdate1 & date2
245        by adding a call to S/R EXF_GETFFIELD_START.
246    o pkg/exf:
247      - allows to compile without pkg/cal (but disabled by current dependency
248        rules, i.e., default "pkg/pkg_depend"). Minimal changes to enable to
249        run with useCAL=F ; this involves setting directly {FLD}StartTime instead
250        of {FLD}startdate1 & date2 ; consistency check not yet coded.
251    o verification/global_ocean.cs32x15:
252      - fix all data.exf for a shift of 1 day in all field startdate1 so that it now
253        corresponds to middle of 1rst month; update outputs (2 fwd + 3 adm + 3 tlm).
254    o pkg/exf:
255      - allow to use EXF_ZENITHANGLE without pkg/cal + simplify (saving some
256        calculations); change FWD experiment global_ocean.cs32x15
257        (#define ALLOW_ZENITHANGLE) to test/check that this code compiles.
258    o pkg/exf:
259      - In preparation for addition to NAMELIST, rename internal (_RL) parameter
260         {FIELD}startdate to {FIELD}StartTime
261        Note: new name also fit better the content, i.e, a start time in second.
262    o eesupp/src:
263      - add 1 argument to S/R EEBOOT & EEBOOT_MINIMAL for interface with ESMF
264    o pkg/exf:
265      - add option ALLOW_READ_TURBFLUXES (and corresponding set of parameters)
266        to allow to read-in Sensible & Latent Heat flux ;
267      - simplify pkg/exf main options:
268        1) move small piece of code (case ALLOW_ATM_TEMP undef) out of
269           exf_bulkformulae.F into exf_wind.F so that exf_bulkformulae.F is
270           compiled only when both ALLOW_ATM_TEMP & ALLOW_BULKFORMULAE are defined;
271        2) make call to EXF_RADIATION and to EXF_WIND independent of CPP option
272           ALLOW_BULKFORMULAE which now only applies to S/R EXF_BULKFORMULAE ;
273        3) improve options documentation in EXF_OPTIONS.h.
274    o pkg/ecco:
275      - cost_gencost_customize.F,ecco.h,ecco_phys.F,ecco_readparms.F, and
276        ecco_summary.F: add passive tracer cost functions to gencost;
277        m_ptracer and m_boxmean_ptracer
278    o pkg/ctrl:
279      - ctrl_map_forcing.F: pass myIter and myTime to ctrl_map_forcing as input
280        parameters; move myIter .EQ. nIter0 inside ctrl_map_forcing; add to list
281        of implemented gentim2d contol parameters: xx_qnet, xx_empmr, xx_qsw,
282        xx_sst, xx_sss, xx_pload, xx_saltflux, xx_fu, xx_fv, xx_fe, xx_fn
283    o model/src:
284      - forward_step.F: pass myIter and myTime to ctrl_map_forcing as input
285        parameters; move myIter .EQ. nIter0 inside ctrl_map_forcing
286    o pkg/exf:
287      - exf_getffields.F: add to list of implemented gentim2d contol parameters:
288        xx_lwflux, xx_swflux, xx_evap, xx_apressure, xx_areamask
289    
290    checkpoint66c (2017/01/19)
291    o verification:
292      - add new option "-src" to testreport to only produce source code (*.f),
293        including taf output src code (if using '-adm'/'-tlm' option).
294    o pkg/exf:
295      - add saltflx :: Net upward salt flux in psu.kg/m^2/s
296    o pkg/diagnostics:
297      - add run-time variable diagMdsDir to specify a subdirectory for
298        diagnostic output when mds is being used and mdsioLocalDir is not.
299    o pkg/mnc:
300      - mnc_utils.F: edit stop message
301    o pkg/autodiff:
302      - autodiff_ini_model_io.F: PRINT_MESSAGE, clean-up comments, add _*_MASTER,
303        add HAVE_SYSTEM bracket around system call to mkdir
304    o pkg/profiles:
305      - profiles_findunit.F, profiles_init_fixed.F, profiles_interp.F,
306        profiles_readparms.F: call ALL_PROC_DIE before 'stop'
307      - profiles_ini_io.F: use PRINT_MESSAGE, clean-up comments, add _*_MASTER,
308        add HAVE_SYSTEM bracket around system call to mkdir
309    o pkg/smooth:
310      - smooth_filtervar2d.F, smooth_filtervar3d.F: call ALL_PROC_DIE before 'stop'
311      - smooth_init2d.F, smooth_init3d.F: move print statements to readparms
312      - smooth_readparms.F: add cleaner print statements from smooth_init?d.F
313    o pkg/exf:
314      - check: count errors and stop cleanly at the end (call to ALL_PROC_DIE);
315        issue error message when climsst_interpMethod.GT.0 and climsst_lon_inc > 500
316        generalize tests on interpMethod, nlat, and lon_inc to all exf variables.
317      - summary: skip detailed field report if not used (empty file-name).
318    o tools/xmakedepend:
319      - In case line editor "ed" is missing, switch to "sed" command to clean-up
320        Makefile from previous dependencies (anything after "# DO NOT DELETE" line).
321    o pkg/exf:
322      - change definition of "hflux" input file to always include Short-Wave;
323        this is now consistent with hflux computation (if using bulk-formulae)
324        and hflux diagnostic & documentation (in EXF_FIELDS.h).
325    
326    checkpoint66b (2016/12/01)
327    o model & momentum pkgs:
328      - implement fully implicit bottom friction combined with implicit surf.
329        pressure, for now, only in hydrostic formulation:
330        + to use: compile with #define ALLOW_SOLVE4_PS_AND_DRAG in CPP_OPTIONS.h
331          and run with selectImplicitDrag=2 ;
332        + currently missing diagnostics of bottom drag and vert. viscosity tendency;
333      - partial implicit time-stepping (bot. friction + vert. visc first, then
334        surf. press) corresponding to selectImplicitDrag=1 should be applicable
335        to NH formulation but not available until we solve for surf. pressure
336        increment (instead of full etaN).
337      - change exp. global_ocean.cs32x15.thsice to test implicit bottom drag
338        with implicit vertical viscosity.
339  o pkg/seaice: add linear remapping scheme (Lipscomb 2001) to ITD model  o pkg/seaice: add linear remapping scheme (Lipscomb 2001) to ITD model
340    - this is a first version that includes many regularisations that may    - this is a first version that includes many regularisations that may
341      not all be necessary, to be sorted out,      not all be necessary, to be sorted out,
342    - turned on by runtime parameter SEAICEuseLinRemapITD (true by default)    - turned on by runtime parameter SEAICEuseLinRemapITD (true by default)
343    - change one verification experiment in seaice_itd to use and test new code    - change one verification experiment in seaice_itd to use and test new code
344    - seaice_growth: catch a case where the argument of log can be zero    - seaice_growth: catch a case where the argument of log can be zero
345      or smaller (important for code stability)      or smaller (important for code stability)
346  o model/src:  o model/src:
347    - modify SOLVE_DIAGONAL_LOWMEMORY version of solve_tridiagonal.F    - modify SOLVE_DIAGONAL_LOWMEMORY version of solve_tridiagonal.F

Legend:
Removed from v.1.2281  
changed lines
  Added in v.1.2350

  ViewVC Help
Powered by ViewVC 1.1.22