Percentile

摘要

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

说明

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

语法

Percentile (rasters, {percentile_values}, {percentile_interpolation_type}, {extent_type}, {cellsize_type}, {ignore_nodata}, {process_as_multiband})
参数说明数据类型
rasters
[rasters,...]

The list of input rasters.

Raster
percentile_values

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_DETECTIf 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.
  • NEARESTThe nearest available value to the specified percentile is used. The output pixel type will match the input.
  • LINEARThe 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.

  • FirstOfThe output extent is defined using the extent of the first input raster.
  • LastOfThe output extent is defined using the extent of the last input raster.
  • IntersectionOfThe output extent is defined as the intersecting area of the input rasters.
  • UnionOfThe output extent is 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.

  • FirstOfThe output pixel size is defined using the pixel size of the first input raster.
  • LastOfThe output pixel size is defined using the pixel size of the last input raster.
  • MaxOfThe output pixel size is defined using the maximum pixel size of the input rasters.
  • MeanOfThe output pixel size is defined using the mean of both input rasters.
  • MinOfThe output pixel size is defined using the minimum pixel size of the input rasters.

(默认值为 FirstOf)

String
ignore_nodata

Specifies whether to ignore NoData values 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 are 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)