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