s_phys_pkgs/text/seaice-parms.tex


\begin{table}[!ht]
\caption{Run-time parameters and default values
\label{tab:pkg:seaice:runtimeparms}}
{\tiny
%\hspace*{-1.5in}
\begin{tabular}{|llp{5cm}c|}
\hline
  & & & \\
  \textbf{Name}  &  \textbf{Default value}  
    &  \textbf{Description}   &  \textbf{Reference}  \\
  & & & \\
\hline \hline
   SEAICEwriteState    &                     T
    &   write sea ice state to file 
    &  %---ref---
    \\
   SEAICEuseDYNAMICS   &                     T
    &   use dynamics 
    &  %---ref---
    \\
   SEAICEuseJFNK       &                     F
    &   use the JFNK-solver
    &  %---ref---
    \\
    SEAICEuseTEM       &                     F
    & use truncated ellipse method
    &  %---ref---
    \\
    SEAICEuseStrImpCpl &                     F
    & use strength implicit coupling in LSR/JFNK
    &  %---ref---
    \\
    SEAICEuseMetricTerms &                   T
    & use metric terms in dynamics
    &  %---ref---
    \\
    SEAICEuseEVPpickup  &                    T
    & use EVP pickups
    &  %---ref---
    \\
    SEAICEuseFluxForm   &                    F
    & use flux form for 2nd central difference advection scheme
    &  %---ref---
    \\
    SEAICErestoreUnderIce &                  F
    & enable restoring to climatology under ice
    &  %---ref---
    \\
    useHB87stressCoupling &                  F
    & turn on ice-ocean stress coupling following \citet{hibler87}
    &  %---ref---
    \\
    usePW79thermodynamics &                T
    & flag to turn off zero-layer-thermodynamics for testing
    &  %---ref---
    \\
    SEAICEadvHeff/Area/Snow/Salt &      T
    & flag to turn off advection of scalar state variables
    &  %---ref---
    \\
    SEAICEuseFlooding   &                   T
    & use flood-freeze algorithm
    &  %---ref---
    \\
    SEAICE\_no\_slip      &                   F
    & switch between free-slip and no-slip boundary conditions 
    &  %---ref---
    \\
   SEAICE\_deltaTtherm  &                   dTracerLev(1)
    &   thermodynamic timestep 
    &  %---ref---
    \\
   SEAICE\_deltaTdyn    &                   dTracerLev(1)
    &   dynamic timestep 
    &  %---ref---
    \\
   SEAICE\_deltaTevp    &                   0
    &   EVP sub-cycling time step, values $>$ 0 turn on EVP
    &  
    \\
   SEAICEuseEVPstar    & F & use modified EVP* instead of EVP & %---ref---
    \\
   SEAICEuseEVPrev     & F & use yet another variation on EVP* & %---ref---
    \\
   SEAICEnEVPstarSteps & UNSET & number of modified EVP* iteration & %---ref---
    \\
   SEAICE\_evpAlpha & UNSET & EVP* parameter & %---ref---
    \\
   SEAICE\_evpBeta & UNSET & EVP* parameter & %---ref---
    \\
   SEAICE\_elasticParm & $\frac{1}{3}$ 
     & EVP paramter $E_0$ & \\
   SEAICE\_evpTauRelax & $\Delta{t}_{EVP}E_0$ 
     & relaxation time scale $T$ for EVP waves & \\
%   SEAICE_evpDampC & & & \\
    SEAICEnewtonIterMax & 10
    & maximum number of JFNK-Newton iterations
    &  %---ref---
    \\
    SEAICEkrylovIterMax & 10
    & maximum number of JFNK-Krylov iterations
    &  %---ref---
    \\
    SEAICE\_JFNK\_lsIter & (off)
    & start line search after ``lsIter'' Newton iterations
    &  %---ref---
    \\
%     SEAICE\_JFNK\_tolIter    & 100
%     & number of Newton iterations after which the
%     the tolerance is relaxed again
%     &  %---ref---
%     \\
    JFNKgamma\_nonlin        & 1.0E-05
    & non-linear tolerance parameter for JFNK solver
    &  %---ref---
    \\
    JFNKgamma\_lin\_min/max  & 0.10/0.99
    & tolerance parameters for linear JFNK solver
    &  %---ref---
    \\
    JFNKres\_tFac            & UNSET
    & tolerance parameter for FGMRES residual
    &  %---ref---
    \\
    SEAICE\_JFNKepsilon      & 1.0E-06
    & step size for the FD-Jacobian-times-vector 
    &  %---ref---
    \\
    SEAICE\_dumpFreq     &                   dumpFreq
    &   dump frequency
    &  %---ref---
    \\
   SEAICE\_taveFreq     &                   taveFreq
    &   time-averaging frequency 
    &  %---ref---
    \\
   SEAICE\_dump\_mdsio   &                     T
    &   write snap-shot   using MDSIO 
    &  %---ref---
    \\
   SEAICE\_tave\_mdsio   &                     T
    &   write TimeAverage using MDSIO 
    &  %---ref---
    \\
   SEAICE\_dump\_mnc     &                     F
    &   write snap-shot   using MNC 
    &  %---ref---
    \\
   SEAICE\_tave\_mnc     &                     F
    &   write TimeAverage using MNC 
    &  %---ref---
    \\
   SEAICE\_initialHEFF  &                   0.00000E+00
    &   initial sea-ice thickness 
    &  %---ref---
    \\
   SEAICE\_drag         &                   2.00000E-03
    &   air-ice drag coefficient 
    &  %---ref---
    \\
   OCEAN\_drag          &                   1.00000E-03
    &   air-ocean drag coefficient 
    &  %---ref---
    \\
   SEAICE\_waterDrag    &                   5.50000E+00
    &   water-ice drag 
    &  %---ref---
    \\
   SEAICE\_dryIceAlb    &                   7.50000E-01
    &   winter albedo 
    &  %---ref---
    \\
   SEAICE\_wetIceAlb    &                   6.60000E-01
    &   summer albedo 
    &  %---ref---
    \\
   SEAICE\_drySnowAlb   &                   8.40000E-01
    &   dry snow albedo 
    &  %---ref---
    \\
   SEAICE\_wetSnowAlb   &                   7.00000E-01
    &   wet snow albedo 
    &  %---ref---
    \\
   SEAICE\_waterAlbedo  &                   1.00000E-01
    &   water albedo 
    &  %---ref---
    \\
   SEAICE\_strength     &                   2.75000E+04
    &   sea-ice strength $P^{*}$
    &  %---ref---
    \\
   SEAICE\_cStar       &                    20.0000E+00
    &   sea-ice strength paramter $C^{*}$ 
    &  %---ref---
    \\
    SEAICE\_rhoAir      & 1.3 (or \code{exf} value)
    & density of air (kg/m$^3$)
    & %---ref--- 
    \\
    SEAICE\_cpAir       & 1004 (or \code{exf} value)
    & specific heat of air (J/kg/K)
    & %---ref--- 
    \\
    SEAICE\_lhEvap      & 2,500,000 (or \code{exf} value)
    & latent heat of evaporation % for water (J/kg)
    & %---ref--- 
    \\
    SEAICE\_lhFusion    &   334,000 (or \code{exf} value) 
    & latent heat of fusion %for ice and snow (J/kg)   
    & %---ref---
    \\
    SEAICE\_lhSublim    & 2,834,000 
    & latent heat of sublimation  %for ice and snow (J/kg)
    & %---ref---
    \\
    SEAICE\_dalton      & 1.75E-03  
    & sensible heat transfer coefficient
    & %---ref--- 
    \\
   SEAICE\_iceConduct   &                   2.16560E+00
    &   sea-ice conductivity 
    &  %---ref---
    \\
   SEAICE\_snowConduct  &                   3.10000E-01
    &   snow conductivity 
    &  %---ref---
    \\
   SEAICE\_emissivity   &                   5.50000E-08
    &   Stefan-Boltzman 
    &  %---ref---
    \\
   SEAICE\_snowThick    &                   1.50000E-01
    &   cutoff snow thickness 
    &  %---ref---
    \\
   SEAICE\_shortwave    &                   3.00000E-01
    &   penetration shortwave radiation 
    &  %---ref---
    \\
   SEAICE\_freeze       &                  -1.96000E+00
    &   freezing temp. of sea water 
    &  %---ref---
    \\
    SEAICE\_saltFrac    &                   0.0
    &   salinity newly formed ice (fraction of ocean surface salinity)
    &  %---ref---
    \\
%     SEAICE\_gamma\_t    &                   UNSET
%     &   restoring time scale for basal freezing and melting
%     &  %---ref---
%     \\
%     SEAICE\_gamma\_t\_frz &                 UNSET
%     &   restoring time scale for basal freezing
%     &  %---ref---
%     \\
%     SEAICE\_mcPheePiston  &                  UNSET
%     &  ocean-ice turbulent flux "piston velocity" (m/s) that sets melt
%     efficiency. 
%     &  %---ref---
%     \\
%     SEAICE\_mcPheeTaper   &                  UNSET
%     & tapering down of turbulent flux term with ice concentration.
%     &  %---ref---
%     \\
    SEAICE\_frazilFrac    &                   0.0
    &  Fraction of surface level negative heat content anomalies
    (relative to the local freezing point) 
    &  %---ref---
    \\
    SEAICEstressFactor  &                  1.00000E+00
    &   scaling factor for ice-ocean stress
    &  %---ref---
    \\
    Heff/Area/HsnowFile/Hsalt & UNSET
    & initial fields for variables HEFF/AREA/HSNOW/HSALT
    &  %---ref---
    \\
    LSR\_ERROR           &                   1.00000E-04
    &   sets accuracy of LSR solver 
    &  %---ref---
    \\
    DIFF1               &                   0.0
    &   parameter used in advect.F 
    &  %---ref---
    \\
   HO                  &                   5.00000E-01
    &   demarcation ice thickness (AKA lead closing paramter $h_0$)
    &  %---ref---
    \\
   MAX\_HEFF            &                   1.00000E+01
    &   maximum ice thickness 
    &  %---ref---
    \\
   MIN\_ATEMP           &                  -5.00000E+01
    &   minimum air temperature 
    &  %---ref---
    \\
   MIN\_LWDOWN          &                   6.00000E+01
    &   minimum downward longwave 
    &  %---ref---
    \\
   MAX\_TICE            &                   3.00000E+01
    &   maximum ice temperature 
    &  %---ref---
    \\
   MIN\_TICE            &                  -5.00000E+01
    &   minimum ice temperature 
    &  %---ref---
    \\
   IMAX\_TICE           &                        10
    &   iterations for ice heat budget 
    &  %---ref---
    \\
   SEAICE\_EPS          &                   1.00000E-10
    &   reduce derivative singularities 
    &  %---ref---
    \\
   SEAICE\_area\_reg    &                   1.00000E-5
    &   minimum concentration to regularize ice thickness
    &  %---ref---
    \\
   SEAICE\_hice\_reg    &                   0.05 m
    &   minimum ice thickness for regularization
    &  %---ref---
    \\
\hline
\end{tabular}
}
\end{table}

%%% Local Variables: 
%%% mode: latex
%%% TeX-master: "../../manual"
%%% End: 
1	molod	1.1
2	jmc	1.5	\begin{table}[!ht]
3	mlosch	1.4	\caption{Run-time parameters and default values
4			\label{tab:pkg:seaice:runtimeparms}}
5	mlosch	1.7	{\tiny
6	heimbach	1.2	%\hspace*{-1.5in}
7	mlosch	1.4	\begin{tabular}{\|llp{5cm}c\|}
8	heimbach	1.2	\hline
9			& & & \\
10	molod	1.1	\textbf{Name} & \textbf{Default value}
11			& \textbf{Description} & \textbf{Reference} \\
12			& & & \\
13	heimbach	1.2	\hline \hline
14	molod	1.1	SEAICEwriteState & T
15			& write sea ice state to file
16			& %---ref---
17			\\
18			SEAICEuseDYNAMICS & T
19			& use dynamics
20			& %---ref---
21			\\
22	mlosch	1.7	SEAICEuseJFNK & F
23			& use the JFNK-solver
24			& %---ref---
25			\\
26	mlosch	1.4	SEAICEuseTEM & F
27			& use truncated ellipse method
28			& %---ref---
29			\\
30	mlosch	1.9	SEAICEuseStrImpCpl & F
31			& use strength implicit coupling in LSR/JFNK
32			& %---ref---
33			\\
34	mlosch	1.4	SEAICEuseMetricTerms & T
35			& use metric terms in dynamics
36			& %---ref---
37			\\
38			SEAICEuseEVPpickup & T
39			& use EVP pickups
40			& %---ref---
41			\\
42			SEAICEuseFluxForm & F
43			& use flux form for 2nd central difference advection scheme
44			& %---ref---
45			\\
46			SEAICErestoreUnderIce & F
47			& enable restoring to climatology under ice
48			& %---ref---
49			\\
50			useHB87stressCoupling & F
51			& turn on ice-ocean stress coupling following \citet{hibler87}
52			& %---ref---
53			\\
54			usePW79thermodynamics & T
55			& flag to turn off zero-layer-thermodynamics for testing
56			& %---ref---
57			\\
58	mlosch	1.7	SEAICEadvHeff/Area/Snow/Salt & T
59	mlosch	1.4	& flag to turn off advection of scalar state variables
60			& %---ref---
61			\\
62			SEAICEuseFlooding & T
63			& use flood-freeze algorithm
64			& %---ref---
65			\\
66			SEAICE\_no\_slip & F
67			& switch between free-slip and no-slip boundary conditions
68			& %---ref---
69			\\
70			SEAICE\_deltaTtherm & dTracerLev(1)
71	molod	1.1	& thermodynamic timestep
72			& %---ref---
73			\\
74	mlosch	1.4	SEAICE\_deltaTdyn & dTracerLev(1)
75	molod	1.1	& dynamic timestep
76			& %---ref---
77			\\
78	mlosch	1.6	SEAICE\_deltaTevp & 0
79			& EVP sub-cycling time step, values $>$ 0 turn on EVP
80	mlosch	1.8	&
81			\\
82			SEAICEuseEVPstar & F & use modified EVP* instead of EVP & %---ref---
83			\\
84			SEAICEuseEVPrev & F & use yet another variation on EVP* & %---ref---
85			\\
86			SEAICEnEVPstarSteps & UNSET & number of modified EVP* iteration & %---ref---
87			\\
88			SEAICE\_evpAlpha & UNSET & EVP* parameter & %---ref---
89			\\
90			SEAICE\_evpBeta & UNSET & EVP* parameter & %---ref---
91	mlosch	1.6	\\
92			SEAICE\_elasticParm & $\frac{1}{3}$
93			& EVP paramter $E_0$ & \\
94			SEAICE\_evpTauRelax & $\Delta{t}_{EVP}E_0$
95			& relaxation time scale $T$ for EVP waves & \\
96			% SEAICE_evpDampC & & & \\
97	mlosch	1.7	SEAICEnewtonIterMax & 10
98			& maximum number of JFNK-Newton iterations
99			& %---ref---
100			\\
101			SEAICEkrylovIterMax & 10
102			& maximum number of JFNK-Krylov iterations
103			& %---ref---
104			\\
105			SEAICE\_JFNK\_lsIter & (off)
106			& start line search after ``lsIter'' Newton iterations
107			& %---ref---
108			\\
109			% SEAICE\_JFNK\_tolIter & 100
110			% & number of Newton iterations after which the
111			% the tolerance is relaxed again
112			% & %---ref---
113			% \\
114			JFNKgamma\_nonlin & 1.0E-05
115			& non-linear tolerance parameter for JFNK solver
116			& %---ref---
117			\\
118			JFNKgamma\_lin\_min/max & 0.10/0.99
119			& tolerance parameters for linear JFNK solver
120			& %---ref---
121			\\
122			JFNKres\_tFac & UNSET
123			& tolerance parameter for FGMRES residual
124			& %---ref---
125			\\
126			SEAICE\_JFNKepsilon & 1.0E-06
127			& step size for the FD-Jacobian-times-vector
128			& %---ref---
129			\\
130			SEAICE\_dumpFreq & dumpFreq
131			& dump frequency
132	molod	1.1	& %---ref---
133			\\
134	mlosch	1.4	SEAICE\_taveFreq & taveFreq
135	molod	1.1	& time-averaging frequency
136			& %---ref---
137			\\
138			SEAICE\_dump\_mdsio & T
139			& write snap-shot using MDSIO
140			& %---ref---
141			\\
142			SEAICE\_tave\_mdsio & T
143			& write TimeAverage using MDSIO
144			& %---ref---
145			\\
146			SEAICE\_dump\_mnc & F
147			& write snap-shot using MNC
148			& %---ref---
149			\\
150			SEAICE\_tave\_mnc & F
151			& write TimeAverage using MNC
152			& %---ref---
153			\\
154	mlosch	1.4	SEAICE\_initialHEFF & 0.00000E+00
155	molod	1.1	& initial sea-ice thickness
156			& %---ref---
157			\\
158	heimbach	1.2	SEAICE\_drag & 2.00000E-03
159	molod	1.1	& air-ice drag coefficient
160			& %---ref---
161			\\
162	heimbach	1.2	OCEAN\_drag & 1.00000E-03
163	molod	1.1	& air-ocean drag coefficient
164			& %---ref---
165			\\
166	heimbach	1.2	SEAICE\_waterDrag & 5.50000E+00
167	molod	1.1	& water-ice drag
168			& %---ref---
169			\\
170	heimbach	1.2	SEAICE\_dryIceAlb & 7.50000E-01
171	molod	1.1	& winter albedo
172			& %---ref---
173			\\
174	heimbach	1.2	SEAICE\_wetIceAlb & 6.60000E-01
175	molod	1.1	& summer albedo
176			& %---ref---
177			\\
178	heimbach	1.2	SEAICE\_drySnowAlb & 8.40000E-01
179	molod	1.1	& dry snow albedo
180			& %---ref---
181			\\
182	heimbach	1.2	SEAICE\_wetSnowAlb & 7.00000E-01
183	molod	1.1	& wet snow albedo
184			& %---ref---
185			\\
186	heimbach	1.2	SEAICE\_waterAlbedo & 1.00000E-01
187	molod	1.1	& water albedo
188			& %---ref---
189			\\
190	heimbach	1.2	SEAICE\_strength & 2.75000E+04
191	mlosch	1.9	& sea-ice strength $P^{*}$
192			& %---ref---
193			\\
194			SEAICE\_cStar & 20.0000E+00
195			& sea-ice strength paramter $C^{*}$
196	molod	1.1	& %---ref---
197			\\
198	mlosch	1.6	SEAICE\_rhoAir & 1.3 (or \code{exf} value)
199			& density of air (kg/m$^3$)
200			& %---ref---
201			\\
202			SEAICE\_cpAir & 1004 (or \code{exf} value)
203			& specific heat of air (J/kg/K)
204			& %---ref---
205			\\
206			SEAICE\_lhEvap & 2,500,000 (or \code{exf} value)
207			& latent heat of evaporation % for water (J/kg)
208			& %---ref---
209			\\
210			SEAICE\_lhFusion & 334,000 (or \code{exf} value)
211			& latent heat of fusion %for ice and snow (J/kg)
212			& %---ref---
213			\\
214			SEAICE\_lhSublim & 2,834,000
215			& latent heat of sublimation %for ice and snow (J/kg)
216			& %---ref---
217			\\
218			SEAICE\_dalton & 1.75E-03
219			& sensible heat transfer coefficient
220			& %---ref---
221	molod	1.1	\\
222	heimbach	1.2	SEAICE\_iceConduct & 2.16560E+00
223	molod	1.1	& sea-ice conductivity
224			& %---ref---
225			\\
226	heimbach	1.2	SEAICE\_snowConduct & 3.10000E-01
227	molod	1.1	& snow conductivity
228			& %---ref---
229			\\
230	heimbach	1.2	SEAICE\_emissivity & 5.50000E-08
231	molod	1.1	& Stefan-Boltzman
232			& %---ref---
233			\\
234	heimbach	1.2	SEAICE\_snowThick & 1.50000E-01
235	molod	1.1	& cutoff snow thickness
236			& %---ref---
237			\\
238	heimbach	1.2	SEAICE\_shortwave & 3.00000E-01
239	molod	1.1	& penetration shortwave radiation
240			& %---ref---
241			\\
242	heimbach	1.2	SEAICE\_freeze & -1.96000E+00
243	molod	1.1	& freezing temp. of sea water
244			& %---ref---
245			\\
246	mlosch	1.7	SEAICE\_saltFrac & 0.0
247			& salinity newly formed ice (fraction of ocean surface salinity)
248	mlosch	1.4	& %---ref---
249			\\
250	mlosch	1.7	% SEAICE\_gamma\_t & UNSET
251			% & restoring time scale for basal freezing and melting
252			% & %---ref---
253			% \\
254			% SEAICE\_gamma\_t\_frz & UNSET
255			% & restoring time scale for basal freezing
256			% & %---ref---
257			% \\
258			% SEAICE\_mcPheePiston & UNSET
259			% & ocean-ice turbulent flux "piston velocity" (m/s) that sets melt
260			% efficiency.
261			% & %---ref---
262			% \\
263			% SEAICE\_mcPheeTaper & UNSET
264			% & tapering down of turbulent flux term with ice concentration.
265			% & %---ref---
266			% \\
267			SEAICE\_frazilFrac & 0.0
268			& Fraction of surface level negative heat content anomalies
269			(relative to the local freezing point)
270	mlosch	1.4	& %---ref---
271			\\
272			SEAICEstressFactor & 1.00000E+00
273			& scaling factor for ice-ocean stress
274			& %---ref---
275			\\
276	mlosch	1.7	Heff/Area/HsnowFile/Hsalt & UNSET
277			& initial fields for variables HEFF/AREA/HSNOW/HSALT
278	mlosch	1.4	& %---ref---
279			\\
280	mlosch	1.7	LSR\_ERROR & 1.00000E-04
281	molod	1.1	& sets accuracy of LSR solver
282			& %---ref---
283			\\
284	mlosch	1.7	DIFF1 & 0.0
285	molod	1.1	& parameter used in advect.F
286			& %---ref---
287			\\
288	heimbach	1.2	HO & 5.00000E-01
289	mlosch	1.6	& demarcation ice thickness (AKA lead closing paramter $h_0$)
290	molod	1.1	& %---ref---
291			\\
292	heimbach	1.2	MAX\_HEFF & 1.00000E+01
293	molod	1.1	& maximum ice thickness
294			& %---ref---
295			\\
296	heimbach	1.2	MIN\_ATEMP & -5.00000E+01
297	molod	1.1	& minimum air temperature
298			& %---ref---
299			\\
300	heimbach	1.2	MIN\_LWDOWN & 6.00000E+01
301	molod	1.1	& minimum downward longwave
302			& %---ref---
303			\\
304	heimbach	1.2	MAX\_TICE & 3.00000E+01
305	molod	1.1	& maximum ice temperature
306			& %---ref---
307			\\
308	heimbach	1.2	MIN\_TICE & -5.00000E+01
309	molod	1.1	& minimum ice temperature
310			& %---ref---
311			\\
312	mlosch	1.6	IMAX\_TICE & 10
313			& iterations for ice heat budget
314			& %---ref---
315			\\
316	heimbach	1.2	SEAICE\_EPS & 1.00000E-10
317	molod	1.1	& reduce derivative singularities
318			& %---ref---
319			\\
320	mlosch	1.7	SEAICE\_area\_reg & 1.00000E-5
321			& minimum concentration to regularize ice thickness
322			& %---ref---
323			\\
324			SEAICE\_hice\_reg & 0.05 m
325			& minimum ice thickness for regularization
326	mlosch	1.6	& %---ref---
327			\\
328	heimbach	1.2	\hline
329	molod	1.1	\end{tabular}
330	heimbach	1.2	}
331	molod	1.1	\end{table}
332
333	mlosch	1.7	%%% Local Variables:
334			%%% mode: latex
335			%%% TeX-master: "../../manual"
336			%%% End: