Land Facet Density
Summary
For every land facet in a land facet raster, computes the proportion of the surrounding neighborhood composed of that facet, from 0 to 1. If half the cells around a location belong to Facet X, the density of Facet X there is 0.5. The output is one multi-band raster with a band per facet, computed in a single pass — a 12-facet analysis produces one 12-band raster in one run. Part of the Land Facet Corridor Designer family; no Spatial Analyst needed.
Why density matters
A cell holds exactly one facet, but a corridor needs more than isolated cells of the right type — it needs places where the facet is genuinely abundant. Density measures that abundance, and Brost and Beier use it twice: the highest-density regions inside each Wildland Block become the corridor termini (Identify Termini Polygons reads the bands and their facet labels directly), and density joins the continuous variables in the Mahalanobis cost surface — where its ideal value is pinned at 100% rather than its mean, so the cheapest ground is ground thoroughly surrounded by its own facet.
The neighborhood machinery is the suite's full set: rectangle, circle, annulus, wedge, or a custom kernel file, with ground-unit neighborhoods sized on the spheroid in any coordinate system, plus a denominator choice for how empty cells count.
A tour of the dialog
The example is Step 3 of the Land Facet Tutorial: the 18-facet raster from Land Facet Clustering, every facet included, a circular neighborhood.
The tool works through the raster in strips of rows rather than holding the whole raster in memory at once, so the number of cells is not a concern; a small raster is simply one strip. Each strip is read with extra rows above and below it, as many as the neighborhood radius, so that every cell sees its full neighborhood, and the strips are sized to use about a gigabyte of working memory however large the raster is. The run messages report the layout: how many strips, how many rows in each, and how many extra rows on each side. The one combination that still needs a lot of memory is a very wide raster with a very large neighborhood, because the extra rows alone then fill several gigabytes (a radius of 500 cells on a raster 30,000 cells wide needs about 10 gigabytes). If a run of that kind fails, clip the raster to the area you need first or use a smaller neighborhood.
ModelBuilder
Parameters
| Label | Explanation | Data type |
|---|---|---|
| Input land facet rasterRequired · in_raster | The single-band facet raster from Land Facet Clustering. | Raster Layer |
| Output multi-band density rasterRequired · out_raster | One band per facet, 0–1 proportions, facet labels recorded. | Raster Dataset |
| Land facets to includeOptional · facets | Restrict to chosen facets (default all). | String |
| NeighborhoodRequired · neighborhood + shape parameters | Rectangle, circle, annulus, wedge, or kernel file, with the matching size parameters and units; ground units sized on the spheroid in any coordinate system. | String + Doubles |
| DenominatorOptional · denominator | How NoData neighbors count in the proportion. | String |
Python
import arcpy
arcpy.ImportToolbox(r"C:\path\to\JennessEnterprisesTools.pyt") # your install path
arcpy.jenness.LandFacetDensity(
in_raster=r"D:\lf.gdb\Land_Facets",
out_raster=r"D:\lf.gdb\Facet_Density",
neighborhood="Circle", radius=200, nbr_units="Map units")
Recommended citation
Credits and references
By Jeff Jenness, Jenness Enterprises (www.jennessent.com), from the Land Facet Corridor Designer by Jenness, Brost and Beier.
- Beier, P., D. Majka, and J. Jenness. 2007, revised 2026. Designing wildlife corridors with ArcGIS: ArcGIS Pro edition. Workshop book, revised by J. Jenness for the Corridor Designer Tools of the Wildlife and Forestry Tools add-in. Available at: CorridorDesigner_WorkshopBook_2026_ArcGISPro.pdf (5 MB)
- Brost, B. M., and P. Beier. 2012. Use of land facets to design linkages for climate change. Ecological Applications 22:87–103. doi.org/10.1890/11-0213.1
- Jenness, J., B. Brost, and P. Beier. 2013. Land Facet Corridor Designer. Available at: corridordesign.org (archived copy at the Internet Archive)
Licensing information
Works at every ArcGIS Pro license level (Basic, Standard, Advanced). No extension licenses are required.
Related tools and pages
- Projection Distortion and Terrain Analysis — how the tools measure cell-to-cell distances on the spheroid in any coordinate system.
- Land Facet Clustering — produces the facet raster.
- Land Facet Mahalanobis and Identify Termini Polygons — the two consumers of the density bands.
- Land Facet Tutorial — the tool in context.