| 标注 | 说明 | 数据类型 |
输入栅格 | 将处理此栅格。 | Raster Layer; Mosaic Layer |
输出要素类 | 将生成的要素类。 | Feature Class |
输出 VIP 表 (可选) | 在为细化方法参数指定 VIP 直方图时，将创建的直方图表格。 在为 method 参数指定 VIP_HISTOGRAM 时，将创建的直方图表格。 | Table |
细化方法 (可选) | 指定要应用于输入栅格的细化方法，以选择要导出至多点要素类的像元的子集。
| String |
核方法 (可选) | 指定在输入栅格应用核细化时在每个核邻域中使用的选择方法。
| String |
Z 因子 (可选) | Z 值将乘上的系数。 此值通常用于转换 z 线性单位来匹配 x,y 线性单位。 默认值为 1，此时高程值保持不变。 如果输入表面的空间参考具有已指定线性单位的 z 基准，则此参数不可用。 | Double |
细化值 (可选) | 与细化方法参数值关联的细化值。
| Double |
摘要
将栅格像元中心转换为 3D 多点要素（其 Z 值反映栅格像元值）。
使用情况
如果拥有栅格高程数据并需要访问表面三角化提供的实用功能，请考虑使用此工具，因为多点要素可加载到 TIN 或 Terrain 数据集中。
当输入栅格的参数值过大时，请考虑应用细化方法参数减少导出至多点要素类的像元数。 选项如下：
- z 容差 - 细化像元的同时保持垂直精度。
- 核 - 细化像元的同时控制水平采样距离。
- VIP - 当生成的多点主要应用于可视化应用程序时，请使用此方法。 此方法相对较快，能够输出可预测点数，并识别局部山峰和凹地。 然而，该方法对噪点敏感，可能会忽略跨越范围大于 3 像元 × 3 像元的地形要素。
- VIP 直方图 - 使用此选项作为应用 VIP 选项的初始步骤，它会生成显著性得分的直方图，便于您了解将选择的点数以及每个递增百分数值。
参数
arcpy.ddd.RasterToMultipoint(in_raster, out_feature_class, {out_vip_table}, {method}, {kernel_method}, {z_factor}, {thinning_value})| 名称 | 说明 | 数据类型 |
in_raster | 将处理此栅格。 | Raster Layer; Mosaic Layer |
out_feature_class | 将生成的要素类。 | Feature Class |
out_vip_table (可选) | 在为细化方法参数指定 VIP 直方图时，将创建的直方图表格。 在为 method 参数指定 VIP_HISTOGRAM 时，将创建的直方图表格。 | Table |
method (可选) | 指定要应用于输入栅格的细化方法，以选择要导出至多点要素类的像元的子集。
| String |
kernel_method (可选) | 指定在输入栅格应用核细化时在每个核邻域中使用的选择方法。
| String |
z_factor (可选) | Z 值将乘上的系数。 此值通常用于转换 z 线性单位来匹配 x,y 线性单位。 默认值为 1，此时高程值保持不变。 如果输入表面的空间参考具有已指定线性单位的 z 基准，则此参数不可用。 | Double |
thinning_value (可选) | 与 method 参数值关联的细化值。
| Double |
代码示例
下面的示例演示了如何在 Python 窗口中使用此工具。
arcpy.env.workspace = "C:/data"
arcpy.ddd.RasterToMultipoint("elevation.tif", out_vip_table="elev_VIP.dbf",
method="VIP_HISTOGRAM", z_factor=1)下面的示例演示了如何在独立 Python 脚本中使用此工具。
'''*********************************************************************
Name: RasterToMultipoint Example
Description: This script demonstrates how to use
the RasterToMultipoint tool to create multipoint datasets
fot all IMG rasters in a target workspace.
**********************************************************************'''
# Import system modules
import arcpy
# Set default workspace
arcpy.env.workspace = "C:/data"
# Create the list of IMG rasters
rasterList = arcpy.ListRasters("*", "IMG")
# Loop the process for each raster
if rasterList:
for raster in rasterList:
# Set Local Variables
# [:-4] strips the last 4 characters (.img) from the raster name
outTbl = "VIP_" + raster[:-4] + ".dbf"
method = "VIP_HISTOGRAM"
zfactor = 1
#Execute RasterToMultipoint
arcpy.ddd.RasterToMultipoint(raster, "",outTbl, method, "", zfactor)
else:
print("There are no IMG rasters in the " + env.workspace + " directory.")