Polyline to Raster (Conversion)

License Level:BasicStandardAdvanced

Summary

Converts polyline features to a raster dataset.

Learn more about how the Polyline to Raster tool works

Usage

Syntax

PolylineToRaster_conversion (in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize})
ParameterExplanationData Type
in_features

The polyline input feature dataset to be converted to a raster.

Feature Layer
value_field

The field used to assign values to the output raster.

It can be any field of the input feature dataset's attribute table.

Field
out_rasterdataset

The output raster dataset to be created.

When not saving to a geodatabase, specify .tif for a TIFF file format, .img for an ERDAS IMAGINE file format, or no extension for an Esri Grid raster format.

Raster Dataset
cell_assignment
(Optional)

The method to determine how the cell will be assigned a value when more than one feature falls within a cell.

  • MAXIMUM_LENGTHThe feature with the longest length that covers the cell will determine the value to assign to the cell.
  • MAXIMUM_COMBINED_LENGTHIf there is more than one feature in a cell with the same value, the lengths of these features will be combined. The combined feature with the longest length within the cell will determine the value to assign to the cell.
String
priority_field
(Optional)

This field is used when a feature should take preference over another feature with the same attribute.

Field
cellsize
(Optional)

The cell size for the output raster dataset.

The default cell size is the shortest of the width or height of the extent of the input feature dataset, in the output spatial reference, divided by 250.

Analysis Cell Size

Code Sample

PolylineToRaster example 1 (Python window)

Converts polyline features to a raster dataset.

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.PolylineToRaster_conversion("roads.shp", "CLASS", "c:/output/roads.img",
                                   "MAXIMUM_COMBINED_LENGTH", "LENGTH", 30)
PolylineToRaster example 2 (stand-alone script)

Converts polyline features to a raster dataset.

# Name: PolylineToRaster_Ex_02.py
# Description: Converts polyline 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 = "roads.shp"
valField = "CLASS"
outRaster = "c:/output/roads.tif"
assignmentType = "MAXIMUM_COMBINED_LENGTH"
priorityField = "LENGTH"
cellSize = 30

# Execute PolylineToRaster
arcpy.PolylineToRaster_conversion(inFeatures, valField, outRaster, 
                                  assignmentType, priorityField, cellSize)

Environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Requires Spatial Analyst or 3D Analyst
ArcGIS for Desktop Standard: Requires Spatial Analyst or 3D Analyst
ArcGIS for Desktop Advanced: Yes
10/24/2012