WSL/SLF GitLab Repository

snowpack_advanced.xml 25.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="60" 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
44
45
			<option value="DEFAULT"/>
			<option value="JAPAN"/>
			<option value="ANTARCTICA"/>
			<option value="POLAR"/>
			<!-- <option value="CALIBRATION"/> -->
			<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 (2017) Firn Meltwater Retention on the Greenland Ice Sheet: A Model Comparison. Front. Earth Sci. 5:3. doi: 10.3389/feart.2017.00003</help>
		</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>
Mathias Bavay's avatar
Mathias Bavay committed
145
		<parameter key="HOAR_DENSITY_BURIED" type="integer+" format="decimal" 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
270
			<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>
	</frame>
271

272
	<frame caption="Parameterization Handling" section="SnowpackAdvanced">
273
		<parameter key="HN_DENSITY" type="alternative" longlabel="true">
274
275
276
277
278
279
280
281
282
283
284
285
286
			<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
287
				<parameter key="HN_DENSITY_FIXEDVALUE" type="number" format="integer+" default="100" min="1" unit="kg/m³">
288
289
290
291
					<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
292
				<parameter key="HN_DENSITY_FIXEDVALUE" type="number" format="integer+" default="100" min="30" unit="kg/m³">
293
294
295
296
297
					<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>
298
		<parameter key="SNOW_ALBEDO" type="alternative" longlabel="true">
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
			<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
319
						<parameter key="ALBEDO_NIED_AV" type="number" format="decimal" precision="2" default="0.75">
320
321
322
323
324
325
326
							<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
327
				<parameter key="ALBEDO_FIXEDVALUE" type="number" format="decimal" precision="2" default="0.95">
328
329
330
331
332
					<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>
333
		<parameter key="ALBEDO_AGING" type="alternative" default="TRUE" longlabel="true">
334
335
336
337
			<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>
338
		<parameter key="SW_ABSORPTION_SCHEME" type="alternative" default="MULTI_BAND" longlabel="true">
339
340
341
342
			<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>
343
		<parameter key="HARDNESS_PARAMETERIZATION" type="alternative" default="MONTI" longlabel="true">
344
345
346
347
348
349
350
			<option value="MONTI"/>
			<option value="BELLAIRE"/>
			<option value="ASARC"/>
			<help>Select the appropriate hand hardness parameterization</help>
		</parameter>
	</frame>

351
	<frame caption="Extras" section="SnowpackAdvanced">
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
		<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>
373

374
	<frame caption="Elements Handling" section="SnowpackAdvanced">
Mathias Bavay's avatar
Mathias Bavay committed
375
376
		<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>
377
		</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
378
379
		<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>
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
		</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>
396

397
	<frame caption="Canopy" section="SnowpackAdvanced">
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
		<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>
419

420
	<frame caption="Permafrost" section="SnowpackAdvanced">
421
422
		<parameter key="ADVECTIVE_HEAT" type="alternative" default="FALSE">
			<option value="TRUE" type="string">
Mathias Bavay's avatar
Mathias Bavay committed
423
				<parameter key="HEAT_BEGIN" type="number" format="decimal" precision="3" unit="m" optional="false">
424
425
					<help>depth in meters where to start injecting the thermal flux (from the surface)</help>
				</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
426
				<parameter key="HEAT_END" type="number" format="decimal" precision="3" unit="m" optional="false">
427
428
429
430
431
432
433
					<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>
434

435
</inishell_include>