Imports grid data from WRF Grads file formats

Overview

This import is available in DELFT-FEWS version 2013.01

todo: Add information about the WRF Grads data format 

Import Configuration

An example of the WRFGrads import will be given here.

<!-- edited with XMLSPY v2004 rel. 3 U (http://www.xmlspy.com) by tacoma (WL | Delft Hydraulics) -->
<timeSeriesImportRun 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/timeSeriesImportRun.xsd">
	<import>
		<general>
			<importType>WRFGrads</importType>
			<folder>../junit_test_output/nl/wldelft/fews/system/plugin/dataImport/TimeSeriesImportTestData/import/wrfgrads</folder>
			<idMapId>WRFGradsMapId</idMapId>
		</general>
		<timeSeriesSet>
			<moduleInstanceId>ImportWRFGrads</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>001</parameterId>
			<locationId>WRFGradsGrid</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<relativeViewPeriod unit="day" start="-10000" end="10000" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportWRFGrads</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>002</parameterId>
			<locationId>WRFGradsGrid</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<relativeViewPeriod unit="day" start="-10000" end="10000" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportWRFGrads</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>003</parameterId>
			<locationId>WRFGradsGrid</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<relativeViewPeriod unit="day" start="-10000" end="10000" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportWRFGrads</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>004</parameterId>
			<locationId>WRFGradsGrid</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<relativeViewPeriod unit="day" start="-10000" end="10000" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportWRFGrads</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>005</parameterId>
			<locationId>WRFGradsGrid</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<relativeViewPeriod unit="day" start="-10000" end="10000" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportWRFGrads</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>006</parameterId>
			<locationId>WRFGradsGrid</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<relativeViewPeriod unit="day" start="-10000" end="10000" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportWRFGrads</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>007</parameterId>
			<locationId>WRFGradsGrid</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<relativeViewPeriod unit="day" start="-10000" end="10000" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
		<timeSeriesSet>
			<moduleInstanceId>ImportWRFGrads</moduleInstanceId>
			<valueType>grid</valueType>
			<parameterId>008</parameterId>
			<locationId>WRFGradsGrid</locationId>
			<timeSeriesType>external historical</timeSeriesType>
			<timeStep unit="nonequidistant" />
			<relativeViewPeriod unit="day" start="-10000" end="10000" />
			<readWriteMode>add originals</readWriteMode>
		</timeSeriesSet>
	</import>
</timeSeriesImportRun>

Id Map Configuration

An example of the IdMapping used for the WRFGrads import is shown below.

<idMap 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/idMap.xsd" version="1.1">
	<parameter external="RAIN" internal="001"/>
	<parameter external="U10" internal="002"/>
	<parameter external="V10" internal="003"/>
	<parameter external="T2" internal="004"/>
	<parameter external="OLR" internal="005"/>
	<parameter external="PSFC" internal="006"/>
	<parameter external="SFROFF" internal="007"/>
	<parameter external="UDROFF" internal="008"/>
</idMap>

Grids Configuration

When importing a WRF Grads grid, it is necessary to defined the dimensions beforehand in the Grids.xml file. The location information present in the import file will be used to verify against the grid that in Grids.xml.

<grids 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/grids.xsd">
	<regular locationId="WRFGradsGrid">
		<rows>56</rows>
		<columns>55</columns>
		<geoDatum>WGS 1984</geoDatum>
		<firstCellCenter>
			<x>-77.738827275</x>
			<y>8.27843636</y>
			<z>0</z>
		</firstCellCenter>
		<xCellSize>0.13254545</xCellSize>
		<yCellSize>0.13258928</yCellSize>
	</regular>
</grids>

Parameter Configuration

An example with 8 parameters.

 <parameterGroups 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/parameters.xsd" version="1.0">&nbsp;
<parameterGroup id="NONGENERIC">
	<parameterType>instantaneous</parameterType>
		<unit>m</unit>
		<parameter id="001">
			<shortName>001</shortName>
		</parameter>
		<parameter id="002">
			<shortName>002</shortName>
		</parameter>
		<parameter id="003">
			<shortName>003</shortName>
		</parameter>
		<parameter id="004">
			<shortName>004</shortName>
		</parameter>
		<parameter id="005">
			<shortName>005</shortName>
		</parameter>
		<parameter id="006">
			<shortName>006</shortName>
		</parameter>
		<parameter id="007">
			<shortName>007</shortName>
		</parameter>
		<parameter id="008">
			<shortName>008</shortName>
		</parameter>
	</parameterGroup>
</parameterGroups>

Java source code

WRFGradsTimeSeriesParser.java