4 |
Notes on tags used in MITgcmUV |
Notes on tags used in MITgcmUV |
5 |
============================== |
============================== |
6 |
|
|
7 |
|
o tools/genmake2: |
8 |
|
- define variable MAKE within Makefile and use it in place of 'make'; |
9 |
|
- update AD_CONFIG.h (if needed) before building any of the executable |
10 |
|
(forward, adjoint or tangent-lin); this involves a 2nd invocation of make; |
11 |
|
and add the usual #ifndef/#define AD_CONFIG_H in AD_CONFIG.h; |
12 |
|
- always print usual warning comment 'this file is automatically generated' |
13 |
|
from script convert_cpp_cmd2defines (+ remove this warning from genmake2). |
14 |
|
o pkg/exf: |
15 |
|
added run time switch useAtmWind to replace ALLOW_ATM_WIND cpp switch. |
16 |
|
ALLOW_ATM_WIND now just sets the useAtmWind default (see exf_readparms.F) |
17 |
|
and force defines ALLOW_BULKFORMULAE (EXF_OPTIONS.h). |
18 |
|
o pkg/exf, autodiff, ctrl, ecco and seaice: |
19 |
|
remove ALLOW_ATM_WIND brackets, or replace them with useAtmWind ones. |
20 |
|
o pkg/ctrl, ecco: |
21 |
|
allow to compile both ALLOW_U/VSTRESS_CONTROL and ALLOW_U/VWIND_CONTROL. |
22 |
|
Depending on useAtmWind, one is inactive, and the other is active (see |
23 |
|
exf_getffields.F/exf_getsurfacefluxes.F). |
24 |
|
o tools/genmake2: |
25 |
|
- improve error msg when failing in 2nd test of check_for_broken_Ff |
26 |
|
- fix option '-makefile' short-name (-mf according to genmake2 -help) |
27 |
|
- source local config file "genmake_local" just after processing the genmake2 |
28 |
|
command arguments (previously done before processing arg). |
29 |
|
o pkg/grdchk: |
30 |
|
- add a call to TURNOFF_MODEL_IO for Tangent-Linear run (in this case, call |
31 |
|
to this routine from cost_final has been dropped in g_cost_final) |
32 |
|
- improve printed information (more explicit msg, no longer using "print *," |
33 |
|
fix fcpertminus printed value). |
34 |
|
o model/src: |
35 |
|
- move call to COST_INIT_VARIA out of packages_init_variables.F directly |
36 |
|
into initialise_varia.F (just after calling PACKAGES_INIT_VARIABLES): |
37 |
|
this prevents getting cost-funct reset in adinitialise_varia recomputations. |
38 |
|
o pkg/dic: |
39 |
|
- move initialisation of "freefe" array from from dic_biotic_forcing.F to |
40 |
|
fe_chem.F: this prevents TAF from dropping this initialisation in TLM code. |
41 |
|
o pkg/grdchk: |
42 |
|
- grdchk_main.F : added CALL GLOBAL_SUM_INT( ierr , myThid ) |
43 |
|
- grdchk_getadxx.F etc. : omit I/O if ierr.EQ.0 |
44 |
|
o pkg/autodiff/ctrl/grdchk : |
45 |
|
- attempt to sort out what works and what does not, |
46 |
|
with regard to I/O, and to warn/stop accordingly. |
47 |
|
o pkg/grdchk: |
48 |
|
- attempt to fix grdchk in the case of useSingleCpuIO. |
49 |
|
- "if ( myProcId .EQ. grdchkwhichproc .AND. ierr .EQ. 0 )" |
50 |
|
statements were moved from grdchk_main.F and into |
51 |
|
grdchk_getadxx.F grdchk_getxx.F grdchk_setxx.F. |
52 |
|
- a global sum is applied to record numbers icvrec/layer |
53 |
|
out of grdchk_loc so that they be passed to I/O routines. |
54 |
|
o pkg/smooth: |
55 |
|
- fix recomputation that appeared with nlfs : use smooth_recip_hFacC, |
56 |
|
smooth_hFacW, smooth_hFacS (copied at init_fixed) in 3d case. |
57 |
|
o verification/testreport: |
58 |
|
- add option '-tlm' for Tangent-Linear test (-adm,-oad,-tlm are all exclusive); |
59 |
|
- can also use compressed (gzip) reference output file; |
60 |
|
- change format (in pkg/grdchk) of TLM output (+ add forward gradient) |
61 |
|
to be easier to collect by testreport. |
62 |
|
- update existing TLM output (half out-of-date by more than 3 yrs). |
63 |
|
- report NETCDF & LAPACK settings (from genmake2) in output dir. |
64 |
|
- report run-time in each individual summary (previously only for AD test); |
65 |
|
for TLM test, add also TAF version. |
66 |
|
- add daily TLM test on (old) aces cluster + weekly test on baudelaire. |
67 |
|
|
68 |
|
checkpoint63r (2012/08/15) |
69 |
|
o tools/genmake2: |
70 |
|
- fix Makefile for target ftlall (+ update files to clean after make ftlall) |
71 |
|
o pkg/ecco/ecco_cost_final.F : |
72 |
|
- fix fc print statements (to stdout and costfunction0000) so |
73 |
|
that the printed value is always after the global sum. |
74 |
|
o pkg/seaice/seaice_dynsolver.F : |
75 |
|
- fix ice strength assymptote at SEAICE_area_max<1 |
76 |
|
(no change for the standard case of SEAICE_area_max=1) |
77 |
|
o some cleaning: |
78 |
|
- pkg source files: ensure that all *.F files from each pkg included the |
79 |
|
corresponding ${PKG}_OPTIONS.h file (except stand-alone src file which |
80 |
|
only includes CPP_EEOPTIONS.h); fix S/R CTRL_SMOOTH ; update AD experiment |
81 |
|
code_ad/*.F src files; add new option-file in pkg/admtlm + corresponding |
82 |
|
includes; |
83 |
|
- model/src: add PACKAGES_CONFIG.h wherever ALLOW_AUTODIFF[_TAMC] is used. |
84 |
|
- ALLOW_DIFFKR_CONTROL: add a stop in S/R CTRL_CHECK in case ALLOW_3D_DIFFKR |
85 |
|
is undef; also define /DYNVARS_DIFFKR/ common block in DYNVARS.h when |
86 |
|
ALLOW_DIFFKR_CONTROL is defined, to allow to compile and reach this stop. |
87 |
|
- update option-file CPP_OPTIONS.h of all AD experiments: |
88 |
|
* no longer include PACKAGES_CONFIG.h ; |
89 |
|
* includes ECCO_CPPOPTIONS.h if PACKAGES_CONFIG.h has been included ; |
90 |
|
* def/undef ALLOW_3D_DIFFKR independently of ALLOW_DIFFKR_CONTROL (before |
91 |
|
including ECCO_CPPOPTIONS.h). |
92 |
|
o pkg/cost, pkg/ctrl, pkg/ecco option-file: |
93 |
|
- clean-up and split content of old pkg/ecco/ECCO_CPPOPTIONS.h file into |
94 |
|
separated pkg option-file (done according to old doc from ECCO_CPPOPTIONS.h, |
95 |
|
not necessary accurate). |
96 |
|
- add a template for option-file ECCO_CPPOPTIONS.h, mostly empty, in |
97 |
|
pkg/autodiff, i.e., the 1rst pkg to compile for adjoint built, with lines to |
98 |
|
deliberately break compilation (a remainder that it needs to be customized) |
99 |
|
- in pkg/ecco, includes ECCO_OPTIONS.h instead of COST_OPTIONS.h |
100 |
|
- rename COST_CPPOPTIONS.h to COST_OPTIONS.h |
101 |
|
- rename CTRL_CPPOPTIONS.h to CTRL_OPTIONS.h |
102 |
|
o tools/genamke2: |
103 |
|
- check for lapack. |
104 |
|
o pkg/cost and pkg/ecco : attempt to sort out some of the limiting intricacies. |
105 |
|
- pkg/cost.cost_final.F : allow for use of pkg/ecco and pkg/cost cost functions |
106 |
|
jointly. The exclusive ifdefs were removed, to add costs terms (when defined) |
107 |
|
from both packages. |
108 |
|
- the fc global sum in pkg/ecco/ecco_cost_final.F was removed accordingly. |
109 |
|
- for objf_atl we use either the pkg/ecco or the pkg/cost term depending on CPPs. |
110 |
|
- pkg/ecco and model/src : add CPP brackets around pkg/cost and pkg/ctrl includes |
111 |
|
of "CTRL_SIZE.h" "ctrl.h" "ctrl_dummy.h" "optim.h" / "cost.h" accordingly. |
112 |
|
o pkg/cost : add comments to explain special and/or untested setups. |
113 |
|
o pkg/exf: |
114 |
|
- use EXF_OPTIONS.h to set pkg/exf options except if done in ECCO_CPPOPTIONS.h |
115 |
|
(previously, ALLOW_AUTODIFF_TAMC was controling this switch). |
116 |
|
o verification/*/code_ad: |
117 |
|
mimimal cleaning of AD experiments ECCO_CPPOPTIONS.h option-file: |
118 |
|
- reccord when this file is included (define ECCO_CPPOPTIONS_H) |
119 |
|
- remove the most obvious obsolete features (e.g., #define ALLOW_COST not |
120 |
|
allowed since Oct 2003 in any option-file except in PACKAGES_CONFIG.h) |
121 |
|
o pkg/seaice : |
122 |
|
- added possibility to change ice strength/PRESS0 relationship to |
123 |
|
HEFF, according to the following run time parameters |
124 |
|
SEAICEpresPow0 :: HEFF exponent for ice strength below SEAICEpresH0 (integer, >0) |
125 |
|
SEAICEpresPow1 :: HEFF exponent for ice strength above SEAICEpresH0 (integer, >0) |
126 |
|
SEAICEpresH0 :: HEFF threshold for ice strength (m) |
127 |
|
o pkg/ggl90 : |
128 |
|
- added run time flag mxlSurfFlag to include the code that ensure |
129 |
|
mixing between first and second level (previously included as a comment) |
130 |
|
o verification/1D_ocean_ice_column/input_ad/data.autodiff : |
131 |
|
- add test of newly added dumpAdByRec=T option where |
132 |
|
we write all records to one file per variable. |
133 |
|
o verification/global_ocean.cs32x15/code_ad/CPP_OPTIONS.h : |
134 |
|
- switch to #define ALLOW_BALANCE_RELAX and ALLOW_BALANCE_FLUXES |
135 |
|
to check that this code is ok with taf and compiles in adjoint. |
136 |
|
o pkg/autodiff : |
137 |
|
- added run time param dumpAdByRec : ad dump format switch. |
138 |
|
If true then write all records to one file per variable. |
139 |
|
Else write one file per record (remains the default). |
140 |
|
- revise seaice_ad_dump.F and exf_adjoint_snapshots_ad.F accordingly. |
141 |
|
o pkg/seaice: |
142 |
|
- Added SEAICEuseTILT run time switch : if set to |
143 |
|
false then omit the tilt term in seaice dynamics. |
144 |
|
- Fix free drift calculation. |
145 |
|
o pkg/shelfice: |
146 |
|
When initializing SHELFICEDragQuadratic, set default to be |
147 |
|
consistent with shiCdrag in case SHELFICEuseGammaFrict is used, |
148 |
|
but retain option to set it independently |
149 |
|
(inconsistenty spotted by Veronique Dansereau) |
150 |
|
o eesupp/inc: |
151 |
|
- in EEPARAMS.h, add real-type constant for some frequently used simple number |
152 |
|
(0,1,2,1/2), with name explicitly referring to RS/RL type. |
153 |
|
o model/src: |
154 |
|
- move balancing of relaxation terms to new S/R balance_relax.F. |
155 |
|
o pkg/autodiff: |
156 |
|
re-write active I/O high-level (control) S/R: |
157 |
|
- rename S/R ACTIVE_READ/WRITE_RL to ACTIVE_READ/WRITE_3D_RL |
158 |
|
- add 1 more argument (useCurrentDir) to replace the "_LOC" 2nd set of S/R. |
159 |
|
- use standard pkg/mdsio I/O routines (MDS_READ/WRITE_SEC_XZ/YZ and |
160 |
|
MDS_READ/WRITE_FIELD); change loops to multi-threads. |
161 |
|
- update and merge active_file_control_slice.flow into active_file_control.flow |
162 |
|
- update the calls in lower level S/R (active_file.F, active_file_g.F and |
163 |
|
active_file_ad.F) keeping the argument list and function unchanged. |
164 |
|
- also update lower-level "_LOC" version (call same S/R with "useCurrentDir |
165 |
|
=.TRUE.") and remove high-level (control) _loc version (not called anymore). |
166 |
|
- new low-level active I/O routines, one for each type (RL/RS), for active var |
167 |
|
of various (XY,XZ,YZ) shape and level number (arguments: arrShape, myNr); |
168 |
|
fix ctrl_init_wet.F & ecco_cost_weights.F by calling the new S/R with the |
169 |
|
right type. |
170 |
|
o autodiff and RS=real*4: |
171 |
|
- call the right type (_RS instead of _RL) of S/R in few output S/R (pkg/exf |
172 |
|
ad-monitor and snapshots); disable arrType='RS' in mdsio_gl*.F ; |
173 |
|
- change argument type of 3-D mask argument to _RS to match type in the call |
174 |
|
(in seaice_cost*.F, ctrl_*_gen.F and *ctrl_bound.F); to be continued. |
175 |
|
o pkg/thsice: |
176 |
|
- re-anable balanceEmPmR when useSEAICE=T with useThSIce=T. |
177 |
|
- option to correct ocean fresh-water flux for imbalance of Atmos+Land |
178 |
|
fresh-water flux: uniform correction or proportional to local precip. |
179 |
|
o pkg/ctrl: |
180 |
|
- new header file CTRL_SIZE.h for parameters maxCtrlArr2D, maxCtrlArr3D |
181 |
|
- redefine CPP option ALLOW_BOTTOMDRAG_CONTROL to |
182 |
|
ALLOW_BOTTOMDRAG_CONTROL_NONGENERIC |
183 |
|
- verification/hs94.1x64x5/ tests ALLOW_GENARR{2D,3D}_CONTROL |
184 |
|
|
185 |
|
checkpoint63q (2012/07/30) |
186 |
|
o pkg/autodiff: |
187 |
|
note about monitor and snap-shot of ad-variables: |
188 |
|
a) need to apply ADEXCH before monitor or output of ad-vars to include |
189 |
|
overlap contributions (was done for adjDump but missing for monitor). |
190 |
|
b) since ADEXCH implies adding overlap values to interior array, machine |
191 |
|
truncation error is expected when adding an ADEXCH call in the middle of |
192 |
|
the time-stepping (although mathematically identical). |
193 |
|
modifs: |
194 |
|
- fix some incorrect type (RL/RS, UV/scalar) in ADEXCH calls and ad-vars |
195 |
|
declaration (adEddyPsiX,adEddyPsiY in adcommon.h). |
196 |
|
- add new run-time params (dumpAdVarExch & mon_AdVarExch) to select how to |
197 |
|
apply ADEXCH before monitor or snap-shot of ad-variables: |
198 |
|
=0 : no ADEXCH ; =1 : do ADEXCH ; =2 : apply ADEXCH on a local copy. |
199 |
|
- implement new method (copy+adexch) for snap-shot and monitor of main model |
200 |
|
ad-vars (initially not used by default -> output unchanged). |
201 |
|
- change default (set to 2) to use new method and update few output_adm.txt |
202 |
|
with accurate ad-monitor (global_ocean.90x40x15, tutorial_global_oce_biogeo |
203 |
|
and both tutorial_tracer_adjsens tests). |
204 |
|
- switch 2 global_ocean.cs32x15 AD-tests to AB-2 (seaice_dynmix & thsice) |
205 |
|
and turn off momDissip_In_AB in the 2 other (needed for stable AB-3). |
206 |
|
o pkg/ctrl: |
207 |
|
enable the use of a variable number (maxCtrlArr2D, maxCtrlArr3D) of |
208 |
|
generic control variables via |
209 |
|
#define ALLOW_GENARR2D_CONTROL and/or #define ALLOW_GENARR3D_CONTROL |
210 |
|
Only required customization should be S/R ctrl_map_ini_genarr.F |
211 |
|
(routine in repository contains example) |
212 |
o pkg/exf: |
o pkg/exf: |
213 |
- fix and refine checking of surface-relaxation setting when using EXF |
- fix and refine checking of surface-relaxation setting when using EXF |
214 |
o verification (adjoint exp): |
o verification (adjoint exp): |