| 标注 | 说明 | 数据类型 |
输入要素 | 要转换为栅格数据集的输入要素数据集。 | Feature Layer |
字段 | 用于向输出栅格分配值的字段。 可以是输入要素数据集属性表中的任何字段。 如果点数据集或多点数据集的 Shape 字段含有 z 值或 m 值，则可以使用二者中的任意一个。 | Field |
输出栅格 | 要创建的输出栅格数据集。 如果不希望将输出栅格保存到地理数据库，请为 TIFF 文件格式指定 .tif，为 CRF 文件格式指定 .CRF，为 ERDAS IMAGINE 文件格式指定 .img，而对于 Esri Grid 栅格格式，无需指定扩展名。 | Raster Dataset |
输出像元大小 (可选) | 正在创建的输出栅格的像元大小。 此参数可以通过数值进行定义，也可以从现有栅格数据集获取。如果未将像元大小明确指定为参数值，则将使用环境像元大小值（如果已指定）；否则，将使用其他规则通过其他输出计算像元大小。有关详细信息，请参阅“用法”。 | Analysis Cell Size |
摘要
将要素转换为栅格数据集。
使用情况
任何包含点、线或面要素的要素类（地理数据库、shapefile 或 coverage）都可以转换为栅格数据集。
输入字段类型决定输出栅格的类型。如果字段是整型，则输出栅格也是整型；如果字段是浮点型，则输出栅格也是浮点型。
输出像元大小可以通过数值进行定义，也可以从现有栅格数据集获取。如果没有将像元大小明确指定为参数值，则将从像元大小环境获取相应值（如果已指定环境）。如果参数像元大小和环境像元大小均未指定，但已设置了捕捉栅格环境，则将使用捕捉栅格的像元大小。如果未指定任何内容，则像元大小会通过使用范围的宽度或高度中的较小值除以 250 来计算，其中范围位于在环境中指定的输出坐标系内。
如果已使用数值指定像元大小，则工具会直接将其用于输出栅格。
如果已使用栅格数据集指定像元大小，则该参数将显示栅格数据集的路径而不是像元大小的值。如果数据集的空间参考与输出空间参考相同，则栅格数据集的像元大小将直接用于分析。如果数据集的空间参考不同，则将基于所选的像元大小投影方法进行投影。
此工具始终使用像元中心确定栅格像素的值。如果要对不同类型的输入要素几何的转换方式进行更多控制，则使用各自的特定转换工具：点转栅格、折线转栅格和面转栅格。
当选择输入要素数据时，默认字段将是第一个有效的可用字段。如果不存在其他有效字段，则 ObjectID 字段（如 OID 或 FID）将成为默认字段。
对于支持空值的数据格式（例如文件地理数据库要素类），当用作输入时，空值将被忽略。
某些栅格存储环境可能适用于此工具。
参数
arcpy.conversion.FeatureToRaster(in_features, field, out_raster, {cell_size})| 名称 | 说明 | 数据类型 |
in_features | 要转换为栅格数据集的输入要素数据集。 | Feature Layer |
field | 用于向输出栅格分配值的字段。 可以是输入要素数据集属性表中的任何字段。 如果点数据集或多点数据集的 Shape 字段含有 z 值或 m 值，则可以使用二者中的任意一个。 | Field |
out_raster | 要创建的输出栅格数据集。 如果不希望将输出栅格保存到地理数据库，请为 TIFF 文件格式指定 .tif，为 CRF 文件格式指定 .CRF，为 ERDAS IMAGINE 文件格式指定 .img，而对于 Esri Grid 栅格格式，无需指定扩展名。 | Raster Dataset |
cell_size (可选) | 正在创建的输出栅格的像元大小。 此参数可以通过数值进行定义，也可以从现有栅格数据集获取。如果未将像元大小明确指定为参数值，则将使用环境像元大小值（如果已指定）；否则，将使用其他规则通过其他输出计算像元大小。有关详细信息，请参阅“用法”。 | Analysis Cell Size |
代码示例
将要素转换为栅格数据集。
import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.FeatureToRaster("roads.shp", "CLASS", "c:/output/roadsgrid", 25)将要素转换为栅格数据集。
# Name: FeatureToRaster_Ex_02.py
# Description: Converts features to a raster dataset.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
inFeature = "roads.shp"
outRaster = "c:/output/roadsgrd"
cellSize = 25
field = "CLASS"
# Run FeatureToRaster
arcpy.conversion.FeatureToRaster(inFeature, field, outRaster, cellSize)