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