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