查找参数统计信息 (Image Analyst)

获得 Image Analyst 许可后可用。

摘要

用于为多维或多波段栅格中的每个像素提取达到给定统计量的维度值或波段指数。

使用情况

  • 可使用查找参数统计信息工具提取在多维栅格数据集的栅格堆栈中达到特定统计数据的维度值(例如日期、高度或深度)。 或者,可以查找在多波段栅格中达到该统计数据的波段号。

    例如,您您可以查找在超过 30 年的数据采集过程中,每个像素达到最高海面温度的月份。 另一个例子是,您拥有一个八波段遥感图像,并且想知道每个像素达到最小反射率值的波段是什么。

  • 受支持的多维栅格数据集包括云栅格格式 (CRF)、多维镶嵌数据集或者由 netCDF、GRIB 或 HDF 格式文件生成的多维栅格图层。

  • 此工具可生成采用云栅格格式 (CRF) 的多维栅格数据集。 目前尚不支持其他输出格式。

  • 如果输入多维栅格仅包含一个维度,则输出将是单波段栅格数据集。 如果输入多维栅格包含多个维度,则输出多维栅格将包含分析中未包含的那些维度。

参数

标注说明数据类型
输入多维或多波段栅格

要分析的输入多维或多波段栅格。

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
维度
(可选)

将从中提取统计数据的维度。 如果输入栅格不是多维栅格,则不需要此参数。

String
维度定义
(可选)

指定如何从维度中提取统计数据。

  • 全部将跨所有维度提取统计数据。 这是默认设置。
  • 间隔关键字系统将根据间隔关键字从时间维度中提取统计数据。
String
关键字间隔
(可选)

将用于提取统计数据的时间单位。

例如,您拥有五年的每日海面温度数据,且您希望知道观测到最高温度的年份。 将统计类型设置为参数最大值,将维度定义设置为间隔关键字,并将关键字间隔设置为每年

或者,如果您想知道在哪个月份可以一直观测到最高温度,请将统计类型设置为参数最大值,将维度定义设置为间隔关键字,并将关键字间隔设置为每月循环。 该操作将生成一个栅格,其中每个像素都包含五年记录中达到统计数据的月份(例如 08/18/2018、08/25/2016、08/07/2013)。

维度参数设置为 StdTime维度定义参数设置为间隔关键字时,此参数为必需项。

  • 每天循环将跨天提取统计数据。
  • 每周循环将跨周提取统计数据。
  • 每月循环将跨月提取统计数据。
  • 每季度循环将跨季度提取统计数据。
  • 每小时将在达到统计数据的那一小时提取该统计数据。
  • 每天将在达到统计数据的那一天提取该统计数据。
  • 每周将在达到统计数据的那一周提取该统计数据。
  • 每月将在达到统计数据的那一月提取该统计数据。
  • 季度将在达到统计数据的那一季度提取该统计数据。
  • 每年将在达到统计数据的那一年提取该统计数据。
String
变量 [维度信息](描述)
(可选)

要分析的一个或多个变量。 如果输入栅格不是多维栅格,则系统会将多波段栅格的像素值视为变量。 如果输入栅格是多维栅格,且未指定任何变量,则系统将分析具有所选维度的全部变量。

例如,要查找温度值最高的年份,请将温度指定为要分析的变量。 如果您没有指定任何变量,并且您同时拥有温度和降水量变量,则将分析这两个变量,并且输出多维栅格将包含两个变量。

String
统计类型
(可选)

指定要沿给定维度从一个或多个变量中提取的统计数据。

  • 参数最小值将提取达到最小变量值时的维度值。 这是默认设置。
  • 参数最大值将提取达到最大变量值时的维度值。
  • 参数中值将提取达到变量中值时的维度值。
  • 持续时间将提取最小变量值和最大变量值之间的最长维度持续时间值。
  • 值参数将提取达到指定变量值时的维度值。
String
最小值
(可选)

用于提取持续时间的最小变量值。

统计类型参数设置为持续时间时,此参数为必需项。

Double
最大值
(可选)

用于提取持续时间的最大变量值。

统计类型参数设置为持续时间时,此参数为必需项。

Double
多次出现值
(可选)

用于表示输入栅格数据集中多次达到给定参数统计数据的像素值。 如果未指定,则像素值将为由出现参数指定的维度值(第一次或最后一次出现)。

Long
忽略 NoData
(可选)

指定分析中是否忽略 NoData 值。

  • 选中 - 分析将包括沿给定维度的所有有效像素,并忽略 NoData 像素。 这是默认设置。
  • 未选中 - 如果沿给定维度的像素包含 NoData 值,则分析结果将变为 NoData。
Boolean
参数值
(可选)

将用于执行比较以提取维度值的值。

统计类型参数设置为值参数时,此参数为必需项。

将用于执行比较以提取维度值的值。

当将 statistics_type 参数设置为 ARGUMENT_VALUE 时,此参数为必需项。

Long
比较
(可选)

指定将用于提取维度值的比较类型。

  • 等于提取的维度等于指定值。 这是默认设置。
  • 大于提取的维度大于指定值。
  • 小于提取的维度小于指定值。
String
出现
(可选)

指定是在第一次还是最后一次达到参数统计信息时返回维度值。

  • 第一次出现将在第一次达到参数统计信息时返回维度值。 这是默认设置。
  • 最后一次出现将在最后一次达到参数统计信息时返回维度值。
String

返回值

标注说明数据类型
输出栅格

输出栅格数据集。

Raster

FindArgumentStatistics(in_raster, {dimension}, {dimension_def}, {interval_keyword}, {variables}, {statistics_type}, {min}, {max}, {multiple_occurrence}, {ignore_nodata}, {value}, {comparison}, {occurrence})
名称说明数据类型
in_raster

要分析的输入多维或多波段栅格。

Raster Dataset; Raster Layer; Mosaic Dataset; Mosaic Layer; Image Service; File
dimension
(可选)

将从中提取统计数据的维度。 如果输入栅格不是多维栅格,则不需要此参数。

String
dimension_def
(可选)

指定如何从维度中提取统计数据。

  • ALL将跨所有维度提取统计数据。 这是默认设置。
  • INTERVAL_KEYWORD系统将根据间隔关键字从时间维度中提取统计数据。
String
interval_keyword
(可选)

将用于提取统计数据的时间单位。

例如,您拥有五年的每日海面温度数据,且您希望知道观测到最高温度的年份。 将统计类型设置为参数最大值,将维度定义设置为间隔关键字,并将关键字间隔设置为每年

或者,如果您想知道在哪个月份可以一直观测到最高温度,请将统计类型设置为参数最大值,将维度定义设置为间隔关键字,并将关键字间隔设置为每月循环。 该操作将生成一个栅格,其中每个像素都包含五年记录中达到统计数据的月份(例如 08/18/2018、08/25/2016、08/07/2013)。

dimension 参数设置为 StdTime 并且 dimension_def 参数设置为 INTERVAL_KEYWORD 时,此参数为必需项。

  • RECURRING_DAILY将跨天提取统计数据。
  • RECURRING_WEEKLY将跨周提取统计数据。
  • RECURRING_MONTHLY将跨月提取统计数据。
  • RECURRING_QUARTERLY将跨季度提取统计数据。
  • HOURLY将在达到统计数据的那一小时提取该统计数据。
  • DAILY将在达到统计数据的那一天提取该统计数据。
  • WEEKLY将在达到统计数据的那一周提取该统计数据。
  • MONTHLY将在达到统计数据的那一月提取该统计数据。
  • QUARTERLY将在达到统计数据的那一季度提取该统计数据。
  • YEARLY将在达到统计数据的那一年提取该统计数据。
String
variables
[variables,...]
(可选)

要分析的一个或多个变量。 如果输入栅格不是多维栅格,则系统会将多波段栅格的像素值视为变量。 如果输入栅格是多维栅格,且未指定任何变量,则系统将分析具有所选维度的全部变量。

例如,要查找温度值最高的年份,请将温度指定为要分析的变量。 如果您没有指定任何变量,并且您同时拥有温度和降水量变量,则将分析这两个变量,并且输出多维栅格将包含两个变量。

String
statistics_type
(可选)

指定要沿给定维度从一个或多个变量中提取的统计数据。

  • ARGUMENT_MIN将提取达到最小变量值时的维度值。 这是默认设置。
  • ARGUMENT_MAX将提取达到最大变量值时的维度值。
  • ARGUMENT_MEDIAN将提取达到变量中值时的维度值。
  • DURATION将提取最小变量值和最大变量值之间的最长维度持续时间值。
  • ARGUMENT_VALUE将提取达到指定变量值时的维度值。
String
min
(可选)

用于提取持续时间的最小变量值。

当将 statistics_type 参数设置为 DURATION 时,此参数为必需项。

Double
max
(可选)

用于提取持续时间的最大变量值。

当将 statistics_type 参数设置为 DURATION 时,此参数为必需项。

Double
multiple_occurrence
(可选)

用于表示输入栅格数据集中多次达到给定参数统计数据的像素值。 如果未指定,则像素值将为由 occurrence 参数指定的维度值,第一次或最后一次出现。

Long
ignore_nodata
(可选)

指定分析中是否忽略 NoData 值。

  • DATA分析将包括沿给定维度的所有有效像素,并忽略 NoData 像素。 这是默认设置。
  • NODATA如果沿给定维度的像素包含 NoData 值,则分析结果将变为 NoData。
Boolean
value
(可选)

将用于执行比较以提取维度值的值。

统计类型参数设置为值参数时,此参数为必需项。

Long
comparison
(可选)

指定将用于提取维度值的比较类型。

  • EQUAL_TO提取的维度等于指定值。 这是默认设置。
  • GREATER_THAN提取的维度大于指定值。
  • SMALLER_THAN提取的维度小于指定值。
String
occurrence
(可选)

指定是在第一次还是最后一次达到参数统计信息时返回维度值。

  • FIRST_OCCURRENCE将在第一次达到参数统计信息时返回维度值。 这是默认设置。
  • LAST_OCCURRENCE将在最后一次达到参数统计信息时返回维度值。
String

返回值

名称说明数据类型
out_raster

输出栅格数据集。

Raster

代码示例

FindArgumentStatistics 示例 1(Python 窗口)

本示例可查找时间序列多维栅格中的最小月降水量和温度值。 如果多次找到相同的最小值,则像素值将为 99999。

# Import system modules
import arcpy
from arcpy.ia import *

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# get the date when the minimal precipitation was observed in each year
# as well as the date when the minimal temperature was observed in each year
argStatOutput = FindArgumentStatistics("prcp_temp_time_series.crf", "StdTime", "INTERVAL_KEYWORD", "YEARLY",
	"prcp;temp", "ARGUMENT_MIN", None, None, 0, "DATA")
	
# Save output
argStatOutput.save("C:/data/yearly_min_temp_precip.crf")
FindArgumentStatistics 示例 2(独立脚本)

本示例可在多维栅格中找到盐度在 10 到 15 个测量单位之间的最长时间间隔。

# Import system modules
import arcpy
from arcpy.ia import *

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Define input parameters
inFile = "C:/data/salinity.crf"
dimensionName = "Time"
dimensiondef = "ALL"
intervalkeyword = ''
variables = "temp"
arg_statistics_type = "DURATION"
min_value = 20
max_value = 25
multiple_occurrances_value = None
ignore_nodata = "NODATA"

# Execute 
# get the number of continous slices that have temperature value between 20 and 25
argStatOutput = FindArgumentStatistics(inFile, dimensionName, dimensiondef, intervalkeyword,
	variables, arg_statistics_type, min_value, max_value, multiple_occurrances_value, ignore_nodata)
	
# Save output
argStatOutput.save("C:/data/arg_statistics_output2.crf")

相关主题