查找参数统计信息 (影像分析工具)

汇总

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

用法

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

例如，您您可以查找在超过 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
参数值（可选）	将进行比较以提取维度值时达到的值。当统计类型参数设置为值参数时，需要使用此参数。	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 （可选）	将用于提取统计数据的时间单位。例如，您拥有五年的每日海面温度数据，且您希望知道观测到最高温度的年份。将 `statistics_type` 参数设置为 `ARGUMENT_MAX`，将 `dimension_def` 参数设置为 `INTERVAL_KEYWORD`，将 `interval_keyword` 参数设置为 `YEARLY`。或者，如果您想知道在哪个月份可以一直观测到最高温度，请将 `statistics_type` 参数设置为 `ARGUMENT_MAX`，将 `dimension_def` 参数设置为 `INTERVAL_KEYWORD`，并将 `interval_keyword` 参数设置为 `RECURRING_MONTHLY`。该操作将生成一个栅格，其中每个像素都包含五年记录中达到统计数据的月份（例如 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 （可选）	将进行比较以提取维度值时达到的值。当 `statistics_type` 参数设置为 `ARGUMENT_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 *

# 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 *

# 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"

# Run
# 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")

环境

像元大小, 压缩, 当前工作空间, 地理变换, NoData, 输出配置关键字, 输出坐标系, 范围, 并行处理因子, 金字塔, 栅格统计, 重采样方法, 临时工作空间, 捕捉栅格, 切片大小

许可信息

基本: 需要 Image Analyst
标准: 需要 Image Analyst
高级: 需要 Image Analyst

查找参数统计信息 (影像分析工具)

汇总

用法

参数

返回值

环境

许可信息

相关主题