1 |
C $Header: /u/gcmpack/MITgcm/model/inc/CPP_OPTIONS.h,v 1.51 2012/11/09 22:29:32 jmc Exp $ |
2 |
C $Name: $ |
3 |
|
4 |
#ifndef CPP_OPTIONS_H |
5 |
#define CPP_OPTIONS_H |
6 |
|
7 |
CBOP |
8 |
C !ROUTINE: CPP_OPTIONS.h |
9 |
C !INTERFACE: |
10 |
C #include "CPP_OPTIONS.h" |
11 |
|
12 |
C !DESCRIPTION: |
13 |
C *==================================================================* |
14 |
C | main CPP options file for the model: |
15 |
C | Control which optional features to compile in model/src code. |
16 |
C *==================================================================* |
17 |
CEOP |
18 |
|
19 |
C CPP flags controlling particular source code features |
20 |
|
21 |
C o Shortwave heating as extra term in external_forcing.F |
22 |
C Note: this should be a run-time option |
23 |
#undef SHORTWAVE_HEATING |
24 |
|
25 |
C o Include/exclude phi_hyd calculation code |
26 |
#define INCLUDE_PHIHYD_CALCULATION_CODE |
27 |
|
28 |
C o Include/exclude call to S/R CONVECT |
29 |
#define INCLUDE_CONVECT_CALL |
30 |
|
31 |
C o Include/exclude call to S/R CALC_DIFFUSIVITY |
32 |
#define INCLUDE_CALC_DIFFUSIVITY_CALL |
33 |
|
34 |
C o Allow full 3D specification of vertical diffusivity |
35 |
#undef ALLOW_3D_DIFFKR |
36 |
|
37 |
C o Allow latitudinally varying BryanLewis79 vertical diffusivity |
38 |
#undef ALLOW_BL79_LAT_VARY |
39 |
|
40 |
C o Include/exclude Implicit vertical advection code |
41 |
#define INCLUDE_IMPLVERTADV_CODE |
42 |
|
43 |
C o Include/exclude AdamsBashforth-3rd-Order code |
44 |
#undef ALLOW_ADAMSBASHFORTH_3 |
45 |
|
46 |
C o Include/exclude nonHydrostatic code |
47 |
#undef ALLOW_NONHYDROSTATIC |
48 |
|
49 |
C o Allow to account for heating due to friction (and momentum dissipation) |
50 |
#undef ALLOW_FRICTION_HEATING |
51 |
|
52 |
C o Allow mass source or sink of Fluid in the interior |
53 |
C (3-D generalisation of oceanic real-fresh water flux) |
54 |
#undef ALLOW_ADDFLUID |
55 |
|
56 |
C o Include pressure loading code |
57 |
#define ATMOSPHERIC_LOADING |
58 |
|
59 |
C o exclude/allow external forcing-fields load |
60 |
C this allows to read & do simple linear time interpolation of oceanic |
61 |
C forcing fields, if no specific pkg (e.g., EXF) is used to compute them. |
62 |
#undef EXCLUDE_FFIELDS_LOAD |
63 |
|
64 |
C o Include/exclude balancing surface forcing fluxes code |
65 |
#undef ALLOW_BALANCE_FLUXES |
66 |
|
67 |
C o Include/exclude balancing surface forcing relaxation code |
68 |
#undef ALLOW_BALANCE_RELAX |
69 |
|
70 |
C o Include/exclude GM-like eddy stress in momentum code |
71 |
#undef ALLOW_EDDYPSI |
72 |
|
73 |
C o Use "Exact Convervation" of fluid in Free-Surface formulation |
74 |
C so that d/dt(eta) is exactly equal to - Div.Transport |
75 |
#define EXACT_CONSERV |
76 |
|
77 |
C o Allow the use of Non-Linear Free-Surface formulation |
78 |
C this implies that surface thickness (hFactors) vary with time |
79 |
#undef NONLIN_FRSURF |
80 |
|
81 |
C o Include/exclude code for single reduction Conjugate-Gradient solver |
82 |
#undef ALLOW_SRCG |
83 |
|
84 |
C o Choices for implicit solver routines solve_*diagonal.F |
85 |
C The following has low memory footprint, but not suitable for AD |
86 |
#undef SOLVE_DIAGONAL_LOWMEMORY |
87 |
C The following one suitable for AD but does not vectorize |
88 |
#undef SOLVE_DIAGONAL_KINNER |
89 |
|
90 |
C o ALLOW isotropic scaling of harmonic and bi-harmonic terms when |
91 |
C using an locally isotropic spherical grid with (dlambda) x (dphi*cos(phi)) |
92 |
C *only for use on a lat-lon grid* |
93 |
C Setting this flag here affects both momentum and tracer equation unless |
94 |
C it is set/unset again in other header fields (e.g., GAD_OPTIONS.h). |
95 |
C The definition of the flag is commented to avoid interference with |
96 |
C such other header files. |
97 |
C The preferred method is specifying a value for viscAhGrid or viscA4Grid |
98 |
C in data which is then automatically scaled by the grid size; |
99 |
C the old method of specifying viscAh/viscA4 and this flag is provided |
100 |
C for completeness only (and for use with the adjoint). |
101 |
C#define ISOTROPIC_COS_SCALING |
102 |
|
103 |
C o This flag selects the form of COSINE(lat) scaling of bi-harmonic term. |
104 |
C *only for use on a lat-lon grid* |
105 |
C Has no effect if ISOTROPIC_COS_SCALING is undefined. |
106 |
C Has no effect on vector invariant momentum equations. |
107 |
C Setting this flag here affects both momentum and tracer equation unless |
108 |
C it is set/unset again in other header fields (e.g., GAD_OPTIONS.h). |
109 |
C The definition of the flag is commented to avoid interference with |
110 |
C such other header files. |
111 |
C#define COSINEMETH_III |
112 |
|
113 |
C o Use "OLD" UV discretisation near boundaries (*not* recommended) |
114 |
C Note - only works with #undef NO_SLIP_LATERAL in calc_mom_rhs.F |
115 |
C because the old code did not have no-slip BCs |
116 |
#undef OLD_ADV_BCS |
117 |
|
118 |
C o Use LONG.bin, LATG.bin, etc., initialization for ini_curviliear_grid.F |
119 |
C Default is to use "new" grid files (OLD_GRID_IO undef) but OLD_GRID_IO |
120 |
C is still useful with, e.g., single-domain curvilinear configurations. |
121 |
#undef OLD_GRID_IO |
122 |
|
123 |
C o Execution environment support options |
124 |
#include "CPP_EEOPTIONS.h" |
125 |
|
126 |
C o Include/exclude single header file containing multiple packages options |
127 |
C (AUTODIFF, COST, CTRL, ECCO, EXF ...) instead of the standard way where |
128 |
C each of the above pkg get its own options from its specific option file. |
129 |
C Although this method, inherited from ECCO setup, has been traditionally |
130 |
C used for all adjoint built, work is in progress to allow to use the |
131 |
C standard method also for adjoint built. |
132 |
#ifdef PACKAGES_CONFIG_H |
133 |
# include "ECCO_CPPOPTIONS.h" |
134 |
#endif |
135 |
|
136 |
#endif /* CPP_OPTIONS_H */ |