Introduction

GIN stands for 'Gemeinsame Informationsplattform Naturgefahren' and will be the central information hub for natural hazards events in Switzerland. The GIN export functionality is available from 2010_01 onwards.

GIN Export Configuration

The configuration of GIN export module follows the normal pattern, except that two qualifiers are necessary to get the proper values for the attributes 'datasourceProvider' and 'abbreviation'.

First put the qualifiers in Config/RegionConfigFiles/Qualifiers.xml

<?xml version="1.0" encoding="UTF-8"?>
<qualifiers xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/qualifiers.xsd">
	<allowReferencingUndefinedQualifiers>false</allowReferencingUndefinedQualifiers>
...
	<qualifier id="BAFU" name="BAFU"/>
	<qualifier id="Abbreviation1" name="Abbreviation1"/>
	<qualifier id="Abbreviation2" name="Abbreviation2"/>
...
</qualifiers>

For instance if your export configuration is in the file Config\ModuleConfigFiles\export\ExportGIN.xml,

<?xml version="1.0" encoding="UTF-8"?>
<timeSeriesExportRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesExportRun.xsd">
	<export>
		<general>
			<exportType>GIN_Export</exportType>
			<folder>$EXPORT_FOLDER_ROOT$/GIN</folder>
			<exportFileName>
				<name>GINOutputSample1.xml</name>
				<prefix>
					<timeZeroFormattingString>yyyyMMdd.HHmm</timeZeroFormattingString>
				</prefix>
			</exportFileName>
...
		</general>
		<timeSeriesSet>
...
			<parameterId>par1</parameterId>
			<qualifierId>BAFU</qualifierId>
			<qualifierId>Abbreviation1</qualifierId>			
			<locationId>loc1</locationId>
...
		</timeSeriesSet>
	</export>
	<export>
		<general>
...
		</general>
		<timeSeriesSet>
...
			<parameterId>par2</parameterId>
			<qualifierId>BAFU</qualifierId>
			<qualifierId>Abbreviation2</qualifierId>			
			<locationId>loc2</locationId>
...
		</timeSeriesSet>
	</export>
</timeSeriesExportRun>

The following code shows a sample output file:

<?xml version="1.0" encoding="UTF-8"?>
<Collection datasourceName="loc1" datasourceProvider="BAFU1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <prediction abbreviation="Abbreviation1" datasourceName="loc1" datasourceProvider="BAFU">
        <run>
            <inittime>2003-11-05T00:00:00.000+0100</inittime><!--  init time hydrological model-->
            <inittime2>2003-11-05T00:00:00.000+0100</inittime2><!--  init time meteorological model-->
        </run>
        <member>3</member>
        <preddata>
            <predtime>2003-10-05T13:45:00.000+0100</predtime>
            <par1>0.5161157</par1>
        </preddata>
        <preddata>
            <predtime>2003-10-05T14:00:00.000+0100</predtime>
            <par1>0.749531</par1>
        </preddata>
        <preddata>
            <predtime>2003-10-05T14:15:00.000+0100</predtime>
            <par1>0.35472012</par1>
        </preddata>
        <preddata>
            <predtime>2003-10-05T14:30:00.000+0100</predtime>
            <par1>0.91763437</par1>
        </preddata>
        <preddata>
            <predtime>2003-10-05T14:45:00.000+0100</predtime>
            <par1>0.29822087</par1>
        </preddata>
        <preddata>
            <predtime>2003-10-05T15:00:00.000+0100</predtime>
            <par1>0.038461924</par1>
        </preddata>
        <preddata>
            <predtime>2003-10-05T15:15:00.000+0100</predtime>
            <par1>0.94585866</par1>
        </preddata>
    </prediction>
</Collection>

Example configuration

<?xml version="1.0" encoding="UTF-8"?>
<timeSeriesExportRun xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/timeSeriesExportRun.xsd">
	<export>
		<general>
			<exportType>GIN_Export</exportType>
			<folder>$EXPORT_FOLDER_ROOT$/GIN</folder>
			<exportFileName>
				<name>.BAFU.B2181-runoff.xml</name>
				<prefix>
					<timeZeroFormattingString>yyyyMMdd.HHmm</timeZeroFormattingString>
				</prefix>
			</exportFileName>
			<idMapId>IdExportGIN</idMapId>
			<exportMissingValue>-999</exportMissingValue>
			<omitMissingValues>true</omitMissingValues>
			<exportTimeZone>
				<timeZoneOffset>+01:00</timeZoneOffset>
			</exportTimeZone>			
		</general>
		<timeSeriesSet>
			<moduleInstanceId>ARMA_OberThur_COSMO7</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>Q.fah</parameterId>
			<qualifierId>BAFU</qualifierId>
			<qualifierId>abbreviation1</qualifierId>			
			<locationId>H-2181</locationId>
			<timeSeriesType>simulated forecasting</timeSeriesType>
			<timeStep unit="hour" multiplier="1"/>
			<relativeViewPeriod unit="hour" start="0" startOverrulable="false" end="72" endOverrulable="true"/>
			<readWriteMode>read only</readWriteMode>
		</timeSeriesSet>
	</export>
	<export>
		<general>
			<exportType>GIN_Export</exportType>
			<folder>$EXPORT_FOLDER_ROOT$/GIN</folder>
			<exportFileName>
				<name>.BAFU.B2181.ENS-runoff.xml</name>
				<prefix>
					<timeZeroFormattingString>yyyyMMdd.HHmm</timeZeroFormattingString>
				</prefix>
			</exportFileName>
			<idMapId>IdExportGIN</idMapId>
			<exportMissingValue>-999</exportMissingValue>
			<omitMissingValues>true</omitMissingValues>
			<exportTimeZone>
				<timeZoneOffset>+01:00</timeZoneOffset>
			</exportTimeZone>
		</general>
		<timeSeriesSet>
			<moduleInstanceId>EnsembleGIN</moduleInstanceId>
			<valueType>scalar</valueType>
			<parameterId>Q.fah</parameterId>
			<qualifierId>BAFU</qualifierId>
			<qualifierId>abbreviation2</qualifierId>			
			<locationId>H-2181</locationId>
			<timeSeriesType>external forecasting</timeSeriesType>
			<timeStep unit="hour" multiplier="1"/>
			<relativeViewPeriod unit="hour" start="0" startOverrulable="false" end="72" endOverrulable="true"/>
			<readWriteMode>read only</readWriteMode>
			<ensembleId>GIN</ensembleId>
		</timeSeriesSet>
	</export>
</timeSeriesExportRun>
  • No labels