值百分位等值线 (Spatial Analyst)—ArcGIS Pro

需要 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

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

名称	说明	数据类型
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

代码示例

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

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 *

## Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
 
## 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"
out_volueP_contour = "ValueP_CrimeDensity_Out.shp"
  
## Execute: Create Volume Percentile Contours  
ValueP_out_contours = ValuePercentileContours(in_surface_raster, 
                                              out_volueP_contour, 
                                              percentile_values,
                                              method, ignore_negative_values)

许可信息

Basic: 需要 Spatial Analyst
Standard: 需要 Spatial Analyst
Advanced: 需要 Spatial Analyst

摘要

插图

使用情况

参数

代码示例

环境

许可信息

相关主题

在本主题中