WSL/SLF GitLab Repository

snowpack_advanced.xml 26.7 KB
Newer Older
1
2
3
4
5
6
<!--
/*****************************************************************************/
/*  Copyright 2019 WSL Institute for Snow and Avalanche Research  SLF-DAVOS  */
/*****************************************************************************/
/* This file is part of INIshell.
INIshell is free software: you can redistribute it and/or modify
7
it under the terms of the GNU General Public License as published by
8
9
10
11
12
13
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

INIshell is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14
GNU General Public License for more details.
15

16
17
You should have received a copy of the GNU General Public License
along with INIshell.  If not, see <http://www.gnu.org/licenses/>.
18
19
20
21
22
23
24
25
26
27
28
29
*/
-->

<!--
This is an INIshell configuration file for the software SNOWPACK.
https://models.slf.ch/p/snowpack
-->

<inishell_include>

	<!-- Alternative panel: SNOWPACK_ADVANCED -->
	<parameter type="label" label="&lt;font color='#ff0000'&gt;&lt;h3&gt;Warning&lt;/h3&gt;&lt;/font&gt;">
30
		<section name="SnowpackAdvanced" color="sl_base01"/>
31
	</parameter>
32
	<parameter type="helptext" wrap="true" section="SnowpackAdvanced">
33
34
		<help>&lt;font color="#ff0000"&gt;&lt;strong&gt;The keys in this section deeply affect the operation of the SNOWPACK model. This could lead to unexpected behavior or surprising results. If you are not an experienced Snowpack user, please do NOT change any keys below!&lt;/strong&gt;&lt;/font&gt;</help>
	</parameter>
35
	<parameter type="spacer" height="10" section="SnowpackAdvanced"/>
36

37
38
	<frame caption="Operation mode" section="SnowpackAdvanced">
		<parameter key="VARIANT" type="alternative" default="DEFAULT" section="SnowpackAdvanced">
39
40
41
42
43
			<option value="DEFAULT"/>
			<option value="JAPAN"/>
			<option value="ANTARCTICA"/>
			<option value="POLAR"/>
			<!-- <option value="CALIBRATION"/> -->
44
			<help>Variant selection. A choice of specific SNOWPACK variants that will set some switches and values to non-default ones. Users can override these by setting them below. When using POLAR variant, please cite: Steger CR, Reijmer CH, van den Broeke MR, Wever N, Forster RR, Koenig LS, Kuipers Munneke P, Lehning M, Lhermitte S, Ligtenberg SRM, Miège C and Noël BPY, &lt;i&gt;"Firn Meltwater Retention on the Greenland Ice Sheet: A Model Comparison"&lt;/i&gt;, Front. Earth Sci. 5:3, 2017, doi: 10.3389/feart.2017.00003</help>
45
		</parameter>
46
		<parameter key="RESEARCH" type="alternative" default="TRUE" section="SnowpackAdvanced">
47
48
49
			<option value="TRUE"/>
			<option value="FALSE"/>
		</parameter>
50
		<parameter key="NUMBER_FIXED_RATES" type="number" format="integer" default="0" section="SnowpackAdvanced"/>
51
	</frame>
52

53
	<frame caption="Station Handling" section="SnowpackAdvanced">
54
		<parameter key="ADJUST_HEIGHT_OF_METEO_VALUES" type="alternative" default="TRUE" longlabel="true">
55
56
57
58
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>If set to true, an adjustment of the height of the meteo values to the presence of a snow cover is applied (e.g., for measurements from a fixed mast that gets snowed in). If false, measured meteo values are assumed to maintain a constant height above the snow surface (e.g., when using measurements from Col de Porte or weather models as input).</help>
		</parameter>
59
		<parameter key="ADJUST_HEIGHT_OF_WIND_VALUE" type="alternative" default="TRUE" longlabel="true">
60
61
62
63
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>If set to true, an adjustment of the height of the wind value to the presence of a snow cover is applied (e.g., for measurements from a fixed mast that gets snowed in). If false, measured wind value are assumed to maintain a constant height above the snow surface (e.g., when using weather models as input).</help>
		</parameter>
64
		<parameter key="SNOW_EROSION" type="alternative" default="FALSE" longlabel="true">
65
66
67
68
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Specifies if snow erosion is enabled for the main station. Works only if measured heigths of snow are available at the main station. Unless NUMBER_SLOPES is set to 1, this erosion will not contribute to the drifting snow index (compare with SNOW_REDISTRIBUTION).</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
69
		<parameter key="WIND_SCALING_FACTOR" type="number" format="decimal" precision="1" default="1.0" min="0" max="2" longlabel="true">
70
71
			<help>Scaling factor to apply to wind values causing drifting snow</help>
		</parameter>
72
		<parameter key="NUMBER_SLOPES" type="alternative" default="1" optional="false" longlabel="true">
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
			<option value="1"/>
			<option value="3">
				<reference name="SP_VIRTUAL_SLOPES_OPTION"/>
			</option>
			<option value="4"/>
			<option value="5">
				<reference name="SP_VIRTUAL_SLOPES_OPTION"/>
			</option>
			<option value="7">
				<reference name="SP_VIRTUAL_SLOPES_OPTION"/>
			</option>
			<option value="9">
				<reference name="SP_VIRTUAL_SLOPES_OPTION"/>
			</option>
			<help>Based on meteorological input from a (flat field) automatic station or numerical weather model, up to 8 expositions can be calculated in addition to the flat field if the corresponding *.sno files are provided. For example, if you provide a flat field *.snow file (mandatory), which is named KLO3.sno and you want 4 slopes to be calculated the corresponding slope files should be named KLO21.sno, . . ., KLO24.sno. SNOW_REDISTRIBUTION is only available if each virtual slope has a matching luv/lee slope.</help>
		</parameter>
89
		<parameter key="PERP_TO_SLOPE" type="alternative" default="FALSE" longlabel="true">
90
91
92
93
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Set this option if the main station is on a slope and the input parameters are taken perpendicular to the slope. Works only for "NUMBER_SLOPES = 1"</help>
		</parameter>
94
		<parameter key="ALLOW_ADAPTIVE_TIMESTEPPING" type="alternative" default="TRUE" longlabel="true">
95
96
97
98
99
			<option value="TRUE" type="string"/>
			<option value="FALSE" type="string"/>
			<help>Set whether adaptive time stepping is allowed for solving the heat advection equation/phase changes when unstable atmospheric stratification is encountered (only for non-neutral atmospheric stability schemes). It then temporarily reduces the time step, in order to reduce oscillations in surface temperature. This increases computation times. Note that independent of this flag, the time step can be temporarily reduced when the heat equation does not converge.</help>
		</parameter>
	</frame>
100

101
102
103
104
105
106
107
	<!--Parameter group for virtual slopes -->
	<parametergroup name="SP_VIRTUAL_SLOPES_OPTION">
		<parameter key="SNOW_REDISTRIBUTION" type="alternative" default="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Specifies if redistribution of snow is allowed from windward (luv) to lee slopes. The snow erosion on virtual slopes will contribute to the drifting snow index.</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
108
		<parameter key="PREVAILING_WIND_DIR" type="number" format="integer+" min="0" max="360" wrap="true" default="0">
109
110
111
112
113
114
115
116
			<help>Shifts the origin of the wind rose for snow redistribution and slope simulations: e.g. choose 45° to have NE/SE/SW/NW</help>
		</parameter>
		<parameter key="MEAS_INCOMING_LONGWAVE" type="alternative" default="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Use the provided incoming long wave on virtual slopes too?</help>
		</parameter>
	</parametergroup>
117

118
	<frame caption="Precipitation Handling" section="SnowpackAdvanced">
Mathias Bavay's avatar
Mathias Bavay committed
119
		<parameter key="THRESH_RAIN" type="number" format="decimal" precision="2" default="1.2" unit="K">
120
121
122
123
124
125
126
			<help>Fallback temperature threshold for rain/snow transition if no other spliting method is provided (as data generator)</help>
		</parameter>
		<parameter key="FORCE_RH_WATER" type="alternative" default="TRUE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Tell the model that relative humidity values are with respect to water regardless of the temperature</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
127
		<parameter key="THRESH_RH" type="number" format="decimal" precision="2" default="0.5">
128
129
			<help>If ENFORCE_MEASURED_SNOW_HEIGHTS, relative humidity threshold for precipitation to occur</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
130
		<parameter key="THRESH_DTEMP_AIR_SNOW" type="number" format="decimal" precision="1" default="3.0" unit="K">
131
132
133
			<help>If ENFORCE_MEASURED_SNOW_HEIGHTS, (TA-TSS)' threshold for precipitation to occur</help>
		</parameter>
	</frame>
134

135
	<frame caption="Hoar Handling" section="SnowpackAdvanced">
Mathias Bavay's avatar
Mathias Bavay committed
136
		<parameter key="HOAR_THRESH_TA" type="number" format="decimal" precision="2" default="1.2" unit="K">
137
138
			<help>Air temperature threshold above which no surface hoar is allowed to form</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
139
		<parameter key="HOAR_THRESH_RH" type="number" format="decimal" precision="2" default="0.97">
140
141
			<help>Relative humidity threshold above which no surface hoar is allowed to form (because at very high humidity, typically no hoar crystals can form)</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
142
		<parameter key="HOAR_THRESH_VW" type="number" format="decimal" precision="1" default="3.5" unit="m/s">
143
144
			<help>Wind speed threshold above which no surface hoar is allowed to form (because it will drift away)</help>
		</parameter>
145
		<parameter key="HOAR_DENSITY_BURIED" type="number" format="integer+" default="125" unit="kg/m³">
146
147
			<help>Define the initial density for surface hoar at the time it gets buried by new snow</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
148
		<parameter key="HOAR_MIN_SIZE_BURIED" type="number" format="decimal" precision="1" default="2.0" unit="mm">
149
150
			<help>Define a threshold below which any traces of surface hoar will not be given a separate hoar layer when buried.</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
151
		<parameter key="HOAR_DENSITY_SURF" type="number" format="integer+" default="100" unit="kg/m³">
152
153
154
			<help>Assumed density of surface hoar while exposed at the surface and not buried</help>
		</parameter>
	</frame>
155

156
	<frame caption="Temperatures Handling" section="SnowpackAdvanced">
157
158
159
160
		<parameter key="FIXED_POSITIONS" type="text" default="">
			<help>positions of temperatur sensors in snow or soil: positive values refer to heigths measured from the ground surface (snow only), negative values refer to depths measured from either the ground surface or the snow surface in case no soil layers are present. A sensor must at least be covered by MIN_DEPTH_SUBSURF (m) snow for its temperature to be output.</help>
		</parameter>
		<!-- <parameter key="MAX_NUMBER_MEAS_TEMPERATURES" type="number" format="integer+" default="5"/> -->
Mathias Bavay's avatar
Mathias Bavay committed
161
162
		<parameter key="MIN_DEPTH_SUBSURF" type="number" format="decimal" precision="2" default="0.07" unit="m">
			<help>Minimum snow depth (m) above a temperature sensor to accept the measurement</help>
163
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
164
		<parameter key="T_CRAZY_MIN" type="number" format="integer+" default="210" unit="K">
165
166
			<help>If you go to Antarctica or the tropics you may expect different reasonable temperatures</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
167
		<parameter key="T_CRAZY_MAX" type="number" format="integer+" default="340" unit="K">
168
169
170
			<help>If you go to Antarctica or the tropics you may expect different reasonable temperatures</help>
		</parameter>
	</frame>
171

172
	<frame caption="Submodel Handling" section="SnowpackAdvanced">
173
		<parameter key="METAMORPHISM_MODEL" type="alternative" default="DEFAULT" longlabel="true">
174
175
176
177
			<option value="DEFAULT"/>
			<option value="NIED"/>
			<help>metamorphism_model</help>
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
178
		<parameter key="NEW_SNOW_GRAIN_SIZE" type="number" format="decimal" precision="1" default="0.3" unit="mm" longlabel="true">
179
180
			<help>Grain size of new snow crystals (mm)</help>
		</parameter>
181
		<parameter key="STRENGTH_MODEL" type="alternative" default="DEFAULT" longlabel="true">
182
183
184
185
			<option value="DEFAULT"/>
			<option value="NIED"/>
			<help>Strength model</help>
		</parameter>
186
		<parameter key="VISCOSITY_MODEL" type="alternative" default="DEFAULT" longlabel="true">
187
188
189
			<option value="DEFAULT"/>
			<help>Viscosity model</help>
		</parameter>
190
		<parameter key="SALTATION_MODEL" type="alternative" default="SORENSEN" longlabel="true">
191
192
193
194
195
196
197
198
199
			<option value="SORENSEN"/>
			<option value="DOORSCHOT"/>
			<help>The simple Sorenson parameterization is computationally more efficient than the full Doorschot model</help>
		</parameter>
		<!-- <parameter key="SURFACECODE" type="alternative">
			<option value="NEUMANN_BC"/>
			<option value="DIRICHLET_BC"/>
			<help>Select the boundary conditions to use</help>
		</parameter> -->
200
		<parameter key="ENABLE_VAPOUR_TRANSPORT" type="alternative" default="FALSE" longlabel="true">
201
202
203
204
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Enable mass transport by vapour flow.</help>
		</parameter>
205
		<parameter key="WATERTRANSPORTMODEL_SNOW" type="alternative" default="BUCKET" longlabel="true">
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
			<option value="BUCKET"/>
			<option value="NIED"/>
			<option value="RICHARDSEQUATION">
				<parameter key="AVG_METHOD_HYDRAULIC_CONDUCTIVITY" type="alternative" default="ARITHMETICMEAN">
					<option value="ARITHMETICMEAN"/>
					<option value="GEOMETRICMEAN"/>
					<option value="HARMONICMEAN"/>
					<option value="MINIMUMVALUE"/>
					<option value="UPSTREAM"/>
					<help>Averaging method for hydraulic conductivity at the layer nodes. Recommended setting either ARITHMETICMEAN (default) or GEOMETRICMEAN.</help>
				</parameter>
				<parameter key="PREF_FLOW" type="alternative" default="FALSE">
					<option value="TRUE">
						<parameter key="AVG_METHOD_HYDRAULIC_CONDUCTIVITY_PREF_FLOW" type="alternative" default="ARITHMETICMEAN">
							<option value="ARITHMETICMEAN"/>
							<option value="GEOMETRICMEAN"/>
							<option value="HARMONICMEAN"/>
							<option value="MINIMUMVALUE"/>
							<option value="UPSTREAM"/>
							<help>Averaging method for hydraulic conductivity at the layer nodes. Recommended setting either ARITHMETICMEAN (default) or GEOMETRICMEAN.</help>
						</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
227
						<parameter key="PREF_FLOW_PARAM_TH" type="number" format="decimal" precision="2" default="0.1">
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
							<help>Tuning parameter: saturation threshold in preferential flow</help>
						</parameter>
						<parameter key="PREF_FLOW_PARAM_N" type="number" format="decimal" default="0.0">
							<help>Tuning parameter: number of preferential flow paths for heat exchange</help>
						</parameter>
						<parameter key="PREF_FLOW_PARAM_HETEROGENEITY_FACTOR" type="number" format="decimal" default="1.0">
							<help>Tuning parameter: heterogeneity factor for grain size</help>
						</parameter>
						<parameter key="PREF_FLOW_RAIN_INPUT_DOMAIN" type="alternative" default="MATRIX">
							<option value="MATRIX"/>
							<option value="PREF_FLOW"/>
							<help>Direct incoming rain water to either matrix or preferential flow domain.</help>
						</parameter>
					</option>
					<option value="FALSE"/>
					<help>Dual domain approach to simulate preferential flow. When set to TRUE, it requires to specify the volumetric water content in preferential flow (Vol_Frac_WP) in the *.sno file, directly following the column Vol_Frac_W.</help>
				</parameter>
			</option>
			<help>Water transport model to use in snow: simple bucket model, Nied model or Richards equation solver</help>
		</parameter>
248
		<parameter key="WATERTRANSPORTMODEL_SOIL" type="alternative" default="BUCKET" longlabel="true">
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
			<option value="BUCKET"/>
			<option value="RICHARDSEQUATION">
				<parameter key="LB_COND_WATERFLUX" type="alternative" default="FREEDRAINAGE" optional="false">
					<option value="FREEDRAINAGE"/>
					<option value="WATERTABLE"/>
					<option value="DIRICHLET"/>
					<option value="GRAVIATIONALDRAINAGE"/>
					<option value="SEEPAGE"/>
					<help>Lower boundary condition for Richards equation solver:
						&lt;dl&gt;
						&lt;dt&gt;FREEDRAINAGE&lt;/dt&gt;  &lt;dd&gt;(default, recommended for shallow soil) prescribes a free drainage boundary;&lt;/dd&gt;
						&lt;dt&gt;WATERTABLE&lt;/dt&gt;  &lt;dd&gt;(recommended for deep soil) prescribes a saturated lower boundary;&lt;/dd&gt;
						&lt;dt&gt;DIRICHLET&lt;/dt&gt;  &lt;dd&gt;keeps the saturation in the lowest layer constant;&lt;/dd&gt;
						&lt;dt&gt;GRAVITATIONALDRAINAGE&lt;/dt&gt;  &lt;dd&gt;prescribes the gravity compenent of the liquid water flow;&lt;/dd&gt;
						&lt;dt&gt;SEEPAGE&lt;/dt&gt;  &lt;dd&gt;provides a seepage boundary condition which typically describes the setup of laboratory experiments;&lt;/dd&gt;
						&lt;/dl&gt;
					</help>
				</parameter>
			</option>
			<help>Water transport model to use in soil: simple bucket model or Richards equation solver. Note that Richards equation solver uses the grain size of the layer to determine the soil type, as listed at: http://models.slf.ch/p/snowpack/page/Soil-with-Richards-equation/.</help>
		</parameter>
270
271
272
273
274
275
276
277
278
279
280
		<frame caption="Degree-day model">
			<parameter type="helptext" wrap="true" section="SnowpackAdvanced">
				<help>For models intercomparisons, it is possible to replace the energy balance model by a degree-day model during the melt phases. This degree-day model provides the energy fluxes at the surface as: &lt;center&gt;temp_index_degree_day*(T&lt;sub&gt;air&lt;/sub&gt; - T&lt;sub&gt;surface&lt;/sub&gt;) + temp_index_swr_factor*SW&lt;sub&gt;net&lt;/sub&gt;&lt;/center&gt;</help>
			</parameter>
			<parameter key="TEMP_INDEX_DEGREE_DAY" type="number" format="decimal" min="0.00" precision="2" optional="true">
				<help>If a positive value is given, the degree-day model is enabled and this is the temperature factor.</help>
			</parameter>
			<parameter key="TEMP_INDEX_SWR_FACTOR" type="number" format="decimal" min="0.00" precision="2" optional="true">
				<help>If using a degree-day model, it is possible to enhance it with an Incoming Short Wave Radiation dependency. This provides the ISWR factor to use.</help>
			</parameter>
		</frame>
281
	</frame>
282

283
	<frame caption="Parameterization Handling" section="SnowpackAdvanced">
284
		<parameter key="HN_DENSITY" type="alternative" longlabel="true">
285
286
287
288
289
290
291
292
293
294
295
296
297
			<option value="EVENT"/>
			<option value="PARAMETERIZED">
				<parameter key="HN_DENSITY_PARAMETERIZATION" type="alternative" default="LEHNING_NEW">
					<option value="LEHNING_NEW"/>
					<option value="ZWART"/>
					<option value="BELLAIRE"/>
					<option value="LEHNING_OLD"/>
					<option value="PAHAUT"/>
					<option value="NIED"/>
					<help>Choice of parameterizations for new snow density (statistical models)</help>
				</parameter>
			</option>
			<option value="MEASURED">
Mathias Bavay's avatar
Mathias Bavay committed
298
				<parameter key="HN_DENSITY_FIXEDVALUE" type="number" format="integer+" default="100" min="1" unit="kg/m³">
299
300
301
302
					<help>Set to 1 kg m-3 to use surface snow density in case of missing measurement values</help>
				</parameter>
			</option>
			<option value="FIXED">
Mathias Bavay's avatar
Mathias Bavay committed
303
				<parameter key="HN_DENSITY_FIXEDVALUE" type="number" format="integer+" default="100" min="30" unit="kg/m³">
304
305
306
307
308
					<help>Usual range used in SNOWPACK : 30 to 250 kg m-3. 30 kg m-3 will be enforced as minimum</help>
				</parameter>
			</option>
			<help>New snow density scheme. By default, Snowpack uses "PARAMETERIZED". If selecting "MEASURED", the new snow density must be provided under the parameter name "RHO_HN".</help>
		</parameter>
309
		<parameter key="SNOW_ALBEDO" type="alternative" longlabel="true">
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
			<option value="PARAMETERIZED">
				<parameter key="ALBEDO_PARAMETERIZATION" type="alternative" default="LEHNING_2">
					<option value="LEHNING_0"/>
					<option value="LEHNING_1"/>
					<option value="LEHNING_2"/>
					<option value="SCHMUCKI_GSZ">
						<parameter key="ALBEDO_AVERAGE_SCHMUCKI" type="alternative" default="ALL_DATA">
							<option value="ALL_DATA"/>
							<option value="CUSTOM"/>
							<help>Average value of regression models. ALL_DATA is the average of all albedo values obtained from four SwissMetNet stations: Weissfluhjoch (WFJ, 2540 m asl), Davos (DAV, 1594 m asl), Napf (NAP, 1404 m asl), and Payerne (PAY, 490 m asl). CUSTOM is the mean of the albedo averages for each single station WFJ, DAV, and PAY; it better fits stations lying below 1500 m asl in Switzerland</help>
						</parameter>
					</option>
					<option value="SCHMUCKI_OGS">
						<parameter key="ALBEDO_AVERAGE_SCHMUCKI" type="alternative" default="ALL_DATA">
							<option value="ALL_DATA"/>
							<option value="CUSTOM"/>
							<help>Average value of regression models. ALL_DATA is the average of all albedo values obtained from four SwissMetNet stations: Weissfluhjoch (WFJ, 2540 m asl), Davos (DAV, 1594 m asl), Napf (NAP, 1404 m asl), and Payerne (PAY, 490 m asl). CUSTOM is the mean of the albedo averages for each single station WFJ, DAV, and PAY; it better fits stations lying below 1600 m asl in Switzerland</help>
						</parameter>
					</option>
					<option value="NIED">
Mathias Bavay's avatar
Mathias Bavay committed
330
						<parameter key="ALBEDO_NIED_AV" type="number" format="decimal" precision="2" default="0.75">
331
332
333
334
335
336
337
							<help>Parameter av in the NIED albedo scheme.</help>
						</parameter>
					</option>
					<help>Choice of parameterizations for snow albedo (statistical models)</help>
				</parameter>
			</option>
			<option value="FIXED">
Mathias Bavay's avatar
Mathias Bavay committed
338
				<parameter key="ALBEDO_FIXEDVALUE" type="number" format="decimal" precision="2" default="0.95">
339
340
341
342
343
					<help>Enter a value between 0.30 (default albedo for glaciers) and 0.95 (enforced range)</help>
				</parameter>
			</option>
			<help>What scheme should be used for snow albedo? By default, Snowpack uses "PARAMETERIZED".</help>
		</parameter>
344
		<parameter key="ALBEDO_AGING" type="alternative" default="TRUE" longlabel="true">
345
346
347
348
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Should the age of the snow be taken into account in the snow albedo parametrizations? (not all such parametrizations use it, though). Turning it off should only be necessary for arctic/antarctic regions.</help>
		</parameter>
349
		<parameter key="SW_ABSORPTION_SCHEME" type="alternative" default="MULTI_BAND" longlabel="true">
350
351
352
353
			<option value="MULTI_BAND"/>
			<option value="SINGLE_BAND"/>
			<help>Select either a multi or a single band scheme for shortwave radiation absorption by the snow cover</help>
		</parameter>
354
		<parameter key="HARDNESS_PARAMETERIZATION" type="alternative" default="MONTI" longlabel="true">
355
356
357
358
359
360
361
			<option value="MONTI"/>
			<option value="BELLAIRE"/>
			<option value="ASARC"/>
			<help>Select the appropriate hand hardness parameterization</help>
		</parameter>
	</frame>

362
	<frame caption="Extras" section="SnowpackAdvanced">
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
		<parameter key="DETECT_GRASS" type="alternative" default="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Identify grass growing under the snow height sensor. This usually works well but might sometimes lead to problems</help>
		</parameter>
		<parameter key="PLASTIC" type="alternative" default="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Switch to tell the model that a impermeable layer should be simulated on top of some snow or ice: this requires that the *.sno file contains this layer, which is characterized via the soil parameters; the option has successfully been used to simulate snow and ice protection using geo-textiles and saw dust.</help>
		</parameter>
		<parameter key="JAM" type="alternative" default="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>If switched on, you can also simulate ponding on impermeable ice surfaces below the snow cover</help>
		</parameter>
		<parameter key="WATER_LAYER" type="alternative" default="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>This flag behaves differently depending on the chosen water transport scheme. For the BUCKET scheme: Assuming an impermeable surface such as on a road or on geo-textiles (e.g. for snow farming), a liquid water layer is allowed to form on this surface. For RICHARDSEQUATION: in case high infiltration fluxes cannot be fully absorbed by the matrix, form a ponding layer on the top of the domain.</help>
		</parameter>
	</frame>
384

385
	<frame caption="Elements Handling" section="SnowpackAdvanced">
Mathias Bavay's avatar
Mathias Bavay committed
386
387
		<parameter key="HEIGHT_NEW_ELEM" type="number" format="decimal" precision="2" default="0.02" unit="m">
			<help>Standard size (m) of a new element added to the stack of elements (layers) during snowfall events</help>
388
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
389
390
		<parameter key="MINIMUM_L_ELEMENT" type="number" format="decimal" precision="4" default="0.0025" unit="m">
			<help>Threshold value for enforcing the layer to be merged with the layer above or below (m)</help>
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
		</parameter>
		<parameter key="COMBINE_ELEMENTS" type="alternative" default="TRUE">
			<option value="TRUE">
				<!--<parameter key="COMB_THRESH_L" type="number" format"decimal" default="0.015">
				<help>Threshold value: both elements must be smaller than COMB_THRESH_L for an action to be taken.</help>
				</parameter>-->
				<!--<parameter key="REDUCE_N_ELEMENTS" type="alternative" default="FALSE">
				<option value="FALSE"/>
				<option value="TRUE"/>
				<help>Increase the combining of elements deeper in the snowpack and split elements when they approach the surface again. This reduces the number of elements and thereby the computational load in case of deep snowpacks, like glaciers or firn packs.</help>
				</parameter>-->
			</option>
			<option value="FALSE"/>
			<help>Combine neighboring elements based on a set of similarity conditions which are hard-coded</help>
		</parameter>
	</frame>
407

408
	<frame caption="Canopy" section="SnowpackAdvanced">
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
		<parameter key="TWO_LAYER_CANOPY" type="alternative" default="TRUE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>The canopy is divided into a trunk layer and a leaf-layer. An energy balance is computed for each layer, producing leaf-layer and trunk layer temperatures that affect LW radiations to the ground.</help>
		</parameter>
		<parameter key="CANOPY_HEAT_MASS" type="alternative" default="TRUE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Add a biomass heat flux term in the canopy energy balance</help>
		</parameter>
		<parameter key="CANOPY_TRANSMISSION" type="alternative" default="TRUE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Computes the canopy shade soil cover fraction, as function of canopy height, crown diameter, vertical canopy soil cover, and solar elevation angle</help>
		</parameter>
		<parameter key="FORESTFLOOR_ALB" type="alternative" default="TRUE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Litter falling on the forest floor can reduce albedo</help>
		</parameter>
	</frame>
430

431
	<frame caption="Permafrost" section="SnowpackAdvanced">
432
433
		<parameter key="ADVECTIVE_HEAT" type="alternative" default="FALSE">
			<option value="TRUE" type="string">
Mathias Bavay's avatar
Mathias Bavay committed
434
				<parameter key="HEAT_BEGIN" type="number" format="decimal" precision="3" unit="m" optional="false">
435
436
					<help>depth in meters where to start injecting the thermal flux (from the surface)</help>
				</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
437
				<parameter key="HEAT_END" type="number" format="decimal" precision="3" unit="m" optional="false">
438
439
440
441
442
443
444
					<help>depth in meters where to stop injecting the thermal flux (from the surface)</help>
				</parameter>
			</option>
			<option value="FALSE"/>
			<help>Inject a thermal flux at a given depth (this must be provided under the parameter name ADV_HEAT in the meteo file, currently only SMET provides this possibility). The flux is in W/m^3</help>
		</parameter>
	</frame>
445

446
</inishell_include>