Raster to Point (Conversion)

Summary

Converts a raster dataset to point features.

Usage

  • For each cell of the input raster dataset, a point will be created in the output feature class. The points will be positioned at the centers of cells that they represent. The NoData cells will not be transformed into points.

  • The input raster can have any cell size and may be any valid raster dataset.

  • The Field parameter allows you to choose which attribute field of the input raster dataset will become an attribute in the output feature class. If a field is not specified, the cell values of the input raster (the VALUE field) will become a column with the heading Grid_code in the attribute table of the output feature class.

  • If Extent is specified in the environment setting and the lower-left corner of the output extent does not match any cell corner of the input raster, during processing, a shift of the cell alignment of the input raster will occur to match the specified extent. This shift will trigger a resampling of the input raster using the Nearest Neighbor method. Consequently, the output features will shift as well, and the resultant output features may not overlay the original input raster exactly. You can avoid this shift by using the input raster as the Snap Raster in the environment.

Parameters

LabelExplanationData Type
Input raster

The input raster dataset.

The raster can be integer or floating-point type.

Raster Layer
Output point features

The output feature class that will contain the converted points.

Feature Class
Field
(Optional)

The field to assign values from the cells in the input raster to the points in the output dataset.

It can be an integer, floating point, or string field.

Field

arcpy.conversion.RasterToPoint(in_raster, out_point_features, {raster_field})
NameExplanationData Type
in_raster

The input raster dataset.

The raster can be integer or floating-point type.

Raster Layer
out_point_features

The output feature class that will contain the converted points.

Feature Class
raster_field
(Optional)

The field to assign values from the cells in the input raster to the points in the output dataset.

It can be an integer, floating point, or string field.

Field

Code sample

RasterToPoint example (Python window)

Converts a raster dataset to point features.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.conversion.RasterToPoint("source.img", "c:/output/source.shp", "VALUE")
RasterToPoint example (stand-alone script)

Converts a raster dataset to point features.

# Name: RasterToPoint_Ex_02.py
# Description: Converts a raster dataset to point features.
# Requirements: None

# Import system modules
import arcpy

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

# Set local variables
inRaster = "source.img"
outPoint = "c:/output/source.shp"
field = "VALUE"

# Run RasterToPoint
arcpy.conversion.RasterToPoint(inRaster, outPoint, field)

Related topics