ArgStatistics 函数

概览

ArgStatistics 函数用于计算统计数据的参数。此函数中存在四种 ArgStatistics 方法:ArgMax、ArgMin、ArgMedian 和 Duration。

备注

如下表所示,在 ArgStatistics 中,会将基于 0 的增量波段索引分配到每个输入栅格的所有栅格波段,该增量波段索引首先按输入栅格索引排序,然后在每个输入栅格内按相关波段顺序排序。例如,如果第一个输入栅格(输入索引 0)具有 2 个波段:b11 和 b12,第二个输入栅格(输入索引 1)具有 4 个波段:b21、b22、b23 和 b24,则波段索引将如下表所示:

波段输入索引波段索引

b11

0

0

b12

0

1

b21

1

2

b22

1

3

b23

1

4

b24

1

5

然后,对于每个像素,ArgMax 函数返回达到最大 Pixel value 时对应的 Band index。例如,在下表中,最大像素值为 189,该值存储在 Band b21 中,其中 band index 为 2。因此,ArgMax 函数返回的值为 2。

波段波段索引像素值

b11

0

33

b12

1

54

b21

2

189

b22

3

145

b23

4

34

b24

5

28

ArgMin 是参数最小值,返回给定像素获得其最小值所对应的Band index。例如,在上表中,最小 Pixel value 为 28,该值存储在 Band b24 中,其中 Band index 为 5。因此,ArgMin 函数返回的值为 5。

ArgMedian 方法返回Band index,给定像素为此获得所有波段值的中值。将所有波段值视为一个数组。将数组按升序排序后,中值是分隔下半部分数组和上半部分数组的一个值。更具体地说,如果升序排列的数组有 n 个值,中值是第 i 个(基于 0)值:

i = ( (n-1) / 2 )

例如,如下表所示,按像素值的升序排序上表。中值为 34,且 ArgMedian 将返回Band index 4。

波段波段索引像素值

b24

5

28

b11

0

33

b23

4

34

b12

1

54

b22

3

145

b21

2

189

Duration 方法可在数组中找到最长的连续元素(每个元素的值都大于或等于 Min 并小于或等于 Max),并返回其长度。Duration 方法需要 MinMax 输入值。

例如,在上表中,给出的最长连续元素为 Min=34 且 Max=189 的 [34, 54, 145, 189],所以持续时间是 4。

参数

参数描述

方法

请选择用于计算以下值的统计数据方法:

  • Arg 最大值 - 参数最大值,返回给定像素从所有波段中获得其最小值所对应的Band index。会将基于 0 的增量波段索引分配到每个输入栅格的所有栅格波段,该增量波段索引首先按输入栅格索引排序,然后在每个输入栅格内按相关波段顺序排序。
  • Arg 最小值 - 参数最小值,返回给定像素从所有波段中获得其最小值所对应的Band index
  • Arg 中值 - 参数中值,返回给定像素从所有波段值中获得的中值所对应的Band index
  • Duration - Duration 方法可在数组中找到最长的连续元素(每个元素的值都大于或等于 Min 并小于或等于 Max),并返回其长度。

未定义类

当无法获得任何明确的最大值、最小值或中值时,将要返回的常量输入。最常见的情景是,在所有波段值中,最大值或最小值出现多于一次。未定义常数的默认值为 100。

当方法是 ArgMaxArgMinArgMedian 时,未定义类才适用。

Min

您设置的最小值是等于或大于持续时间开始值的最低值。

此输入仅在方法为 Duration 时适用。

Max

您设置的最大值是等于或小于持续时间结束值的最高值。

此输入仅在方法为 Duration 时适用。

输入栅格

您执行各种统计方法所依据的输入栅格。

索引

此函数中存在两种索引类型:栅格索引和波段索引。输入索引追踪每个栅格输入,其中输入索引相同的行对应的栅格相同。由于栅格可以有多个波段,因此可能有多个行对应相同的栅格索引。波段索引跟踪每个输入波段。每个波段索引都是唯一的并且不能有所重复。

参数描述

栅格

您执行各种统计方法所依据的输入栅格。

方法

请选择用于计算以下值的统计数据方法:

  • Arg 最大值 - 参数最大值,返回给定像素从所有波段中获得其最小值所对应的Band index。会将基于 0 的增量波段索引分配到每个输入栅格的所有栅格波段,该增量波段索引首先按输入栅格索引排序,然后在每个输入栅格内按相关波段顺序排序。
  • Arg 最小值 - 参数最小值,返回给定像素从所有波段中获得其最小值所对应的Band index
  • Arg 中值 - 参数中值,返回给定像素从所有波段值中获得的中值所对应的Band index
  • Duration - Duration 方法可在数组中找到最长的连续元素(每个元素的值都大于或等于 Min 并小于或等于 Max),并返回其长度。

未定义类

当无法获得任何明确的最大值、最小值或中值时,将要返回的常量输入。最常见的情景是,在所有波段值中,最大值或最小值出现多于一次。未定义常数的默认值为 100。

当方法是 ArgMaxArgMinArgMedian 时,未定义类才适用。

Min

您设置的最小值是等于或大于持续时间开始值的最低值。

此输入仅在方法为 Duration 时适用。

Max

您设置的最大值是等于或小于持续时间结束值的最高值。

此输入仅在方法为 Duration 时适用。

在计算中忽略 NoData

指示在进行统计计算时是否忽略 NoData 值。

  • 已选中 - 分析将包括输入栅格中的所有有效像素,并忽略所有 NoData 像素。
  • 未选中 - 如果输入栅格中存在包含 NoData 值的像素,则分析结果将变为 NoData。这是默认设置。

相关主题


在本主题中
  1. 概览
  2. 备注
  3. 参数