pkg/seaice/SEAICE_OPTIONS.h

C $Header: /u/gcmpack/MITgcm/pkg/seaice/SEAICE_OPTIONS.h,v 1.28 2007/12/05 07:28:29 dimitri Exp $
C $Name:  $

C     /==========================================================\
C     | SEAICE_OPTIONS.h                                         |
C     | o CPP options file for sea ice package.                  |
C     |==========================================================|
C     | Use this file for selecting options within the sea ice   |
C     | package.                                                 |
C     \==========================================================/

#ifndef SEAICE_OPTIONS_H
#define SEAICE_OPTIONS_H
#include "PACKAGES_CONFIG.h"
#include "CPP_OPTIONS.h"

C--   Write "text-plots" of certain fields in STDOUT for debugging.
#undef SEAICE_DEBUG

C--   This flag is meant for options that make more sense than the
C     original options but that break the verification experiments.
#undef SEAICE_BREAKS_VERIFICATION

C--   Allow sea-ice dynamic code.
C     This option is provided to allow use of TAMC
C     on the thermodynamics component of the code only.
C     Sea-ice dynamics can also be turned off at runtime
C     using variable SEAICEuseDYNAMICS.
#define SEAICE_ALLOW_DYNAMICS

C--   By default, the sea-ice package uses its own integrated bulk
C     formulae to compute fluxes (fu, fv, EmPmR, Qnet, and Qsw) over
C     open-ocean.  When this flag is set, these variables are computed
C     in a separate external package, for example, pkg/exf, and then
C     modified for sea-ice effects by pkg/seaice.
#define SEAICE_EXTERNAL_FLUXES

C--   By default, the sea-ice package uses 2-category thermodynamics.
C     When this flag is set, an 8-category calculation of ice
C     thermodynamics is carried out in groatb.F
C     Note the pickup_seaice.* generated by this option differ
C     from those generated with the default 2-category model.
C     Therefore it is not possible to switch between the two
C     in the middle of an integration.
#undef SEAICE_MULTICATEGORY

C--   By default for B-grid dynamics solver wind stress under sea-ice is
C     set to the same value as it would be if there was no sea-ice.
C     Define following CPP flag for B-grid ice-ocean stress coupling.
#undef SEAICE_TEST_ICE_STRESS_1

C--   By default for B-grid dynamics solver surface tilt is obtained
C     indirectly via geostrophic velocities.  Define following CPP
C     in order to ues ETAN instead.
#undef EXPLICIT_SSH_SLOPE

C--   By default the freezing point of water is set to the value of 
C     the parameter SEAICE_freeze (=-1.96 by default). To use a
C     simple linear dependence of the freezing point on salinity, 
C     set the following flag (pressure is assumed to have no effect,
C     which is a good assumption for the top 20 meters). With this
C     option defined the parameter SEAICE_freeze has no effect.
#undef SEAICE_VARIABLE_FREEZING_POINT

C--   Allow SEAICEuseFlooding, which converts snow to ice if submerged.
#undef ALLOW_SEAICE_FLOODING

C--   By default sea ice is fresh.  Set following flag for salty ice.
#undef SEAICE_SALINITY

C--   By default the seaice model is discretized on a B-Grid (for 
C     historical reasons). Define the following flag to use a new
C     (not thoroughly) test version on a C-grid
#define SEAICE_CGRID

C--   Only for the C-grid version it is possible to enable EVP code by
C     defining the following flag
#ifdef SEAICE_CGRID
#define SEAICE_ALLOW_EVP
#endif /* SEAICE_CGRID */

C--   When set use MAX_HEFF to cap sea ice thickness in seaice_growth
#undef SEAICE_CAP_HEFF

#endif /* SEAICE_OPTIONS_H */

CEH3 ;;; Local Variables: ***
CEH3 ;;; mode:fortran ***
CEH3 ;;; End: ***
1	dimitri	1.29	C $Header: /u/gcmpack/MITgcm/pkg/seaice/SEAICE_OPTIONS.h,v 1.28 2007/12/05 07:28:29 dimitri Exp $
2	jmc	1.17	C $Name: $
3	heimbach	1.2
4			C /==========================================================\
5			C \| SEAICE_OPTIONS.h \|
6			C \| o CPP options file for sea ice package. \|
7			C \|==========================================================\|
8			C \| Use this file for selecting options within the sea ice \|
9	edhill	1.7	C \| package. \|
10	heimbach	1.2	C \==========================================================/
11
12	edhill	1.7	#ifndef SEAICE_OPTIONS_H
13			#define SEAICE_OPTIONS_H
14			#include "PACKAGES_CONFIG.h"
15	heimbach	1.2	#include "CPP_OPTIONS.h"
16
17	dimitri	1.3	C-- Write "text-plots" of certain fields in STDOUT for debugging.
18	heimbach	1.2	#undef SEAICE_DEBUG
19
20	dimitri	1.29	C-- This flag is meant for options that make more sense than the
21			C original options but that break the verification experiments.
22			#undef SEAICE_BREAKS_VERIFICATION
23
24	dimitri	1.3	C-- Allow sea-ice dynamic code.
25			C This option is provided to allow use of TAMC
26			C on the thermodynamics component of the code only.
27			C Sea-ice dynamics can also be turned off at runtime
28			C using variable SEAICEuseDYNAMICS.
29	heimbach	1.2	#define SEAICE_ALLOW_DYNAMICS
30	dimitri	1.3
31			C-- By default, the sea-ice package uses its own integrated bulk
32			C formulae to compute fluxes (fu, fv, EmPmR, Qnet, and Qsw) over
33			C open-ocean. When this flag is set, these variables are computed
34			C in a separate external package, for example, pkg/exf, and then
35			C modified for sea-ice effects by pkg/seaice.
36	dimitri	1.28	#define SEAICE_EXTERNAL_FLUXES
37	heimbach	1.2
38	dimitri	1.5	C-- By default, the sea-ice package uses 2-category thermodynamics.
39			C When this flag is set, an 8-category calculation of ice
40			C thermodynamics is carried out in groatb.F
41	dimitri	1.10	C Note the pickup_seaice.* generated by this option differ
42			C from those generated with the default 2-category model.
43			C Therefore it is not possible to switch between the two
44			C in the middle of an integration.
45	mlosch	1.18	#undef SEAICE_MULTICATEGORY
46	dimitri	1.5
47	dimitri	1.26	C-- By default for B-grid dynamics solver wind stress under sea-ice is
48			C set to the same value as it would be if there was no sea-ice.
49			C Define following CPP flag for B-grid ice-ocean stress coupling.
50	dimitri	1.10	#undef SEAICE_TEST_ICE_STRESS_1
51
52	dimitri	1.26	C-- By default for B-grid dynamics solver surface tilt is obtained
53			C indirectly via geostrophic velocities. Define following CPP
54			C in order to ues ETAN instead.
55			#undef EXPLICIT_SSH_SLOPE
56
57	mlosch	1.13	C-- By default the freezing point of water is set to the value of
58			C the parameter SEAICE_freeze (=-1.96 by default). To use a
59			C simple linear dependence of the freezing point on salinity,
60			C set the following flag (pressure is assumed to have no effect,
61			C which is a good assumption for the top 20 meters). With this
62			C option defined the parameter SEAICE_freeze has no effect.
63			#undef SEAICE_VARIABLE_FREEZING_POINT
64
65	dimitri	1.19	C-- Allow SEAICEuseFlooding, which converts snow to ice if submerged.
66			#undef ALLOW_SEAICE_FLOODING
67
68	dimitri	1.27	C-- By default sea ice is fresh. Set following flag for salty ice.
69			#undef SEAICE_SALINITY
70
71	mlosch	1.14	C-- By default the seaice model is discretized on a B-Grid (for
72			C historical reasons). Define the following flag to use a new
73			C (not thoroughly) test version on a C-grid
74	jmc	1.17	#define SEAICE_CGRID
75	mlosch	1.14
76	mlosch	1.15	C-- Only for the C-grid version it is possible to enable EVP code by
77			C defining the following flag
78			#ifdef SEAICE_CGRID
79	jmc	1.17	#define SEAICE_ALLOW_EVP
80	jmc	1.16	#endif /* SEAICE_CGRID */
81	mlosch	1.15
82	dimitri	1.24	C-- When set use MAX_HEFF to cap sea ice thickness in seaice_growth
83			#undef SEAICE_CAP_HEFF
84
85	edhill	1.7	#endif /* SEAICE_OPTIONS_H */
86	edhill	1.12
87			CEH3 ;;; Local Variables: ***
88			CEH3 ;;; mode:fortran ***
89			CEH3 ;;; End: ***