Get Raster Properties (Data Management)

Summary

Retrieves information from the metadata and descriptive statistics about a raster dataset.

Usage

• The property value returned is displayed in the Geoprocessing history item created by running the tool.

• The Python result of this tool is a geoprocessing Result object. In order to obtain the string value, use the Result object's getOutput method.

Parameters

Dialog

Label	Explanation	Data Type
Input Raster	The raster containing the properties to retrieve.	Composite Geodataset
Property type (Optional)	The property to be obtained from the input raster. Minimum cell value—Smallest value of all cells in the input raster. Maximum cell value—Largest value of all cells in the input raster. Mean of all cells—Average of all cells in the input raster. Standard Deviation of all cells—Standard deviation of all cells in the input raster. Unique value count—Number of unique values in the input raster. Maximum Y coordinate (top)—Top (maximum y-coordinate) value of the extent. Minimum X coordinate (left)—Left (minimum x-coordinate) value of the extent. Maximum X coordinate (right)—Right (maximum x-coordinate) value of the extent. Minimum Y coordinate (bottom)—Bottom (minimum y-coordinate) value of the extent. Cell size x-direction—Cell size in the x-direction. Cell size y-direction—Cell size in the y-direction. Cell value type—Type of the cell value in the input raster. Number of columns—Number of columns in the input raster. Number of rows—Number of rows in the input raster. Number of bands—Number of bands in the input raster. Contains NoData cells—Returns whether there is NoData in the raster. All cells contain NoData—Returns whether all the pixels are NoData. This is also known as ISNULL. Sensor name—Name of the sensor. Product name—Product name related to the sensor. Acquisition date—Date that the data was captured. Source type—Source type. Cloud cover—Amount of cloud cover as a percentage. Sun azimuth—Sun azimuth, in degrees. Sun elevation—Sun elevation, in degrees. Sensor azimuth—Sensor azimuth, in degrees. Sensor elevation—Sensor elevation, in degrees. Off nadir—Off-nadir angle, in degrees. Wavelength—Wavelength range of the band, in nanometers.	String
Band Name (Optional)	Choose the band name from the drop-down box. If no band is chosen, then the first band will be used.	String

Derived Output

Label	Explanation	Data Type
Property	Returns the property value that was specified.	Variant

Python

arcpy.management.GetRasterProperties(in_raster, {property_type}, {band_index})

Name	Explanation	Data Type
in_raster	The raster containing the properties to retrieve.	Composite Geodataset
property_type (Optional)	The property to be obtained from the input raster. MINIMUM—Smallest value of all cells in the input raster. MAXIMUM—Largest value of all cells in the input raster. MEAN—Average of all cells in the input raster. STD—Standard deviation of all cells in the input raster. UNIQUEVALUECOUNT—Number of unique values in the input raster. TOP—Top or YMax value of the extent. LEFT—Left or XMin value of the extent. RIGHT—Right or XMax value of the extent. BOTTOM—Bottom or YMin value of the extent. CELLSIZEX—Cell size in the x-direction. CELLSIZEY—Cell size in the y-direction. VALUETYPE—Type of the cell value in the input raster: 0 = 1-bit 1 = 2-bit 2 = 4-bit 3 = 8-bit unsigned integer 4 = 8-bit signed integer 5 = 16-bit unsigned integer 6 = 16-bit signed integer 7 = 32-bit unsigned integer 8 = 32-bit signed integer 9 = 32-bit floating point 10 = 64-bit double precision 11 = 8-bit complex 12 = 16-bit complex 13 = 32-bit complex 14 = 64-bit complex COLUMNCOUNT—Number of columns in the input raster. ROWCOUNT—Number of rows in the input raster. BANDCOUNT—Number of bands in the input raster. ANYNODATA—Returns whether there is NoData in the raster. ALLNODATA—Returns whether all the pixels are NoData. This is the same as ISNULL. SENSORNAME—Name of the sensor. PRODUCTNAME—Product name related to the sensor. ACQUISITIONDATE—Date that the data was captured. SOURCETYPE—Source type. CLOUDCOVER—Amount of cloud cover as a percentage. SUNAZIMUTH—Sun azimuth, in degrees. SUNELEVATION—Sun elevation, in degrees. SENSORAZIMUTH—Sensor azimuth, in degrees. SENSORELEVATION—Sensor elevation, in degrees. OFFNADIR—Off-nadir angle, in degrees. WAVELENGTH—Wavelength range of the band, in nanometers.	String
band_index (Optional)	Choose the band name from which to get the properties. If no band is chosen, then the first band will be used.	String

Derived Output

Name	Explanation	Data Type
property	Returns the property value that was specified.	Variant

Code sample

GetRasterProperties example 1 (Python window)

This is a Python sample for GetRasterProperties.

import arcpy
#Get the geoprocessing result object
elevSTDResult = arcpy.GetRasterProperties_management("c:/data/elevation", "STD")
#Get the elevation standard deviation value from geoprocessing result object
elevSTD = elevSTDResult.getOutput(0)

GetRasterProperties example 2 (stand-alone script)

This is a Python script sample for GetRasterProperties.

import arcpy
#Get the geoprocessing result object
elevSTDResult = arcpy.GetRasterProperties_management("c:/data/elevation", "STD")
#Get the elevation standard deviation value from geoprocessing result object
elevSTD = elevSTDResult.getOutput(0)

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: Yes
• Standard: Yes
• Advanced: Yes