ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Help
  • Sign Out
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions

NbrCircle

Available with Spatial Analyst license.

  • Summary
  • Illustration
  • Discussion
  • Syntax
  • Properties
  • Code sample

Summary

Defines a circle neighborhood which is created by specifying the radius in either map units or number of cells.

Illustration

NbrCircle neighborhood for FocalStatistics function
NbrCircle neighborhood example for the FocalStatistics function (radius = 2 cells).
NbrCircle neighborhood for BlockStatistics function
NbrCircle neighborhood example for the BlockStatistics function (radius = 3 cells).

Discussion

Tools that use neighborhood circle object: Block Statistics, Focal Statistics, Point Statistics, and Point Density.

A circle neighborhood is created by specifying a radius value. The radius is identified in cell or map units, measured perpendicular to the x- or y-axis. When the radius is specified in map units, it is converted to a radius in cell units. The resulting radius in cell units produces an area that most closely represents the area calculated by using the original radius in map units. Any cell center encompassed by the circle will be included in the processing of the neighborhood.

Syntax

NbrCircle ({radius}, {units})
ParameterExplanationData Type
radius

The radius of the circle neighborhood.

(The default value is 3)

Double
units

Defines the units of the neighborhood.

  • CELL —The unit of measurement is in cells.
  • MAP —The units are in map coordinates.

(The default value is CELL)

String

Properties

PropertyExplanationData Type
radius
(Read and Write)

The radius of the circle neighborhood.

Double
units
(Read and Write)

Defines the units of the neighborhood.

String

Code sample

NbrCircle example 1 (Python window)

Demonstrates how to create a NbrCircle class and use it in the BlockStatistics tool within the Python window.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outNbrC = BlockStatistics("block", NbrCircle(2, "MAP"))
outNbrC.save("C:/sapyexamples/output/blstatsnbrc2")
NbrCircle example 2 (stand-alone script)

Implements the BlockStatistics tool using the NbrCircle class.

# Name: NbrCircle_Ex_02.py
# Description: Uses the NbrCircle object to execute BlockStatistics tool.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inRaster = "block"

# Create the Neighborhood Object
radius = 2
myNbrCirc = NbrCircle(radius, "MAP")

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute BlockStatistics
outBlkStat =  BlockStatistics(inRaster, myNbrCirc, "MINIMUM", "DATA")

# Save the output 
outBlkStat.save("C:/sapyexamples/output/blstat_cir3")

Related topics

  • An overview of Spatial Analyst classes
  • An overview of neighborhood classes

ArcGIS Desktop

  • Home
  • Documentation
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Esri Blog
  • User Conference
  • Developer Summit
Esri
Tell us what you think.
Copyright © 2019 Esri. | Privacy | Legal