meteoio_timeseries_input.xml

<!--
/*****************************************************************************/
/*  Copyright 2020 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/>.
*/
-->

<!--
INIshell include file for timeseries input plugin definitions
Please include meteoio_parametergroups before use!
-->

<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: -->
		<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>
		<parameter key="METEO" label="Select METEO data plugin:" type="alternative" optional="false" default="SMET" pre-generate="false">
			<option value="A3D">
				<parameter key="METEOPATH" type="path" optional="false">
					<help>Path to the meteorological files; this path must exist, it won't be created</help>
				</parameter>
				<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>
			</option>
			<option value="ALPUG">
				<reference name="ALPUG_IN"/>
				<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>
			</option>
			<option value="ARGOS">
				<reference name="ARGOS_IN"/>
				<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>
			</option>
			<option value="COSMOXML" italic="true">
				<reference name="COSMO_IN"/>
				<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>
			</option>
			<option value="CSV" bold="true">
				<reference name="CSV_IN"/>
				<help>Comma separated files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/csvio.html&quot;&gt;more…&lt;/a&gt;]</help>
			</option>
			<option value="DBO" italic="true">
				<reference name="DBO_IN"/>
				<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>
			</option>
			<option value="GEOTOP">
				<reference name="GEOTOP_IN"/>
				<help>GeoTop meteo files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/geotop.html&quot;&gt;more…&lt;/a&gt;]</help>
			</option>
			<option value="GOES">
				<reference name="GOES_IN"/>
				<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>
			</option>
			<option value="GRIB" italic="true">
				<reference name="GRIB_METEO_IN"/>
				<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>
			</option>
			<option value="IMIS" italic="true">
				<reference name="IMIS_IN" />
				<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>
			</option>
			<option value="METEOBLUE" bold="true" italic="true">
				<reference name="METEOBLUE_IN"/>
				<help>Meteo timeseries provided through the webservice API of MeteoBlue [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/doc/html/meteoblue.html&quot;&gt;more…&lt;/a&gt;]</help>
			</option>
			<option value="NETCDF" bold="true" italic="true">
				<reference name="NETCDF_IN"/>
				<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>
			</option>
			<option value="OSHD" italic="true">
				<reference name="OSHD_METEO_IN"/>
				<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>
			</option>
			<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>
			<option value="PSQL" italic="true">
				<reference name="PSQL_IN"/>
				<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>
			</option>
			<option value="SASE" italic="true">
				<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>
			</option>
			<option value="SMET" bold="true">
				<reference name="SMET_IN"/>
				<help>SMET data files [&lt;a href=&quot;https://models.slf.ch/docserver/meteoio/html/smetio.html&quot;&gt;more…&lt;/a&gt;]</help>
			</option>
			<option value="SNOWPACK">
				<reference name="SNOWPACK_IN"/>
				<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>
			</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 -->
	<parametergroup name="ALPUG_IN">
		<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>
		<reference name="STATIONGROUP_NAMES"/>
		<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" notoggle="true">
			<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>

	<!-- 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>

	<!-- 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>
		<parameter key="METEOFILE" type="text">
			<help>Specify the XML file that contains the data (in &lt;code&gt;METEOPATH&lt;/code&gt;)</help>
		</parameter>
		<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>

	<!-- 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>
		<parameter key="METEOPATH_RECURSIVE" type="alternative">
			<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>
		<parameter key="CSV_SILENT_ERRORS" type="alternative">
			<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>
		<parameter key="CSV_ERRORS_TO_NODATA" type="alternative">
			<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>

		<parameter key="CSV_DELIMITER" type="text" default="," size="small">
			<help>Field delimiter character (use &lt;code&gt;SPACE&lt;/code&gt; or &lt;code&gt;TAB&lt;/code&gt; for whitespaces)</help>
		</parameter>
		<parameter key="CSV_NODATA" type="text">
			<help>A space delimited list of strings that should be interpreted as &lt;code&gt;nodata&lt;/code&gt; (for example: NAN NULL -6999)</help>
		</parameter>

		<frame caption="Header handling" color="#c4c4c4">
			<parameter key="CSV_NR_HEADERS" type="number" format="integer+" 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>
			<parameter key="CSV_UNITS_HEADERS" type="number" format="integer+" size="large" notoggle="true">
				<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>
			<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>
		</frame>
		
		<frame caption="Data parsing restrictions" color="#c4c4c4">
			<parameter key="CSV_COMMENTS_MK" type="text" validate="^.$">
				<help>Single character to use as marker for comments in the input file (default: none)</help>
			</parameter>
			<parameter key="CSV_PURGE_CHARS" type="text" size="large" validate="^(?:\S|(\d{1,3})|(0[xX][0-9a-fA-F]{2}))(?:\s(\S|(\d{1,3})|(0[xX][0-9a-fA-F]{2})))*\s*$">
				<help>Exclude a space delimited list of characters, either directly provided or as decimal representation or as hexadecimal representation prefixed by &lt;i&gt;0x&lt;/i&gt;. Example: &lt;i&gt;0x40 " 13&lt;/i&gt;</help>
			</parameter>
			<parameter key="CSV_EXCLUDE_LINES" type="text" size="large" validate="^(?:\d+(?:\s\-\s\d+)?(?:\s?,\s)?)+$">
				<help>Exclude a comma delimited list of line ranges (line numbers separated by ' - ') such as &lt;i&gt;456 - 468&lt;/i&gt; or individual lines. Please note that it is not possible to mix CSV_EXCLUDE_LINES and CSV_ONLY_LINES, only one type of specification may be provided.</help>
			</parameter>
			<parameter key="CSV_ONLY_LINES" type="text" size="large" validate="^(?:\d+(?:\s\-\s\d+)?(?:\s?,\s)?)+$">
				<help>Restrict the parsing to a comma delimited list of line ranges (line numbers separated by ' - ') such as &lt;i&gt;456 - 468&lt;/i&gt; or individual lines. Please note that it is not possible to mix CSV_EXCLUDE_LINES and CSV_ONLY_LINES, only one type of specification may be provided.</help>
			</parameter>
		</frame>

		<frame caption="Fields parsing" color="#c4c4c4">
			<parameter key="CSV_COLUMNS_HEADERS" type="number" format="integer+" notoggle="true">
				<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 ID TA&lt;/code&gt;. See below for special field names related to Date/Time handling or in the &lt;a href="https://models.slf.ch/docserver/dev/meteoio/doc/html/csvio.html#csvio_metadata_field_types"&gt;documentation&lt;/a&gt; for more special field names.</help>
			</parameter>
			<parameter key="CSV_FILTER_ID" type="text" size="large">
				<help>if the data contains an "ID" column, which ID should be kept (all others will be rejected); default: station ID</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>
		</frame>

		<frame caption="Date/Time handling" color="#c4c4c4">
			<parameter type="helptext" wrap="true">
				<help>Date/Time information is either provided as strings that will be parsed (as one combined timestamp (DATETIME or TIMESTAMP) or as a date and a time field (DATE and TIME), see below) or as separate components: then the fields must be named (either from the headers or through the CSV_FIELDS key) as YEAR, JDAY (number of days since the begining of the year), MONTH, DAY, NTIME (numerical representation of time, for example 952 for 09:52), HOURS, MINUTES, SECONDS (if minutes or seconds are missing, they will be assumed to be zero).</help>
			</parameter>
			<parameter key="CSV_TIMESTAMP" type="alternative">
				<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>
				<option value="DECIMAL">
					<parameter key="CSV_DECIMALDATE_TYPE" type="alternative" optional="false">
						<option value="EXCEL"/>
						<option value="MATLAB"/>
						<option value="RFC868"/>
						<option value="UNIX"/>
						<option value="JULIAN"/>
						<option value="MJULIAN"/>
						<option value="TJULIAN"/>
					</parameter>
				</option>
				<help>How is time represented: a filed combines date and time or these are split into two fields?</help>
			</parameter>
			<parameter key="CSV_FALLBACK_YEAR" type="number" format="integer+" notoggle="true">
				<help>When using components date (ie separate columns for year, month, day), it could be that there is no year column. This parameter provides the (fixed) year to use</help>
			</parameter>
			<parameter key="CSV_FALLBACK_AUTO_WRAP" type="alternative">
				<option value="TRUE"/>
				<option value="FALSE"/>
				<help>If using CSV_FALLBACK_YEAR, by default all data at dates greater than 1st October that appear before data at dates less than 1st October are assumed to belong to the year before. If this is not desired, set this to false.</help>
			</parameter>
		</frame>

		<frame caption="Metadata" color="#c4c4c4">
			<parameter key="CSV_NAME" type="text">
				<help>A descriptive station name to use (if provided, has priority over the special headers). Example: "Davos::SLF-station"</help>
			</parameter>
			<parameter key="CSV_ID" type="text">
				<help>The (short) station ID to use (if provided, has priority over the special headers). The station ID is often used to built the output file name as well as to apply specific processing at specific stations, if necessary. Example: "SLF2"</help>
			</parameter>
			<parameter key="CSV_SLOPE" type="number" format="integer+" min="0" max="90">
				<help>The slope angle at the station, in degrees (if providing a slope, also provide an azimuth)</help>
			</parameter>
			<parameter key="CSV_AZIMUTH" type="number" format="integer+" min="0" max="360">
				<help>The slope azimuth at the station, in degrees from North </help>
			</parameter>
			<parameter key="POSITION" type="text" validate="coordinates">
				<help>Coordinates are given as lat/lon/alt or easting/northing/alt such as &lt;b&gt;"latlon (46.75, 9.80, 2200)"&lt;/b&gt; or &lt;b&gt;"latlon (46d 43' 51", 9.80, 2200)"&lt;/b&gt; or &lt;b&gt;"xy (198754, 723458, 2200)"&lt;/b&gt;</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>

		<parameter key="STATION#" type="grid" replicate="true"> <!-- a grid without raster positions aligns vertically -->
			<option>
				<parameter key="STATION#" type="filename" mode="input" optional="false">
					<help>File name containing the data for station number #</help>
				</parameter>
			</option>
			<option>
				<parameter key="POSITION#" type="text" validate="coordinates">
					<help>Coordinates are given as lat/lon/alt or easting/northing/alt such as &lt;b&gt;"latlon (46.75, 9.80, 2200)"&lt;/b&gt; or &lt;b&gt;"latlon (46d 43' 51", 9.80, 2200)"&lt;/b&gt; or &lt;b&gt;"xy (198754, 723458, 2200)"&lt;/b&gt;</help>
				</parameter>
			</option>
			<option>
				<reference name="CSV_NUMBERED_STATION"/>
			</option>
			<help>Enter file name and position for station number #</help>
		</parameter>
	</parametergroup>

	<parametergroup name="CSV_NUMBERED_STATION">
		<parameter type="alternative">
			<option value="Show station specific settings">
				<parameter key="CSV#_DELIMITER" type="text" default="," size="small">
					<help>Field delimiter character</help>
				</parameter>
				<parameter key="CSV#_NODATA" type="text">
					<help>A space delimited list of strings that should be interpreted as &lt;code&gt;nodata&lt;/code&gt; (for example: NAN NULL -6999)</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>
					<parameter key="CSV#_UNITS_HEADERS" type="number" format="integer+" size="large" notoggle="true">
						<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>
					<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>
				</frame>
				<frame caption="Data parsing restrictions" color="#c4c4c4">
					<parameter key="CSV#_COMMENTS_MK" type="text" validate="^.$">
						<help>Single character to use as marker for comments in the input file (default: none)</help>
					</parameter>
					<parameter key="CSV#_PURGE_CHARS" type="text" size="large" validate="^(?:\S|(\d{1,3})|(0[xX][0-9a-fA-F]{2}))(?:\s(\S|(\d{1,3})|(0[xX][0-9a-fA-F]{2})))*\s*$">
						<help>Exclude a space delimited list of characters, either directly provided or as decimal representation or as hexadecimal representation prefixed by &lt;i&gt;0x&lt;/i&gt;. Example: &lt;i&gt;0x40 " 13&lt;/i&gt;</help>
					</parameter>
					<parameter key="CSV#_EXCLUDE_LINES" type="text" size="large" validate="^(?:\d+(?:\s\-\s\d+)?(?:\s?,\s)?)+$">
						<help>Exclude a comma delimited list of line ranges (line numbers separated by ' - ') such as &lt;i&gt;456 - 468&lt;/i&gt; or individual lines. Please note that it is not possible to mix CSV_EXCLUDE_LINES and CSV_ONLY_LINES, only one type of specification may be provided.</help>
					</parameter>
					<parameter key="CSV#_ONLY_LINES" type="text" size="large" validate="^(?:\d+(?:\s\-\s\d+)?(?:\s?,\s)?)+$">
						<help>Restrict the parsing to a comma delimited list of line ranges (line numbers separated by ' - ') such as &lt;i&gt;456 - 468&lt;/i&gt; or individual lines. Please note that it is not possible to mix CSV_EXCLUDE_LINES and CSV_ONLY_LINES, only one type of specification may be provided.</help>
					</parameter>
				</frame>
				<frame caption="Fields parsing" color="#c4c4c4">
					<parameter key="CSV#_COLUMNS_HEADERS" type="number" format="integer+" notoggle="true">
						<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 ID TA&lt;/code&gt;. See in the &lt;a href="https://models.slf.ch/docserver/dev/meteoio/doc/html/csvio.html#csvio_metadata_field_types"&gt;documentation&lt;/a&gt; for details.</help>
					</parameter>
					<parameter key="CSV#_FILTER_ID" type="text" size="large">
						<help>if the data contains an "ID" column, which ID should be kept (all others will be rejected); default: station ID</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>
				</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>
					<parameter key="CSV#_FALLBACK_YEAR" type="number" format="integer+" notoggle="true">
						<help>When using components date (ie separate columns for year, month, day), it could be that there is no year column. This parameter provides the (fixed) year to use</help>
					</parameter>
					<parameter key="CSV#_FALLBACK_AUTO_WRAP" type="alternative">
						<option value="TRUE"/>
						<option value="FALSE"/>
						<help>If using CSV_FALLBACK_YEAR, by default all data at dates greater than 1st October that appear before data at dates less than 1st October are assumed to belong to the year before. If this is not desired, set this to false.</help>
					</parameter>
				</frame>
				<frame caption="Metadata" color="#c4c4c4">
					<parameter key="CSV#_NAME" type="text">
						<help>A descriptive station name to use (if provided, has priority over the special headers). Example: "Davos::SLF-station"</help>
					</parameter>
					<parameter key="CSV#_ID" type="text">
						<help>The (short) station ID to use (if provided, has priority over the special headers). The station ID is often used to built the output file name as well as to apply specific processing at specific stations, if necessary. Example: "SLF2"</help>
					</parameter>
					<parameter key="CSV#_SLOPE" type="number" format="integer+" min="0" max="90">
						<help>The slope angle at the station, in degrees (if providing a slope, also provide an azimuth)</help>
					</parameter>
					<parameter key="CSV#_AZIMUTH" type="number" format="integer+" min="0" max="360">
						<help>The slope azimuth at the station, in degrees from North </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>
	</parametergroup>

	<!-- 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>
		<parameter key="DBO_DEBUG" type="alternative">
			<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>

	<!-- GEOTOP -->
	<parametergroup name="GEOTOP_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Path to the data files</help>
		</parameter>
		<parameter key="METEOPREFIX" type="text">
			<help>prefix to append when generating a file name for reading</help>
		</parameter>
		<parameter key="METAFILE" type="file" mode="input" optional="false">
			<help>Absolute filename of the geotop.inpts file</help>
		</parameter>
	</parametergroup>

	<!-- 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>
		<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="GOES_NODATA" type="number" format="integer" default="-8190" optional="false" notoggle="true">
			<help>value used to represent nodata</help>
		</parameter>
		<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>
		<parameter key="GOES_DEBUG" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>should extra (ie very verbose) information be displayed?</help>
		</parameter>
	</parametergroup>

	<!-- GRIB -->
	<parametergroup name="GRIB_METEO_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Path to the grib files</help>
		</parameter>
		<parameter key="METEOEXT" type="text">
			<help>GRIB file extension, or none for no file extension (default: .grb)</help>
		</parameter>
		<reference name="STATIONGROUP_POSITION"/>
		<parameter key="GRIB_DEBUG" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>output more information about the grib files in order to help fix potential problems</help>
		</parameter>
	</parametergroup>

	<!-- IMIS -->
	<parametergroup name="IMIS_IN">
		<parameter key="DBNAME" type="text" optional="false">
			<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>
		</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>
		<reference name="STATIONGROUP_NAMES"/>
		<parameter key="USEANETZ" type="alternative">
			<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
				average to get what should be its local precipitations (default: false)</help>
		</parameter>
		<parameter key="USE_IMIS_PSUM" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<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>
		</parameter>
		<parameter key="USE_SNOWPACK_PSUM" type="alternative">
			<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>
	
	<!-- METEOBLUE -->
	<parametergroup name="METEOBLUE_IN">
		<parameter key="METEOBLUE_URL" type="text" optional="true">
			<help>RESTful service URL (default: http://my.meteoblue.com/)</help>
		</parameter>
		<parameter key="METEOBLUE_APIKEY" type="text" optional="false">
			<help>the key purchased from Meteoblue that gives access to its API (mandatory)</help>
		</parameter>
		<parameter key="METEOBLUE_PACKAGES" type="text" size="large" optional="false">
			<help>a space delimited list of &lt;a href="https://docs.meteoblue.com/en/weather-apis/packages-api/forecast-data"&gt;packages&lt;/a&gt; to read data from. Please note that you must have purchased an API key that gives access to all the packages that you list here!</help>
		</parameter>
		<parameter key="METEOBLUE_TIMEOUT" type="number" format="integer+" optional="true">
			<help>timeout (in seconds) for the connection to the server (default: 60s)</help>
		</parameter>
		<parameter key="METEOBLUE_DEBUG" type="alternative" optional="true">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>print more information in order to better understand when something does not work as expected</help>
		</parameter>
		<parameter key="STATION#" type="text" replicate="true" optional="false" validate="coordinates">
			<help>Coordinates are given as lat/lon/alt or easting/northing/alt such as &lt;b&gt;"latlon (46.75, 9.80, 2200)"&lt;/b&gt; or &lt;b&gt;"latlon (46d 43' 51", 9.80, 2200)"&lt;/b&gt; or &lt;b&gt;"xy (198754, 723458, 2200)"&lt;/b&gt;</help>
			<!-- <parameter key="STATION#_ID" type="text" replicate="true" optional="true">
				<help>Station ID to use for the matching STATION</help>
			</parameter>
			<parameter key="STATION#_NAME" type="text" replicate="true" optional="true">
				<help>Station name to use for the matching STATION</help>
			</parameter>-->
		</parameter>
		<parameter key="STATION#_ID" type="text" replicate="true" optional="true">
			<help>Station ID to use for the matching STATION</help>
		</parameter>
		<parameter key="STATION#_NAME" type="text" replicate="true" optional="true">
			<help>Station name to use for the matching STATION</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>
		<reference name="FILESGROUP_OPTIONAL"/>
		<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? (default: false)</help>
		</parameter>
		<parameter key="NETCDF_SCHEMA" type="alternative" default="CF-1.6">
			<option value="CF-1.6"/>
			<option value="CROCUS"/>
			<option value="AMUNDSEN"/>
			<option value="ERA-INTERIM"/>
			<option value="ERA5"/>
			<option value="WRF"/>
			<help>Data schema to use (i. e. mostly variables and dimensions naming)</help>
		</parameter>
		<parameter label="Remap variables:" type="selector">
			<parameter key="NETCDF_VAR::%" type="text" template="true">
				<help>parameter name as found in the current NetCDF file</help>
			</parameter>
			<reference name="METEOGRIDS"/>
			<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>
		</parameter>
		<parameter label="Remap dimensions:" type="selector">
			<parameter key="NETCDF_DIM::%" type="text" template="true">
				<help>dimension name as found in the current NetCDF file</help>
			</parameter>
			<reference name="METEOGRIDS"/>
			<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>
		</parameter>
		<parameter key="NC_KEEP_FILES_OPEN" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>keep files open for efficient access? Beware, there is a max number of simultaneously opened files (default: true)</help>
		</parameter>
		<parameter key="NC_DEBUG" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>print some low level details about the file being read</help>
		</parameter>
	</parametergroup>

	<!-- OSHD -->
	<parametergroup name="OSHD_METEO_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Path to the data files</help>
		</parameter>
		<parameter key="METEOPATH_RECURSIVE" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>If set to true, files are recursively searched within &lt;a href=&quot;app://input::meteopath&quot;&gt;METEOPATH&lt;/a&gt; (default: false)</help>
		</parameter>
		<reference name="STATIONGROUP_NAMES"/>
		<parameter key="METAFILE" type="file" mode="input" optional="false">
			<help>Absolute filename of the metadata file</help>
		</parameter>
		<parameter key="OSHD_DEBUG" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>write out extra information to better show what is in the files</help>
		</parameter>
	</parametergroup>

	<!-- PSQL -->
	<parametergroup name="PSQL_IN">
		<parameter key="PSQL_URL" type="text" optional="false">
			<help>Database URL</help>
		</parameter>
		<parameter key="PSQL_PORT" type="text" validate="[0-9]+" size="small">
			<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 -->
	<parametergroup name="SASE_IN">
		<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>

	<!-- SMET -->
	<parametergroup name="SMET_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Directory of your SMET data files</help>
		</parameter>
		<parameter key="METEOPATH_RECURSIVE" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<help>If set to true, files are recursively searched within &lt;a href=&quot;app://input::meteopath&quot;&gt;METEOPATH&lt;/a&gt; (default: false)</help>
		</parameter>
		<reference name="STATIONGROUP_FILES_OPTIONAL"/>
		<parameter key="SNOWPACK_SLOPES" type="alternative">
			<option value="TRUE"/>
			<option value="FALSE"/>
			<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>
		</parameter>
	</parametergroup>

	<!-- SNOWPACK -->
	<parametergroup name="SNOWPACK_IN">
		<parameter key="METEOPATH" type="path" optional="false">
			<help>Path to the SNOWPACK files</help>
		</parameter>
		<reference name="STATIONGROUP_FILES"/>
		<parameter key="METAFILE" type="filename" mode="input" optional="false">
			<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" notoggle="true">
			<help>Number of measured snow temperatures that are provided</help>
		</parameter>
		<parameter key="NUMBER_OF_SOLUTES" type="number" format="integer+" default="0" optional="false" notoggle="true">
			<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>