FlamMap Help

Click here to see this page in full context

Grid Themes

Grid or raster refers to a type of spatial data used by a GIS that consists of rows and columns of rectangular cells. Each cell contains values or attributes for that particular theme or layer. For example, if the theme is elevation, then the attributes will contain elevations in meters or feet. FlamMap uses raster data as inputs for all spatial data on topography, fuels, and crown structure. FlamMap can also export fire behavior information as raster themes for use in a GIS.

Raster Layers used in FARSITE

FlamMap can utilize two grid formats, Arc Grid ASCII and GeoTIFF.

ARC GRID ASCII Format

Arc Grid ASCII format files can be used with any FlamMap feature that requires a grid or raster theme.

These files are quite simple and are supported by any GIS system. They can even be viewed, created, and edited with a simple text editor.

Example of ASCII grid viewed in Notepad.

Arc Grid ASCII format raster files have a six line header describing the size and location of the represented data.

Keyword	Description
ncols	number of grid columns
nrows	number of grid rows
xllcorner	lower left corner X coordinate
yllcorner	lower left corner Y coordinate
cellsize	size of the individual cells
NODATA_value	a default code for cells with no data

After the header the individual cell values are simply arranged in rows and columns like you would see when viewing the file as a map feature.

GeoTIFF Format

GeoTIFF format files are a bit more complex as they have projection information embedded within, are compressed, and can contain multiple layers or themes known as bands.

Single band GeoTIFF format files can be displayed in FlamMap as Auxiliary Grid Themes, used to Create a Landscape, or as gridded wind inputs.

Raster outputs for an entire FlamMap, FARSITE, or SpatialFOFEM run can now all be saved in one multi-band GeoTIFF file with the Raster Outputs to GeoTIFF shortcut command.

Also a Landscape (.LCP) File can be converted to a multi-band GeoTIFF format file which can be used in FlamMap or viewed with a GIS.

Grid Theme Commands

Right-clicking any individual grid theme (Auxiliary, Landscape, or Output) in the "Tree" Pane displays this short cut menu.

Note the Delete command is not available for Landscape Themes or Output Grids, only Auxiliary Grids.

Saving an Individual Grid Theme

You can save your grids in several formats so you can use it in a GIS, image editor, or word processor. Right-click an individual grid theme from the "Tree" pane and select Save As… A standard Windows "Save As" dialog box appears where you can navigate and name your new file.

Grids can be saved in ASCII Grid or GeoTIFF file formats for exporting to a GIS.

If projection information is available for the landscape it will be included in the GeoTIFF or a Projection (.PRJ) File will also be saved when selecting the ASCII Grid format.
The grid will be saved with the units currenly displayed for the theme.

For most GIS applications the GeoTIFF format has several benefits,

the file size is significantly smaller,
there is only one file as projection information is embedded with the data,
and the GeoTIFF (.TIF) format is widely supported in GIS, image processing, and authoring applications.

An aux.xml file containing metadata will be created for both ASCII Grid and GeoTiff file formats with the same name as entered in the Save As dialog. For example, "fakeFlameLength.tif" would have a companion file "fakeFlameLength.tif.aux.xml".

An aux.xml file can be viewed in a text editor like WordPad, like this flame length raster output.

Flame length example of a .aux.xml metadata file.

Also Bitmap, JPEG, GIF, and PNG image formats are also available from the Save as Type: drop-down list for saving your FlamMap display window as an image for use in an image or word processor.

Saving All Raster Outputs

Raster outputs for an entire FlamMap, FARSITE, or SpatialFOFEM run can now all be saved in one multi-band GeoTIFF file.

Right-clicking any individual run tree item displays a shortcut menu with the Raster Outputs to GeoTIFF command.

An aux.xml file containing metadata will be also be created when saving a multi-band GeoTIFF.

Deleting an Individual Auxiliary Grid Theme

To delete a single Auxiliary Grid Theme, right-click the individual item in the "Tree" pane and select Delete from the shortcut menu. The following warning asks for confirmation of your delete request.

Note the Delete command is not available for Landscape Themes or Output Grids, only Auxiliary Grids.

Contouring a Grid Theme

Contours can be created from any landscape, auxiliary, or output grid. Contours can be used to overlay a grid's information on top of another grid theme. In the image below a contour of the elevation grid is overlaid on the canopy base height grid.

Create contours by right-clicking a grid theme item in the "Tree" pane or the "Display" Pane and selecting Contour from the shortcut menu to display the "Contouring" dialog box. Not all grids make sense for contouring, many grids will have strange results when contoured. MTT Arrival Time and Elevation grids are best suited to contouring.

For Farsite simulations it is suggested to save the Farsite Perimeters instead of contouring the Farsite Arrival Time grid. The visible perimeters can be modified with the "Farsite Perimeters" dialog.

The Theme Value Range gives the range of values over the theme for the entire landscape. You cannot edit this range. The Units: are whatever the grid theme is currently displayed in.

Select either the Equal Intervals or Use Legend Classes radio button.

With equal intervals set the contour interval in the Contour Interval spin box. The Offset from zero to which to interpret intervals (optional) spin box controls the where to start the contour labels in the shapefile attribute table. Usually the minimum value in the Theme Value Range will be appropriate.
The Use Legend Classes option creates contours based on the bins in the Properties of the grid theme being contoured.

Select the Create Polygons check box for polygon geometry contours, leaving the check box cleared will create line geometry contours. Lines may not include the final perimeter when contouring MTT Arrival Time grids, so utilize the polygon option in that case. When exporting to a GIS lines and polygons will have different display properties.

Click the OK button and the contours will be generated and displayed in the default black color.

Properties of Grid Themes

The Properties command displays the "Create/Modify Legend" dialog where you can change the colors and ranges of values your grid theme displays.

Statistics

The Statistics command displays the "Theme Statistics" dialog which consists of two tabs. The first is the General Statistics tab which displays general information about the grid theme and summary statistics.

NOTE: For themes with class units some of the summary statistics are meaningless.

The Save As button opens a "Save As" dialog box for the user to save the tab contents in a plain text (.TXT) format file.

The second Classes tab displays the legend bins as determined by the "Create/Modify Legend" dialog box. Cell frequency and area data is also shown.

The Save As button opens a "Save As" dialog box for the user to save the tab contents in a comma separated value (.CSV) format file which can be imported into a text editor or spreadsheet application.

Help

Selecting the Help command will bring you to the Auxiliary Grid Themes heading above in this online help system.