值百分位等值线 (Spatial Analyst 工具)

汇总

通过对像元值进行排序、选择百分位阈值处的像元，并生成极端区域覆盖区，创建用于描绘栅格前 p% 的等值线。

了解值百分位等值线原理详情

插图

用法

百分位值可以是 0 到 100 之间的任意值。值 100 可能会导致空结果或无意义结果。值 0 返回整个有效覆盖区。
该工具按升序将像元按值排列，并返回前百分之 \(p\) 的栅格像元。基于排列好的像元值计算百分位阈值。该输出选择满足或超过阈值的像元。
输出等值线面的覆盖区表示指定百分位以上的极值总和占比所围成的区域。
如果阈值处有重复值，则将选择所有重复值。因此，相邻百分位可以会产生相同的阈值和输出等值线面。然而，该工具不会选择比指定百分位相关值低的值。
当指定多个百分位值时，输出面就会嵌套。最内侧面对应于最高值的区域，最外侧面则覆盖较小值的区域。
如果在局部比例下执行分析，且所使用的投影能准确保持距离与面积的正确性，则可为方法参数选择平面选项。

如果要在区域或大比例尺下执行分析（例如，使用 Web Mercator 或任何地理坐标系），则可使用测地线选项。此选项考虑了椭球体的曲率，并可以正确处理两极和国际日期变更线附近的数据。
如果未选中忽略负值参数，则该工具在计算时将包含负输入像元值。
输入表面栅格必须为单波段栅格。
如果目标是基于像元值的累积量创建面，则使用体积百分位等值线工具。
有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。

标注	说明	数据类型
输入表面栅格	将为之计算等值线面的输入栅格。这必须是连续栅格。输入栅格数据类型可以是整型，也可以是浮点型。	Raster Layer
输出等值线面	输出等值线面要素。该输出包括针对所有指定百分位值的等值线面。	Feature Class
百分位值（可选）	将为之计算等值线的百分位值。默认值为 90，表示 90%。取值范围为 0 到 100。	Double
方法（可选）	指定计算将基于平面（平地）还是测地线（椭球）方法。平面方法适用于保持正确距离和面积的投影中的局部区域。适用于覆盖诸如城市、县或面积较小的州等区域的分析。测地线方法可以产生更精确的结果，但会造成处理时间这一潜在成本增加。平面—将使用 2D 笛卡尔坐标系对投影平面执行计算。这是默认设置。测地线—通过将地球形状视为椭球体，在 3D 笛卡尔坐标系中执行计算。	String
忽略负值（可选）	指定在值百分位计算中是否忽略负值。选中—在百分位计算中将忽略负值。未选中—在百分位计算中将不忽略负值；它们将被包含在内。这是默认设置。	Boolean
平滑输出（可选）	确定将输出面平滑处理为更简单的形状，还是与输入栅格的像元边保持一致。选中—将面平滑处理为更简单的形状。面拥有最少线段数，同时尽可能接近原始栅格像元边，这就是平滑的实现方式。这是默认设置。未选中—面的边与输入栅格的像元边完全保持一致。使用此选项将生成的面要素类转换回栅格，会生成与原始栅格相同的栅格。	Boolean

ValuePercentileContours(in_surface_raster, out_contour_polygons, {percentile_values}, {method}, {ignore_negative_values}, {smooth_outputs})

名称	说明	数据类型
in_surface_raster	将为之计算等值线面的输入栅格。这必须是连续栅格。输入栅格数据类型可以是整型，也可以是浮点型。	Raster Layer
out_contour_polygons	输出等值线面要素。该输出包括针对所有指定百分位值的等值线面。	Feature Class
percentile_values [percentile_values,...] （可选）	将为之计算等值线的百分位值。默认值为 90，表示 90%。取值范围为 0 到 100。	Double
method （可选）	指定计算将基于平面（平地）还是测地线（椭球）方法。平面方法适用于保持正确距离和面积的投影中的局部区域。适用于覆盖诸如城市、县或面积较小的州等区域的分析。测地线方法可以产生更精确的结果，但会造成处理时间这一潜在成本增加。 `PLANAR`—将使用 2D 笛卡尔坐标系对投影平面执行计算。这是默认设置。 `GEODESIC`—通过将地球形状视为椭球体，在 3D 笛卡尔坐标系中执行计算。	String
ignore_negative_values （可选）	指定在值百分位计算中是否忽略负值。 `IGNORE_NEGATIVE_VALUES`—在百分位计算中将忽略负值。 `USE_ALL_VALUES`—在百分位计算中将不忽略负值；它们将被包含在内。这是默认设置。	Boolean
smooth_outputs （可选）	确定将输出面平滑处理为更简单的形状，还是与输入栅格的像元边保持一致。 `SMOOTH`—将面平滑处理为更简单的形状。面拥有最少线段数，同时尽可能接近原始栅格像元边，这就是平滑的实现方式。这是默认设置。 `NO_SMOOTH`—面的边与输入栅格的像元边完全保持一致。使用此选项将生成的面要素类转换回栅格，会生成与原始栅格相同的栅格。	Boolean

代码示例

ValuePercentileContours 示例 1（Python 窗口）

以下示例演示了在 Python 窗口中使用此工具。

import arcpy
from arcpy import env
from arcpy.sa import *

env.workspace = "C:/sapyexamples/data"
ValuePercentileContours("CrimeEventsDensity.tif", "ValP_CrimeDensity_Out.shp",
                        [50, 75, 90, 95, 99], method = "Planar",
                        ignore_negative_values = "USE_ALL_VALUES",
                        smooth_outputs="SMOOTH")

ValuePercentileContours 示例 2（独立脚本）

下面的示例演示了如何在独立 Python 脚本中使用此工具。

## Name: ValuePercentileContours_Ex_standalone.py
## Description: Identify different local intensity zones from density surface
## Requirements: Spatial Analyst extension

## Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

### Set environment settings
env.workspace = "C:/sapyexamples/data"
# To allow overwriting outputs change overwriteOutput option to True.
env.overwriteOutput = False

## Set local variables
in_surface_raster = "CrimeEventsDensity.tif"
percentile_values = [50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
smooth_outputs="SMOOTH"
out_volueP_contour = "ValueP_CrimeDensity_Out.shp"

## Run: Create Value Percentile Contours
ValueP_out_contours = ValuePercentileContours(in_surface_raster,
                                              out_volueP_contour,
                                              percentile_values,
                                              method, ignore_negative_values, smooth_outputs)

环境

自动提交, 当前工作空间, 默认输出 Z 值, 范围, 地理变换, M 分辨率, M 容差, 并行处理因子, 输出配置关键字, 输出坐标系, 输出包含 M 值, 输出包含 Z 值, 输出 M 值域, 输出 XY 值域, 输出 Z 值域, 临时工作空间, XY 分辨率, XY 容差, Z 分辨率, Z 容差

许可信息

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

值百分位等值线 (Spatial Analyst 工具)

汇总

插图

用法

参数

环境

许可信息

相关主题