Page History

...

The MapStack format is a FEWS specific way to export a grid timeseries in one or more files using either ESRI ASCII grid, PC-Raster or USGS BIL format files. As the ASCII grid file format can only contain a single grid dataset, for this format multiple files are stored, one per timestep and / or parameter. The MapStack format was implemented primarily for the purpose of transferring gridded dat dats to and from external models using the General Adapter, but it is also supported by both the Import and Export module. A map stack is always represented by a main XML file which contains the relevant meta data of the exported set of grid files.

...

3) The exportMissingValue can be used to replace the missing values by given number to indicate that there is no valid data, this option is required to use the resulting files with ArcGIS as the default setting using 'NaN' to represent missing values is not supported by ArcGIS.

An example of the structure of the MapStack XML file is given below, this example uses the ESRI ASCII grid format to store the actual data where the filename contains a date/time stamp:

Example:

<?xml version="1.0" encoding="UTF-8"?>
<MapStacks xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.wldelft.nl/fews/PI" xsi:schemaLocation="http://www.wldelft.nl/fews/PI http://fews.wldelft.nl/schemas/version1.0/pi-schemas/pi_mapstacks.xsd" version="1.2">
    <geoDatum>WGS 1984</geoDatum>
    <timeZone>0.0</timeZone>
    <mapStack>
        <locationId>EA_H-2001</locationId>
        <parameterId>waterlevel</parameterId>
        <timeStep unit="hour" multiplier="1"/>
        <startDate date="2003-02-28" time="22:00:00"/>
        <endDate date="2003-03-01" time="00:00:00"/>
        <file>
            <ascii file="_EA_H-2001_'yyyyMMdd_HHmm'.asc"/>
        </file>
    </mapStack>
</MapStacks>