折线转栅格 (转换)

在 Advanced 许可等级下可用。

摘要

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

了解有关“折线转栅格”工具的工作原理的详细信息

使用情况

  • 可以将包含折线要素的任意要素类(地理数据库、shapefile 或 coverage)转换为栅格数据集。

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

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

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

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

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

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

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

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

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

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

    • 对于压缩环境,仅支持压缩类型。这适用于除 Esri 格网以外的栅格格式。

参数

标注说明数据类型
输入要素

要转换为栅格的折线输入要素数据集。

Feature Layer
值字段

用于向输出栅格分配值的字段。

可以是输入要素数据集属性表中的任何字段。

Field
输出栅格数据集

要创建的输出栅格数据集。

如果不希望将输出栅格保存到地理数据库,请为 TIFF 文件格式指定 .tif,为 CRF 文件格式指定 .CRF,为 ERDAS IMAGINE 文件格式指定 .img,而对于 Esri Grid 栅格格式,无需指定扩展名。

Raster Dataset
像元分配类型
(可选)

此方法用于在多个要素位于一个像元中时,确定为该像元分配值的方式。

  • 最大长度像元内具有最大长度的要素可确定将分配给像元的值。
  • 最大合并长度如果像元中有多个要素具有相同的值,则合并这些要素的长度。 像元内具有最大长度的组合要素可确定将分配给像元的值。
String
优先级字段
(可选)

此字段用于确定哪个要素应该优先于像元外的其他要素。 使用时,无论选择何种像元分配类型,始终为转换选择优先级为最大正值的要素。

Field
像元大小
(可选)

正在创建的输出栅格的像元大小。

此参数可以通过数值进行定义,也可以从现有栅格数据集获取。如果未将像元大小明确指定为参数值,则将使用环境像元大小值(如果已指定);否则,将使用其他规则通过其他输出计算像元大小。有关详细信息,请参阅“用法”。

Analysis Cell Size
构建栅格属性表
(可选)

指定输出栅格是否将具有栅格属性表。

此参数仅适用于整型栅格。

  • 选中 - 输出栅格将具有栅格属性表。这是默认设置。
  • 未选中 - 输出栅格将不具有栅格属性表。
Boolean

arcpy.conversion.PolylineToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})
名称说明数据类型
in_features

要转换为栅格的折线输入要素数据集。

Feature Layer
value_field

用于向输出栅格分配值的字段。

可以是输入要素数据集属性表中的任何字段。

Field
out_rasterdataset

要创建的输出栅格数据集。

如果不希望将输出栅格保存到地理数据库,请为 TIFF 文件格式指定 .tif,为 CRF 文件格式指定 .CRF,为 ERDAS IMAGINE 文件格式指定 .img,而对于 Esri Grid 栅格格式,无需指定扩展名。

Raster Dataset
cell_assignment
(可选)

此方法用于在多个要素位于一个像元中时,确定为该像元分配值的方式。

  • MAXIMUM_LENGTH像元内具有最大长度的要素可确定将分配给像元的值。
  • MAXIMUM_COMBINED_LENGTH如果像元中有多个要素具有相同的值,则合并这些要素的长度。 像元内具有最大长度的组合要素可确定将分配给像元的值。
String
priority_field
(可选)

此字段用于确定哪个要素应该优先于像元外的其他要素。 使用时,无论选择何种像元分配类型,始终为转换选择优先级为最大正值的要素。

Field
cellsize
(可选)

正在创建的输出栅格的像元大小。

此参数可以通过数值进行定义,也可以从现有栅格数据集获取。如果未将像元大小明确指定为参数值,则将使用环境像元大小值(如果已指定);否则,将使用其他规则通过其他输出计算像元大小。有关详细信息,请参阅“用法”。

Analysis Cell Size
build_rat
(可选)

指定输出栅格是否将具有栅格属性表。

此参数仅适用于整型栅格。

  • BUILD输出栅格将具有栅格属性表。这是默认设置。
  • DO_NOT_BUILD输出栅格将不具有栅格属性表。
Boolean

代码示例

PolylineToRaster 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.PolylineToRaster("roads.shp", "CLASS", "c:/output/roads.img",
                                  "MAXIMUM_COMBINED_LENGTH", "LENGTH", 30)
PolylineToRaster 示例 2(独立脚本)

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

# Name: PolylineToRaster_Ex_02.py
# Description: Converts polyline features to a raster dataset.

# Import system modules
import arcpy

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

# Set local variables
inFeatures = "roads.shp"
valField = "CLASS"
outRaster = "c:/output/roads.tif"
assignmentType = "MAXIMUM_COMBINED_LENGTH"
priorityField = "LENGTH"
cellSize = 30

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