| 1 | dimitri | 1.9 | C $Header: /u/gcmpack/MITgcm_contrib/high_res_cube/code-mods/SEAICE_OPTIONS.h,v 1.8 2007/02/07 01:30:48 dimitri Exp $ | 
| 2 | dimitri | 1.1 |  | 
| 3 |  |  | C     /==========================================================\ | 
| 4 |  |  | C     | SEAICE_OPTIONS.h                                         | | 
| 5 |  |  | C     | o CPP options file for sea ice package.                  | | 
| 6 |  |  | C     |==========================================================| | 
| 7 |  |  | C     | Use this file for selecting options within the sea ice   | | 
| 8 |  |  | C     | package.                                                 | | 
| 9 |  |  | C     \==========================================================/ | 
| 10 |  |  |  | 
| 11 |  |  | #ifndef SEAICE_OPTIONS_H | 
| 12 |  |  | #define SEAICE_OPTIONS_H | 
| 13 |  |  | #include "PACKAGES_CONFIG.h" | 
| 14 |  |  | #include "CPP_OPTIONS.h" | 
| 15 |  |  |  | 
| 16 |  |  | C--   Write "text-plots" of certain fields in STDOUT for debugging. | 
| 17 |  |  | #undef SEAICE_DEBUG | 
| 18 |  |  |  | 
| 19 |  |  | C--   Allow sea-ice dynamic code. | 
| 20 |  |  | C     This option is provided to allow use of TAMC | 
| 21 |  |  | C     on the thermodynamics component of the code only. | 
| 22 |  |  | C     Sea-ice dynamics can also be turned off at runtime | 
| 23 |  |  | C     using variable SEAICEuseDYNAMICS. | 
| 24 | dimitri | 1.3 | #define SEAICE_ALLOW_DYNAMICS | 
| 25 | dimitri | 1.1 |  | 
| 26 |  |  | C--   By default, pkg/seaice defines forcing variable internally, in | 
| 27 |  |  | C     SEAICE_FFIELDS.h, and reads them in from files.  When CPP option | 
| 28 |  |  | C     SEAICE_EXTERNAL_FORCING is defined, the above forcing variables | 
| 29 |  |  | C     are defined and provided by an external package.  At present this | 
| 30 |  |  | C     option is hardwired for pkg/exf and the variables are passed using | 
| 31 |  |  | C     include file exf_fields.h. | 
| 32 |  |  | #define SEAICE_EXTERNAL_FORCING | 
| 33 |  |  | #ifdef SEAICE_EXTERNAL_FORCING | 
| 34 |  |  | #include "EXF_OPTIONS.h" | 
| 35 |  |  | #endif /* SEAICE_EXTERNAL_FORCING */ | 
| 36 |  |  |  | 
| 37 |  |  | C--   By default, the sea-ice package uses its own integrated bulk | 
| 38 |  |  | C     formulae to compute fluxes (fu, fv, EmPmR, Qnet, and Qsw) over | 
| 39 |  |  | C     open-ocean.  When this flag is set, these variables are computed | 
| 40 |  |  | C     in a separate external package, for example, pkg/exf, and then | 
| 41 |  |  | C     modified for sea-ice effects by pkg/seaice. | 
| 42 | dimitri | 1.2 | #define SEAICE_EXTERNAL_FLUXES | 
| 43 | dimitri | 1.1 |  | 
| 44 |  |  | C--   By default, the sea-ice package uses 2-category thermodynamics. | 
| 45 |  |  | C     When this flag is set, an 8-category calculation of ice | 
| 46 |  |  | C     thermodynamics is carried out in groatb.F | 
| 47 | dimitri | 1.4 | C     Note the pickup_seaice.* generated by this option differ | 
| 48 |  |  | C     from those generated with the default 2-category model. | 
| 49 |  |  | C     Therefore it is not possible to switch between the two | 
| 50 |  |  | C     in the middle of an integration. | 
| 51 | dimitri | 1.9 | #define SEAICE_MULTICATEGORY | 
| 52 | dimitri | 1.1 |  | 
| 53 | dimitri | 1.4 | C--   By default cdm wind stress under sea-ice is set to the | 
| 54 |  |  | C     same value as it would be if there was no sea-ice. | 
| 55 |  |  | C     This is a placeholder until a more physically-sensible | 
| 56 |  |  | C     stable solution is developed.  Apparently ocean stress | 
| 57 |  |  | C     that is based on sea-ice velocity can cause trouble in | 
| 58 |  |  | C     Arctic Ocean configurations.  This temporary solution | 
| 59 |  |  | C     also corresponds to that adopted by CCSM-2.  For the | 
| 60 |  |  | C     adventurous user who requires ice-modified stress, | 
| 61 |  |  | C     following options are available. | 
| 62 |  |  | #undef SEAICE_ORIGINAL_BAD_ICE_STRESS | 
| 63 | dimitri | 1.6 | #undef SEAICE_TEST_ICE_STRESS_1 | 
| 64 | dimitri | 1.4 |  | 
| 65 | dimitri | 1.7 | C--   By default the freezing point of water is set to the value of | 
| 66 |  |  | C     the parameter SEAICE_freeze (=-1.96 by default). To use a | 
| 67 |  |  | C     simple linear dependence of the freezing point on salinity, | 
| 68 |  |  | C     set the following flag (pressure is assumed to have no effect, | 
| 69 |  |  | C     which is a good assumption for the top 20 meters). With this | 
| 70 |  |  | C     option defined the parameter SEAICE_freeze has no effect. | 
| 71 |  |  | #undef SEAICE_VARIABLE_FREEZING_POINT | 
| 72 |  |  |  | 
| 73 | dimitri | 1.8 | C--   Allow SEAICEuseFlooding, which converts snow to ice if submerged. | 
| 74 |  |  | #define ALLOW_SEAICE_FLOODING | 
| 75 |  |  |  | 
| 76 | dimitri | 1.7 | C--   By default the seaice model is discretized on a B-Grid (for | 
| 77 |  |  | C     historical reasons). Define the following flag to use a new | 
| 78 |  |  | C     (not thoroughly) test version on a C-grid | 
| 79 |  |  | #define SEAICE_CGRID | 
| 80 |  |  |  | 
| 81 |  |  | C--   Only for the C-grid version it is possible to enable EVP code by | 
| 82 |  |  | C     defining the following flag | 
| 83 |  |  | #ifdef SEAICE_CGRID | 
| 84 |  |  | #undef SEAICE_ALLOW_EVP | 
| 85 |  |  | #endif /* SEAICE_CGRID */ | 
| 86 |  |  |  | 
| 87 | dimitri | 1.1 | #endif /* SEAICE_OPTIONS_H */ | 
| 88 | dimitri | 1.7 |  | 
| 89 |  |  | CEH3 ;;; Local Variables: *** | 
| 90 |  |  | CEH3 ;;; mode:fortran *** | 
| 91 |  |  | CEH3 ;;; End: *** |