Point Density (Spatial Analyst)

Summary

Calculates a magnitude-per-unit area from point features that fall within a neighborhood around each cell.

Learn more about how Point Density works

Illustration

Point Density illustration
OutRas = PointDensity(InPts, None, 30)

Usage

  • Only the points that fall within the neighborhood are considered when calculating the density. If no points fall within the neighborhood at a particular cell, that cell is assigned NoData.

  • The values on the output raster will always be floating point.

  • The Output cell size parameter can be defined by a numeric value or obtained from an existing raster dataset. If the cell size hasn’t been explicitly specified as the parameter value, it is derived from the Cell Size environment if it has been specified. If the parameter cell size or the environment cell size have not been specified, but the Snap Raster environment has been set, the cell size of the snap raster is used. If nothing is specified, the cell size is calculated from the shorter of the width or height of the extent divided by 250 in which the extent is in the output coordinate system specified in the environment.

  • If the cell size is specified using a numeric value, the tool will use it directly for the output raster.

    If the cell size is specified using a raster dataset, the parameter will show the path of the raster dataset instead of the cell size value. The cell size of that raster dataset will be used directly in the analysis, provided the spatial reference of the dataset is the same as the output spatial reference. If the spatial reference of the dataset is different than the output spatial reference, it will be projected based on the specified Cell Size Projection Method value.

  • Larger values of the radius parameter produce a more generalized density raster. Smaller values produce a raster that shows more detail.

  • For data formats that support Null values, such as file geodatabase feature classes, a Null value will be ignored when used as input.

  • If the area unit scale factor units are small, relative to the distance between the points, the output raster values may be small. To obtain larger values, use the area unit scale factor for larger units (for example, square kilometers versus square meters).

  • See Analysis environments and Spatial Analyst for additional details on the geoprocessing environments that apply to this tool.

Parameters

LabelExplanationData Type
Input point features

The input point features for which to calculate the density.

Feature Layer
Population field

Field denoting population values for each point. The population field is the count or quantity to be used in the calculation of a continuous surface.

Values in the population field can be integer or floating point.

The options and default behaviors for the field are listed below.

  • Use None if no item or special value will be used and each feature will be counted once.

  • You can use the Shape field if input features contain z-values.

  • Otherwise, the default field is POPULATION. The following conditions may also apply:

    • If there is no POPULATION field, but there is a POPULATIONabcd field, it will be used by default. The 'abcd' can be any valid characters, for example, POPULATION6, POPULATION1974, or POPULATIONROADTYPE.
    • If there is no POPULATION field or POPULATIONabcd field, but there is a POP field, the POP field will be used by default.
    • If there is no POPULATION field, POPULATIONabcd field, or POP field, but there is a POPabcd field, the POPabcd field will be used by default.
    • If there is no POPULATION field, POPULATIONabcd field, POP field, or POPabcd field, NONE will be used by default.
Field
Output cell size
(Optional)

The cell size of the output raster that will be created.

This parameter can be defined by a numeric value or obtained from an existing raster dataset. If the cell size hasn't been explicitly specified as the parameter value, the environment cell size value will be used if specified; otherwise, additional rules will be used to calculate it from the other inputs. See the usage section for more detail.

Analysis Cell Size
Neighborhood
(Optional)

Dictates the shape of the area around each cell that is used to calculate the density value.

  • Annulus—A torus (donut shaped) neighborhood defined by an inner and outer radius.
  • Circle—A circular neighborhood with the given radius. This is default where the radius is the shortest of the width or height of the extent of the input point features, in the output spatial reference, divided by 30.
  • Rectangle—A rectangular neighborhood with the given height and width.
  • Wedge—A wedge-shaped neighborhood. A wedge is specified by a start angle, an end angle and a radius. The wedge extends counterclockwise from the starting angle to the ending angle. Angles are specified in arithmetic degrees (counterclockwise from the positive x-axis). Negative angles may be used.
  • Cell | Map—Defines the units of the selected neighborhood measurements in either cells or map units (based on the linear unit of the projection of the output spatial reference).
Neighborhood
Area units
(Optional)

Specifies the area units that will be used for the output density values.

A default unit is determined based on the linear unit of the output spatial reference. You can change this to the appropriate unit to convert the density output. Values for line density convert the units of both length and area.

If no output spatial reference is specified, the output spatial reference will be the same as the input feature class. The default output density units are determined by the linear units of the output spatial reference . If the output linear units are meters, the output area density units will be set to Square kilometers, outputting square kilometers for point features or kilometers per square kilometers for polyline features. If the output linear units are feet, the output area density units will be set to Square miles.

If the output units are anything other than feet or meters, the output area density units will be set to Square map units. That is, the output density units will be the square of the linear units of the output spatial reference. For example, if the output linear units are centimeters, the output area density units will be Square map units, which will result in square centimeters. If the output linear units are kilometers, the output area density units will be Square map units, which will result in square kilometers.

The available options and their corresponding output density units are the following:

  • Square map unitsThe square of the linear units of the output spatial reference will be used.
  • Square milesU.S. miles will be used.
  • Square kilometersKilometers will be used.
  • AcresU.S. acres will be used.
  • HectaresHectares will be used.
  • Square yardsU.S. yards will be used.
  • Square feetU.S. feet will be used.
  • Square inchesU.S. inches will be used.
  • Square metersMeters will be used.
  • Square centimetersCentimeters will be used.
  • Square millimetersMillimeters will be used.
String

Return Value

LabelExplanationData Type
Output raster

The output point density raster.

It is always a floating point raster.

Raster

PointDensity(in_point_features, population_field, {cell_size}, {neighborhood}, {area_unit_scale_factor})
NameExplanationData Type
in_point_features

The input point features for which to calculate the density.

Feature Layer
population_field

Field denoting population values for each point. The population field is the count or quantity to be used in the calculation of a continuous surface.

Values in the population field can be integer or floating point.

The options and default behaviors for the field are listed below.

  • Use None if no item or special value will be used and each feature will be counted once.

  • You can use the Shape field if input features contain z-values.

  • Otherwise, the default field is POPULATION. The following conditions may also apply:

    • If there is no POPULATION field, but there is a POPULATIONabcd field, it will be used by default. The 'abcd' can be any valid characters, for example, POPULATION6, POPULATION1974, or POPULATIONROADTYPE.
    • If there is no POPULATION field or POPULATIONabcd field, but there is a POP field, the POP field will be used by default.
    • If there is no POPULATION field, POPULATIONabcd field, or POP field, but there is a POPabcd field, the POPabcd field will be used by default.
    • If there is no POPULATION field, POPULATIONabcd field, POP field, or POPabcd field, NONE will be used by default.
Field
cell_size
(Optional)

The cell size of the output raster that will be created.

This parameter can be defined by a numeric value or obtained from an existing raster dataset. If the cell size hasn't been explicitly specified as the parameter value, the environment cell size value will be used if specified; otherwise, additional rules will be used to calculate it from the other inputs. See the usage section for more detail.

Analysis Cell Size
neighborhood
(Optional)

Dictates the shape of the area around each cell used to calculate the density value.

This is a Neighborhood class.

There are four types of neighbourhood class: NbrAnnulus, NbrCircle, NbrRectangle, and NbrWedge.

The forms and descriptions of the classes are:

  • NbrAnnulus ({innerRadius}, {outerRadius}, {units})

    A torus (donut shaped) neighborhood defined by an inner radius and an outer radius.

  • NbrCircle ({radius}, {units})

    A circular neighborhood with the given radius.

  • NbrRectangle ({width}, {height}, {units})

    A rectangular neighborhood with the given width and height.

  • NbrWedge ({radius}, {startAngle}, {endAngle}, {units})

    A wedge (pie) shaped neighborhood. A wedge is specified by a start angle, an end angle, and a radius. The wedge extends counterclockwise from the starting angle to the ending angle. Angles are specified in arithmetic degrees (counterclockwise from the positive x-axis). Negative angles may be used.

  • {units}

    Defines the units as either the number of cells or as value in map units.

The default is NbrCircle, where radius is the shortest of the width or height of the output extent in the output spatial reference, divided by 30.

Neighborhood
area_unit_scale_factor
(Optional)

Specifies the area units that will be used for the output density values.

A default unit is determined based on the linear unit of the output spatial reference. You can change this to the appropriate unit to convert the density output. Values for line density convert the units of both length and area.

If no output spatial reference is specified, the output spatial reference will be the same as the input feature class. The default output density units are determined by the linear units of the output spatial reference . If the output linear units are meters, the output area density units will be set to Square kilometers, outputting square kilometers for point features or kilometers per square kilometers for polyline features. If the output linear units are feet, the output area density units will be set to Square miles.

If the output units are anything other than feet or meters, the output area density units will be set to Square map units. That is, the output density units will be the square of the linear units of the output spatial reference. For example, if the output linear units are centimeters, the output area density units will be Square map units, which will result in square centimeters. If the output linear units are kilometers, the output area density units will be Square map units, which will result in square kilometers.

The available options and their corresponding output density units are the following:

  • SQUARE_MAP_UNITSThe square of the linear units of the output spatial reference will be used.
  • SQUARE_MILESU.S. miles will be used.
  • SQUARE_KILOMETERSKilometers will be used.
  • ACRESU.S. acres will be used.
  • HECTARESHectares will be used.
  • SQUARE_YARDSU.S. yards will be used.
  • SQUARE_FEETU.S. feet will be used.
  • SQUARE_INCHESU.S. inches will be used.
  • SQUARE_METERSMeters will be used.
  • SQUARE_CENTIMETERSCentimeters will be used.
  • SQUARE_MILLIMETERSMillimeters will be used.
String

Return Value

NameExplanationData Type
out_raster

The output point density raster.

It is always a floating point raster.

Raster

Code sample

PointDensity example 1 (Python window)

This example calculates a density raster from a point shape file.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
pdensOut = PointDensity("rec_sites.shp", "NONE", 60, NbrCircle(2500, "MAP"))
pdensOut.save("C:/sapyexamples/output/pointdensity")
PointDensity example 2 (stand-alone script)

This example calculates a density raster from a point shape file.

# Name: PointDensity_Ex_02.py
# Description: Calculates a magnitude per unit area from point 
#    features that fall within a neighborhood around each cell.
# 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
inFeatures = "rec_sites.shp"
populationField = "NONE"
cellSize = 60

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

# Execute PointDensity
outPdens = PointDensity(inFeatures, populationField, cellSize, 
                        myNbrCirc, "SQUARE_KILOMETERS")

# Save the output 
outPdens.save("C:/sapyexamples/output/outpdens")

Related topics