The mapping platform for your organization
A complete professional GIS
GIS in your enterprise
Tools to build location-aware apps
Free template maps and apps for your industry
Get apps and data for your organization
Calculates statistics for a raster dataset or a mosaic dataset.
Statistics are required for your raster and mosaic datasets to perform certain tasks, such as applying a contrast stretch or classifying your data.
UsageCalculating statistics allows ArcGIS applications to properly stretch and symbolize raster data for display.
A skip factor controls the portion of the raster that is used when calculating the statistics. The input value indicates the horizontal or vertical skip factor, where a value of 1 will use each pixel and a value of 2 will use every second pixel. The skip factor can only range from 1 to the number of columns/rows in the raster.
The skip factors for raster datasets stored in a file geodatabase or an enterprise geodatabase are quite 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 (for example, if the skip factor is 5 and the closest pyramid level is 4 x 4 pixels, which is level 2), the software will round down to the next pyramid level (in this case, 2) and use that value as the skip factor.
A skip factor is not used for all raster formats. The raster formats that will calculate statistics and take advantage of the skip factor include TIFF, IMG, NITF, DTED, RAW, ADRG, CIB, CADRG, DIGEST, GIS, LAN, CIT, COT, ERMapper, ENVI DAT, BIL, BIP, BSQ, and geodatabase.
When using this tool to calculate statistics on a mosaic dataset, the statistics are calculated for the top-level mosaicked image, not for every raster contained in the mosaic dataset.
Specifying a skip factor for a mosaic dataset is highly recommended as these datasets tend to be very large.
The Ignore Values option allows you to exclude a specific value from the calculation of statistics. You may want to ignore a value if it is a NoData value or if it will skew your calculation.
Calculating statistics on the Esri Grid and the RADARSAT2 formats always uses a skip factor of 1.
arcpy.management.CalculateStatistics(in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})Code sample CalculateStatistics example 1 (Python window)
This is a Python sample for CalculateStatistics.
import arcpy
arcpy.CalculateStatistics_management(
"C:/data/image.tif", "5", "5", "0;255",
"SKIP_EXISTING", "c:/data/aoi.shp")
CalculateStatistics example 2 (stand-alone script)
This is a Python script sample for CalculateStatistics.
# Calculate Statistics for single raster dataset
import arcpy
arcpy.env.workspace = "C:/Workspace"
arcpy.CalculateStatistics_management("image.tif", "4", "6", "0;255;21")
Environments
Licensing information
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4