ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Raster statistics (Environment setting)

  • Usage notes
  • Dialog syntax
  • Scripting syntax

Tools that honor the Raster Statistics environment control how statistics are built for output raster datasets.

The Statistics option enables you to build statistics for the output raster dataset. Statistics are required for the raster dataset to perform certain tasks in ArcMap or ArcCatalog, such as applying a contrast stretch or classifying data. It is not essential to build statistics, since they are calculated the first time they are needed, if they have not already been calculated. It is, however, recommended that you calculate statistics before using the raster dataset if certain features that require statistics are to be used.

Usage notes

  • Statistics are required for your raster dataset to perform certain tasks in the application, such as applying a contrast stretch or classifying your data.
  • It is recommended that you calculate statistics for your raster datasets before using them if you want to use certain features that require statistics.
  • The skip factor allows you to speed up the process of calculating statistics by skipping pixels.
  • The ignore values applies to the values that will not participate in the statistics calculation. Normally, you may want to ignore the values of the background.
  • The skip factors for raster datasets stored in a geodatabase are different. First, if the x and y skip factors are different, the smaller skip factor will be used for both the x and y skip factors. Second, the skip factor is related to the pyramid level that most closely fits the skip factor chosen. If the skip factor value is not equal to the number of pixels in a pyramid layer, the number is rounded down to the next pyramid level, and those statistics are used.
  • Refer to the Raster Storage Matrix to see which raster storage formats can be controlled when using this setting.

Dialog syntax

  • Calculate statistics—To calculate statistics, check the check box.
  • Statistics skip factor—Choose to skip pixels between samples.
    • X skip factor—The number of horizontal pixels between samples. The value must be greater than zero and less than or equal to the number of columns in the raster dataset. The default is 1 or the last skip factor used.
    • Y skip factor—The number of vertical pixels between samples. The value must be greater than zero and less than or equal to the number of rows in the raster dataset. The default is 1 or the last skip factor used.
  • Statistics ignore value—One or more ignore values, such as a background value, that will not participate in the statistics calculation. Multiple values are separated by a semicolon.

Scripting syntax

arcpy.env.rasterStatistics = "calculate_statistics {x_skip_factor} {y_skip_factor} {statistics_ignore_value}"

ParametersExplanation

calculate_statistics (Required)

To calculate statistics, use STATISTICS; otherwise, specify NONE.

x_skip_factor (Optional)

The skip factor for the X axis.

y_skip_factor (Optional)

The skip factor for the Y axis.

statistics_ignore_value (Optional)

One or more ignore values, such as a background value, that will not participate in the statistics calculation. Multiple values are separated by a space.

rasterStatistics syntax
import arcpy

# Statistics using a skip factor of 100 for x and y, and 
# ignore values of 0 and 255.
arcpy.env.rasterStatistics = 'STATISTICS 100 100 (0 255)'

Related Topics

  • An overview of raster storage settings
  • An overview of geoprocessing environments
  • Environment levels and hierarchy
  • Setting geoprocessing environments
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal