Полилинии в растр (Конвертация)

Доступно с лицензией Advanced.

Сводка

Конвертирует линейные пространственные объекты в набор растровых данных.

Более подробно о том, как работает инструмент Полилинии в растр

Использование

  • Любой класс пространственных объектов (база геоданных, шейп-файл или покрытие), содержащий полилинейные объекты, может быть конвертирован в набор растровых данных.

  • Входной тип поля определяет тип выходного растра. Если поле целочисленное, выходной растр будет целочисленным; если оно представлено значениями с плавающей точкой, выходные данные будут представлены значениями с плавающей точкой.

    Если входное поле содержит строковые значения, выходной растр будет содержать поле с целочисленным значением и текстовое поле.

  • Cellsize можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки невозможно указать непосредственно как значение параметра, он будет получен из параметра среды Размер ячейки, если он был там задан. Если же не указано ни размер ячейки, ни параметр среды «размер ячейки», но при этом задан параметр среды Растр привязки, то будет использоваться размер ячейки этого растра. Если же ни один из параметров не задан, то размер ячейки будет равен наименьшему из значений ширины и высоты экстента растра, деленному на 250 (экстент берется из параметра среды Выходная система координат.

  • Если размер ячейки указан в виде числа, то инструмент будет использовать это значение для выходного растра.

    Если для определения размера ячейки указан набора растровых данных, в параметре будет показан путь к набору растровых данных вместо значения размера ячейки. Размер ячейки этого растра будет использоваться непосредственно в анализе указанная пространственная привязка набора данных будет такой же, как и выходная система координат. Если же пространственная привязка набора данных отличается от выходной пространственной привязки, она будет перепроецирована на основе выбранного Метода проецирования размера ячейки.

  • Этот инструмент является обратным по отношению к инструменту Растр в полилинии, который конвертирует растр в класс объектов-полилиний.

  • Если в выходной ячейке находится более одного объекта, этот инструмент предоставляет больше возможностей для управления присвоением значений ячеек, чем инструмент Объекты в растр.

  • При использовании в качестве входных данных форматов, которые поддерживают значения Null, таких как классы пространственных объектов файловой базы геоданных, значение Null будет игнорироваться.

  • К этому инструменту могут применяться некоторые параметры среды хранения растров.

    • В параметрах среды Пирамидные слои используется только опция Построение пирамидных слоев. Остальные параметры среды Пирамидные слои игнорируются. Больший контроль над пирамидами дает следующей инструмент Построить пирамидные слои.

    • В параметрах среды Сжатие учитывается только тип сжатия. Это относится ко всем растровым форматам, кроме Esri Grid.

Синтаксис

arcpy.conversion.PolylineToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})
ParameterОбъяснениеТип данных
in_features

Входной набор линейных объектов, который будет конвертирован в растр.

Feature Layer
value_field

Поле, используемое для присвоения значений выходному растру.

Это может быть любое поле таблицы атрибутов входного набора классов объектов.

Field
out_rasterdataset

Создаваемый выходной набор растровых данных.

Если выходной растр не будет сохраняться в базе геоданных, задайте расширение .tif для файла формата TIFF, .CRF для файла формата CRF, .img для файла формата ERDAS IMAGINE или не задавайте расширение для растрового формата 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
from arcpy import env
env.workspace = "c:/data"
arcpy.PolylineToRaster_conversion("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
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)

Информация о лицензиях

  • Basic: Требуется Spatial Analyst или 3D Analyst
  • Standard: Требуется Spatial Analyst или 3D Analyst
  • Advanced: Да

Связанные разделы