Skip To Content

Get Cell Value


Retrieves the value of a given pixel using its x, y coordinates.


  • This tool is used when you need the pixel value for a geoprocessing model. In ArcGIS Pro, select the navigation button from the Map tab and click on a pixel. Values for each visible band will be returned.


GetCellValue_management (in_raster, location_point, {band_index})
ParameterExplanationData Type

The raster that you want to query.

Mosaic Dataset; Mosaic Layer; Raster Layer

The X and Y coordinates of the pixel location.


Specify the bands that you want to query. Leave blank to query all bands in a multiband dataset.

Value Table

Code sample

GetCellValue example 1 (Python window)

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))
GetCellValue example 2 (stand-alone script)

This is a Python script sample for the GetCellValue tool.

Get Cell Value
Usage: GetCellValue_management in_raster location_point {ID;ID...}
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

Licensing information

  • ArcGIS Desktop Basic: Yes
  • ArcGIS Desktop Standard: Yes
  • ArcGIS Desktop Advanced: Yes