计算统计数据 (Data Management)

许可等级:BasicStandardAdvanced

摘要

计算栅格数据集或镶嵌数据集的统计数据。

需要对栅格和镶嵌数据集进行统计方可执行诸如应用对比度拉伸或分类数据等任务。

用法

语法

CalculateStatistics_management (in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})
参数说明数据类型
in_raster_dataset

输入栅格数据集或镶嵌数据集。

Mosaic Dataset; Mosaic Layer; Raster Dataset
x_skip_factor
(可选)

样本之间水平像素的数量。

此值必须大于零,并且小于等于栅格数据集中的列数。默认值为 1 或者为上次使用的跳跃因子。

对于储存在文件地理数据库或 ArcSDE 地理数据库中的栅格数据集,它们的跳跃因子并不相同。首先,如果 x 和 y 跳跃因子不同,则使用两者中较小的一个来作为 x 和 y 共同的跳跃因子。其次,跳跃因子同与其最接近的金字塔等级相关联。如果跳跃因子不等于金字塔图层中像素的数量,则该数量向下舍入至下一个金字塔等级,并使用那些统计值。

Long
y_skip_factor
(可选)

样本之间垂直像素的数量。

此值必须大于零并小于等于栅格中的行数。默认值为 1 或者为上次使用的 y 跳跃因子。

对于储存在文件地理数据库或 ArcSDE 地理数据库中的栅格数据集,它们的跳跃因子并不相同。首先,如果 x 和 y 跳跃因子不同,则使用两者中较小的一个来作为 x 和 y 共同的跳跃因子。其次,跳跃因子同与其最接近的金字塔等级相关联。如果跳跃因子不等于金字塔图层中像素的数量,则该数量向下舍入至下一个金字塔等级,并使用那些统计值。

Long
ignore_values
[ignore_value,...]
(可选)

排除在统计值计算之外的像素值。

默认情况下没有值,或者是上次使用的忽略值。

Long
skip_existing
(可选)

指定在缺少统计数据的位置进行计算,还是重新计算全部统计数据(即使已经存在仍重新计算)。

  • OVERWRITE即使统计数据已经存在仍要重新计算。因此,现有统计数据将被覆盖。这是默认设置。
  • SKIP_EXISTING只有当统计数据不存在时才会计算统计数据。
Boolean
area_of_interest
(可选)

指定表示数据集中开始计算统计数据区域的要素类,这样,可避免从整个数据集生成统计数据。

Feature Set

代码实例

CalculateStatistics 示例 1(Python 窗口)

这是 CalculateStatistics 的 Python 示例。

import arcpy
arcpy.CalculateStatistics_management(
     "C:/data/image.tif", "5", "5", "0;255", 
     "SKIP_EXISTING", "c:/data/aoi.shp")
CalculateStatistics 示例 2(独立窗口)

这是 CalculateStatistics 的 Python 脚本示例。

# Calculate Statistics for single raster dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.CalculateStatistics_management("image.tif", "4", "6", "0;255;21")

环境

相关主题

许可信息

ArcGIS for Desktop Basic:是
ArcGIS for Desktop Standard:是
ArcGIS for Desktop Advanced:是
9/15/2013