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.
Syntax
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 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
from arcpy import env
env.workspace = "C:/data"
arcpy.RasterToPoint_conversion("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
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inRaster = "source.img"
outPoint = "c:/output/source.shp"
field = "VALUE"
# Execute RasterToPoint
arcpy.RasterToPoint_conversion(inRaster, outPoint, field)
Environments
- Auto Commit
- Current Workspace
- Default Output Z Value
- Extent
- Geographic Transformations
- M Resolution
- M Tolerance
- Maintain Spatial Index
- Output CONFIG Keyword
- Output Coordinate System
- Output has M values
- Output has Z values
- Output M Domain
- Output XY Domain
- Output Z Domain
- Scratch Workspace
- Snap Raster
- XY Resolution
- XY Tolerance
- Z Resolution
- Z Tolerance
Licensing information
- ArcGIS for Desktop Basic: Yes
- ArcGIS for Desktop Standard: Yes
- ArcGIS for Desktop Advanced: Yes