You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Overview

The EARS Satellite Rainfall Image is a special version of a standard binary BIL format; the file does not include any header information. The identifier for this reader is "EARS_Satellite_Rainfall_Estimate" and the extention of the files is normally *.prc. For each file to be imported no other header information file is required. The information on the grids that are imported need to be specified in the Delft-FEWS Grid.xml file.

The import module is developed to import daily rainfall files for the area of interest. More information on the EARS datellite rainfall format can be obtained from EARS (https://www.ears.nl/).

File format

For specification of the file format, check the BIL file format. The filename is used to retreive the date information of the files. There is always one file per daily timestep; a standard filename pattern used is 'NI_'yyyyMMdd'.prc' for importing files with a name NI_20180101.prc

The *.prc files uses a raw binary format without any headers.

The files represent a rectangular (in equal lat lon) area/grid of the area of interest. The example file has the following characteristics.

  • <npix>1002</npix> -> nr of columns
  • <nscan>702</nscan> -> nr of rows
  • <UL_lat>25</UL_lat> -> latitude of upper left pixel
  • <UL_Long>-13</UL_Long> -> longitude of upper left pixel
  • <Xangstep>0.03</Xangstep>
  • <Yangstep>-0.03</Yangstep> -> pixel resolution: 0.03 x 0.03 degrees
  • The 2 bytes integer pixel values represent precipitation in [mm * 10].

Configuration

An example import configuration to import a bil file is shown below:

 

<?xml version="1.0" encoding="UTF-8"?>
<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>EARS_Satellite_Rainfall_Estimate</importType>
<folder>$IMPORT_FOLDER$\SATH</folder>
<fileNameObservationDateTimePattern>'NI_'yyyyMMdd'.prc'</fileNameObservationDateTimePattern>
<idMapId>IdImportRFE</idMapId>
<unitConversionsId>ImportUnitConversions</unitConversionsId>
<importTimeZone>
<timeZoneOffset>+00:00</timeZoneOffset>
</importTimeZone>
<geoDatum>WGS 1984</geoDatum>
<dataFeedId>SATH_AFRICA</dataFeedId>
</general>
<timeSeriesSet>
<moduleInstanceId>ImportSATH</moduleInstanceId>
<valueType>grid</valueType>
<parameterId>P</parameterId>
<locationId>SATH_AFRICA</locationId>
<timeSeriesType>external historical</timeSeriesType>
<timeStep unit="day"/>
<readWriteMode>add originals</readWriteMode>
<expiryTime unit="day" multiplier="400"/>
</timeSeriesSet>
<externUnit unit="0.1mm" parameterId="P"/>
</import>
</timeSeriesImportRun>

 

<regular locationId="SATH_AFRICA">
<description>SATH Rainfall files</description>
<rows>702</rows>
<columns>1002</columns>
<geoDatum>WGS 1984</geoDatum>
<firstCellCenter>
<x>-13</x>
<y>25</y>
<z>0</z>
</firstCellCenter>
<xCellSize>.03</xCellSize>
<yCellSize>.03</yCellSize>
</regular>

 

<?xml version="1.0" encoding="UTF-8"?>
<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 internal="T.fx" external="1"/>
	<parameter internal="P.fx" external="0"/>
	<!---->
	<location internal="BIL" external="BIL"/>
</idMap>

The idmap used in this example:

External parameter should be 0, or in case multiple parameters 0, 1, 2 etc.
The bil file doesn't contain any location informations, so location id mapping can be omitted.
If you still use location id mapping, use for external and internal location id the same string.

The *.prc files uses a raw binary format without any headers.

The files represent a rectangular (in equal lat lon) area/grid of the Niger River basin

  <npix>1002</npix> -> nr of columns 

  <nscan>702</nscan> -> nr of rows 

  <UL_lat>25</UL_lat> -> latitude of upper left pixel 

  <UL_Long>-13</UL_Long> -> longitude of upper left pixel 

  <Xangstep>0.03</Xangstep>

  <Yangstep>-0.03</Yangstep> -> pixel resolution: 0.03 x 0.03 degrees

The 2 bytes integer pixel values represent precipitation in [mm * 10].

 

  • No labels

Disclaimer