IRWIN

Integrated Reporting of Wildland Fire Information

Overview

The IRWIN module provides access to wildfire incident data from the Integrated Reporting of Wildland Fire Information system. This is the authoritative source for federal and some state fire agency incident data.

Data Source: IRWIN/InFORM

Available Datasets

Dataset	Description	Category
:fire_occurrence	InFORM Fire Occurrence Records (2020-present)	incidents
:usa_current_incidents	Current US wildfire incidents	incidents
:usa_current_perimeters	Current US wildfire perimeters	perimeters

Basic Usage

using WildfireData.IRWIN

# List all datasets
IRWIN.datasets()

# Filter by category
IRWIN.datasets(category=:incidents)

# Get dataset info
IRWIN.info(:usa_current_incidents)

Downloading Data

# Download current incidents
data = IRWIN.download(:usa_current_incidents, limit=10)

# Download fire occurrence records for California
data = IRWIN.download(:fire_occurrence, where="POOState = 'US-CA'", limit=100)

# Download large fires only
data = IRWIN.download(:usa_current_incidents, where="DailyAcres > 1000", limit=10)

Querying

# Count all current incidents
n = IRWIN.count(:usa_current_incidents)

# Count fire occurrence records
n = IRWIN.count(:fire_occurrence)
n = IRWIN.count(:fire_occurrence, where="POOState = 'US-CA'")

# Get field information
fields = IRWIN.fields(:usa_current_incidents)

Saving and Loading Files

# Download and save to local file
path = IRWIN.download_file(:usa_current_incidents, limit=100)

# Load previously downloaded file
data = IRWIN.load_file(:usa_current_incidents)

Working with Results

data = IRWIN.download(:usa_current_incidents, limit=5)

# Access incident properties
for feature in data
    println("$(feature.IncidentName)")
    println("  Acres: $(feature.DailyAcres)")
    println("  State: $(feature.POOState)")
end

Key Fields

Common fields in the incident data:

• IncidentName - Name of the fire
• DailyAcres - Current size in acres
• POOState - State (e.g., “US-CA”)
• DiscoveryDate - When the fire was discovered
• FireCause - Cause of the fire
• PercentContained - Containment percentage

Plot Example

using WildfireData.IRWIN
using CairoMakie, GeoMakie, Tyler
using Extents, TileProviders
CairoMakie.activate!(visible=false)  # don't open an image viewer when Tyler calls display
# OpenStreetMap's tile policy requires an identifying User-Agent and attribution:
# https://operations.osmfoundation.org/policies/tiles/
Tyler.USER_AGENT[] = "WildfireData.jl-docs (+https://github.com/RallypointOne/WildfireData.jl)"

data = IRWIN.download(:fire_occurrence, limit=200, verbose=false)

lons = Float64[]
lats = Float64[]
acres = Float64[]

for feature in data.features
    props = feature.properties
    geom = feature.geometry
    isnothing(geom) && continue
    a = get(props, :IncidentSize, nothing)
    (isnothing(a) || a <= 0) && continue
    push!(lons, geom.coordinates[1])
    push!(lats, geom.coordinates[2])
    push!(acres, Float64(a))
end

if !isempty(lons)
    pad = 2.0
    ext = Extent(; X=(minimum(lons) - pad, maximum(lons) + pad),
                   Y=(minimum(lats) - pad, maximum(lats) + pad))
    m = Tyler.Map(ext;
        size = (900, 600),
        axis = (; type = GeoMakie.GeoAxis, dest = "+proj=merc"),
        provider = TileProviders.OpenStreetMap(:Mapnik),
        fetching_scheme = Tyler.SimpleTiling(),  # only the tiles in view
    )
    text!(m.axis, 1, 0; text="© OpenStreetMap contributors", space=:relative, align=(:right, :bottom), offset=(-4, 4), fontsize=10)
    sc = scatter!(m.axis, lons, lats, color=log10.(acres), colormap=:inferno, markersize=6)
    Colorbar(m.figure[1, 2], sc, label="log₁₀(IncidentSize)")
    m  # show the Map, not m.figure, so rendering waits for tiles
end

API Reference

Functions

• datasets(; category=nothing) - List available datasets
• info(dataset) - Print dataset information
• download(dataset; where, fields, limit, verbose) - Download data
• download_file(dataset; filename, force, verbose, ...) - Download and save to file
• load_file(dataset; filename) - Load previously downloaded file
• count(dataset; where) - Get record count
• fields(dataset) - Get field names and types
• query_url(dataset; kwargs...) - Build query URL
• dir() - Get local data directory path