Get Cell Value (Data Management)
Summary
Retrieves the pixel value at a specific x,y coordinate. For multiband raster datasets you can specify from which bands to retrieve the cell value. If you do not specify any bands, the pixel value for all the bands will be returned for the input location.
Usage
-
This tool is used when you need the pixel value for a geoprocessing model. In ArcMap, ArcScene, or ArcGlobe you can use the Identify tool instead.
Syntax
Parameter | Explanation | Data Type |
in_raster |
The input raster dataset. | Mosaic Dataset; Mosaic Layer; Raster Layer |
location_point |
Type the x and y coordinates of the pixel location. | Point |
band_index [band_index,...] (Optional) |
Define which bands for which you would like to get the pixel value. If you do not define any bands, a pixel value for all the bands in the x,y location will be returned. | Value Table |
Code Sample
This is a Python sample for the GetCellValue tool.
import arcpy
result = arcpy.GetCellValue_management("C:/data/rgb.img", "480785 3807335", "2;3")
cellSize = int(result.getOutput(0))
print cellSize
This is a Python script sample for the GetCellValue tool.
'''====================================
Get Cell Value
Usage: GetCellValue_management in_raster location_point {ID;ID...}
'''
try:
import arcpy
arcpy.env.workspace = "C:/Workspace"
# Get the Band_2 and Band_3 cell value of certain point in a RGB image
result = arcpy.GetCellValue_management("rgb.img", "480785 3807335", "2;3")
cellSize = int(result.getOutput(0))
# View the result in execution log
print cellSize
except:
print "Get Cell Value exsample failed."
print arcpy.GetMessages()