WSL/SLF GitLab Repository

meteoio_timeseries_input.xml 33.3 KB
Newer Older
1
2
<!--
/*****************************************************************************/
3
/*  Copyright 2020 WSL Institute for Snow and Avalanche Research  SLF-DAVOS  */
4
5
6
/*****************************************************************************/
/* 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
INIshell include file for timeseries input plugin definitions
Please include meteoio_parametergroups before use!
24
25
26
27
28
29
30
-->

<inishell_include>

	<!-- Alternative panel: METEOIO_TS_IN -->
	<parametergroup name="METEOIO_TS_IN">
		<!-- it's nice to give defaults to non-optional keys (no 'unsaved changes' warning: -->
31
32
33
		<parameter type="helptext" wrap="true">
			<help>The plugins in the dropdown menu below that are italicized require third-party libraries that might not be installed on your system.</help>
		</parameter>
34
		<parameter key="METEO" label="Select METEO data plugin:" type="alternative" optional="false" default="SMET" pre-generate="false">
35
36
			<section name="Input"/>
			<option value="A3D">
37
38
39
				<parameter key="METEOPATH" type="path" optional="false">
					<help>Path to the meteorological files; this path must exist, it won't be created</help>
				</parameter>
40
				<help>Original Alpine3D meteo files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/a3d.html&quot;&gt;more…&lt;/a&gt;]</help>
41
			</option>
42
			<option value="ALPUG">
43
				<reference name="ALPUG_IN"/>
44
				<help>Data files generated by the ALPUG meteo stations [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/alpug.html&quot;&gt;more…&lt;/a&gt;]</help>
45
			</option>
46
			<option value="ARGOS">
Mathias Bavay's avatar
Mathias Bavay committed
47
				<reference name="ARGOS_IN"/>
48
				<help>Data files transmitted by the ARGOS system [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/argosio.html&quot;&gt;more…&lt;/a&gt;]</help>
Mathias Bavay's avatar
Mathias Bavay committed
49
			</option>
50
			<option value="COSMOXML" italic="true">
51
				<reference name="COSMO_IN"/>
52
				<help>MeteoSwiss COSMO's postprocessing XML format [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/cosmoxml.html&quot;&gt;more…&lt;/a&gt;]</help>
53
			</option>
54
			<option value="CSV" bold="true">
55
				<reference name="CSV_IN"/>
56
				<help>Comma separated files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/csvio.html&quot;&gt;more…&lt;/a&gt;]</help>
57
			</option>
58
			<option value="DBO" italic="true">
59
				<reference name="DBO_IN"/>
60
				<help>Connects to SLF's DBO web service interface [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/dbo.html&quot;&gt;more…&lt;/a&gt;]</help>
61
			</option>
62
			<option value="GEOTOP">
63
				<reference name="GEOTOP_IN"/>
64
				<help>GeoTop meteo files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/geotop.html&quot;&gt;more…&lt;/a&gt;]</help>
65
			</option>
66
			<option value="GOES">
67
				<reference name="GOES_IN"/>
68
				<help>Meteo files transmitted by the GOES satellites [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/goesio.html&quot;&gt;more…&lt;/a&gt;]</help>
69
			</option>
70
			<option value="GRIB" italic="true">
71
				<reference name="GRIB_METEO_IN"/>
72
				<help>GRIB meteo grid files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/gribio.html&quot;&gt;more…&lt;/a&gt;]</help>
73
			</option>
74
			<option value="IMIS" italic="true">
75
				<reference name="IMIS_IN" />
76
				<help>SLF's IMIS database [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/imis.html&quot;&gt;more…&lt;/a&gt;]</help>
77
			</option>
78
			<option value="NETCDF" bold="true" italic="true">
79
				<reference name="NETCDF_IN"/>
80
				<help>NetCDF grids and timeseries [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/netcdf.html&quot;&gt;more…&lt;/a&gt;]</help>
81
			</option>
82
			<option value="OSHD" italic="true">
83
				<reference name="OSHD_METEO_IN"/>
84
				<help>OSHD generated binary Matlab files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/oshd.html&quot;&gt;more…&lt;/a&gt;]</help>
85
			</option>
86
			<o value="PMOD"><help>Raw data files from Pmod/Wrc [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/pmodio.html&quot;&gt;more…&lt;/a&gt;]</help></o>
87
			<option value="PSQL" italic="true">
88
				<reference name="PSQL_IN"/>
89
				<help>Connects to PostgreSQL database [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/psqlio.html&quot;&gt;more…&lt;/a&gt;]</help>
90
			</option>
91
			<option value="SASE" italic="true">
92
				<help>Connects to the SASE database [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/sase.html&quot;&gt;more…&lt;/a&gt;]</help>
93
			</option>
94
			<option value="SMET" bold="true">
95
				<reference name="SMET_IN"/>
96
				<help>SMET data files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/smetio.html&quot;&gt;more…&lt;/a&gt;]</help>
97
			</option>
98
			<option value="SNOWPACK">
99
				<reference name="SNOWPACK_IN"/>
100
				<help>Original SNOWPACK meteo files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/snowpack.html&quot;&gt;more…&lt;/a&gt;]</help>
101
102
103
104
105
106
			</option>
			<help>See &lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/data_sources.html&quot;&gt;MeteoIO's help&lt;/a&gt; for more information</help>
		</parameter> <!-- end METEOIO_TS_IN -->
	</parametergroup>

	<!-- ALPUG -->
107
	<parametergroup name="ALPUG_IN">
108
109
110
		<parameter key="METEOPATH" type="path" mode="input" optional="false">
			<help>Path to the data files; this path MUST exist, it won't be created</help>
		</parameter>
111
		<reference name="STATIONGROUP_NAMES"/>
112
113
114
115
116
117
118
119
120
121
		<parameter key="METAFILE" type="file" mode="input" optional="false">
			<help>Absolute filename of the metadata file</help>
		</parameter>
		<parameter key="WRAP_MONTH" type="number" format="integer+" min="1" max="12" default="10" optional="false">
			<help>month when a new file is started</help>
		</parameter>
		<parameter key="ALPUG_FIELDS" type="text" default="%,%,ID,timestamp,VW,VW_MAX,DW,TA,RH, RSWR,HS,%,%,%,%,%,TSG,%,%,%,TSS,ISWR,P" size="large" optional="false">
			<help>Description of the fields (using % to mark the fields to skip)</help>
		</parameter>
	</parametergroup>
Michael Reisecker's avatar
Michael Reisecker committed
122

Mathias Bavay's avatar
Mathias Bavay committed
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
	<!-- ARGOS -->
	<parametergroup name="ARGOS_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>directory where to read the data files from</help>
		</parameter>
		<parameter key="ARGOS_EXT" type="text" size="small">
			<help>extension of Argos data files to use when no FILE# keyword has been provided</help>
		</parameter>
		<parameter key="METEOPATH_RECURSIVE" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>when no METEOFILE# keyword has been defined, should all files under METEOPATH be searched recursively?</help>
		</parameter>
		<reference name="FILESGROUP"/>
		<parameter key="METAFILE" type="file" mode="input" optional="false">
			<help>an ini file that contains all the metadata, for each station that has to be read</help>
		</parameter>
		<parameter key="ARGOS_DEBUG" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>should extra (ie very verbose) information be displayed?</help>
		</parameter>
	</parametergroup>
146

147
148
149
150
151
152
153
154
155
156
157
158
159
	<!-- COSMO -->
	<parametergroup name="COSMO_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Path to the data files; this path MUST exist, it won't be created</help>
		</parameter>
		<parameter key="METEO_PREFIX" type="text">
			<help>Specify the prefix that stands ahead of the numerical date in the filenames. This is used for
				filtering which files to read when reading a whole directory but also in any case to help extract the date
				of the first timestep from the filename.</help>
		</parameter>
		<parameter key="METEO_EXT" type="text" default=".xml" size="small">
			<help>Specify the extension of the input files (default ".xml", specify "none" to get an empty string</help>
		</parameter>
160
161
162
		<parameter key="METEOFILE" type="text">
			<help>Specify the XML file that contains the data (in &lt;code&gt;METEOPATH&lt;/code&gt;)</help>
		</parameter>
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
		<parameter key="IMIS_STATIONS" type="alternative" default="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>Strip the provided station names of their number to fit the IMIS naming scheme with the COSMO-CH naming scheme</help>
		</parameter>
		<parameter key="USE_MODEL_LOC" type="alternative" default="TRUE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>If set to false, the true station location (lat, lon, altitude) is used. Otherwise, it uses the model location (default)</help>
		</parameter>
		<parameter key="XML_ENCODING" type="alternative">
			<option value="UTF-8"/>
			<option value="UTF-16-LE"/>
			<option value="UTF-16-BE"/>
			<option value="UCS-4-LE"/>
			<option value="UCS-4-BE"/>
			<option value="UCS-4-2143"/>
			<option value="UCS-4-3412"/>
			<option value="UCS-2"/>
			<option value="EBCDIC"/>
			<option value="ISO-8859-1"/>
			<option value="ISO-8859-2"/>
			<option value="ISO-8859-3"/>
			<option value="ISO-8859-4"/>
			<option value="ISO-8859-5"/>
			<option value="ISO-8859-6"/>
			<option value="ISO-8859-7"/>
			<option value="ISO-8859-8"/>
			<option value="ISO-8859-9"/>
			<option value="ISO-2022-JP"/>
			<option value="SHIFT-JIS"/>
			<option value="EUC-JP"/>
			<option value="ASCII"/>
			<help>Force the input file encoding, overriding the file's own encoding declaration</help>
		</parameter>
		<reference name="STATIONGROUP_NAMES"/>
	</parametergroup>

201
202
203
204
205
	<!-- CSV -->
	<parametergroup name="CSV_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Path to the csv files; this path must exist, it won't be created</help>
		</parameter>
206
		<parameter key="METEOPATH_RECURSIVE" type="alternative">
207
208
209
210
211
212
213
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>If set to true, &lt;code&gt;METEOPATH&lt;/code&gt; will be search recursively for data files</help>
		</parameter>
		<parameter key="CSV_FILE_EXTENSION" type="text" default=".csv" size="small">
			<help>When scanning a directory for all csv files, which extension to consider (only used when no &lt;code&gt;STATION&lt;/code&gt; key is defined)</help>
		</parameter>
214
		<parameter key="CSV_SILENT_ERRORS" type="alternative">
215
216
217
218
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>If set to true, lines that can not be read are silently ignored (has priority over &lt;code&gt;CSV_ERRORS_TO_NODATA&lt;/code&gt;)</help>
		</parameter>
219
		<parameter key="CSV_ERRORS_TO_NODATA" type="alternative">
220
221
222
223
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>If set to true, fields that can not be parsed are assigned &lt;code&gt;nodata&lt;/code&gt;</help>
		</parameter>
224

225
226
227
		<parameter key="CSV_DELIMITER" type="text" default="," size="small">
			<help>Field delimiter character</help>
		</parameter>
228
		<parameter key="CSV_NODATA" type="text">
229
230
			<help>A value that should be interpreted as &lt;code&gt;nodata&lt;/code&gt;</help>
		</parameter>
231
		<parameter key="CSV_DEQUOTE" type="alternative">
232
233
234
235
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>if set to true, all single and double quotes will be purged from each line before parsing</help>
		</parameter>
236

237
		<frame caption="Header handling" color="#c4c4c4">
238
			<parameter key="CSV_NR_HEADERS" type="number" format="integer+" default="1" notoggle="true">
239
240
241
242
243
244
245
246
				<help>Number of header lines</help>
			</parameter>
			<parameter key="CSV_HEADER_DELIMITER" type="text" default="" size="small">
				<help>different field delimiter to use in header lines</help>
			</parameter>
			<parameter key="CSV_HEADER_REPEAT_MK" type="text" size="large">
				<help>A string that is used to signal another copy of the headers mixed with the data in the file (the matching is done anywhere in the line)</help>
			</parameter>
247
			<parameter key="CSV_UNITS_HEADERS" type="number" format="integer+" size="large" notoggle="true">
248
249
250
251
252
253
254
255
				<help>Header line providing the measurements units</help>
			</parameter>
			<parameter key="CSV_UNITS_OFFSET" type="text" size="large">
				<help>Offset to add to each value in order to convert it to SI, such as &lt;code&gt;0 0 273.15&lt;/code&gt;</help>
			</parameter>
			<parameter key="CSV_UNITS_MULTIPLIER" type="text" size="large">
				<help>Factor to multiply each value by, in order to convert it to SI, such as &lt;code&gt;1 1 0.01&lt;/code&gt;</help>
			</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
256
257
258
			<parameter key="CSV_UNITS" type="text" size="large">
				<help>Space delimited list of units to use for the columns (including the timestamp). No units is represented by "-". This can not be used together with units_offset / units multiplier</help>
			</parameter>
259
		</frame>
260

261
		<frame caption="Fields parsing" color="#c4c4c4">
262
			<parameter key="CSV_COLUMNS_HEADERS" type="number" format="integer+" notoggle="true">
263
264
265
266
267
268
269
270
				<help>header line number to interpret as columns headers</help>
			</parameter>
			<parameter key="CSV_FIELDS" type="text" size="large">
				<help>Provide a column header (if none is present or to overwrite it) such as &lt;code&gt;DATE TIME TA&lt;/code&gt;</help>
			</parameter>
			<parameter key="CSV_SKIP_FIELDS" type="text" size="large">
				<help>A space-delimited list of field to skip (first field is numbered 1). Keep in mind that when using parameters such as &lt;code&gt;UNITS_OFFSET&lt;/code&gt;, the skipped field MUST be taken into consideration (since even if a field is skipped, it is still present in the file!)</help>
			</parameter>
271
			<parameter key="CSV_SINGLE_PARAM_INDEX" type="number" format="integer+" notoggle="true">
272
273
274
				<help>if the parameter is identified by {PARAM}, this sets the column number in which the parameter is found</help>
			</parameter>
		</frame>
275

276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
		<frame caption="Date/Time handling" color="#c4c4c4">
			<parameter key="CSV_TIMESTAMP" type="alternative" optional="false">
				<option value="COMBINED">
					<parameter key="CSV_DATETIME_SPEC" type="text" optional="false">
						<help>Mixed date and time format specification, such as &lt;code&gt;YYYY-MM-DDTHH24:MI:SS&lt;/code&gt;</help>
					</parameter>
				</option>
				<option value="SPLIT">
					<parameter key="CSV_DATE_SPEC" type="text" optional="false">
						<help>Date format specification, such as &lt;code&gt;YYYY-MM-DD&lt;/code&gt;</help>
					</parameter>
					<parameter key="CSV_TIME_SPEC" type="text" optional="false">
						<help>Time format specification, such as &lt;code&gt;HH24:MI:SS&lt;/code&gt;</help>
					</parameter>
				</option>
				<help>How is time represented: a filed combines date and time or these are split into two fields?</help>
			</parameter>
		</frame>
294

295
296
297
298
299
300
301
		<frame caption="Metadata" color="#c4c4c4">
			<parameter key="CSV_NAME" type="text">
				<help>The station name to use (if provided, has priority over the special headers)</help>
			</parameter>
			<parameter key="CSV_ID" type="text">
				<help>The station name to use (if provided, has priority over the special headers)</help>
			</parameter>
302
303
304
			<parameter key="POSITION" type="text">
				<help>Coordinates are given as lat/lon/alt or easting/northing/alt such as &lt;code&gt;latlon (46.75; 9.80; 2200)&lt;/code&gt; or &lt;code&gt;xy (198754, 723458, 2200)&lt;/code&gt;</help>
			</parameter>
305
306
307
308
309
310
311
			<parameter key="CSV_SPECIAL_HEADERS" type="text">
				<help>Description of how to extract more metadata out of the headers, such as &lt;code&gt;name:1:3 id:2:5 lat:3:2 lon:3:4 alt:3:6&lt;/code&gt;</help>
			</parameter>
			<parameter key="CSV_FILENAME_SPEC" type="text">
				<help>Pattern to parse the filename and extract metadata out of it, such as &lt;code&gt;{ID}_{NAME}-{SKIP}_-_{PARAM}&lt;/code&gt;</help>
			</parameter>
		</frame>
312
313
314
315

		<parameter key="STATION#" type="grid" replicate="true"> <!-- a grid without raster positions aligns vertically -->
			<option>
				<parameter key="STATION#" type="text" optional="false">
Mathias Bavay's avatar
Mathias Bavay committed
316
					<help>File name containing the data for station number #</help>
317
318
319
320
321
322
323
324
325
326
				</parameter>
			</option>
			<option>
				<parameter key="POSITION#" type="text">
					<help>Coordinates are given as lat/lon/alt or easting/northing/alt such as &lt;code&gt;latlon (46.75; 9.80; 2200)&lt;/code&gt; or &lt;code&gt;xy (198754, 723458, 2200)&lt;/code&gt;</help>
				</parameter>
			</option>
			<option>
				<reference name="CSV_NUMBERED_STATION"/>
			</option>
Mathias Bavay's avatar
Mathias Bavay committed
327
			<help>Enter file name and position for station number #</help>
328
329
330
331
		</parameter>
	</parametergroup>

	<parametergroup name="CSV_NUMBERED_STATION">
332
		<parameter type="alternative">
333
334
335
336
			<option value="Show station specific settings">
				<parameter key="CSV#_DELIMITER" type="text" default="," size="small">
					<help>Field delimiter character</help>
				</parameter>
337
				<parameter key="CSV#_NODATA" type="text">
338
339
					<help>A value that should be interpreted as &lt;code&gt;nodata&lt;/code&gt;</help>
				</parameter>
340
				<parameter key="CSV#_DEQUOTE" type="alternative">
341
342
343
344
345
346
347
348
349
350
351
352
353
354
					<option value="TRUE"/>
					<option value="FALSE"/>
					<help>if set to true, all single and double quotes will be purged from each line before parsing</help>
				</parameter>
				<frame caption="Header handling" color="#c4c4c4">
					<parameter key="CSV#_NR_HEADERS" type="number" format="integer+" min="0" default="1" notoggle="true">
						<help>Number of header lines</help>
					</parameter>
					<parameter key="CSV#_HEADER_DELIMITER" type="text" default="" size="small">
						<help>different field delimiter to use in header lines</help>
					</parameter>
					<parameter key="CSV#_HEADER_REPEAT_MK" type="text" size="large">
						<help>A string that is used to signal another copy of the headers mixed with the data in the file (the matching is done anywhere in the line)</help>
					</parameter>
355
					<parameter key="CSV#_UNITS_HEADERS" type="number" format="integer+" size="large" notoggle="true">
356
357
358
359
360
361
362
363
						<help>Header line providing the measurements units</help>
					</parameter>
					<parameter key="CSV#_UNITS_OFFSET" type="text" size="large">
						<help>Offset to add to each value in order to convert it to SI, such as &lt;code&gt;0 0 273.15&lt;/code&gt;</help>
					</parameter>
					<parameter key="CSV#_UNITS_MULTIPLIER" type="text" size="large">
						<help>Factor to multiply each value by, in order to convert it to SI, such as &lt;code&gt;1 1 0.01&lt;/code&gt;</help>
					</parameter>
Mathias Bavay's avatar
Mathias Bavay committed
364
365
366
					<parameter key="CSV#_UNITS" type="text" size="large">
						<help>Space delimited list of units to use for the columns (including the timestamp). No units is represented by "-". This can not be used together with units_offset / units multiplier</help>
					</parameter>
367
368
				</frame>
				<frame caption="Fields parsing" color="#c4c4c4">
369
					<parameter key="CSV#_COLUMNS_HEADERS" type="number" format="integer+" notoggle="true">
370
371
372
373
374
375
376
377
						<help>header line number to interpret as columns headers</help>
					</parameter>
					<parameter key="CSV#_FIELDS" type="text" size="large">
						<help>Provide a column header (if none is present or to overwrite it) such as &lt;code&gt;DATE TIME TA&lt;/code&gt;</help>
					</parameter>
					<parameter key="CSV#_SKIP_FIELDS" type="text" size="large">
						<help>A space-delimited list of field to skip (first field is numbered 1). Keep in mind that when using parameters such as &lt;code&gt;UNITS_OFFSET&lt;/code&gt;, the skipped field MUST be taken into consideration (since even if a field is skipped, it is still present in the file!)</help>
					</parameter>
378
					<parameter key="CSV#_SINGLE_PARAM_INDEX" type="number" format="integer+" notoggle="true">
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
						<help>if the parameter is identified by {PARAM}, this sets the column number in which the parameter is found</help>
					</parameter>
				</frame>
				<frame caption="Date/Time handling" color="#c4c4c4">
					<parameter key="CSV#_TIMESTAMP" type="alternative">
						<option value="COMBINED">
							<parameter key="CSV#_DATETIME_SPEC" type="text">
								<help>Mixed date and time format specification, such as &lt;code&gt;YYYY-MM-DDTHH24:MI:SS&lt;/code&gt;</help>
							</parameter>
						</option>
						<option value="SPLIT">
							<parameter key="CSV#_DATE_SPEC" type="text">
								<help>Date format specification, such as &lt;code&gt;YYYY-MM-DD&lt;/code&gt;</help>
							</parameter>
							<parameter key="CSV#_TIME_SPEC" type="text">
								<help>Time format specification, such as &lt;code&gt;HH24:MI:SS&lt;/code&gt;</help>
							</parameter>
						</option>
						<help>How is time represented: a filed combines date and time or these are split into two fields?</help>
					</parameter>
				</frame>
				<frame caption="Metadata" color="#c4c4c4">
					<parameter key="CSV#_NAME" type="text">
						<help>The station name to use (if provided, has priority over the special headers)</help>
					</parameter>
					<parameter key="CSV#_ID" type="text">
						<help>The station name to use (if provided, has priority over the special headers)</help>
					</parameter>
					<parameter key="CSV#_SPECIAL_HEADERS" type="text">
						<help>Description of how to extract more metadata out of the headers, such as &lt;code&gt;name:1:3 id:2:5 lat:3:2 lon:3:4 alt:3:6&lt;/code&gt;</help>
					</parameter>
					<parameter key="CSV#_FILENAME_SPEC" type="text">
						<help>Pattern to parse the filename and extract metadata out of it, such as &lt;code&gt;{ID}_{NAME}-{SKIP}_-_{PARAM}&lt;/code&gt;</help>
					</parameter>
				</frame>
			</option>
			<option value="Hide station specific settings" default="true"/>
			<help>If you have given station numbers you can set most of the keys from above individually for each station. If not set, the global value will be used.</help>
		</parameter>
418
	</parametergroup>
419

420
421
422
423
424
425
426
427
428
	<!-- DBO -->
	<parametergroup name="DBO_IN">
		<parameter key="DBO_URL" type="text" optional="false">
			<help>RESTful service URL (e.g.http://developwis.wsl.ch:8730)</help>
		</parameter>
		<reference name="STATIONGROUP_NAMES"/>
		<parameter key="DBO_TIMEOUT" type="number" format="integer+" default="60" optional="false">
			<help>timeout (in seconds) for the connection to the server</help>
		</parameter>
429
		<parameter key="DBO_DEBUG" type="alternative">
430
431
432
433
434
435
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>print the full requests/answers from the server when something does not work as expected</help>
		</parameter>
	</parametergroup>

436
437
438
	<!-- GEOTOP -->
	<parametergroup name="GEOTOP_IN">
		<parameter key="METEOPATH" type="path" optional="false">
439
			<help>Path to the data files</help>
440
441
442
443
		</parameter>
		<parameter key="METEOPREFIX" type="text">
			<help>prefix to append when generating a file name for reading</help>
		</parameter>
444
		<parameter key="METAFILE" type="file" mode="input" optional="false">
445
446
447
			<help>Absolute filename of the geotop.inpts file</help>
		</parameter>
	</parametergroup>
448

449
450
451
452
453
454
455
456
	<!-- GOES -->
	<parametergroup name="GOES_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>directory where to read the data files from</help>
		</parameter>
		<parameter key="GOES_EXT" type="text" size="small">
			<help>extension of Goes data files to use when no FILE# keyword has been provided</help>
		</parameter>
457
		<parameter key="METEOPATH_RECURSIVE" type="alternative">
458
459
460
461
462
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>when no METEOFILE# keyword has been defined, should all files under METEOPATH be searched recursively?</help>
		</parameter>
		<reference name="FILESGROUP"/>
463
		<parameter key="METAFILE" type="file" mode="input" optional="false">
464
465
466
467
468
			<help>an ini file that contains all the metadata, for each station that has to be read</help>
		</parameter>
		<parameter key="GOES_NODATA" type="number" format="integer" default="-8190" optional="false">
			<help>value used to represent nodata</help>
		</parameter>
469
470
471
472
473
		<parameter key="GOES_ONLYFROMPAST" type="alternative" default="TRUE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>if set to true, data point beyond the current date and time will be rejected as invalid</help>
		</parameter>
474
		<parameter key="GOES_DEBUG" type="alternative">
475
476
477
478
479
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>should extra (ie very verbose) information be displayed?</help>
		</parameter>
	</parametergroup>
480
481

	<!-- GRIB -->
482
	<parametergroup name="GRIB_METEO_IN">
483
		<parameter key="METEOPATH" type="path" optional="false">
484
			<help>Path to the grib files</help>
485
486
487
488
489
		</parameter>
		<parameter key="METEOEXT" type="text">
			<help>GRIB file extension, or none for no file extension (default: .grb)</help>
		</parameter>
		<reference name="STATIONGROUP_POSITION"/>
490
		<parameter key="GRIB_DEBUG" type="alternative">
491
492
493
494
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>output more information about the grib files in order to help fix potential problems</help>
		</parameter>
495
496
497
	</parametergroup>

	<!-- IMIS -->
498
	<parametergroup name="IMIS_IN">
499
		<parameter key="DBNAME" type="text" optional="false">
500
			<help>Database name, either as //hostname:port/service_name (exemple: //sdbo.wd.op:1521/sdbo.slf.ch) or as a symbolic name as defined in the tnsnames.ora Network Configuration File provided by the Database administrator.</help>
501
502
503
504
505
506
507
		</parameter>
		<parameter key="DBUSER" type="text" optional="false">
			<help>Database user name</help>
		</parameter>
		<parameter key="DBPASS" type="text" optional="false">
			<help>Database password associated with the user name</help>
		</parameter>
508
		<reference name="STATIONGROUP_NAMES"/>
509
		<parameter key="USEANETZ" type="alternative">
510
511
512
513
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>OPTIONAL: use ANETZ stations to provide precipitations for normal IMIS stations.
				Each IMIS station is associated with one or two ANETZ stations and does a weighted
514
				average to get what should be its local precipitations (default: false)</help>
515
		</parameter>
516
		<parameter key="USE_IMIS_PSUM" type="alternative">
517
518
			<option value="TRUE"/>
			<option value="FALSE"/>
519
			<help>OPTIONAL: if set to false (default), all IMIS precipitation will be deleted (since IMIS stations don't have heated rain gauges, their precipitation measurements are not good in winter conditions). If set to true, it is strongly advised to use a UNHEATED_RAINGAUGE filter to detect snow melting in the rain gauge and perform winter conditions detection in the application (default: false).</help>
520
		</parameter>
521
		<parameter key="USE_SNOWPACK_PSUM" type="alternative">
522
523
524
525
526
527
528
529
530
531
532
533
534
535
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>if set to true, the SNOWPACK simulated Snow Water Equivalent from the database will be used to compute PSUM. Data gaps greater than 3 hours on SWE will lead to unchanged hnw while all data that can properly be computed will overwrite hnw. (default=false)</help>
		</parameter>
	</parametergroup>

	<!-- NETCDF -->
	<parametergroup name="NETCDF_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Path to the data files</help>
		</parameter>
		<parameter key="NC_EXT" type="text" default=".nc" size="small">
			<help>NetCDF file extension (for example: .nc)</help>
		</parameter>
536
		<reference name="FILESGROUP_OPTIONAL"/>
537
		<parameter key="METEOPATH_RECURSIVE" type="alternative">
538
539
			<option value="TRUE"/>
			<option value="FALSE"/>
540
			<help>when no METEOFILE# keyword has been defined, should all files under METEOPATH be searched recursively? (default: false)</help>
541
		</parameter>
542
543
544
545
		<parameter key="NETCDF_SCHEMA" type="alternative" default="CF-1.6">
			<option value="CF-1.6"/>
			<option value="CROCUS"/>
			<option value="AMUNDSEN"/>
546
547
			<option value="ERA-INTERIM"/>
			<option value="ERA5"/>
548
549
550
			<option value="WRF"/>
			<help>Data schema to use (i. e. mostly variables and dimensions naming)</help>
		</parameter>
551
		<parameter label="Remap variables:" type="selector">
552
			<parameter key="NETCDF_VAR::%" type="text" template="true">
553
554
555
				<help>parameter name as found in the current NetCDF file</help>
			</parameter>
			<reference name="METEOGRIDS"/>
556
			<help>remap the names as found in the NetCDF file to MeteoIO's &lt;a href=https://models.slf.ch/docserver/meteoio/html/classmio_1_1MeteoGrids.html#a2063b187182804ab133b154b65ae592c"&gt;MeteoGrids::parameters&lt;/a&gt;</help>
557
558
		</parameter>
		<parameter label="Remap dimensions:" type="selector">
559
			<parameter key="NETCDF_DIM::%" type="text" template="true">
560
561
562
				<help>dimension name as found in the current NetCDF file</help>
			</parameter>
			<reference name="METEOGRIDS"/>
563
			<help>remap the names as found in the NetCDF file to MeteoIO's &lt;a href=https://models.slf.ch/docserver/meteoio/html/classmio_1_1MeteoGrids.html#a2063b187182804ab133b154b65ae592c"&gt;MeteoGrids::parameters&lt;/a&gt;</help>
564
		</parameter>
565
		<parameter key="NC_DEBUG" type="alternative">
566
567
568
569
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>print some low level details about the file being read</help>
		</parameter>
570
571
572
	</parametergroup>

	<!-- OSHD -->
573
	<parametergroup name="OSHD_METEO_IN">
574
575
576
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Path to the data files</help>
		</parameter>
577
		<parameter key="METEOPATH_RECURSIVE" type="alternative">
578
579
			<option value="TRUE"/>
			<option value="FALSE"/>
580
			<help>If set to true, files are recursively searched within METEOPATH (default: false)</help>
581
		</parameter>
582
		<reference name="STATIONGROUP_NAMES"/>
583
		<parameter key="METAFILE" type="file" mode="input" optional="false">
584
585
			<help>Absolute filename of the metadata file</help>
		</parameter>
586
		<parameter key="OSHD_DEBUG" type="alternative">
587
588
589
590
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>write out extra information to better show what is in the files</help>
		</parameter>
591
592
593
594
595
596
597
	</parametergroup>

	<!-- PSQL -->
	<parametergroup name="PSQL_IN">
		<parameter key="PSQL_URL" type="text" optional="false">
			<help>Database URL</help>
		</parameter>
598
		<parameter key="PSQL_PORT" type="text" validate="[0-9]+" size="small">
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
			<help>Database port to use for connection</help>
		</parameter>
		<parameter key="PSQL_DB" type="text" optional="false">
			<help>Database name</help>
		</parameter>
		<parameter key="PSQL_USER" type="text" optional="false"/>
		<parameter key="PSQL_PASS" type="text" optional="false"/>
		<parameter key="SQL_META" type="text" optional="false">
			<help>Query to retrieve the metadata. For example, &lt;code&gt;SELECT id, station_name AS name, x_coord AS x, y_coord AS y, z AS altitude, epsg from all_stations WHERE id IN&lt;/code&gt;
			</help>
		</parameter>
		<parameter key="SQL_DATA" type="text" optional="false">
			<help>Query to retrieve the data. For example, &lt;code&gt;SELECT * FROM all_measurements WHERE id = ''STATIONID'' AND date&gt;=''DATE_START'' AND date&lt;=''DATE_END'' ORDER BY date&lt;/code&gt;
			</help>
		</parameter>
		<parameter key="STATIONS" type="text" optional="false">
			<help>Comma-separated list of station IDs to use</help>
		</parameter>
	</parametergroup>

	<!-- SASE -->
620
	<parametergroup name="SASE_IN">
621
622
623
624
625
626
627
628
629
630
631
632
633
634
		<parameter key="SASE_HOST" type="text" optional="false">
			<help>Database host name, as provided by your database administrator</help>
		</parameter>
		<parameter key="SASE_DB" type="text" optional="false">
			<help>Database name, as provided by your database administrator</help>
		</parameter>
		<parameter key="SASE_USER" type="text" optional="false">
			<help>Database user name</help>
		</parameter>
		<parameter key="SASE_PASS" type="string" optional="false">
			<help>Database password associated with the user name</help>
		</parameter>
		<reference name="STATIONGROUP_NAMES"/>
	</parametergroup>
635

636
637
638
639
640
	<!-- SMET -->
	<parametergroup name="SMET_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Directory of your SMET data files</help>
		</parameter>
641
		<parameter key="METEOPATH_RECURSIVE" type="alternative">
642
643
			<option value="TRUE"/>
			<option value="FALSE"/>
644
			<help>If set to true, files are recursively searched within METEOPATH (default: false)</help>
645
646
		</parameter>
		<reference name="STATIONGROUP_FILES_OPTIONAL"/>
647
		<parameter key="SNOWPACK_SLOPES" type="alternative">
648
649
			<option value="TRUE"/>
			<option value="FALSE"/>
650
			<help>if set to true and no slope information is found in the input files, the IMIS/Snowpack naming scheme will be used to derive the slope information (default: false)</help>
651
652
		</parameter>
	</parametergroup>
653
654
655
656

	<!-- SNOWPACK -->
	<parametergroup name="SNOWPACK_IN">
		<parameter key="METEOPATH" type="path" optional="false">
657
			<help>Path to the SNOWPACK files</help>
658
		</parameter>
659
		<reference name="STATIONGROUP_FILES"/>
660
		<parameter key="METAFILE" type="file" mode="input" optional="false">
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
			<help>filename of the meta data file (in METEOPATH)</help>
		</parameter>
		<parameter key="NUMBER_MEAS_TEMPERATURES" type="number" format="integer" min="0" default="0" optional="false">
			<help>Number of measured snow temperatures that are provided</help>
		</parameter>
		<parameter key="NUMBER_OF_SOLUTES" type="number" format="integer+" default="0" optional="false">
			<help>Number of solutes for which input data are provided</help>
		</parameter>
		<parameter key="RSWR_INP" type="alternative" optional="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
		</parameter>
		<parameter key="ISWR_INP" type="alternative" optional="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
		</parameter>
		<parameter key="VW_DRIFT" type="alternative" default="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>OPTIONAL: wind velocity to use for blowing and drifting snow is provided</help>
		</parameter>
		<parameter key="RHO_HN" type="alternative" default="FALSE">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>OPTIONAL: measured new snow density is provided</help>
		</parameter>
	</parametergroup>

</inishell_include>