Skip to content

Landscape export

Jump to bottom
alexander-petkov edited this page Sep 11, 2024 · 17 revisions

Overview

The Landscape Export allows users to create an 8-band raster image, suitable for use with Fire Behaviour simulators such as Flammap/Farsite.

This service is implemented as a Web Processing Service (WPS) module as part of Geoserver

Data availability

The module uses Landfire data at 30 meters resolution that covers CONUS, Alaska, and Hawaii, for [versions] up to 1.4.0.

Data can be requested for a pair of geographical longitude/latitude coordinates, for an area of size between 5 and 60 US miles.

Users can request the original 30m resolution, or create a coarser Landscape file up to 1/10th of the original data.

Raster bands

The raster bands, as required by Flammap/Farsite are as follows:

Band Data Landfire name
1 Elevation DEM
2 Slope SLP
3 Aspect ASP
4 Fuel model FBFM40
5 Forest Canopy Cover CC
6 Forest Canopy Height CH
7 Forest Canopy Base Height CBH
8 Forest Canopy Bulk Density CBD

Usage

Web interface

This service can be accessed from wfas.firenet.gov/geoserver/web

  1. Go to the WPS Request Bulder page.
  2. Choose gs:LandscapeExport from the drop-down list:
  3. Enter your desired parameters. Fields denoted with * are mandatory.

  • POINT or POLYGON geometry--the algorithm checks for POINT geometry first, then for a POLYGON. If neither is provided, the process terminates. If both are supplied, the point is input geometry.

    Example WKT inputs:

    POINT( -110 40)
POLYGON ((-109.9 40.1, -109.9 39.9, -110.1 39.9, -110.1 40.1, -109.9 40.1))

    Example JSON inputs:

    {"type":"Point","coordinates":[-110,40]}
{"type":"Polygon","coordinates":[[[-109.9,40.1],[-109.9,39.9],[-110.1,39.9],[-110.1,40.1],[-109.9,40.1]]]}

  • Coordinate reference system for the input geometry--default is EPSG:4326.

  • Landfire version--currently LF105 (for version 1.0.5) through LF140 (for version 1.4.0). Default value is LF140.

  • Resolution: pixel resolution in meters, where minimum value is 30, and maximum value is 300. Default value is 30.

  • Dеsired extent (in miles)--minimum 5, maximum 60 miles. Default value is 5 miles.

To generate a 8-band Landscape raster, click "Execute process". "Generate XML from process inputs/outputs" creates an XML document, useful for command line requests.

HTTP Get

It is possible to extract weather data by using a HTTP Get request, either via a browser, or a command line utility such as curl or wget (useful for scripted requests). The input parameters are provided as key/value pairs as part of the URL, and separated by a semicolon (;). The symbols '+' or '%20' are used to encode spaces in parameter names and values. String values should be URL encoded, this applies most of all to the supplied geometry.

Below is an example of such a request using curl, where the extracted data is saved to landscape.tif. Either point or polygon parameter needs to be supplied, along with sourceCRS. Other parameters are optional:

curl "https://wfas.firenet.gov/geoserver/ows?service=WPS&version=1.0.0
             &request=execute
             &identifier=gs:LandscapeExport
             &DataInputs=point=POINT%28-110%2040%29;
             sourceCRS=EPSG:4326;
             Version=LF140;
             Resolution=30;
             Extent=5
             &RawDataOutput=output" -o landscape.tif

HTTP Post

Below is a sample XML-formatted document with sample inputs. This can be saved to a file and used in a POST request from the command line, which is very useful in automated scenarios.

<?xml version="1.0" encoding="UTF-8"?><wps:Execute version="1.0.0" service="WPS" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.opengis.net/wps/1.0.0" xmlns:wfs="http://www.opengis.net/wfs" xmlns:wps="http://www.opengis.net/wps/1.0.0" xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:gml="http://www.opengis.net/gml" xmlns:ogc="http://www.opengis.net/ogc" xmlns:wcs="http://www.opengis.net/wcs/1.1.1" xmlns:xlink="http://www.w3.org/1999/xlink" xsi:schemaLocation="http://www.opengis.net/wps/1.0.0 http://schemas.opengis.net/wps/1.0.0/wpsAll.xsd">
  <ows:Identifier>gs:LandscapeExport</ows:Identifier>
  <wps:DataInputs>
    <wps:Input>
      <ows:Identifier>Longitude</ows:Identifier>
      <wps:Data>
        <wps:LiteralData>-114</wps:LiteralData>
      </wps:Data>
    </wps:Input>
    <wps:Input>
      <ows:Identifier>Latitude</ows:Identifier>
      <wps:Data>
        <wps:LiteralData>45</wps:LiteralData>
      </wps:Data>
    </wps:Input>
    <wps:Input>
      <ows:Identifier>Version</ows:Identifier>
      <wps:Data>
        <wps:LiteralData>LF140</wps:LiteralData>
      </wps:Data>
    </wps:Input>
    <wps:Input>
      <ows:Identifier>Resolution</ows:Identifier>
      <wps:Data>
        <wps:LiteralData>30</wps:LiteralData>
      </wps:Data>
    </wps:Input>
    <wps:Input>
      <ows:Identifier>Extent</ows:Identifier>
      <wps:Data>
        <wps:LiteralData>5</wps:LiteralData>
      </wps:Data>
    </wps:Input>
  </wps:DataInputs>
  <wps:ResponseForm>
    <wps:RawDataOutput mimeType="image/tiff">
      <ows:Identifier>output</ows:Identifier>
    </wps:RawDataOutput>
  </wps:ResponseForm>
</wps:Execute>

With the XML content saved to a file (for example, landscape.xml), a command line POST request can be constructed to extract a 8-band Landscape file in Geotiff format. Here is an example with using curl:

curl -q -v -XPOST -H "Content-type: xml" -d @landscape.xml "http://aws.wfas.net/geoserver/wps?request=Execute&service=WPS&version=1.0.0" -o output.tiff

The result is an 8-band Landscape Geotiff, suitable for Flammap/Farsite

The output from the LandscapeExport service imported in Flammap:

WFAS Web Processing Services:

Clone this wiki locally