| 标注 | 说明 | 数据类型 |
输入表面栅格 | 将为之计算等值线面的输入栅格。 这必须是连续栅格。 输入栅格数据类型可以是整型，也可以是浮点型。 | Raster Layer |
输出等值线面 | 输出等值线面要素。 该输出包括针对所有指定百分位值的等值线面。 | Feature Class |
百分位值 (可选) | 将为之计算等值线的百分位值。 默认值为 90，指示 90%。 取值范围为 0 到 100。 | Double |
方法 (可选) | 指定计算将基于平面（平地）还是测地线（椭球）方法。 平面方法适用于保持正确距离和面积的投影中的局部区域。 适用于覆盖诸如城市、县或面积较小的州等区域的分析。 测地线方法可以产生更精确的结果，但会造成处理时间这一潜在成本增加。
| String |
忽略负值 (可选) | 指定在体积百分位计算中是否忽略负值。
| Boolean |
需要 Spatial Analyst 许可。
插图
使用情况
百分位值可以是 0 到 100 之间的任意值。 值 0 可能会导致空结果或无意义结果。 值 100 返回整个有效覆盖区。
该工具按降序对像元值进行排列，并累积每个像元体积（体积 x 像元面积），直到累积的总体达到栅格总体积的百分之 p。 该面积使用平面或测地线的方法参数值来计算。 百分位体积阈值就是截断点处的值。 该输出选择满足或超过此阈值的像元。
输出等值线面内所围成的区域表示使用该百分位值计算的体积总和百分比所围成的区域。 该输出面的区域表示物理覆盖区；它不等于体积，而是百分之 p 的体积所在的区域。
如果体积阈值处存在重复值，则该工具将包含该阈值处的所有值。 因此，输出体积将不会低于指定百分位。 这将导致相邻百分位的结果可能相似。
当指定多个百分位值时，输出面就会嵌套。 最内侧面对应于最高值的区域，最外侧面则覆盖较小值的区域。
面的形状区域表示该极端区域内所涵盖的地面范围大小。
如果在局部比例下执行分析，且所使用的投影能准确保持距离与面积的正确性，则可为方法参数选择平面选项。
如果要在区域或大比例尺下执行分析（例如，使用 Web Mercator 或任何地理坐标系），则可使用测地线选项。 此选项考虑了椭球体的曲率，并可以正确处理两极和国际日期变更线附近的数据。
如果未选中忽略负值参数，则该工具在分析时将包含负输入像元值。 这可能会影响体积计算的累积总和。
输入表面栅格必须为单波段栅格。
如果目标是仅仅基于已排序的像元值创建面，则改为使用值百分位等值线工具。
有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 Spatial Analyst。
参数
VolumePercentileContours(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 (可选) | 指定计算将基于平面（平地）还是测地线（椭球）方法。 平面方法适用于保持正确距离和面积的投影中的局部区域。 适用于覆盖诸如城市、县或面积较小的州等区域的分析。 测地线方法可以产生更精确的结果，但会造成处理时间这一潜在成本增加。
| String |
ignore_negative_values (可选) | 指定在体积百分位计算中是否忽略负值。
| Boolean |
代码示例
以下示例演示了在 Python 窗口中使用此工具。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
VolumePercentileContours("CrimeEventsDensity.tif", "VolP_CrimeDensity_Out.shp",
[50, 75, 90, 95, 99], method = "Planar",
ignore_negative_values = "USE_ALL_VALUES")以下示例演示了在独立 Python 脚本中使用此工具。
## Name: VolumePercentileContours_Ex_standalone.py
## Description: Delineate areas of different magnitudes 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 = [25, 50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
out_volP_contour = "VolumeP_CrimeDensity_Out.shp"
## Execute: Create Volume Percentile Contours
VolumP_out_contours = VolumePercentileContours(in_surface_raster,
out_volP_contour,
percentile_values, method,
ignore_negative_values)环境
许可信息
- Basic: 需要 Spatial Analyst
- Standard: 需要 Spatial Analyst
- Advanced: 需要 Spatial Analyst