Raster To Point (Conversion)
Release 9.3 Last modified November 21, 2008	Print all topics in : "Tools"

Converts a raster dataset to point features.

Usage tips

Command line and Scripting

• 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 feature output is assumed to be a shapefile.

• The Field parameter allows you to choose which column in the raster dataset will become an attribute in the output point file. The column containing the cell values (VALUE) will become a column with the heading Grid_code in the attribute table of the output feature class.

• The following environments affect this tool: current workspace, scratch workspace, output coordinate system, and output extent.

Command line syntax
An overview of the Command Line window
RasterToPoint_conversion <in_raster> <out_point_features> {raster_field}

Parameter	Explanation	Data Type
<in_raster>	The input raster dataset. The raster can be integer or floating point.	Composite Geodataset
<out_point_features>	The output feature class that will contain the converted points.	Feature Class
{raster_field}	The field to assign values from the cells in the input raster to the point features in the output dataset. It can be an integer, floating-point, or string field.	Field

Data types for geoprocessing tool parameters

Command line example

RasterToPoint_conversion buildings.tif building_locations Values

Scripting syntax
About getting started with writing geoprocessing scripts
RasterToPoint_conversion (in_raster, out_point_features, raster_field)

Parameter	Explanation	Data Type
in_raster (Required)	The input raster dataset. The raster can be integer or floating point.	Composite Geodataset
out_point_features (Required)	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 point features in the output dataset. It can be an integer, floating-point, or string field.	Field

Data types for geoprocessing tool parameters

Script example

# RasterToPoint_sample.py
# Description: 
#   Converts a raster to point features.
# Requirements: None
# Author: ESRI
# Date: Oct 20, 2005
# Import system modules
import arcgisscripting

# Create the Geoprocessor object
gp = arcgisscripting.create()

try:
    # Set local variables
    InRaster = "C:/data/raster1"
    OutPointFeatures = "C:/data/raster2point.shp"

    # Process: RasterToPoint_conversion
    gp.RasterToPoint_conversion(InRaster, OutPointFeatures)

except:
    # Print error message if an error occurs
    print gp.GetMessages()

Map Algebra syntax
See GridPointShape.

The Spatial Analyst extension must be present to use this link.

ArcObjects syntax
See RasterDataToPointFeatureData.

The Spatial Analyst extension must be present to use this link.

Please visit the Feedback page to comment or give suggestions on ArcGIS Desktop Help.
Copyright © Environmental Systems Research Institute, Inc.