点转栅格 (转换)

在 Advanced 许可等级下可用。

摘要

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

了解“点转栅格”工具的工作原理

使用情况

  • 任何包含点或多点要素的要素类(地理数据库、shapefile 或 coverage)都可以转换为栅格数据集。

  • 输入字段类型决定输出栅格的类型。如果字段是整型,则输出栅格也是整型;如果字段是浮点型,则输出栅格也是浮点型。

    如果输入字段包含字符串值,则输出栅格将包含一个整数值字段和一个字符串字段。

  • 像元大小可以通过数值进行定义,也可以从现有栅格数据集获取。如果没有将像元大小明确指定为参数值,则将从像元大小环境获取相应值(如果已指定环境)。如果参数像元大小和环境像元大小均未指定,但已设置了捕捉栅格环境,则将使用捕捉栅格的像元大小。如果未指定任何内容,则像元大小会通过使用范围的宽度或高度中的较小值除以 250 来计算,其中范围位于在环境中指定的输出坐标系内。

  • 如果已使用数值指定像元大小,则工具会直接将其用于输出栅格。

    如果已使用栅格数据集指定像元大小,则该参数将显示栅格数据集的路径而不是像元大小的值。如果数据集的空间参考与输出空间参考相同,则栅格数据集的像元大小将直接用于分析。如果数据集的空间参考不同,则将基于所选的像元大小投影方法进行投影。

  • 此工具与栅格转点工具互为补充,后者是将栅格转换为点要素类。

  • 当输出像元中存在多个要素时,此工具可提供比要素转栅格工具更全面的像元值分配控制。

  • 对于支持空值的数据格式(例如文件地理数据库要素类),当用作输入时,空值将被忽略。

  • 某些栅格存储环境可能适用于此工具。

    • 对于金字塔环境,仅支持构建金字塔设置。其余的金字塔环境设置将被忽略。可使用构建金字塔工具在后续步骤中更好地控制金字塔的性质。

    • 对于压缩环境,仅支持压缩类型。这适用于除 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
arcpy.env.workspace = "c:/data"
arcpy.conversion.PointToRaster("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

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inFeatures = "ca_ozone_pts.shp"
valField = "ELEVATION"
outRaster = "c:/output/ca_elev02"
assignmentType = "MAXIMUM"
priorityField = ""
cellSize = 2000

# Run PointToRaster
arcpy.conversion.PointToRaster(inFeatures, valField, outRaster, 
                               assignmentType, priorityField, cellSize)