标注 | 说明 | 数据类型 |
输入多面体要素 | 要转换为栅格的输入多面体要素。 | Feature Layer |
输出栅格 | 要创建的输出栅格数据集。 此栅格为浮点类型。 如果不希望将输出栅格保存到地理数据库,请为 TIFF 文件格式指定 .tif,为 CRF 文件格式指定 .CRF,为 ERDAS IMAGINE 文件格式指定 .img,而对于 Esri Grid 栅格格式,无需指定扩展名。 | Raster Dataset |
输出像元大小 (可选) | 正在创建的输出栅格的像元大小。 此参数可以通过数值进行定义,也可以从现有栅格数据集获取。如果未将像元大小明确指定为参数值,则将使用环境像元大小值(如果已指定);否则,将使用其他规则通过其他输出计算像元大小。有关详细信息,请参阅“用法”。 | Analysis Cell Size |
摘要
将多面体要素转换为栅格数据集。
插图
使用情况
输出栅格在每个像元中心位置存储输入多面体要素的 Z 值。要确定每个像元的 Z 值,需要从像元中心位置延伸出一条垂直线以与输入多面体要素相交。将相交点的最大 Z 值分配到输出栅格。如果像元中心落在一个或多个输入多面体要素的覆盖区,输出像元会得到一个值;否则,会将输出像元指定为 NoData。
栅格化中不包含垂直三角形(实质上是没有顶的垂直墙壁),所以不会在输出栅格中显示垂直三角形。
输出像元大小可以通过数值进行定义,也可以从现有栅格数据集获取。如果没有将像元大小明确指定为参数值,则将从像元大小环境获取相应值(如果已指定环境)。如果参数像元大小和环境像元大小均未指定,但已设置了捕捉栅格环境,则将使用捕捉栅格的像元大小。如果未指定任何内容,则像元大小会通过使用范围的宽度或高度中的较小值除以 250 来计算,其中范围位于在环境中指定的输出坐标系内。
如果已使用数值指定像元大小,则工具会直接将其用于输出栅格。
如果已使用栅格数据集指定像元大小,则该参数将显示栅格数据集的路径而不是像元大小的值。如果数据集的空间参考与输出空间参考相同,则栅格数据集的像元大小将直接用于分析。如果数据集的空间参考不同,则将基于所选的像元大小投影方法进行投影。
借助该工具您可以在城市空间将 3D 建筑物要素(作为多面体)刻录到数字高程模型 (DEM) 中。要实现此目的,首先使用该工具将多面体要素转换到栅格中。然后使用镶嵌工具通过 DEM 栅格镶嵌建筑物栅格。通过得到的高程栅格,您可以在城市空间中运行操作栅格数据的其他工具来解决分析问题。例如,在城市环境中,您可以运行视域工具来计算可视性或运行太阳辐射工具来计算建筑物的潜在屋顶太阳能。
默认情况下,此工具会利用多核处理器。可供使用的最大核数为四。
要使用较少的核,请使用并行处理因子环境设置。
参数
arcpy.conversion.MultipatchToRaster(in_multipatch_features, out_raster, {cell_size})
名称 | 说明 | 数据类型 |
in_multipatch_features | 要转换为栅格的输入多面体要素。 | Feature Layer |
out_raster | 要创建的输出栅格数据集。 此栅格为浮点类型。 如果不希望将输出栅格保存到地理数据库,请为 TIFF 文件格式指定 .tif,为 CRF 文件格式指定 .CRF,为 ERDAS IMAGINE 文件格式指定 .img,而对于 Esri Grid 栅格格式,无需指定扩展名。 | Raster Dataset |
cell_size (可选) | 正在创建的输出栅格的像元大小。 此参数可以通过数值进行定义,也可以从现有栅格数据集获取。如果未将像元大小明确指定为参数值,则将使用环境像元大小值(如果已指定);否则,将使用其他规则通过其他输出计算像元大小。有关详细信息,请参阅“用法”。 | Analysis Cell Size |
代码示例
该示例将多面体 shapefile 转换为栅格并将输出栅格保存为 IMG 格式。
import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.MultipatchToRaster_conversion("buildings.shp",
"c:/output/outbuildings.img", 0.25)
该示例将多面体 shapefile 转换为栅格并将输出栅格保存为 TIFF 格式。
# Name: MultipatchToRaster_Ex_02.py
# Description: Converts multipatch features to a raster dataset.
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inFeatures = "buildings.shp"
outRaster = "c:/output/outbuildings.tif"
cellSize = 0.5
# Execute MultipatchToRaster
arcpy.MultipatchToRaster_conversion(inFeatures, outRaster, cellSize)
环境
特殊情况
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是