offline_exf_seaice/code_ad/CPP_OPTIONS.h

C $Header: /u/gcmpack/MITgcm/verification/offline_exf_seaice/code_ad/CPP_OPTIONS.h,v 1.5 2013/03/25 02:39:33 gforget Exp $
C $Name:  $

#ifndef CPP_OPTIONS_H
#define CPP_OPTIONS_H

CBOP
C !ROUTINE: CPP_OPTIONS.h
C !INTERFACE:
C #include "CPP_OPTIONS.h"

C !DESCRIPTION:
C *==================================================================*
C | main CPP options file for the model:
C | Control which optional features to compile in model/src code.
C *==================================================================*
CEOP

C CPP flags controlling particular source code features

C o Shortwave heating as extra term in external_forcing.F
C Note: this should be a run-time option
#define SHORTWAVE_HEATING

C o Include/exclude phi_hyd calculation code
#define INCLUDE_PHIHYD_CALCULATION_CODE

C o Include/exclude call to S/R CONVECT
#define INCLUDE_CONVECT_CALL

C o Include/exclude call to S/R CALC_DIFFUSIVITY
#define INCLUDE_CALC_DIFFUSIVITY_CALL

C o Allow full 3D specification of vertical diffusivity
#undef ALLOW_3D_DIFFKR

C o Allow latitudinally varying BryanLewis79 vertical diffusivity
#undef ALLOW_BL79_LAT_VARY

C o Include/exclude Implicit vertical advection code
#define INCLUDE_IMPLVERTADV_CODE

C o Include/exclude AdamsBashforth-3rd-Order code
#undef ALLOW_ADAMSBASHFORTH_3

C o Include/exclude nonHydrostatic code
#undef ALLOW_NONHYDROSTATIC

C o Allow to account for heating due to friction (and momentum dissipation)
#undef ALLOW_FRICTION_HEATING

C o Allow mass source or sink of Fluid in the interior
C   (3-D generalisation of oceanic real-fresh water flux)
#undef ALLOW_ADDFLUID

C o Include pressure loading code
#define ATMOSPHERIC_LOADING

C o exclude/allow external forcing-fields load
C   this allows to read & do simple linear time interpolation of oceanic
C   forcing fields, if no specific pkg (e.g., EXF) is used to compute them.
#undef EXCLUDE_FFIELDS_LOAD

C o Include/exclude balancing surface forcing fluxes code
#undef ALLOW_BALANCE_FLUXES

C o Include/exclude balancing surface forcing relaxation code
#undef ALLOW_BALANCE_RELAX

C o Include/exclude GM-like eddy stress in momentum code
#undef ALLOW_EDDYPSI

C o Use "Exact Convervation" of fluid in Free-Surface formulation
C   so that d/dt(eta) is exactly equal to - Div.Transport
#define EXACT_CONSERV

C o Allow the use of Non-Linear Free-Surface formulation
C   this implies that surface thickness (hFactors) vary with time
#undef NONLIN_FRSURF

C o Include/exclude code for single reduction Conjugate-Gradient solver
#define ALLOW_SRCG

C o Choices for implicit solver routines solve_*diagonal.F
C   The following has low memory footprint, but not suitable for AD
#undef SOLVE_DIAGONAL_LOWMEMORY
C   The following one suitable for AD but does not vectorize
#undef SOLVE_DIAGONAL_KINNER

C o ALLOW isotropic scaling of harmonic and bi-harmonic terms when
C   using an locally isotropic spherical grid with (dlambda) x (dphi*cos(phi))
C *only for use on a lat-lon grid*
C   Setting this flag here affects both momentum and tracer equation unless
C   it is set/unset again in other header fields (e.g., GAD_OPTIONS.h).
C   The definition of the flag is commented to avoid interference with
C   such other header files.
C   The preferred method is specifying a value for viscAhGrid or viscA4Grid
C   in data which is then automatically scaled by the grid size;
C   the old method of specifying viscAh/viscA4 and this flag is provided
C   for completeness only (and for use with the adjoint).
C#define ISOTROPIC_COS_SCALING

C o This flag selects the form of COSINE(lat) scaling of bi-harmonic term.
C *only for use on a lat-lon grid*
C   Has no effect if ISOTROPIC_COS_SCALING is undefined.
C   Has no effect on vector invariant momentum equations.
C   Setting this flag here affects both momentum and tracer equation unless
C   it is set/unset again in other header fields (e.g., GAD_OPTIONS.h).
C   The definition of the flag is commented to avoid interference with
C   such other header files.
C#define COSINEMETH_III

C o Use "OLD" UV discretisation near boundaries (*not* recommended)
C   Note - only works with  #undef NO_SLIP_LATERAL  in calc_mom_rhs.F
C          because the old code did not have no-slip BCs
#undef  OLD_ADV_BCS

C o Use LONG.bin, LATG.bin, etc., initialization for ini_curviliear_grid.F
C   Default is to use "new" grid files (OLD_GRID_IO undef) but OLD_GRID_IO
C   is still useful with, e.g., single-domain curvilinear configurations.
#undef OLD_GRID_IO

C o Execution environment support options
#include "CPP_EEOPTIONS.h"

C o Include/exclude single header file containing multiple packages options
C   (AUTODIFF, COST, CTRL, ECCO, EXF ...) instead of the standard way where
C   each of the above pkg get its own options from its specific option file.
C   Although this method, inherited from ECCO setup, has been traditionally
C   used for all adjoint built, work is in progress to allow to use the
C   standard method also for adjoint built.
#ifdef PACKAGES_CONFIG_H
# include "ECCO_CPPOPTIONS.h"
#endif

#endif /* CPP_OPTIONS_H */
1	jmc	1.6	C $Header: /u/gcmpack/MITgcm/verification/offline_exf_seaice/code_ad/CPP_OPTIONS.h,v 1.5 2013/03/25 02:39:33 gforget Exp $
2	heimbach	1.1	C $Name: $
3
4			#ifndef CPP_OPTIONS_H
5			#define CPP_OPTIONS_H
6
7	jmc	1.3	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	heimbach	1.1
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			#define 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	gforget	1.5	#define INCLUDE_CONVECT_CALL
30	heimbach	1.1
31			C o Include/exclude call to S/R CALC_DIFFUSIVITY
32			#define INCLUDE_CALC_DIFFUSIVITY_CALL
33
34	jmc	1.3	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	heimbach	1.1	C o Include/exclude Implicit vertical advection code
41	gforget	1.5	#define INCLUDE_IMPLVERTADV_CODE
42	heimbach	1.1
43	jmc	1.3	C o Include/exclude AdamsBashforth-3rd-Order code
44			#undef ALLOW_ADAMSBASHFORTH_3
45
46	heimbach	1.1	C o Include/exclude nonHydrostatic code
47			#undef ALLOW_NONHYDROSTATIC
48
49	gforget	1.5	C o Allow to account for heating due to friction (and momentum dissipation)
50			#undef ALLOW_FRICTION_HEATING
51
52	jmc	1.3	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	heimbach	1.1	C o Include pressure loading code
57	gforget	1.5	#define ATMOSPHERIC_LOADING
58	heimbach	1.1
59	jmc	1.3	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	heimbach	1.1	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	gforget	1.5	#define EXACT_CONSERV
76	heimbach	1.1
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	jmc	1.3	C o Include/exclude code for single reduction Conjugate-Gradient solver
82	gforget	1.5	#define ALLOW_SRCG
83	heimbach	1.1
84	jmc	1.3	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	gforget	1.5	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	jmc	1.3	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	heimbach	1.1
123			C o Execution environment support options
124			#include "CPP_EEOPTIONS.h"
125
126	jmc	1.3	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	jmc	1.6	#ifdef PACKAGES_CONFIG_H
133	jmc	1.3	# include "ECCO_CPPOPTIONS.h"
134			#endif
135	jmc	1.2
136	heimbach	1.1	#endif /* CPP_OPTIONS_H */