WSL/SLF GitLab Repository

alpine3d_ebalance.xml 8.74 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<!--
/*****************************************************************************/
/*  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
it under the terms of the GNU General Public License as published by
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
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with INIshell.  If not, see <http://www.gnu.org/licenses/>.
*/
-->

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

<inishell_include>

	<!-- Alternative panel: EBalance -->
	<parameter type="helptext" wrap="true" section="EBalance">
		<help>First, the measured radiation (as provided by each station that measured both ISWR, TA and RH) is interpolated over the domain (see the &lt;a href="https://models.slf.ch/docserver/alpine3d/html/radiation_balance.html"&gt;online documentation&lt;/a&gt;). Then the effects of the terrain on the radiation field are accounted for. These are twofold: first the topography can cast shade on some parts of the domain (this is always computed) and second some radiation can be reflected by the terrain on some other cells (this is what is configured here).</help>
	</parameter>
32
	<parameter type="spacer" height="10" section="EBalance"/>
Michael Reisecker's avatar
Michael Reisecker committed
33

34
	<parameter key="Terrain_Radiation" type="alternative" default="TRUE" section="EBalance">
35
36
37
38
39
40
41
42
43
44
45
46
		<option value="TRUE">
			<parameter key="Terrain_Radiation_Method" type="alternative" default="SIMPLE" section="EBalance">
				<reference name="TERRAIN_SIMPLE"/>
				<reference name="TERRAIN_FULL"/>
				<reference name="TERRAIN_HELBIG"/>
				<reference name="TERRAIN_PETSC"/>
				<help>Select how the radiation reflected by the terrain will be computed</help>
			</parameter>
		</option>
		<option value="FALSE"/>
		<help>Should the radiation reflected by the terrain be computed?</help>
	</parameter>
Michael Reisecker's avatar
Michael Reisecker committed
47

48
49
50
51
52
	<parametergroup name="TERRAIN_SIMPLE">
		<option value="SIMPLE">
			<help>a very basic (but fast) guess, see &lt;a href="https://models.slf.ch/docserver/alpine3d/html/classTerrainRadiationSimple.html"&gt;TerrainRadiationSimple&lt;/a&gt;</help>
		</option>
	</parametergroup>
Michael Reisecker's avatar
Michael Reisecker committed
53

54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
	<parametergroup name="TERRAIN_FULL">
		<option value="FULL">
			<parameter key="itEps_SW" type="number" format="decimal" precision="2" default="0.4" min="0">
				<help>stopping tolerance/iteration error for shortwave radiation (default: 0.4). Make it larger to stop the iteration earlier, i.e. less terrain reflections are included –> with 10 % (0.1) a good accuracy is obtained.</help>
			</parameter>
			<parameter key="itEps1_SW" type="number" format="decimal" precision="2" default="0.1" min="0">
				<help>stopping tolerance/iteration error for shortwave radiation (default: 0.1). Make it lower to stop the iteration earlier, i.e. less terrain reflections are included</help>
			</parameter>
			<parameter key="itEps_LW" type="number" format="decimal" precision="2" default="0.1" min="0">
				<help>stopping tolerance/iteration error for longwave radiation (default: 0.4). Note that two stopping critera are used</help>
			</parameter>
			<parameter key="sw_radius" type="number" format="integer+" default="3000" unit="m">
				<help>the distance radius (in m) around each grid cell until which terrain reflection is taken into account (default: 3000)</help>
			</parameter>
			<parameter key="lw_radius" type="number" format="integer+" default="3000" unit="m">
				<help>the distance radius (in m) around each grid cell until which longwave emission is taken into account (default: 3000)</help>
			</parameter>
			<help>a parallelized implementation of a radiosity algorithm, see &lt;a href="https://models.slf.ch/docserver/alpine3d/html/classTerrainRadiation.html"&gt;TerrainRadiation&lt;/a&gt;</help>
		</option>
	</parametergroup>
Michael Reisecker's avatar
Michael Reisecker committed
74

75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
	<parametergroup name="TERRAIN_HELBIG">
		<option value="HELBIG">
			<parameter key="itEps_SW" type="number" format="decimal" precision="2" default="0.4" min="0">
				<help>stopping tolerance/iteration error for shortwave radiation (default: 0.4). Make it larger to stop the iteration earlier, i.e. less terrain reflections are included –> with 10 % (0.1) a good accuracy is obtained.</help>
			</parameter>
			<parameter key="itEps1_SW" type="number" format="decimal" precision="2" default="0.1" min="0">
				<help>stopping tolerance/iteration error for shortwave radiation (default: 0.1). Make it lower to stop the iteration earlier, i.e. less terrain reflections are included</help>
			</parameter>
			<parameter key="itEps_LW" type="number" format="decimal" precision="2" default="0.1" min="0">
				<help>stopping tolerance/iteration error for longwave radiation (default: 0.4). Note that two stopping critera are used</help>
			</parameter>
			<parameter key="sw_radius" type="number" format="integer+" default="3000" unit="m">
				<help>the distance radius (in m) around each grid cell until which terrain reflection is taken into account (default: 3000)</help>
			</parameter>
			<parameter key="lw_radius" type="number" format="integer+" default="3000" unit="m">
				<help>the distance radius (in m) around each grid cell until which longwave emission is taken into account (default: 3000)</help>
			</parameter>
			<parameter key="sub_crit" type="number" format="decimal" precision="2" default="0.4" min="0">
				<help>substructuring threshold (in %) of the patches in the view factor computation (default: 0.4). Note that mccluney(1994) proposes 0.1, i.e. for accurate view factors / radiation exchange computations a threshold of least 0.1 should be used.</help>
			</parameter>
			<parameter key="vf_in_ram" type="alternative" default="TRUE">
				<option value="TRUE"/>
				<option value="FALSE"/>
				<help>Progressive Refinement iteration is used; but you can enable storing the view factors in memory (in case of sufficient memory capacity –> faster terrain radiation computation)</help>
			</parameter>
			<help>the original radiosity implementation, not parallelized, see &lt;a href="https://models.slf.ch/docserver/alpine3d/html/classTerrainRadiationHelbig.html"&gt;TerrainRadiationHelbig&lt;/a&gt;</help>
		</option>
	</parametergroup>
Michael Reisecker's avatar
Michael Reisecker committed
103

104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
	<parametergroup name="TERRAIN_PETSC">
		<option value="PETSC">
			<parameter key="itEps_SW" type="number" format="decimal" precision="2" default="0.4" min="0">
				<help>stopping tolerance/iteration error for shortwave radiation (default: 0.4). Make it larger to stop the iteration earlier, i.e. less terrain reflections are included –> with 10 % (0.1) a good accuracy is obtained.</help>
			</parameter>
			<parameter key="itEps1_SW" type="number" format="decimal" precision="2" default="0.1" min="0">
				<help>stopping tolerance/iteration error for shortwave radiation (default: 0.1). Make it lower to stop the iteration earlier, i.e. less terrain reflections are included</help>
			</parameter>
			<parameter key="itEps_LW" type="number" format="decimal" precision="2" default="0.1" min="0">
				<help>stopping tolerance/iteration error for longwave radiation (default: 0.4). Note that two stopping critera are used</help>
			</parameter>
			<parameter key="sw_radius" type="number" format="integer+" default="3000" unit="m">
				<help>the distance radius (in m) around each grid cell until which terrain reflection is taken into account (default: 3000)</help>
			</parameter>
			<parameter key="lw_radius" type="number" format="integer+" default="3000" unit="m">
				<help>the distance radius (in m) around each grid cell until which longwave emission is taken into account (default: 3000)</help>
			</parameter>
			<parameter key="sub_crit" type="number" format="decimal" precision="2" default="0.4" min="0">
				<help>substructuring threshold (in %) of the patches in the view factor computation (default: 0.4). Note that mccluney(1994) proposes 0.1, i.e. for accurate view factors / radiation exchange computations a threshold of least 0.1 should be used.</help>
			</parameter>
			<parameter key="vf_in_ram" type="alternative" default="TRUE">
				<option value="TRUE"/>
				<option value="FALSE"/>
				<help>Progressive Refinement iteration is used; but you can enable storing the view factors in memory (in case of sufficient memory capacity –> faster terrain radiation computation)</help>
			</parameter>
			<help>&lt;font color='#ff0000'&gt;This method relies on special libraries and compilation flags!! Use it at your own risk!&lt;/font&gt;</help>
		</option>
	</parametergroup>
132
133

</inishell_include>