Critical Habitat Feature

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

Summary

Rescales a habitat suitability model by distance from a critical habitat feature — a resource the species must stay near. Neither the geometric nor the additive combining method adequately handles a species absolutely dependent on proximity to one specific resource, and a standard model for such a species can greatly overpredict its habitat: bighorn sheep must stay within about 300 m of the steep escape terrain; many amphibians must stay near perennial water; many rattlesnakes and lizards must stay near rocky outcrops. The remedy is to make suitability decline with distance from the critical feature, in bands you define. A modernized port of the CorridorDesigner Critical Feature tool; no Spatial Analyst needed.

Learn more About Corridor Design covers modifying a habitat map for a species that depends on one critical resource, the situation this tool exists for. The Corridor Design Tutorial builds the black bear model rescaled in the example below, and its clipped streams are the critical feature, with the tutorial data (41 MB) available to download so you can follow along.

How each cell is scored

The tool computes every cell's straight-line distance to the nearest critical-feature cell, finds the distance band it falls in, and multiplies the cell's suitability by that band's percentage. The workshop book's riparian example, exactly reproducible with this tool's bands: within 30 m of perennial streams the new HSM is 100% of the existing HSM; from 30–60 m, 80%; from 60–100 m, 60%; and beyond 100 m, 0% — not habitat at all. The same mechanism works in reverse for a hazard the species must stay away from: keep a small percentage in the near bands and 100% far away. The critical feature can be a feature layer (selections honored) or a raster. End your bands at a very large distance — cells beyond the last band are left unchanged, with a warning.

A tour of the dialog

The example applies the workshop book's riparian rule to the black bear model from the Corridor Design Tutorial, with the clipped streams from the tutorial data as the critical feature. Black bears are not in fact riparian obligates, so treat this as a demonstration of the mechanism rather than a claim about bears: the point is what the tool does to a model, which is easiest to see when the effect is drastic. Before the run, the country between the streams is a patchwork of optimal, suboptimal and occasionally-used ground, and the streams themselves make no difference to it.

The Corridor Designer Tools gallery open on the ribbon, with the Critical Habitat Feature button, in the Habitat Suitability Modeling row, outlined in blue
Where to find it: Critical Habitat Feature 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.
A close view of the black bear habitat suitability model in five classes, a patchwork of optimal dark green, suboptimal bright green, occasionally-used pale yellow and scattered red non-habitat, with the clipped streams overlaid as blue lines that bear no relation to the pattern
Before: a close view of the model with the streams overlaid. Suitability here is a matter of land cover, elevation, topography and roads; distance from water plays no part.

The bands are the book's: within 30 m of a stream the cell keeps 100% of its score, from 30 to 60 m it keeps 80%, from 60 to 100 m it keeps 60%, and beyond 100 m it keeps nothing. The last band runs out to ten million meters so that no cell in the study area escapes it: a cell beyond the last band would be left unchanged, with a warning, which is not what we mean here.

The Critical Habitat Feature geoprocessing pane: input habitat suitability model Black Bear Habitat Suitability Index, critical habitat feature streams, four distance bands of 0 to 30 meters keeping 100 percent, 30 to 60 keeping 80, 60 to 100 keeping 60 and 100 to 10,000,000 keeping 0, an Add another button, and the output named Black_Bear_near_Streams
The model, the streams, and four bands: 100%, 80%, 60% and 0% of the score kept, out to a distance nothing in the study area exceeds.
The same close view after the run: the model is red non-habitat everywhere except narrow ribbons along each stream, where a dark green core nearest the water gives way outward to bright green, pale yellow and pink bands before the red
After: everything more than 100 m from a stream is now non-habitat, and each stream is wrapped in concentric bands that step down with distance. At this raster's 30 m cell size, each band is about one cell wide.

Read the ribbons from the water outward. The innermost cells keep the model's own scores, so along a stream that ran through optimal habitat the core stays dark green, and along one that ran through poorer ground it starts lower. The next band is those scores at 80%, the next at 60%, and then nothing. The five legend classes are natural breaks recomputed on the new raster, which is why the pink strongly-avoided class, empty in the original model, now appears: the 60% band has created a population of middling scores that did not exist before. That is also the reason to look at the numbers rather than the colors when comparing two models.

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 and streams feeding Critical Habitat Feature, producing Black_Bear_near_Streams
The model and the feature in, the rescaled model out. The band table travels inside the tool.

Parameters

LabelExplanationData type
Input habitat suitability modelRequired · in_hsm The 0–100 surface to rescale. Raster Layer
Critical habitat featureRequired · in_critical The resource, as features (selections honored) or a raster. Feature or Raster Layer
Distance bandsRequired · bands Rows of from-distance, to-distance (meters), and the percent of the score kept in that band. Value Table
Output modified HSMRequired · out_raster The rescaled surface. Raster Dataset

Python

import arcpy
arcpy.ImportToolbox(r"C:\path\to\JennessEnterprisesTools.pyt")  # your install path
arcpy.jenness.CriticalHabitatFeature(
    in_hsm=r"D:\corr.gdb\frog_hsm",
    in_critical="Perennial_Streams",
    bands="0 30 100;30 60 80;60 100 60;100 100000 0",
    out_raster=r"D:\corr.gdb\frog_hsm_water")

Recommended citation

Jenness, J., D. Majka and P. Beier. 2026. Critical Habitat Feature. 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.