Create Habitat Patches

Corridor Designer Tools · Habitat Suitability Modeling · geoprocessing tool · by Jeff Jenness
Works at every ArcGIS Pro license level

Summary

Turns a habitat suitability model into habitat patch polygons classified by whether each is large enough to matter. A habitat model tells you how good each cell is; it does not tell you whether the good cells add up to a contiguous area large enough to support the species. This tool answers that: the HSM is averaged over a moving window, cells meeting your quality threshold become suitable habitat, touching suitable cells group into patches, and each patch is classed by its geodesic area as too small, a breeding patch (supports at least one breeding event), or a population patch. A modernized port of the CorridorDesigner Patch Configuration tool; no Spatial Analyst needed.

Learn more About Corridor Design covers what a habitat patch is, why patches matter for corridor modeling, and how the moving window, quality threshold and patch sizes are chosen. Step 6 of the Corridor Design Tutorial runs this tool on the black bear model, with the tutorial data (41 MB) available to download so you can follow along.

How a cell becomes a patch

First the HSM is averaged over a circular moving window (the mean of the data cells), so a lone bad cell inside good habitat — or a lone good cell in bad — neither fragments nor fabricates patches. The window size is a species decision: the original species files ranged from a 3×3-cell window for small animals to a 200-m circle for wide-ranging ones (the species' perceptual range is the usual guide, as best as we can guess what that is). Cells whose average meets the quality threshold count as suitable; suitable cells touching along edges or corners join into one patch; and each patch's area decides its class.

Areas are geodesic hectares This tool sums each patch's true per-row cell areas on the spheroid, so the hectare thresholds mean the same thing on any coordinate system — geographic rasters and State Plane feet included. The Area_Ha field holds the exact number the classification used.

Reading the output

One polygon per patch: Class 1 “Too small” (below the breeding size), Class 2 “Breeding patch”, Class 3 “Population patch”, each with its hectares, symbolized by class on delivery (dark green population, light green breeding, pale too-small). The run messages report patch counts and total hectares per class, and warn if no patch reaches the population size — worth heeding before corridor modeling, since population patches are the preferred corridor termini. The output carries the source model's analysis record forward for the Corridor Analysis Data Report.

A tour of the dialog

The Corridor Designer Tools gallery open on the ribbon, with the Create Habitat Patches button, in the Habitat Suitability Modeling row, outlined in blue
Where to find it: Create Habitat Patches is in the Habitat Suitability Modeling row of the Corridor Designer Tools gallery, in the Corridor Designer Tools group of the Wildlife and Forestry tab.
The Create Habitat Patches geoprocessing pane: the black bear habitat suitability model as input, a 200-meter moving-window radius, a habitat quality threshold of 60, minimum breeding patch size 1000 hectares, minimum population patch size 5000 hectares
The black bear settings, from the Corridor Design Tutorial.
The patch map over a hillshade: large dark-green population patches filling both wildland blocks, a few light-green breeding patches in the hills between them, and small pale-yellow patches too small for breeding scattered across the valley
The result: a population patch in each block, breeding patches in the hills between.

The tool holds the whole raster in memory at once, so the memory it needs grows with the number of cells. On most rasters that is no concern. On a very large one the tool may need more memory than your computer has free, and then one of two things happens: Windows starts using the disk as overflow memory and the tool slows to a crawl, or the tool stops with an out-of-memory error. There is no fixed limit; it depends on how much memory your computer has free. If a raster is too large, clip it to the area you need first.

ModelBuilder

A ModelBuilder diagram: Black Bear Habitat Suitability Index feeding Create Habitat Patches, producing the Black_Bear_Patches polygon feature class
The suitability model in, the patch polygons out. The moving window, the quality threshold and the two patch sizes travel inside the tool, so a model that sweeps thresholds is a matter of copying this block and changing one number in each copy.

Parameters

LabelExplanationData type
Input habitat suitability modelRequired · in_hsm The 0–100 suitability raster. Raster Layer
Moving-window radiusRequired · radius Radius for averaging the HSM — matched to the species' perceptual range. Double
Radius unitsRequired · radius_units Cells, Meters (the default), Kilometers, Feet or Miles — mind the choice (200 meters, not 200 cells). String
Habitat quality thresholdRequired · threshold Averaged cells at or above this 0–100 score count as suitable (60 in the Arizona Missing Linkages standard). Double
Minimum breeding patch sizeRequired · breeding_ha Geodesic hectares for Class 2. Double
Minimum population patch sizeRequired · population_ha Geodesic hectares for Class 3. Double
Output habitat patchesRequired · out_fc The classified patch polygons. Feature Class

Python

import arcpy
arcpy.ImportToolbox(r"C:\path\to\JennessEnterprisesTools.pyt")  # your install path
arcpy.jenness.HabitatPatches(
    in_hsm=r"D:\corr.gdb\blackbear_hsm",
    radius=200, radius_units="Meters",
    threshold=60,
    breeding_ha=1000, population_ha=5000,
    out_fc=r"D:\corr.gdb\blackbear_patches60")

Recommended citation

Jenness, J., D. Majka and P. Beier. 2026. Create Habitat Patches. Wildlife and Forestry Tools add-in for ArcGIS Pro, v. 1.99 (September 2026). Jenness Enterprises. Available at: https://github.com/JeffJenness/Wildlife_Tools.

Credits and references

By Jeff Jenness, Jenness Enterprises (www.jennessent.com), ported from the CorridorDesigner tools by Jenness, Majka and Beier.

Licensing information

Works at every ArcGIS Pro license level (Basic, Standard, Advanced). No extension licenses are required.