点转栅格 (转换)—ArcGIS Pro

在 Advanced 许可等级下可用。

摘要

将点要素转换为栅格数据集。

使用情况

可以将包含点或多点要素的任意要素类（地理数据库、shapefile 或 coverage）转换为栅格数据集。
输入字段类型决定输出栅格的类型。如果字段是整型，则输出栅格也是整型；如果字段是浮点型，则输出栅格也是浮点型。
如果输入字段包含字符串值，则输出栅格将包含一个整数值字段和一个字符串字段。
像元大小可以通过数值进行定义，也可以从现有栅格数据集获取。如果没有将像元大小明确指定为参数值，则将从像元大小环境获取相应值（如果已指定环境）。如果参数像元大小和环境像元大小均未指定，但已设置了捕捉栅格环境，则将使用捕捉栅格的像元大小。如果未指定任何内容，则像元大小会通过使用范围的宽度或高度中的较小值除以 250 来计算，其中范围位于在环境中指定的输出坐标系内。
如果已使用数值指定像元大小，则工具会直接将其用于输出栅格。
如果已使用栅格数据集指定像元大小，则该参数将显示栅格数据集的路径而不是像元大小的值。如果数据集的空间参考与输出空间参考相同，则栅格数据集的像元大小将直接用于分析。如果数据集的空间参考不同，则将基于所选的像元大小投影方法进行投影。
此工具与栅格转点工具互为补充，后者是将栅格转换为点要素类。
当输出像元中存在多个要素时，此工具可提供比要素转栅格工具更全面的像元值分配控制。
对于支持 Null 值的数据格式，例如文件地理数据库要素类，在将 Null 值用作输入时，该值将被忽略。
某些栅格存储环境可能适用于此工具。
- 对于金字塔环境，仅支持构建金字塔设置。其余的金字塔环境设置将被忽略。可使用构建金字塔工具在后续步骤中更好地控制金字塔的性质。
- 对于压缩环境，仅支持压缩类型。这适用于除 Esri 格网以外的栅格格式。

参数

标注	说明	数据类型
输入要素	要转换为栅格的点或多点输入要素数据集。	Feature Layer
值字段	用于向输出栅格分配值的字段。可以是输入要素数据集属性表中的任何字段。如果点数据集或多点数据集的 Shape 字段含有 z 值或 m 值，则可以使用二者中的任意一个。	Field
输出栅格数据集	要创建的输出栅格数据集。如果不希望将输出栅格保存到地理数据库，请为 TIFF 文件格式指定 .tif，为 CRF 文件格式指定 .CRF，为 ERDAS IMAGINE 文件格式指定 .img，而对于 Esri Grid 栅格格式，无需指定扩展名。	Raster Dataset
像元分配类型 (可选)	用于确定当多个要素落在一个像元中时如何为像元分配值的方法。最常见—如果像元中有多个要素，则将值字段中具有最多通用属性的要素分配给像元。如果这些要素具有相同数量的通用属性，则使用具有最低 FID 的要素。总和—像元中所有点的属性的和（对字符串数据无效）。平均值—像元中所有点的属性的平均值（对字符串数据无效）。标准差—像元中所有点的属性的标准差。如果像元中少于两点，则为像元分配 NoData（对字符串数据无效）。最大值—像元中所有点的属性的最大值（对字符串数据无效）。最小值—像元中所有点的属性的最小值（对字符串数据无效）。范围—像元中所有点的属性的范围（对字符串数据无效）。计数—像元中的点的个数。	String
优先级字段 (可选)	需要确定一个要素是否应该优先于具有相同属性的其他要素时，使用此字段。优先级字段仅与最常见像元分配类型选项一起使用。	Field
像元大小 (可选)	正在创建的输出栅格的像元大小。此参数可以通过数值进行定义，也可以从现有栅格数据集获取。如果未将像元大小明确指定为参数值，则将使用环境像元大小值（如果已指定）；否则，将使用其他规则通过其他输出计算像元大小。有关详细信息，请参阅“用法”。	Analysis Cell Size
构建栅格属性表 (可选)	指定输出栅格是否将具有栅格属性表。此参数仅适用于整型栅格。选中 - 输出栅格将具有栅格属性表。这是默认设置。未选中 - 输出栅格将不具有栅格属性表。	Boolean

arcpy.conversion.PointToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})

名称	说明	数据类型
in_features	要转换为栅格的点或多点输入要素数据集。	Feature Layer
value_field	用于向输出栅格分配值的字段。可以是输入要素数据集属性表中的任何字段。如果点数据集或多点数据集的 Shape 字段含有 z 值或 m 值，则可以使用二者中的任意一个。	Field
out_rasterdataset	要创建的输出栅格数据集。如果不希望将输出栅格保存到地理数据库，请为 TIFF 文件格式指定 .tif，为 CRF 文件格式指定 .CRF，为 ERDAS IMAGINE 文件格式指定 .img，而对于 Esri Grid 栅格格式，无需指定扩展名。	Raster Dataset
cell_assignment (可选)	用于确定当多个要素落在一个像元中时如何为像元分配值的方法。 MOST_FREQUENT—如果像元中有多个要素，则将值字段中具有最多通用属性的要素分配给像元。如果这些要素具有相同数量的通用属性，则使用具有最低 FID 的要素。 SUM—像元中所有点的属性的和（对字符串数据无效）。 MEAN—像元中所有点的属性的平均值（对字符串数据无效）。 STANDARD_DEVIATION—像元中所有点的属性的标准差。如果像元中少于两点，则为像元分配 NoData（对字符串数据无效）。 MAXIMUM—像元中所有点的属性的最大值（对字符串数据无效）。 MINIMUM—像元中所有点的属性的最小值（对字符串数据无效）。 RANGE—像元中所有点的属性的范围（对字符串数据无效）。 COUNT—像元中的点的个数。	String
priority_field (可选)	需要确定一个要素是否应该优先于具有相同属性的其他要素时，使用此字段。优先级字段仅与最常见像元分配类型选项一起使用。	Field
cellsize (可选)	正在创建的输出栅格的像元大小。此参数可以通过数值进行定义，也可以从现有栅格数据集获取。如果未将像元大小明确指定为参数值，则将使用环境像元大小值（如果已指定）；否则，将使用其他规则通过其他输出计算像元大小。有关详细信息，请参阅“用法”。	Analysis Cell Size
build_rat (可选)	指定输出栅格是否将具有栅格属性表。此参数仅适用于整型栅格。 BUILD—输出栅格将具有栅格属性表。这是默认设置。 DO_NOT_BUILD—输出栅格将不具有栅格属性表。	Boolean

代码示例

点转栅格 (PointToRaster) 示例 1（Python 窗口）

将点要素转换为栅格数据集。

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.PointToRaster_conversion("ca_ozone_pts.shp", "ELEVATION", 
                                "c:/output/ca_elev", "MAXIMUM", "", 2000)

点转栅格 (PointToRaster) 示例 2（独立脚本）

将点要素转换为栅格数据集。

# Name: PointToRaster_Ex_02.py
# Description: Converts point 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 = "ca_ozone_pts.shp"
valField = "ELEVATION"
outRaster = "c:/output/ca_elev02"
assignmentType = "MAXIMUM"
priorityField = ""
cellSize = 2000

# Execute PointToRaster
arcpy.PointToRaster_conversion(inFeatures, valField, outRaster, 
                               assignmentType, priorityField, cellSize)

环境

自动提交, 像元大小, 像元大小投影方法, 压缩, 当前工作空间, 范围, 地理变换, 输出配置关键字, 输出坐标系, 金字塔, 临时工作空间, 捕捉栅格, 切片大小

许可信息

Basic: 需要 Spatial Analyst 或 3D Analyst
Standard: 需要 Spatial Analyst 或 3D Analyst
Advanced: 是

摘要

使用情况

参数

代码示例

环境

许可信息

相关主题

在本主题中