PHOENIX Input Data Guide
This page is under development, please be patient whilst we improve our website. If you have questions that can not be answered by this website at this time please contact us via email: firepredictions@afac.com.au
- 1 Overview
- 1.1 Input
- 2 The Data Directory
- 3 Gridded Weather
- 4 Other directories
- 4.1 Application
- 4.2 Outputs
- 4.3 Projects
- 5 Data Preparation Requirements
- 6 Source Data Preparation
- 7 1. Fuel (Vegetation)
- 8 2. Fire History
- 9 3. Road Proximity Layer
- 10 4. Fuel Disruptions Layer
- 11 5. Digital Elevation Model Layer
- 12 6. Assets Layer
- 12.1 Asset Code Description
- 12.2 Asset Id
- 12.3 Impact Type Code
- 12.4 Asset Value
- 12.5 Asset Layer Preparation Process
- 13 7. Wind Modifiers Layer
Overview
Input
When running a simulation Phoenix obtains input data from 3 sources.
Data entered into the application directly, and saved in the project file,
Files in the Gridded_Weather directory, and
Files in the Data directory.
Input data to the model must be prepared in a GIS such as ESRI's ArcGIS or MapInfo. This base data is then converted into a format read by PHOENIX which is an ASCII grid broken into data "tiles", 30 x 30 cells wide. This tiling can be easily done in ArcGIS using a specially developed "Toolbox". The base input data is usually at 20 or 30m resolution, but when it is read into PHOENIX it is averaged into larger cells to speed computations. Typically the grid cell size for PHOENIX computation is 100 or 200m, but could range from 50 to 500m depending on the nature of the terrain and the level of detail required.
This document describes the data files that are obtained from the Gridded_Weather and Data directories.
The actual location of these directories is specified in the project file, and usually defaults to subdirectories of C:\Phoenix
Sub directories :-
The Data Directory
The Data directory normally contains input layers that have been created by hand.
General Requirements
All data layers must be in the same coordinate system, and this must be a map grid projection (grid reference in metres) not a geographic one (latitude and longitude in degrees).
In Victoria, we suggest using "VicGrid 94" which is a Lambert Conformal Conic Projection with a GDA 94 reference Datum.
Across Australia, we suggest "Geoscience Australia Lambert 94" projection which is a Lambert Conformal Conic Projection with a GDA 94 reference Datum.The only data layer that MUST be provided is the Fuel Layer.
However, other layers make the simulation much more realistic. If there is no data file location specified, then the input value will be zero.As all data layers must be in the same coordinate system only one projection file is required. The default name of this file is data.prj and is best located in the root of the Data directory.
The format of the projection file conforms to the requirements of ESRI ArcGIS 9.Layers can be provided as zip files, to decrease the size of data that has to be copied around.
Possible Input Layers
The actual layers that Phoenix will use in a simulation are configured in the Project window, on the Data tab. The list below is the complete set of possible layers:
Mandatory
Fuel Layer - developed from a vegetation layer
Optional
Digital Elevation Model (DEM) - from which to calculate slope, aspect and elevation
Fire History Layer, with an optional Supplementary Fire History Layer - from which to calculate the current level of fuels across the landscape
Road Proximity Layer - from which to determine the level of assistance given to suppression
Disruption Layer - from which to determine the effect of linear features such as roads, rivers, railway lines and fire breaks, on fire behaviour and spread
Assets Layer - assists in assessing asset impact during the fire simulation. Assets include Housing, Infrastructure, Plantation and Rainforest
Wind Modifiers Layer - assists in making changes to local wind speed and direction
Curing Layer
Drought Factor Layer
Example :-
Other files in the Data directory
In addition to the source data for running the PHOENIX model, it is also necessary to have a visual reference layer such as a satellite image or topographic map on which to set up the simulation area and to overlay the results of the simulation. More on this below.
This geographic reference layer(s) is encapsulated in an ArcGIS project. Apart from the basic visual reference layer, other GIS information may also be included in this project for display in PHOENIX. However, within PHOENIX, these layers can only be turned on or off for display, no other manipulation of these layers is possible in the PHOENIX environment.
Below are some examples of geographic reference layers. The top image shows a satellite image overlaid with major rivers, roads and town names. The bottom image shows a section of a 1:250,000 topographic map.
Gridded Weather
The Gridded_Weather directory is expected to contain gridded forecast weather data in the form of NetCDF files normally obtained from the Bureau of Meteorology. This data is produced twice a day by the BOM. A downloading process has to be put in place to get this data, but it is restricted to registered users. PHOENIX will also run on a single stream of weather data
TBD - Info about the weather downloader required.
The Tools dropdown menu provides the options to
Download Gridded Weather - get the latest gridded weather from the Bureau of Meteorology ftp server (only available to registered users)
Shut Down Phoenix Workers - a facility to run separate simulations, in a parallel process, on a cluster of computers or on different processors for multi-core processors such as Quad-cores. This is a function set up for large simulations.
Unpack Phoenix Datafile - unpack the zipped input data tiles to compile a single ASCII file
Edit Fuel Types
Edit Suppression Rates
Push data to nodes - such as write the simulation inputs and outputs to the ignition points
TBD - populate this section with a description of how to use the weather downloader
Refer to the manual for how to use weather entered directly into the UI/project file
Other directories
Application
This is where you'll find Phoenix.exe which you can use to run the application.
Outputs
This will ultimately contain the range of files produced from the simulations.
Projects
This will store the .xml files containing the settings for each simulation created.
Data Preparation Requirements
Datum and Coordinate System
All data needs to be prepared in a consistent projection that has a scale in metres. You cannot use a geographic coordinate system using measurement in degrees. For consistency across Australia, we recommend using the GDA_1994_Geoscience_Australia_Lambert projection.
GIS Software
GIS software is an ongoing problem. We have decided to write PHOENIX to use ESRI ArcGIS 9.2, sp4. You need a licence to operate ArcGIS 9.2 ArcView (or similar Arc product such as ArcEditor, ArcInfo). It is our intention to keep the PHOENIX software compatible with the most recent version of ESRI ArcGIS.
Source Data Preparation
1. Fuel (Vegetation)
The Fuel layer is used in conjunction with the fire history layer to create the fuel attributes used in PHOENIX. It has been assumed that the vegetation layer is the layer most likely to be kept up-to-date and more readily available than a purpose built fuel type layer. However, it is also acknowledged that there are several vegetation type classifications and a range of mapping detail and quality within some states and between states. Therefore, the approach taken in PHOENIX has been to convert various vegetation classifications into a standard set of fuel types, e.g. there are about 700 vegetation types mapped in Victoria and these are classified into about 40 different fuel types.
Fuel Types currently recognised in southern Australia.
Veg Type | FuelCode | No. | Description | Fuel Characteristics |
|---|---|---|---|---|
Bare | NIL | 0 | Water, sand, no vegetation | fuel absent |
Herbs | H01 | 30 | Moorland / Fjaeldmarks | low flammability cushion plants |
| H02 | 36 | Alpine Herbland | dense, upright, low flammability herbs |
| H03 | 34 | Wet herbland | freshwater herbs on mud flats |
| H03 | 37 | Wet Herbland | low herbs in seasonally inundated lakebeds or wetlands |
Grass/sedges | G01 | 16 | High Elevation Grassland | dense sward of tussock grasses or herbs, high cover |
| G02 | 4 | Moist Sedgeland / Grassland | dense sward, potentially high dead component, button grass |
| G03 | 29 | Ephemeral grass/sedge/herbs | dense grass and sedges with potentially high levels of dead suspended material |
| G04 | 20 | Temperate Grassland / Sedgeland | grasses and sedges widespread, but varying in biomass |
| G05 | 44 | Hummock grassland | hummock grassland, discontinuous surface fuels |
Shrubs | S01 | 17 | High Elevation Shrubland/Heath | dense cover of shrubs with surface fuel largely under plants |
| S02 | 14 | Riparian shrubland | dense vegetation with little dead material |
| S03 | 35 | Wet Scrub | flammable shrubland with high level of dead elevated fuels |
| S04 | 1 | Moist Shrubland | dense shrubland, salt affected |
| S05 | 31 | Dry Closed Shrubland | tea-tree or paperbark thickets, little understorey |
| S06 | 21 | Broombush / Shrubland / Tea-tree | dense shrubland, but with relatively low level of dead material |
| S07 | 10 | Sparse shrubland | sparse shrubby vegetation with discontinuous surface fuels |
| S08 | 3 | Low flammable Shrubs | low flammability except after exceptional rain bringing grasses |
| S09 | 38 | Mangroves / Aquatic Herbs | trees, shrubs and herbs in permanent water, unburnable |
Heaths | S10 | 23 | Wet Heath | dense heath possibly with dense sedgy undergrowth |
| S11 | 24 | Dry Heath | dense heath with significant amounts of dead material |
Mallee | M01 | 27 | Mallee chenopod | low flammability except after exceptional rain bringing grasses |
| M02 | 42 | Mallee grass | mallee woodland with predominantly grass understorey |
| M03 | 25 | Mallee shrub/heath | continuous shrub layer but amount of dead material depending on species present |
| M04 | 26 | Mallee spinifex | discontinuous fuels, very flammable under windy conditions |
Woodland | W01 | 18 | High Elevation Woodland shrub | wooded area with shrubby understorey |
| W02 | 19 | High Elevation Woodland grass | wooded area with continuous grass tussocks |
| W03 | 97 | Orchard / Vineyard | orchard or vineyard |
| W04 | 2 | Moist Woodland | low trees, shrubby, sedgy understorey, bark hazard |
| W05 | 22 | Woodland bracken/shrubby | wooded area with varying understorey, but not heathy |
| W06 | 9 | Woodland Grass/Herb-rich | surface fuels dominated by grass and herbs |
| W07 | 5 | Woodland Heath | flammable shrubs and high bark hazard |
| W08 | 41 | Gum Woodland heath/shrub | gum woodland with moderate bark hazard, heath/shrub understorey |
| W09 | 43 | Gum Woodland grass/herbs | gum woodland with moderate bark hazard, herbaceous understorey |
| W10 | 39 | Savanna grasslands | tall flammable grasses in an open woodland |
| W11 | 28 | Woodland Callitris/Belah | low flammability except after exceptional rain bringing grasses |
Forest | F01 | 15 | Rainforest | dense vegetation with little dead material, epiphytes, vines, ferns, rarely dry |
| F02 | 32 | Wet Forest with rainforest understor | ewet sclerophyll forest with mesic understorey |
| F03 | 13 | Riparian Forest shrub | dense vegetation but with a small proportion of dead material |
| F04 | 11 | Wet Forest shrub & wiregrass | high biomass forest, but with little dead suspended material unless wiregrass present |
| F05 | 12 | Damp Forest shrub | dense understorey and potentially high bark hazard (karri) |
| F06 | 40 | Semi-mesic Sclerophyll forest | forest with semi-mesic shurbs and flammable grasses, sedge understorey |
| F07 | 33 | Swamp Forest | dense Melaleuca forest with little understorey |
| F08 | 6 | Forest with shrub | potentially high bark hazard, shrubs moderate flammability (mixed jarrah/karri) |
| F09 | 7 | Forest herb-rich | potentially high bark hazard, little elevated fuel |
| F10 | 45 | Dry Forest shrubs | dry forest with continuous understorey, (southern jarrah) |
| F11 | 8 | Dry Open Forest shrub/herbs | dry forest with open understorey (northern jarrah) |
Plantations | P01 | 98 | Softwood Plantation | dense canopy with continuous surface fuels |
| P02 | 99 | Hardwood Plantation | uniform canopy with continuous surface fuels |
The user needs to assign a fuel type to every vegetation type in the area of interest. To enable this, a code for each vegetation type is needed, e.g. 97 – Semi-arid Woodland. This code is used in a lookup table and joined to a fuel-type code. This fuel type code must then be added to the attribute table for the vegetation map in a GIS. The setting up of the conversion process is beyond the scope of these notes, but
it can be done by “Joining” the lookup table to the vegetation attribute table in the GIS.