Python ArcGIS find_argument_statistics用法及代码示例

本文简要介绍 python 语言中 arcgis.raster.analytics.find_argument_statistics 的用法。

用法:

arcgis.raster.analytics.find_argument_statistics(input_raster, dimension=None, dimension_definition='ALL', interval_keyword=None, variables=None, statistics_type='ARGUMENT_MIN', min_value=None, max_value=None, multiple_occurrence_value=None, ignore_nodata=True, output_name=None, context=None, argument_value=None, comparison='EQUAL_TO', occurrence='FIRST_OCCURRENCE', *, gis=None, future=False, **kwargs)

返回：

output_raster：影像图层项目

提取在多维栅格中为每个像素获得给定统计信息的维度值。 ArcGIS Image Server 10.8 及更高版本中可用的函数。

Parameter	Description
input_raster	必需的 ImageryLayer 对象。输入栅格。传送门物品可以通过。
dimension	必需的字符串。从中提取统计信息的维度。如果输入栅格不是多维栅格，则不需要此参数。
dimension_definition	必需的字符串。指定将分析数据的维度间隔。 ALL：将跨所有切片分析数据值。这是默认设置。 INTERVAL_KEYWORD：变量数据将使用众所周知的区间进行分析。 例子： ‘ALL’
interval_keyword	必需的字符串。指定沿维度分析时将使用的关键字区间。当dimension_definition参数设置为INTERVAL_KEYWORD时需要该参数，并且分析必须是跨时间的。 可能的选项：每小时、每天、每周、每月、每季度、每年、RECURRING_DAILY、RECURRING_WEEKLY、RECURRING_MONTHLY、RECURRING_QUARTERLY
variables	可选列表。要分析的一个或多个变量。如果输入栅格不是多维的，则将多波段栅格的像素值视为变量。如果输入栅格是多维的且未指定变量，则将分析具有选定维度的所有变量。 例如，要查找温度值最高的年份，请将温度指定为要分析的变量。如果您未指定任何变量并且同时具有温度和降水变量，则将对这两个变量进行分析，并且输出多维栅格将包含这两个变量。
statistics_type	可选字符串。指定要从给定维度上的一个或多个变量中提取的统计信息。 ARGUMENT_MIN：将提取达到最小变量值的维度值。这是默认设置。 ARGUMENT_MAX：将提取达到最大变量值的维度值。 ARGUMENT_MEDIAN：将提取达到中间变量值的维度值。 DURATION：变量值介于最小值和最大值之间的最长维度持续时间。 ARGUMENT_VALUE：将提取达到指定变量值的尺寸值。
min_value	可选浮点数。用于提取持续时间的最小变量值。 当statistics_type 参数设置为 DURATION 时需要此参数。
max_value	可选浮点数。用于提取持续时间的最大变量值。
multiple_occurrence_value	可选整数。指定用于指示在输入栅格数据集中多次达到给定参数统计信息的像素值。如果未指定，像素值将是第一次达到参数统计时的维度值。
ignore_nodata	可选布尔值。指定在分析中是否忽略 NoData 值。 True：分析将包括沿给定维度的所有有效像素，并忽略任何 NoData 像素。这是默认设置。 错误：如果沿给定维度的像素有任何 NoData 值，则分析将导致 NoData。
output_name	可选字符串。如果未提供，则由该方法创建影像服务并将其用作输出栅格。您可以从 GIS 中传入现有的影像服务项目来使用它。 或者，您可以传入应通过此方法创建的输出图像服务的名称，以用作工具的输出。 如果该名称的服务已经存在，则会引发 RuntimeError
context	context 包含影响任务执行的其他设置。 context 参数覆盖通过arcgis.env 参数设置的值 此函数具有以下设置： Extent(范围)：定义分析区域的边界框。 例子： {“extent”: {“xmin”: -122.68, “ymin”: 45.53, “xmax”: -122.45, “ymax”: 45.6, “spatialReference”: {“wkid”: 4326}}} 输出空间参考 (outSR)：输出栅格将投影到输出空间参考中。 例子： {“outSR”: {spatial reference}} 捕捉栅格 (snapRaster)：输出栅格的像元将与指定的捕捉栅格对齐。 例子： {‘snapRaster’: {‘url’: ‘<image_service_url>’}} 像元大小(cellSize)：输出栅格将具有由像元大小指定的分辨率。 例子： {‘cellSize’: 11} or {‘cellSize’: {‘url’: <image_service_url>}} or {‘cellSize’: ‘MaxOfIn’} 并行处理因子(parallelProcessingFactor)：控制光栅处理(CPU)服务实例。 例子： 具有指定数量的处理实例的语法示例： {“parallelProcessingFactor”: “2”} 具有指定百分比的总处理实例的语法示例： {“parallelProcessingFactor”: “60%”}
argument_value	可选整数。将进行比较以提取尺寸值的值。当statistics_type参数设置为ARGUMENT_VALUE时，需要此参数。 注意： 该参数目前仅在ArcGIS在线上可用。
comparison	可选字符串。指定将用于提取维度值的比较类型。 EQUAL_TO：提取的维度等于指定值。这是默认设置。 GREATER_THAN：提取的维度大于指定值。 SMALLER_THAN：提取的维度小于指定值。 注意： 该参数目前仅在ArcGIS在线上可用。
occurrence	可选字符串。指定是第一次还是最后一次达到参数统计量时返回维度值。 FIRST_OCCURRENCE：第一次达到参数统计量时将返回维度的值。这是默认设置。 LAST_OCCURRENCE：将返回最后一次达到参数统计量时的维度值。 注意： 该参数目前仅在ArcGIS在线上可用。
gis	仅关键字参数。可选的 GIS 对象。运行该工具的 GIS。如果未指定，则使用活动 GIS。
future	仅关键字参数。可选布尔值。如果为 True，则结果将是一个 GPJob 对象，并且结果将异步返回。
folder	仅关键字参数。可选的 str 或 dict。使用给定的文件夹名称在门户中创建一个文件夹(如果不存在)，并将输出保留在此文件夹中。 create_folder() 返回的字典也可以作为输入传入。 例子： {‘username’: ‘user1’, ‘id’: ‘6a3b77c187514ef7873ba73338cf1af8’, ‘title’: ‘trial’}
tiles_only	仅关键字参数。可选的布尔值。在ArcGIS Online 中，此函数的默认输出影像服务将是平铺影像图层。 要在 ArcGIS Online 上创建动态影像图层作为输出，请将 tiles_only 参数设置为 False。 函数将不支持ArcGIS Enterprise 中的tiles_only 参数，默认情况下会生成动态影像图层。

示例 1：

# Usage Example 1: This example finds the minimum precipitation and temperature values across a time series multidimensional raster.
# If the same minimum value is found multiple times, the pixel value will be 99999.

arg_stat_output = arcgis.raster.analytics.find_argument_statistics(input_raster=input_layer,
                                                                          dimension="StdTime",
                                                                          variables=["precip","temp"],
                                                                          statistics_type='ARGUMENT_MIN',
                                                                          multiple_occurrence_value=99999,
                                                                          ignore_nodata=True,
                                                                          output_name="arg_stat_output",
                                                                          gis=gis,
                                                                          folder="find_argument_statistics")

示例 2：

# Usage Example 2: This example finds the longest time interval for which salinity fell between 10 and 15 units of measurement in the multidimensional raster.

arg_stat_output = find_argument_statistics(input_raster=input_layer,
                                           dimension="StdTime",
                                           variables=["salinity"],
                                           statistics_type='DURATION',
                                           min_value=10,
                                           max_value=15,
                                           ignore_nodata=True,
                                           output_name="arg_stat_output",
                                           gis=gis,
                                           folder={'username': 'user1', 'id': '6a3b77c187514ef7873ba73338cf1af8', 'title': 'trial'})