Batch Calculate Statistics (Data Management)

License Level:BasicStandardAdvanced

Summary

Calculates statistics for multiple raster datasets.

Usage

Syntax

BatchCalculateStatistics_management (Input_Raster_Datasets, {Number_of_columns_to_skip}, {Number_of_rows_to_skip}, {Ignore_values}, {Skip_Existing})
ParameterExplanationData Type
Input_Raster_Datasets
[input_raster_dataset,...]

The input raster datasets.

Raster Dataset
Number_of_columns_to_skip
(Optional)

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.

The skip factors for raster datasets stored in a file geodatabase or an ArcSDE 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.

Long
Number_of_rows_to_skip
(Optional)

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. The default is 1 or the last y skip factor used.

The skip factors for raster datasets stored in a file geodatabase or an ArcSDE 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.

Long
Ignore_values
[ignore_value,...]
(Optional)

The pixel values that are not to be included in the statistics calculation.

The default is no value.

Double
Skip_Existing
(Optional)

Specify whether to calculate statistics only where they are missing or regenerate them even if they exist.

  • OVERWRITEStatistics will be calculated even if they already exist; therefore, existing statistics will be overwritten. This is the default.
  • SKIP_EXISTINGStatistics will only be calculated if they do not already exist.
Boolean

Code Sample

BatchCalculateStatistics example 1 (Python window)

This is a Python sample for BatchCalculateStatistics.

import arcpy
arcpy.BatchCalculateStatistics_management(
     "C:/data/img1.tif;C:/data/img2.jp2",
     "5", "5", "0;255", "SKEP_EXISTING")
BatchCalculateStatistics example 2 (stand-alone script)

This is a Python script sample for BatchCalculateStatistics.

#Calculate Statistics for multiple raster datasets with 
#multiple ignore values. 
#Skip datasets that already have the statistics.

import arcpy
arcpy.env.workspace = "C:/Workspace"

    
inras = "image1.tif;image2.img;fgdb.gdb/image3"
skipcol = "5"
skiprow = "5"
ignoreval = "0;255;21"
skipexist = "SKIP_EXISTING"

arcpy.BatchCalculateStatistics_management(
     inras, skipcol, skiprow, ignoreval,skipexist)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Yes
ArcGIS for Desktop Standard: Yes
ArcGIS for Desktop Advanced: Yes
11/18/2013