/[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.1656 by jmc, Thu Apr 26 13:49:29 2012 UTC revision 1.1703 by jmc, Fri Aug 3 18:51:48 2012 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/autodiff:
8      re-write active I/O high-level (control) S/R:
9      - rename  S/R ACTIVE_READ/WRITE_RL to ACTIVE_READ/WRITE_3D_RL
10      - add 1 more argument (useCurrentDir) to replace the "_LOC" 2nd set of S/R.
11      - use standard pkg/mdsio I/O routines (MDS_READ/WRITE_SEC_XZ/YZ  and
12        MDS_READ/WRITE_FIELD); change loops to multi-threads.
13      - update and merge active_file_control_slice.flow into active_file_control.flow
14      - update the calls in lower level S/R (active_file.F, active_file_g.F and
15        active_file_ad.F) keeping the argument list and function unchanged.
16      - also update lower-level "_LOC" version (call same S/R with "useCurrentDir
17        =.TRUE.") and remove high-level (control) _loc version (not called anymore).
18    o autodiff and RS=real*4:
19      - call the right type (_RS instead of _RL) of S/R in few output S/R (pkg/exf
20        ad-monitor and snapshots); disable arrType='RS' in mdsio_gl*.F ;
21      - change argument type of 3-D mask argument to _RS to match type in the call
22        (in seaice_cost*.F, ctrl_*_gen.F and *ctrl_bound.F); to be continued.
23    o pkg/thsice:
24      - re-anable balanceEmPmR when useSEAICE=T with useThSIce=T.
25      - option to correct ocean fresh-water flux for imbalance of Atmos+Land
26        fresh-water flux: uniform correction or proportional to local precip.
27    o pkg/ctrl:
28      - new header file CTRL_SIZE.h for parameters maxCtrlArr2D, maxCtrlArr3D
29      - redefine CPP option ALLOW_BOTTOMDRAG_CONTROL to
30                            ALLOW_BOTTOMDRAG_CONTROL_NONGENERIC
31      - verification/hs94.1x64x5/ tests ALLOW_GENARR{2D,3D}_CONTROL
32    
33    checkpoint63q (2012/07/30)
34    o pkg/autodiff:
35      note about monitor and snap-shot of ad-variables:
36      a) need to apply ADEXCH before monitor or output of ad-vars to include
37       overlap contributions (was done for adjDump but missing for monitor).
38      b) since ADEXCH implies adding overlap values to interior array, machine
39       truncation error is expected when adding an ADEXCH call in the middle of
40       the time-stepping (although mathematically identical).
41      modifs:
42      - fix some incorrect type (RL/RS, UV/scalar) in ADEXCH calls and ad-vars
43        declaration (adEddyPsiX,adEddyPsiY in adcommon.h).
44      - add new run-time params (dumpAdVarExch & mon_AdVarExch) to select how  to
45        apply ADEXCH before monitor or snap-shot of ad-variables:
46           =0 : no ADEXCH ; =1 : do ADEXCH ; =2 : apply ADEXCH on a local copy.
47      - implement new method (copy+adexch) for snap-shot and monitor of main model
48        ad-vars (initially not used by default -> output unchanged).
49      - change default (set to 2) to use new method and update few output_adm.txt
50        with accurate ad-monitor (global_ocean.90x40x15, tutorial_global_oce_biogeo
51        and both tutorial_tracer_adjsens tests).
52      - switch 2 global_ocean.cs32x15 AD-tests to AB-2 (seaice_dynmix & thsice)
53        and turn off momDissip_In_AB in the 2 other (needed for stable AB-3).
54    o pkg/ctrl:
55      enable the use of a variable number (maxCtrlArr2D, maxCtrlArr3D) of
56      generic control variables via
57      #define ALLOW_GENARR2D_CONTROL and/or #define ALLOW_GENARR3D_CONTROL
58      Only required customization should be S/R ctrl_map_ini_genarr.F
59      (routine in repository contains example)
60    o pkg/exf:
61      - fix and refine checking of surface-relaxation setting when using EXF
62    o verification (adjoint exp):
63      - reduce length of simulation by half for experiment global_ocean.cs32x15
64        (std, seaice & seaice_dynmix) and exp tutorial_dic_adjoffline; update output.
65    o pkg/mom_common (mom_u/v_bottomdrag), pkg/shelfice (shelfice_u/v_drag)
66      - replace if statements KE.ne.0 with KE.gt.0 to avoid sqrt of negative numbers
67        of KE that can occur with aggressive optimization
68      + put quadratic bottom drag calculation in separated loops (only done if
69        using bottomDragQuadratic)
70    o model/src: CG2D_NSA
71      - clean-up:  stop if cg2dNormaliseRHS=T and AUTODIFF
72         and replace GLOBAL_SUM calls with GLOBAL_SUM_TILE.
73      - in test-exp that uses CG2D_NSA (bottom_ctrl & tutorial_tracer_adjsens),
74         change cg2d residual target to be expressed in Wunits (=> do not normalise
75         RHS ; this fix global_max Pb with TAF); update output.
76    o verification/tutorial_tracer_adjsens:
77       improve parameter consistency (and get rid of warnings):
78       - use deltaTFreeSurf=deltaTtracer (better with NonLin FreeSurf);
79       - switch Temp Adv Scheme from 81 to 80 (no limiter since theta < 0 is physical)
80       - use staggerTimeStep (for stability) in som81; use default rotation period.
81    o pkg/exch2:
82      - with empty facet: fix compact-format (W2_mapIO=1) definition (was previously
83        reset to 0 = 1 long line in X)
84    o pkg/mdsio:
85      - fix reading of dimensions from meta file for large-size domain
86    o model/src:
87      - fix saltIsActiveTr setting for IdealGas eosType (eosType is 6 character long);
88      - to refine CS-grid check, add logical flag "hasWetCSCorners": true if using
89        Cubed-Sphere Exch with CS-corners inside the domain;
90        make new S/R INI_GLOBAL_DOMAIN from code in ini_linear_phisurf.F to calculate
91        globalArea and to set hasWetCSCorners.
92      - add warning if usingCurvilinearGrid and momAdvection in flux-form (missing
93        metric terms); stop if hasWetCSCorners=T and momAdvection in flux-form.
94      - re-activate the stop if useCDscheme and hasWetCSCorners=T (previously if
95        useCDscheme and useCubedSphereExchange).
96    o pkg/seaice/seaice_growth.F :
97      - compute the SEAICE_DISABLE_HEATCONSFIX term accordingly
98        for the (.NOT.useRealFreshWaterFlux).OR.(nonlinFreeSurf.EQ.0)
99        when the previous code was not correct.
100      - in all cases diagnoze the boundary condition mismatch to SIaaflux
101      - in the case of useRealFreshWaterFlux.AND.(nonlinFreeSurf.GT.0) add
102        that term to QNET (essentially to set the melt/freeze water to 0degC).
103        when SEAICEheatConsFix is true, so that the ocean+ice budget heat is closed.
104    o verification/global_ocean.cs32x15/input.seaice :
105      - add SEAICEheatConsFix in data.seaice, ensuring closed ocean+ice heat budget.
106      - add diagnostics (commented out) for budget test using my matlab codes (gcmfaces).
107      - update results (output.seaice.txt) accordingly.
108    o verification/lab_sea/input/data.seaice :
109      - remove SEAICEheatConsFix, which is now be tested
110        in global_ocean.cs32x15. The presently coded fix
111        is only consistent with real fresh water + nlfs.
112      - update results (output.txt) accordingly.
113    o pkg/salt_plume: added diagnotic for salt tendency (oceSPtnd).
114    o AD_CONFIG.h file:
115      - in genmake2: remove "#undef ALLOW_ECCO_OPTIMIZATION" from AD_CONFIG.h;
116      - remove #include "AD_CONFIG.h" from all included OPTIONS files and
117        add it explicitly in each fortran src file where it is needed.
118        motivation: header file AD_CONFIG.h is generated/modified after "make depend"
119        thus introducing potentially wrong dependency; therefore, better to include
120        it only where it's really needed, and after any other included OPTIONS file
121        (less tempting to bring conditional includes according to ALLOW_ADJOINT_RUN
122        or ALLOW_TANGENTLINEAR_RUN).
123    
124    checkpoint63p (2012/07/06)
125    o pkg/autodiff:
126      - rename S/R INI_AUTODIFF to AUTODIFF_INIT_VARIA ;
127      - create new header file "AUTODIFF_PARAMS.h" for pkg/autodiff parameters
128        which are now read from new parameter file "data.autodiff" (inAdExact
129        previously in "data", use{KPP/GMRedi/SEAICE}inAdMode previously in data.pkg)
130      - add file "data.autodiff" in all verification/*/input_ad/ directories.
131      - add run-time parameter to turn On/Off SEAICEuseFREEDRIFT in adjoint/forward
132        mode (used in global_ocean.cs32x15.seaice_dynmix test exp.)
133    o verification/tutorial_tracer_adjsens/
134      - add extra sub-verification which uses "SOM" advection scheme
135        (2nd Order-Moment Advection Scheme, Prather Limiter) with
136          #define GAD_ALLOW_TS_SOM_ADV in GAD_OPTIONS.h
137        and in data:
138          multiDimAdvection=.TRUE.,
139          tempAdvScheme=81,
140          saltAdvScheme=81,
141    o model/src:
142      - introduce ALLOW_BALANCE_RELAX which allow the removal
143       of the global mean of relaxation terms by setting
144       balanceThetaClimRelax and balanceSaltClimRelax
145      - disable balanceEmPmR and balanceQnet in the case when useSeaice.
146       This case is now treated appropriately in seaice_growth.F
147    o pkg/seaice:
148      - do balanceEmPmR and balanceQnet based on the net fluxes
149        (SItflux) that enter the ocean+ice system rather than QNET
150        and EMPMR. Works best in real fresh water.
151      - SIatmFW, SIatmQnet, and SItflux computations had to be moved
152        out of the diagnotics bloc, and stored in global arrays.
153    
154    checkpoint63o (2012/06/29)
155    o vertical mixing schemes:
156      - remove unused S/R CALC_BUOYANCY (left from branch-atmos merging)
157      - replace computation of density (in Function STATE1, opps_calc.F) by a call
158        to S/R FIND_RHO_SCALAR
159      - pass sigmaR to S/R PP81_CALC, MY82_CALC (but not yet used) and to GGL90_CALC
160        and use it for N^2 calculation in ggl90_calc.F (save 2 density computations);
161        affects output (vermix.ggl90) at truncation level.
162    o testreport:
163      - change adjustment of SIZE.h for mpi+mth testing: preserve enough tiles
164        (nSx,nSy) for the number of threads (from eedata.mth)
165    o model/src:
166      - remove 2nd set of calls at the top of initialise_varia.F (Adjoint part)
167        related to Non_Lin Free-Surf or Bottom-Control (but not longer necessary).
168    o verification/tutorial_tracer_adjsens/
169      - compile with ALLOW_CG2D_NSA
170      - run with nonlinFreeSurf=3
171      - update reference output_adm.txt
172    o tools/genmake2:
173      - add "-DHAVE_NETCDF" to the DEFINES list when NetCDF is available ;
174        refine usePROFILES switching off (only when NetCDF is not available).
175    o verification (atmospheric set-up):
176      - change eosType='IDEALGAS' to eosType='IDEALG' to match variable declaration
177    o pkg/profiles : refine profiles and files handling.
178    o model/src and pkg/ecco : introduce run-time switch usePROFILES.
179    o model/src/the_main_loop.F, forward_step.F and pkg/exf/EXF_OPTIONS.h :
180      - changes to use model/src/the_main_loop.F rather than the ecco version
181        in ecco type adjoint runs.
182    o model/src:
183      - move computation of recip of grid distance & area from INI_MASKS_ETC to INI_GRID
184      - move setting of h0Fac[C,W,S] from INI_LINEAR_PHISURF to INI_MASKS_ETC
185      - update_masks_etc.F: rename SMOOTH*_R4,R8 function to the corresponding type (RS,RL)
186    o model/src:
187      - fix S/R UPDATE_CG2D for ALLOW_DEPTH_CONTROL case (was empty before);
188        update output of test experiment bottom_ctrl_5x5.
189    o pkg/generic_advdiff:
190      - implement vertical bi-harmonic diffusion (for now, only for T & S and
191        only explicitly).
192    o verification/bottom_ctrl_5x5/
193      update reference output (results changed quite some time ago,
194      not sure when; but new reference results look ok in terms of grdchk)
195    o verification/1D_ocean_ice_column/
196      For verification purposes, the exact adjoint rather than an approx.
197      should be used (e.g., to comare against F.D. or TLM).
198      removed autodiff_inadmode*_ad.F routines in code_ad/
199      Update results/ accordingly.
200    o pkg/cal:
201      - change cal_getdate.F so that output date is function of input time only
202        (less ambiguous, not mixed up with input iteration number).
203      - fix calendarDumps for non-zero phase-lag (S/R CAL_TIME2DUMP).
204    o pkg/diagnostics:
205      - implement calendarDumps also for stats-diags
206      - implement calendarDumps also for snap-shot output (negative freq)
207      - for now, ignores calendarDumps if non-zero phase-lag.
208    
209    checkpoint63n (2012/06/04)
210    o model/src:
211      - recompute rSurfW & S to ensure consistent column thickness (needed for rStar)
212        between Sum_k(hFac*drF) and rSurf-rLow, for now only when using pkg/shelfice;
213      - use h0FacC, W & S to compute hFac_surfC, W & S in calc_surf_dr.F (more
214        similar to calc_r_star.F); update results of experiment internal_wave and
215        tutorial_global_oce_in_p (affected @ truncation level).
216    o pkg/shelfice:
217      - add parameterisation of advective-diffusive flux into the ice shelf
218        according to Holland and Jenkins (1999), eq.22-33, as suggested by Jan De Ryd
219      - simply eps3/3a computation
220    o eesupp:
221     - add new CPP option (DISCONNECTED_TILES) to disconnect tiles (no exchange
222       between tiles, just fill-in edges assuming locally periodic subdomain) and
223       add corresponding exchange subroutines (EXCH0);
224     - new CG-solver version (_EX0) for disconnected-tiles special case.
225    o model/src (CG-solvers):
226     - modify Single-Reduction version (CG2D_SR) in case cg2dMaxIters is reached
227       (similar final residual output and max-Iter number as with standard version);
228     - allows to store and use lowest-residual solution (standard & _SR versions);
229     - cleaning up (remove old, commented out code, LETS_MAKE_JAM ...).
230     - by default, also compile CG2D_SR version (define ALLOW_SRCG in CPP_OPTIONS.h)
231    o eesup/src:
232     - global_vec_sum.F cleaning: add a BARRIER ; update comments ; remove ndef
233       ALWAYS_USE_MPI (no longer needed after fixing usingMPI settings - March 2012)
234    o pkg/salt_plume added to lab_sea/input_ad.noseaicedyn
235    
236    checkpoint63m (2012/04/27)
237  o pkg/shelfice:  o pkg/shelfice:
238   - account for partical cells in surface level below ice-shelf for hydrostatic   - account for partical cells in surface level below ice-shelf for hydrostatic
239     pressure calculion (set uniformFreeSurfLev to F); update isomip experiments.     pressure calculion (set uniformFreeSurfLev to F); update isomip experiments.

Legend:
Removed from v.1.1656  
changed lines
  Added in v.1.1703

  ViewVC Help
Powered by ViewVC 1.1.22