Set Raster Properties (Data Management)

Summary

Sets the data type, statistics, and NoData values on a raster or mosaic dataset.

Usage

• This tool allows you to define the statistics for a raster or mosaic dataset. Typically, you use this tool if you do not want them calculated for you. Statistics you can set are the minimum, maximum, standard deviation, and mean values for each band. These statistics can be read from an XML file.

• The properties that can be set with this tool determine the default rendering settings in ArcGIS Pro, as well as statistics that are used by other tools.

  Properties you can set include:

  • Data Source Type: this defines whether the cell values represent elevation or categorical data, or whether the values have been processed by other methods and do not require stretching when displaying the data.
  • Statistics Per Band: for each band, you can define minimum, maximum, mean, and standard deviation values.
  • Bands for NoData Value: for each band, you can define a No Data value.

Parameters

Dialog

Label	Explanation	Data Type
Input Raster	The raster or mosaic dataset whose properties you want to set.	Mosaic Layer ; Raster Layer
Data Source Type (Optional)	The type of imagery in the mosaic dataset. Generic — The mosaic dataset does not have a specified data type. Elevation — The mosaic dataset contains elevation data. Thematic —Thematic data has discrete values, such as land cover. Scientific —The data has scientific information, and will be displayed with the blue to red color ramp, by default. Vector UV —The data is a two band raster that contains a U and a V component of vector field data. Magnitude and Direction —The data is a two band raster that contains the magnitude and direction of vector field data. Processed —The mosaic dataset has been color balanced.	String
Statistics Per Band (Optional)	Specify the bands and values for the minimum, maximum, mean, and standard deviation.	Value Table
Import Statistics From File (Optional)	An .xml file that contains the statistics.	File
Bands for NoData Value (Optional)	Specify the NoData value for each band. Each band can have a unique NoData value defined, or the same value can be specified for all bands. Choose the band from the NoData drop-down arrow and click the Add button to add this to the table. Then enter a value or multiple values. If you choose multiple NoData values, separate each value with a space.	Value Table
Key Properties (Optional)	The natively supported properties are as follows. Your data may have additional properties not included in this list. All properties are case insensitive. AcquisitionDate BandName BlockName CloudCover DatasetTag Dimensions FlowDirection Footprint HighCellSize LowCellSize MinCellSize MaxCellSize OffNadir ParentRasterType ParentTemplate PerspectiveX PerspectiveY PerspectiveZ ProductName RadianceBias RadianceGain ReflectanceBias RefelctanceGain Segmented SensorAzimuth SensorElevation SensorName SolarIrradiance SourceBandIndex StdPressure StdPressure_Max StdTemperature StdTemperature_Max StdTime StdTime_Max StdZ StdZ_max SunAzimuth SunElevation ThermalConstant_K1 ThermalConstant_K2 Variable VerticalAccuracy WavelengthMin WavelengthMax	Value Table

Derived Output

Label	Explanation	Data Type
Updated Raster Dataset	The output raster dataset.	Raster Dataset

Python

arcpy.management.SetRasterProperties(in_raster, {data_type}, {statistics}, {stats_file}, {nodata}, {key_properties})

Name	Explanation	Data Type
in_raster	The raster or mosaic dataset whose properties you want to set.	Mosaic Layer ; Raster Layer
data_type (Optional)	The type of imagery in the mosaic dataset. GENERIC — The mosaic dataset does not have a specified data type. ELEVATION — The mosaic dataset contains elevation data. THEMATIC —Thematic data has discrete values, such as land cover. PROCESSED —The mosaic dataset has been color balanced. SCIENTIFIC —The data has scientific information, and will be displayed with the blue to red color ramp, by default. VECTOR_UV —The data is a two band raster that contains a U and a V component of vector field data. VECTOR_MAGDIR —The data is a two band raster that contains the magnitude and direction of vector field data.	String
statistics [[band_index, min, max, mean, std_dev],...] (Optional)	Specify the bands and values for the minimum, maximum, mean, and standard deviation.	Value Table
stats_file (Optional)	An .xml file that contains the statistics.	File
nodata [[band index, nodata_value],...] (Optional)	Specify the NoData value for each band. 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
key_properties [key_properties,...] (Optional)	The natively supported properties are as follows. Your data may have additional properties not included in this list. All properties are case insensitive. AcquisitionDate BandName BlockName CloudCover DatasetTag Dimensions FlowDirection Footprint HighCellSize LowCellSize MinCellSize MaxCellSize OffNadir ParentRasterType ParentTemplate PerspectiveX PerspectiveY PerspectiveZ ProductName RadianceBias RadianceGain ReflectanceBias RefelctanceGain Segmented SensorAzimuth SensorElevation SensorName SolarIrradiance SourceBandIndex StdPressure StdPressure_Max StdTemperature StdTemperature_Max StdTime StdTime_Max StdZ StdZ_max SunAzimuth SunElevation ThermalConstant_K1 ThermalConstant_K2 Variable VerticalAccuracy WavelengthMin WavelengthMax	Value Table

Derived Output

Name	Explanation	Data Type
out_raster	The output raster dataset.	Raster Dataset

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", "#", "#")

Environments

Current Workspace, Scratch Workspace

Licensing information

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