Skip to main content

Percentile

汇总

创建栅格对象，其中每个像素包含多个栅格中的指定百分位值。

讨论

栅格对象所引用的栅格数据集是临时性的。 要将其设置为永久，可以调用栅格对象的 save 方法。

语法

Percentile(rasters, {percentile_value}, {percentile_interpolation_type}, {extent_type}, {cellsize_type}, {ignore_nodata}, {process_as_multiband})

参数 说明 数据类型

rasters

The list of input rasters.

Raster

percentile_value

The percentile value to calculate.

(默认值为 90)

Double

percentile_interpolation_type

The interpolation method used when the specified percentile value lies between two input cell values.

  • AUTO_DETECT—If the input raster collection is integer type, the NEAREST method is used. If the input raster collection is floating point type, the LINEAR method is used.

  • NEAREST—The nearest available value to the specified percentile is used. The output pixel type will match the input.

  • LINEAR—The weighted average of the two surrounding percentile values is used. The output pixel type is floating point.

(默认值为 AUTO_DETECT)

String

extent_type

The method that will be used to compute the extent of the output when the input rasters have different extents.

  • FirstOf—The output extent will be defined using the extent of the first input raster.

  • LastOf—The output extent will be defined using the extent of the last input raster.

  • IntersectionOf—The output extent will be defined as the intersecting area of the input rasters.

  • UnionOf—The output extent will be defined as the total extent of the input rasters.

(默认值为 FirstOf)

String

cellsize_type

The method that will be used to compute the pixel size of the output when the input rasters have different pixel sizes.

  • FirstOf—The output pixel size will be defined using the pixel size of the first input raster.

  • LastOf—The output pixel size will be defined using the pixel size of the last input raster.

  • MaxOf—The output pixel size will be defined using the maximum pixel size of the input rasters.

  • MeanOf—The output pixel size will be defined using the mean of both input rasters.

  • MinOf—The output pixel size will be defined using the minimum pixel size of the input rasters.

(默认值为 FirstOf)

String

ignore_nodata

Specifies whether NoData values will be ignored in the calculation.

  • True—The analysis will include all valid pixels in the input rasters and ignore any NoData pixels.

  • False—The analysis will result in NoData if there are any NoData values for the pixels in the input rasters.

(默认值为 False)

Boolean

process_as_multiband

Specifies how the bands of the input rasters will be processed.

  • True—Each multiband raster will be processed as a multiband raster. The operation will be performed for each band from one input using the corresponding band number from other inputs.

  • False—Each band from a multiband raster input will be processed separately as a single-band raster.

(默认值为 False)

Boolean

返回值

数据类型 说明

Raster

输出栅格。

代码示例

百分位数示例

计算其中包含三个多波段栅格的第 90 个百分位值的栅格对象。

from arcpy.ia import *

rc = RasterCollection([landsat_1, landsat_2, landsat_3])

percentile_raster = Percentile(rc, percentile_value = 90, percentile_interpolation_type = "AUTO_DETECT", extent_type = "UnionOf", cellsize_type = "MinOf",
ignore_nodata = True, process_as_multiband = True)