/[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.2040 by jmc, Wed Aug 6 23:19:25 2014 UTC revision 1.2091 by mlosch, Mon Nov 17 09:44:26 2014 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/ctrl : add generic pre-processing (xx_genarr2d_preproc etc)
8      - remove xx_genarr2d_numsmooth etc
9      - use xx_genarr2d_preproc etc instead
10      - carry out smooth_correl2D at initialization
11      stage rather than during time stepping.
12      - get smoothOpNb from xx_gentim2d_preproc
13    o global_oce_cs32 :
14      - add test of generic ecco capabilities.
15    o pkg/exf/exf_getsurfacefluxes.F :
16      - add to tmpUE/tmpVN rather than re-initializing them (conventional behavior).
17    o pkg/ctrl,ecco :
18      -  omit un-necessary arguments to ctrl_cost_gen.F
19      unless ECCO_CTRL_DEPRECATED is defined.
20    o pkg/seaice: add diagnostics for Delta (deformation parameter)
21    o model/src:
22      - when ALLOW_3D_DIFFKR is defined, add a STOP if any of the vertical
23        diffusivity (background) is specified but ignored.
24    o verification:
25      - in testreport, convert hostname to lower case for default output dir name
26    o model, pkg : add useCTRL, useECCO parameters (on/off run time switch).
27    o pkg/dic: add modifications from Hajoon:
28      - add iron sedimentation flux function of the flux of PO4 out of bottom layer
29      - light attenuation: add self-shading effect by climatological Chlorophyll
30        (read from file).
31    o pkg/seaice/seaice_preconditioner.F : fix cpp flags, so that code also
32        compiles when SEAICE_ALLOW_DYNAMICS is undefined
33    o global_oce_llc90,cs32 : ecco_v4 verification exps now use separate
34        AUTODIFF_OPTIONS.h, CTRL_OPTIONS.h, ECCO_OPTIONS.h rather than
35        ECCO_CPPOPTIONS.h (i.e. replacing the deprecated, circumvoluted,
36        approach where CPP_OPTIONS.h includes an omnipotent
37        ECCO_CPPOPTIONS.h that superseeds pkgs '_OPTIONS.h').
38    o pkg/ctrl/ctrl_map_ini_genarr.F : include GMREDI_OPTIONS.h where
39        ALLOW_3D_KAPGM, ALLOW_3D_KAPREDI (to be added later) belong.
40    o pkg/seaice/SEAICE_SIZE.h : replace ALLOW_AUTODIFF_TAMC with ALLOW_AUTODIFF
41        to avoid needing AUTODIFF_OPTIONS.h anytime SEAICE_SIZE.h is included
42        (it seems that THSICE_SIZE.h, PTRACERS_SIZE.h have the same issue...)
43    o model/src, pkg/smooth, profiles, salt_plume, seaice, exf, ecco, ctrl :
44      add ECCO_OPTIONS.h, AUTODIFF_OPTIONS.h, CTRL_OPTIONS.h when needed
45      - ECCO_OPTIONS.h is needed when including ecco_cost.h, ecco.h
46      - AUTODIFF_OPTIONS.h is needed when including tamc.h, tamc_keys.h
47      - CTRL_OPTIONS.h is needed when including ctrl.h, optim.h, etc
48    o pkg/ctrl,ecco,exf :
49      - remove variables associated with NON-generic costs,
50        unless ECCO_CTRL_DEPRECATED is defined.
51      - remove NON-generic NON-obcs controls,
52        unless ECCO_CTRL_DEPRECATED is defined.
53    o pkg/ctrl : added ctrl_local_params.h
54    o pkg/ecco : added ecco_local_params.h
55    o verification : added ECCO_CTRL_DEPRECATED to most as and oad
56        experiments, which will progressively be removed once the
57        experiments are revised to use only generic controls/costs.
58    
59    checkpoint65f (2014/10/13)
60    o pkg/ctrl, ecco, seaice : minor changes in headers
61    o global_oce_llc90,cs32 : ecco_v4 verification exps now test generic
62        cost function and control capabilities added since checkpoint65c.
63    o pkg/ctrl: regroup all obcs ctrl variables in CTRL_OBCS.h.
64    o pkg/ecco: increase modularity and improve logic
65      - ecco_toolbox.F (new) : basic operations that are often used,
66        including ecco_zero, ecco_cp, ecco_cprsrl, ecco_diffmsk,
67        ecco_addcost, ecco_add, ecco_div, ecco_readbar.
68      - cost_gencal.F (new) : determine filnames and records.
69      - cost_genread.F, cost_generic.F : condense code using ecco_toolbox.
70      - cost_generic.F : use spzeroloc rather than hard-coded -9999,
71        and exploit the above functions leading to more compact code.
72      - cost_genread.F : rm un-necessary arguments, re-arrange args order.
73      - ecco_check.F, ecco_readparms.F : bring logic up to date (using_tpj,
74        using_ers, using_gfo, using_mdt is now only defined within gencost)
75    o pkg/ecco: extend generic cost capabilities
76      - pkg/ecco : added 3D gencost (ALLOW_GENCOST3D), added gencost
77        capabilities via gencost_preproc (+ _c,_i,_r related params),
78        gencost_posproc (+ _c,_i,_r related params), gencost_nrecperiod,
79        gencost_outputlevel arguments to cost_generic
80      - pkg/ecco/cost_genread.F (new) : interface between cost_generic
81        and active_read, making room for gencost_preproc to take effect.
82        Added preproc code ('climmon') to replace GENERIC_BAR_MONTH.
83      - pkg/ecco/cost_generic.F :
84        compute and store misfit maks*(model-data) in localdif that is
85        then used in cost and for output, output misfit if outlev.GT.0
86      - pkg/ecco/cost_averagesfields.F : depend on gencost_barskip
87        rather gencost_barfile for deciding whether to write barfile
88      - pkg/ecco/ecco_cost_driver.F : extract call to cost_profiles from cost_hyd
89      - pkg/ecco/ecco_cost_init_fixed.F : extract gencost weights from
90        ecco_cost_weights, re-activate ecco_summary, determine gencost_barskip
91      - pkg/ecco/ecco_summary.F : report gencost variables
92      - pkg/ecco/cost_gencost_customize.F : treat case of scatterometer costs
93    o pkg/sea/SEAICE_OPTIONS.h : add ALLOW_COST_ICE, ALLOW_SEAICE_COST_SMR_AREA
94    o pkg/ecco: internal re-organization
95      - resolve un-necessary dependancies within pkg/ecco and to pkg/ctrl
96        (rm includes of optim.h and ctrl.h, replace optimcycle with eccoiter,
97        mv relevant variables definition from ecco_cost.h to ecco.h,
98        make sure gencost routines only include ecco.h)
99      - throughout : add missing CCP switches, rm unused variables,
100        and rm un-necessary CPP switches
101      - throughout gencost routines : replace modelstartdate with
102        gencost_startdate when needed
103      - cost_bp_read.F : use arguments, instead of common blocs
104        so that it can be used also by (new) cost_gencost_bpv4.F
105      - ecco_init_varia.F : initialize RHOsumGlob_0, VOLsumGlob_0
106      - ecco_phys.F : compute etanFull
107      - ecco_readparms.F : rename using_topex as using_tpj, add
108        bpv4-grace to gencost list, initialize added parameters
109      - ecco_summary.F : include SIZE.h needed for augmented ecco.h
110    
111    checkpoint65e (2014/09/28)
112    o pkg/obcs:
113      - replaced the just-added CPP options with run-time variables
114        (see pkg/obcs/OBCS_PARAMS.h for details)
115    o pkg/obcs:
116      - add additional CPP options for sponge boundary layers
117        (see pkg/obcs/OBCS_OPTIONS.h for details)
118    o pkg/atm_phys:
119      - implement simple (obliquity only, assuming circular planet orbit)
120        seasonal cycle for incoming insolation ; used when run-time parameter
121        "select_incSW" is set to 1 ; by default (=0), uses old unchanged formula.
122    o pkg/exf, pkg/ecco, pkg/ctrl:
123      - add ctrlUseGen and .NOT.ctrlUseGen exclusive brackets
124      - activate gentim2d for xx_atemp,xx_aqh,xx_swdown,xx_lwdown,xx_precip
125      - implement gentim2d for xx_tauu, xx_tauv
126    o pkg/ctrl, pkg/ecco :
127      - fix and complement the generic controls implementation
128    o pkg/exf/exf_getclim.F, exf_getffields.F, exf_getsurfacefluxes.F,
129        pkg/shelfice/shelfice_thermodynamics.F,
130        verification/hs94.1x64x5/code_ad/ctrl_map_gentim2d.F,
131        verification/hs94.1x64x5/code_oad/ctrl_map_gentim2d.F :
132      - add weight in CTRL_GET_GEN calls
133    o pkg/ctrl :
134      - ctrl_get_gen.F : add weight as input parameter, and apply
135        it directly rather than using smooth_correl2Dw (to be retired).
136      - ctrl_map_gentim2d.F : add wgentim2d in CTRL_GET_GEN call
137    o pkg/ctrl :
138      - introduce run time switch ctrlUseGen (in ctrl.h, ctrl_check.F,
139        ctrl_init_variables.F, ctrl_readparms.F, ctrl_summary.F)
140      - re-activate ctrl_summary (call in ctrl_init.F)
141    o pkg/ctrl/ctrl_cost_gen.F :
142      - fix CCP brackets, remove un-necessary myiter, mytime
143    o pkg/ecco, pkg/ctrl :
144      - remove cost_genctrl.F (now pkg/ctrl/ctrl_cost_driver.F)
145      - remove cost_forcing_gen.F (now pkg/ctrl/ctrl_cost_gen2d.F)
146      - add ctrl_cost_driver.F (replaces pkg/ecco/cost_genctrl.F)
147      - add ctrl_cost_gen2d.F (replaces pkg/ecco/cost_forcing_gen.F)
148    
149    checkpoint65d (2014/09/15)
150    o pkg/ctrl/CTRL_GENARR.h, ctrl_readparms.F :
151      - add xx_genarr2d_bounds,xx_genarr3d_bounds,
152        xx_genarr2d_numsmooth, xx_genarr3d_numsmooth
153    o pkg/ctrl/ctrl_map_ini_genarr.F :
154      - remove compilation failure
155      - replace hard coded example
156      - use ctrl_map_ini_gen2D, 3D
157    o pkg/ctrl/ctrl_pack.F, ctrl_unpack.F :
158      - on/off switch based upon xx_genarr2d_weight,3d
159    o src/packages_init_variables.F :
160      - regroup pkg/estimation calls
161      - remove CTRL_MAP_INI, CTRL_MAP_INI_ECCO
162        (moved to ctrl_init_variables)
163    o cost/cost_init_varia.F :
164      - remove ecco_cost_init_varia
165        (moved to ecco_init_varia)
166    o ctrl/ctrl_init_variables.F :
167      - add CTRL_MAP_INI, CTRL_MAP_INI_ECCO
168      - add CTRL_MAP_INI_GENARR, SEAICE_CTRL_MAP_INI
169    o ctrl/ctrl_map_ini.F :
170      - remove ctrl_map_ini_genarr, seaice_ctrl_map_ini
171        (moved to ctrl_init_variables)
172    o ctrl/ctrl_map_ini_ecco.F :
173      - remove ECCO_PHYS (mv to ecco_init_varia)
174      - remove seaice_ctrl_map_ini (mv to ctrl_init_variables)
175    o ecco/ecco_ad_diff.list :
176      - add ecco_init_varia.f
177    o ecco/ecco_init_varia.F
178      - new routine
179    o pkg/streamice:
180      - move call to STREAMICE_INITIALIZE_PETSC from the_model_main.F
181        to streamice_init_fixed.F ; fix setting of STREAMICEisOn.
182      - from model/src, only call pkg/streamice routines if useStreamIce is TRUE.
183    o pkg/generic_advdiff:
184      - fix bug causing negatives in GAD_SMOLARKIEWICZ_HACK, introduced 8/8/2014.
185    o pkg/exf:
186      - exf_getffields.F : add xxg_atemp, xxg_aqh, xxg_swdown, xxg_lwdown,
187         xxg_precip capability
188      - exf_wind.F : no need for ALLOW_WSPEED_CONTROL cpp switch
189    o pkg/ctrl:
190      - ctrl_pack.F, ctrl_unpack.F : omit (un)packing of undefined xx_gentim2d
191    o model/src/load_fields_driver.F :
192      - move call to CTRL_MAP_GENTIM2D ahead of BULKF_FIELDS_LOAD, EXF_GETFORCING
193        so xx_gentim2d can be applied to e.g. exf fields in a timely manner.
194    o OpenAD verification experiments:
195      - Include explicitly AUTODIFF_OPTIONS.h, COST_OPTIONS.h, and CTRL_OPTIONS.h
196        in src files (to enable to skip the ECCO_CPPOPTIONS.h);
197        for now, only in pkgs used in OpenAD verification experiments.
198      - Change all except one (halfpipe_streamice) OpenAD experiments to use pkg
199        specific option file (AUTODIFF_OPTIONS.h, COST_OPTIONS.h & CTRL_OPTIONS.h)
200        instead of using ECCO_CPPOPTIONS.h (with all relevant options in it).
201        This applies to both TAF (*/code_ad/) and OpenAD (*/code_oad/) tests.
202    o OpenAD verification tests:
203      - finish removing ALLOW_AUTODIFF_OPENAD (replaced by ALLOW_OPENAD);
204      - finish replacing ALLOW_AUTODIFF_TAMC by ALLOW_AUTODIFF (except for
205        tape/storage which are specific to TAF/TAMC) in pkgs used in OpenAD exp.
206      - leave ALLOW_AUTODIFF_TAMC undef in OpenAD verification tests (*/code_oad/)
207        and remove local copy of "tamc.h" (needed only if ALLOW_AUTODIFF_TAMC).
208    o model/src & generic_advdiff:
209      - change hard-coded loop-range in S/R APPLY_FORCING_T/S to set T & S
210        forcing over 0:sNx+1, 0:sNy=1 (instead of just 1:sNx,1:sNy): Model
211        dynamics requires valid tracer forcing only over tile interior but, for
212        some diagnostics, may need to extend it over 1 point in tile halo region.
213      - in gad_calc_rhs.F, update calls to gmredi_x/ytransport to get valid
214        tendency over i,j_Min,Max range. This allows to simplfy i,j_Min,Max
215        setting in temp/salt/ptracer_integrate.F
216    o pkg/dic:
217      - multiply tracer tendencies by maskInC (if ussing OBCS) before updating
218        gchem tracers: this allows to skip the 2nd call to OBCS_APPLY_PTRACER
219        in gchem_forcing_sep.F
220    o pkg/autodiff & obcs:
221      - add storage of current OB values for U & V (was already done for T & S).
222    
223    checkpoint65c (2014/08/30)
224    o pkg/dic:
225      - take out of dic_atmos.F the initialisation part (corresponding to istate=0)
226        and move it to new S/R DIC_INI_ATMOS ; also simplify the dependencies for
227        AD compilers (but still a Pb with multi-threading and Ajoint dependencies).
228    o verification:
229      - new experiment testing OBCS and DIC pkgs, using params & output from
230        tutorial_global_oce_biogeo but limited to a sub-domain around Drake
231        passage: take OBCS from the last year of a 2 yrs simulation and initial
232        conditions from t=1.yr while keeping the same forcing.
233    o model/src:
234      - when allowFreezing=T, only reset below freezing initial Temp to Tfreezing
235        (at any k) if checkIniTemp is not set to FALSE (default checkIniTemp=T).
236    o pkg/diagnostics (Stats-Diags):
237      - re-write S/R DIAGSTATS_CALC (more similar to TARGET_NEC_SX part) to:
238        a) refine region where stats are computed, excluding where arrhFac=0 ;
239        b) fix missing interior mask (use with OBCS) in 3-D fields statistics;
240        c) extend regional stats over the region edges (for U or V pt location).
241    o pkg/gchem:
242      - add a (2nd) call to OBCS_APPLY_PTRACER in gchem_forcing_sep.F (needed since
243        pkg/dic is currently changing/updating ptracers values beyond the OB).
244    o verification (hs94):
245      - convert Held & Suarez external_forcing.F (from hs94.cs, with Sigma-coords
246        bits) to apply_forcing.F and undef USE_OLD_EXTERNAL_FORCING in experiments
247        hs94.cs-32x32x5 and tutorial_held_suarez_cs ; also use the same version of
248        apply_forcing.F in 2D hs94 (fwd, ad & oad) but keep LatLon hs94 unchanged.
249    o pkg/ptracers:
250      - implement Adams-Bashforth on pTracers (instead of on tracer tendency),
251        switched on by setting PTRACERS_doAB_onGpTr=F (default set to doAB_onGtGs)
252      - change exp4 secondary test (input.nlfs) to test AB on T & S & pTracer
253        with AB-2 code (so that it get tested).
254    o model/src:
255      - allow to apply Adams-Bashforth on Temp & Salt (instead of on gT,gS)
256        with AB-2 code (previously only available with AB-3 code).
257        Also move the code (call to ADAMS_BASHFORTH S/R) form thermodynamics.F
258        to temp/salt_integrate.F (since the 2nd part of gt/sNm1 update is done
259        there, by calling CYCLE_AB_TRACER).
260    o pkg/generic_advdiff:
261      - change Tracer argument (drop bi,bj indices) in S/R GAD_CALC_RHS,
262        GAD_C2_ADV_R, GAD_U3_ADV_R, GAD_C4_ADV_R, GAD_DIFF_R, GAD_BIHARM_R
263        + also in GMREDI_X/Y/RTRANSPORT ; and update corresponding calls in
264        S/R temp/salt/ptracers_integrate.F
265    o model/src & pkg/ptracers:
266      - remove common block variables gT,gS (in DYNVARS.h), except when
267         USE_OLD_EXTERNAL_FORCING is defined; update TAF storage accordingly.
268      - remove common block variable gPtr.
269    o model/src & pkgs:
270      - change gTracer (and/or tracer) argument (drop bi,bj indices) in S/R
271         ADAMS_BASHFORTH(2&3), CYCLE_(AB_)TRACER, FREESURF_RESCALE_G,
272         IMPLDIFF, SOLVE_TRIDIAGONAL & _PENTADIAGONAL, GAD_SOM_ADVECT,
273         GAD_ADVECTION, GAD_CALC_RHS, GAD_IMPLICIT_R, TIMEAVE_CUMUL_DIF_1T
274      + change accordingly all calling S/R.
275      - use local temperature/salinity/ptracer tendency array (without bi,bj)
276        in S/R temp/salt/ptracers_integrate.F
277    o pkg/seaice:
278      - move computation of stress contributions to rhsU/V in s/r seaice_lsr
279        to separate s/r seaice_lsr_rhsu/v in order to be able to re-use code
280      - make u/vIceC local variables if SEAICE_CGRID is defined only to be used
281        in seaice_lsr
282      - seaice_lsr.F: make local 4D arrays UXX, VYY, etc 2D
283        in s/r seaice_lsr_calc_coeffs
284    o pkg/mdsio:
285      - in MDS_READ/WRITE_FIELD, stop if file-name (+prefix) is too long
286        (e.g., > MAX_LEN_MBUF -90 ) or, in INI_MODEL_IO, if mdsioLocalDir is
287        too long (e.g., > MAX_LEN_FNAM/2 )
288    
289    checkpoint65b (2014/08/12)
290    o pkg/matrix:
291      - pass, as argument, updated tracer field to S/R MATRIX_STORE_TENDENCY_EXP
292    o model/src:
293      - fix initialisation of geothermalFile; compile geothermal-flux code in
294        natl_box verification experiment.
295    o model/src & pkg/down_slope:
296      - push the k loop inside S/R TIMESTEP_TRACER (now called outside the k loop).
297      - in dwnslp_apply.F, update tracer tendency instead of the future tracer
298        field and call S/R DWNSLP_APPLY before TIMESTEP_TRACER; this affects
299        results at machine truncation level: update output of experiments
300        global_ocean.90x40x15.dwnslp (FWD) and lab_sea.noseaicedyn (AD).
301    o pkg/diagnostics (Stats-Diags):
302      - do not cumulate the full volume when DIAGNOSTICS_FILL is
303        called with bibjFlg < 0 (no increment of the counter for 2D/3D diag);
304        This fix the mean statistics when DIAGNOSTICS_FILL is called multiple
305        times (but Min,Max and StD are still wrong).
306    o model/src:
307      - add geothermal flux forcing: read in ini_forcing.F as time-constant
308        field "geothermalFlux" applied in S/R APPLY_FORCING_T (apply_forcing.F)
309    o model/src:
310      - move CYCLE_TRACER calls from tracers_correction_step.F to temp/salt/ptracer
311        _integrate.F so that, when leaving S/R THERMODYANMICS, theta,salt and pTrac
312        arrays are already updated while adjustments (filters, conv.adjustment) are
313        still applied later, in S/R TRACERS_CORRECTION_STEP.
314  o model/src:  o model/src:
315    - store in common bloc array "rhoInSitu" the virtual potential temperature    - store in common bloc array "rhoInSitu" the virtual potential temperature
316      anomaly that is used to compute geopotential: this make the atmos code      anomaly that is used to compute geopotential: this make the atmos code
# Line 82  o model/src: Line 389  o model/src:
389    - collect T & S forcing tendency into local 2-D array (passed as argument to    - collect T & S forcing tendency into local 2-D array (passed as argument to
390      apply_forcing S/R); add 3-D diagnostics for temp & salt forcing tendency.      apply_forcing S/R); add 3-D diagnostics for temp & salt forcing tendency.
391      affects results at machine truncation level (e.g., ocean: if using      affects results at machine truncation level (e.g., ocean: if using
392      SHORTWAVE_HEATING and atmos:, if using FrictionHeating or (atm_Rq<>0)      SHORTWAVE_HEATING ; atmos: if using FrictionHeating or (atm_Rq<>0) moist
393      moist correction due to vertical advection).      correction due to vertical advection).
394    - update output of experiments: fizhi-cs-32x32x40 (13 digits),    - update output of experiments: fizhi-cs-32x32x40 (13 digits),
395      global_ocean.cs32x15 (fwd: icedyn, seaice, thsice, all 3 @ 11d; adm & tml:      global_ocean.cs32x15 (fwd: icedyn, seaice, thsice, all 3 @ 11d; adm & tml:
396      seaice_dynmix & thsice, fwd grd @ 3 & 8), hs94.1x64x5 (ad grd @ 13),      seaice_dynmix & thsice, fwd grd @ 3 & 8), hs94.1x64x5 (ad grd @ 13),

Legend:
Removed from v.1.2040  
changed lines
  Added in v.1.2091

  ViewVC Help
Powered by ViewVC 1.1.22