| 1 | 
C $Header: /u/gcmpack/MITgcm/model/inc/CPP_OPTIONS.h,v 1.42 2007/11/28 00:18:16 dimitri 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 nonHydrostatic code | 
| 32 | 
#undef ALLOW_NONHYDROSTATIC | 
| 33 | 
 | 
| 34 | 
C o Include pressure loading code | 
| 35 | 
#define ATMOSPHERIC_LOADING | 
| 36 | 
 | 
| 37 | 
C o exclude/allow external forcing-fields load | 
| 38 | 
C   this allows to read & do simple linear time interpolation of oceanic | 
| 39 | 
C   forcing fields, if no specific pkg (e.g., EXF) is used to compute them. | 
| 40 | 
#undef EXCLUDE_FFIELDS_LOAD | 
| 41 | 
 | 
| 42 | 
C o Include/exclude GM-like eddy stress in momentum code | 
| 43 | 
#undef ALLOW_EDDYPSI | 
| 44 | 
 | 
| 45 | 
C o Use "Exact Convervation" of fluid in Free-Surface formulation | 
| 46 | 
C   so that d/dt(eta) is exactly equal to - Div.Transport | 
| 47 | 
#define EXACT_CONSERV | 
| 48 | 
 | 
| 49 | 
C o Allow the use of Non-Linear Free-Surface formulation | 
| 50 | 
C   this implies that surface thickness (hFactors) vary with time | 
| 51 | 
#undef NONLIN_FRSURF | 
| 52 | 
 | 
| 53 | 
C o Allow mass source or sink of Fluid in the interior | 
| 54 | 
C   (3-D generalisation of oceanic real-fresh water flux) | 
| 55 | 
#undef ALLOW_ADDFLUID | 
| 56 | 
 | 
| 57 | 
C o ALLOW isotropic scaling of harmonic and bi-harmonic terms when | 
| 58 | 
C   using an locally isotropic spherical grid with (dlambda) x (dphi*cos(phi)) | 
| 59 | 
C *only for use on a lat-lon grid* | 
| 60 | 
C   Setting this flag here affects both momentum and tracer equation unless | 
| 61 | 
C   it is set/unset again in other header fields (e.g., GAD_OPTIONS.h). | 
| 62 | 
C   The definition of the flag is commented to avoid interference with | 
| 63 | 
C   such other header files. | 
| 64 | 
C   The preferred method is specifying a value for viscAhGrid or viscA4Grid | 
| 65 | 
C   in data which is then automatically scaled by the grid size; | 
| 66 | 
C   the old method of specifying viscAh/viscA4 and this flag is provided | 
| 67 | 
C   for completeness only (and for use with the adjoint). | 
| 68 | 
C#define ISOTROPIC_COS_SCALING | 
| 69 | 
 | 
| 70 | 
C o This flag selects the form of COSINE(lat) scaling of bi-harmonic term. | 
| 71 | 
C *only for use on a lat-lon grid* | 
| 72 | 
C   Has no effect if ISOTROPIC_COS_SCALING is undefined. | 
| 73 | 
C   Has no effect on vector invariant momentum equations. | 
| 74 | 
C   Setting this flag here affects both momentum and tracer equation unless | 
| 75 | 
C   it is set/unset again in other header fields (e.g., GAD_OPTIONS.h). | 
| 76 | 
C   The definition of the flag is commented to avoid interference with | 
| 77 | 
C   such other header files. | 
| 78 | 
C#define COSINEMETH_III | 
| 79 | 
 | 
| 80 | 
C o Use "OLD" UV discretisation near boundaries (*not* recommended) | 
| 81 | 
C   Note - only works with  #undef NO_SLIP_LATERAL  in calc_mom_rhs.F | 
| 82 | 
C          because the old code did not have no-slip BCs | 
| 83 | 
#undef  OLD_ADV_BCS | 
| 84 | 
 | 
| 85 | 
C o Use LONG.bin, LATG.bin, etc., initialization for ini_curviliear_grid.F | 
| 86 | 
C   Default is to use "new" grid files (OLD_GRID_IO undef) but OLD_GRID_IO | 
| 87 | 
C   is still useful with, e.g., single-domain curvilinear configurations. | 
| 88 | 
#undef OLD_GRID_IO | 
| 89 | 
 | 
| 90 | 
C o Execution environment support options | 
| 91 | 
#include "CPP_EEOPTIONS.h" | 
| 92 | 
 | 
| 93 | 
C o Include/exclude code specific to the ECCO/SEALION version. | 
| 94 | 
C   AUTODIFF or EXF package. | 
| 95 | 
C   Currently controled by a single header file | 
| 96 | 
C   For this to work, PACKAGES_CONFIG.h needs to be included! | 
| 97 | 
cph#if (defined (ALLOW_AUTODIFF) || \ | 
| 98 | 
cph     defined (ALLOW_ECCO) || \ | 
| 99 | 
cph     defined (ALLOW_EXF)) | 
| 100 | 
cph# include "ECCO_CPPOPTIONS.h" | 
| 101 | 
cph#endif | 
| 102 | 
 | 
| 103 | 
C o Allow full 3D specification of vertical diffusivity | 
| 104 | 
#ifdef ALLOW_DIFFKR_CONTROL | 
| 105 | 
C - Need to be defined if using DIFFKR_CONTROL | 
| 106 | 
C   (alternatively, could have put this in ECCO_CPPOPTIONS) | 
| 107 | 
#define ALLOW_3D_DIFFKR | 
| 108 | 
#else | 
| 109 | 
C - otherwise, can be turned on or off hereafter: | 
| 110 | 
#undef  ALLOW_3D_DIFFKR | 
| 111 | 
#endif /* ALLOW_DIFFKR_CONTROL */ | 
| 112 | 
 | 
| 113 | 
#endif /* CPP_OPTIONS_H */ | 
| 114 | 
 |