Set Raster Properties (Data Management)

License Level:BasicStandardAdvanced


Sets some properties on a raster dataset or mosaic dataset, such as data type, statistics, and nodata values.

Learn more about raster statistics and properties



SetRasterProperties_management (in_raster, {data_type}, {statistics}, {stats_file}, {nodata})
ParameterExplanationData Type

The input raster dataset or mosaic dataset.

Mosaic Layer ; Raster Layer

The type of data this dataset contains.

These settings control the symbology applied when these datasets are rendered.

  • GENERICThis is a raster that does not fit any other data source type. ArcGIS will try to use the most appropriate renderer to display this data.
  • ELEVATIONThe data is elevation data. A minimum-maximum stretch will be applied when displaying this data.
  • THEMATICThe data is categorical; therefore, no stretching will be used. This data should probably be displayed with the colormap or the unique value renderer.
  • PROCESSEDThe data has already been enhanced; therefore, no stretch will be applied when displaying this dataset.
[[band_index, min, max, mean, std_dev],...]

Enter the band number, minimum statistics value, maximum statistics value, mean statistics value, and standard deviation value.

Value Table

An XML file that contains the statistics. This file can be created by exporting the statistics from another raster or mosaic dataset.

[[band index, nodata_value],...]

Define values for each or all bands. Each band can have a unique NoData value defined, or the same value can be specified for all bands. If you want to define multiple NoData values for each band selection, use a space delimiter between each NoData value within the bands_for_nodata_value parameter.

Value Table

Code Sample

SetRasterProperties example 1 (Python window)

This is a Python sample for SetRasterProperties.

import arcpy
arcpy.SetRasterProperties_management("\\cpu\data\srtm.tif", "ELEVATION", 
                                     "1 50 400 5 28" , "#" , "#")
SetRasterProperties example 2 (stand-alone script)

This is a Python script sample for SetRasterProperties.

#Set raster dataset type and statistics

import arcpy
arcpy.env.workspace = "C:/Workspace"
arcpy.SetRasterProperties_management("srtmraster.tif", "ELEVATION", 
                                         "1 50 400 5 28", "#", "#")


Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes