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

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

Краткая информация

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

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

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

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

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

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

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

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

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

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

  • Этот инструмент является дополнением к инструменту Растр в полигоны, который конвертирует растр в класс полигональных пространственных объектов.

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

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входные объекты

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

Feature Layer
Поле значений

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

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

Field
Выходной набор растровых данных

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

Если выходной растр не будет сохраняться в базе геоданных, задайте расширение .tif для файла формата TIFF, .CRF для файла формата CRF, .img для файла формата ERDAS IMAGINE или не задавайте расширение для растрового формата Esri Grid.

Raster Dataset
Метод присвоения значений ячейкам
(Дополнительный)

Метод, определяющий, как будут присвоены значения ячейкам, если на одну ячейку попадает более одного объекта.

  • Центр ячейкиПри наложении полигона на центр ячейки этой ячейке присваивается его атрибут.
  • Максимальная площадьОдин пространственный объект с большей площадью в пределах ячейки заставляет атрибут быть присвоенным ячейке.
  • Максимальная комбинированная площадьЕсли в ячейке более одного пространственного объекта с одинаковыми значениями, то области этих объектов будут объединены. Комбинированный объект с большей площадью в пределах ячейки будет определять значение, которое будет присваиваться ячейке.
String
Поле приоритета
(Дополнительный)

Это поле используется для определения, какой пространственный объект должен быть предпочтительнее другого в той же ячейке. При его использовании для конвертации всегда выбирается объект с наибольшим положительным приоритетом, независимо от выбранного Метода присвоения значений ячейкам.

Field
Размер ячейки
(Дополнительный)

Размер ячейки для создаваемого выходного набора растровых данных.

Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, а если и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. Использование.

Analysis Cell Size
Построить атрибутивную таблицу растра
(Дополнительный)

Определяет, будет ли у выходного растра таблица атрибутов.

Данный параметр применяется только к целочисленным растрам.

  • Отмечено - у выходного растра будет таблица атрибутов. Это значение по умолчанию.
  • Не отмечено - у выходного растра не будет таблицы атрибутов.
Boolean

arcpy.conversion.PolygonToRaster(in_features, value_field, out_rasterdataset, {cell_assignment}, {priority_field}, {cellsize}, {build_rat})
ИмяОписаниеТип данных
in_features

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

Feature Layer
value_field

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

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

Field
out_rasterdataset

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

Если выходной растр не будет сохраняться в базе геоданных, задайте расширение .tif для файла формата TIFF, .CRF для файла формата CRF, .img для файла формата ERDAS IMAGINE или не задавайте расширение для растрового формата Esri Grid.

Raster Dataset
cell_assignment
(Дополнительный)

Метод, определяющий, как будут присвоены значения ячейкам, если на одну ячейку попадает более одного объекта.

  • CELL_CENTERПри наложении полигона на центр ячейки этой ячейке присваивается его атрибут.
  • MAXIMUM_AREAОдин пространственный объект с большей площадью в пределах ячейки заставляет атрибут быть присвоенным ячейке.
  • MAXIMUM_COMBINED_AREAЕсли в ячейке более одного пространственного объекта с одинаковыми значениями, то области этих объектов будут объединены. Комбинированный объект с большей площадью в пределах ячейки будет определять значение, которое будет присваиваться ячейке.
String
priority_field
(Дополнительный)

Это поле используется для определения, какой пространственный объект должен быть предпочтительнее другого в той же ячейке. При его использовании для конвертации всегда выбирается объект с наибольшим положительным приоритетом, независимо от выбранного Метода присвоения значений ячейкам.

Field
cellsize
(Дополнительный)

Размер ячейки для создаваемого выходного набора растровых данных.

Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, а если и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. Использование.

Analysis Cell Size
build_rat
(Дополнительный)

Определяет, будет ли у выходного растра таблица атрибутов.

Данный параметр применяется только к целочисленным растрам.

  • BUILDУ выходного растра будет таблица атрибутов. Это значение по умолчанию.
  • DO_NOT_BUILDУ выходного растра не будет таблицы атрибутов.
Boolean

Пример кода

PolygonToRaster, пример 1 (окно Python)

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

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.PolygonToRaster("ca_counties.shp", "NAME", 
                                 "c:/output/ca_counties.img", 
                                 "MAXIMUM_AREA", "MALES", 0.25)
PolygonToRaster, пример 2 (автономный скрипт)

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

# Name: PolygonToRaster_Ex_02.py
# Description: Converts polygon features to a raster dataset.

# Import system modules
import arcpy

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

# Set local variables
inFeatures = "ca_counties.shp"
valField = "NAME"
outRaster = "c:/output/ca_counties"
assignmentType = "MAXIMUM_AREA"
priorityField = "MALES"
cellSize = 0.5

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