| Подпись | Описание | Тип данных |
Входные объекты | Входной набор полигональных объектов, который будет конвертирован в набор растровых данных. | Feature Layer |
Поле значений | Поле, используемое для присвоения значений выходному растру. Это может быть любое поле таблицы атрибутов входного набора классов объектов. | Field |
Выходной набор растровых данных | Создаваемый выходной набор растровых данных. Если выходной растр не будет сохраняться в базе геоданных, задайте расширение .tif для файла формата TIFF, .CRF для файла формата CRF, .img для файла формата ERDAS IMAGINE или не задавайте расширение для растрового формата Esri Grid. | Raster Dataset |
Метод присвоения значений ячейкам (Дополнительный) | Метод, определяющий, как будут присвоены значения ячейкам, если на одну ячейку попадает более одного объекта.
| String |
Поле приоритета (Дополнительный) | Это поле используется для определения, какой пространственный объект должен быть предпочтительнее другого в той же ячейке. При его использовании для конвертации всегда выбирается объект с наибольшим положительным приоритетом, независимо от выбранного Метода присвоения значений ячейкам. | Field |
Размер ячейки (Дополнительный) | Размер ячейки для создаваемого выходного набора растровых данных. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, а если и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. Использование. | Analysis Cell Size |
Построить атрибутивную таблицу растра (Дополнительный) | Определяет, будет ли у выходного растра таблица атрибутов. Данный параметр применяется только к целочисленным растрам.
| Boolean |
Доступно с лицензией Advanced.
Краткая информация
Конвертирует полигональные пространственные объекты в набор растровых данных.
Более подробно о том, как работает инструмент Полигоны в растр
Использование
Любой класс пространственных объектов (в базе геоданных, шейп-файл или покрытие), содержащий полигоны, может быть конвертирован в набор растровых данных.
Входной тип поля определяет тип выходного растра. Если поле целочисленное, выходной растр будет целочисленным; если оно представлено значениями с плавающей точкой, выходные данные будут представлены значениями с плавающей точкой.
Если входное поле содержит строковые значения, выходной растр будет содержать поле с целочисленным значением и текстовое поле.
Однако если поле будет иметь тип c плавающей точкой и значения будут выражены целыми числами, то выходной растер будет целочисленным.
Cellsize можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки невозможно указать непосредственно как значение параметра, он будет получен из параметра среды Размер ячейки, если он был там задан. Если же не указано ни размер ячейки, ни параметр среды «размер ячейки», но при этом задан параметр среды Растр привязки, то будет использоваться размер ячейки этого растра. Если же ни один из параметров не задан, то размер ячейки будет равен наименьшему из значений ширины и высоты экстента растра, деленному на 250 (экстент берется из параметра среды Выходная система координат.
Если размер ячейки указан в виде числа, то инструмент будет использовать это значение для выходного растра.
Если для определения размера ячейки указан набора растровых данных, в параметре будет показан путь к набору растровых данных вместо значения размера ячейки. Размер ячейки этого растра будет использоваться непосредственно в анализе указанная пространственная привязка набора данных будет такой же, как и выходная система координат. Если же пространственная привязка набора данных отличается от выходной пространственной привязки, она будет перепроецирована на основе выбранного Метода проецирования размера ячейки.
Этот инструмент является дополнением к инструменту Растр в полигоны, который конвертирует растр в класс полигональных пространственных объектов.
Если в выходной ячейке находится более одного объекта, этот инструмент предоставляет больше возможностей для управления присвоением значений ячеек, чем инструмент Объекты в растр.
Если в выходном растре появятся искажения или полосы, используйте инструменты Проверить геометрию и Восстановить геометрию, чтобы исправить входные данные объектов.
При конвертации накладывающихся полигонов, вы, возможно, захотите, чтобы полигоны с меньшей площадью были присвоены ячейке. Простой способ сделать это – добавить дополнительное поле к входному классу объектов и рассчитать в нем обратную площадь полигонов, а затем использовать это поле как Поле приоритета при запуске этого инструмента.
При использовании в качестве входных данных форматов, которые поддерживают значения Null, таких как классы пространственных объектов файловой базы геоданных, значение Null будет игнорироваться.
К этому инструменту могут применяться некоторые параметры среды хранения растров.
В параметрах среды Пирамидные слои используется только опция Построение пирамидных слоев. Остальные параметры среды Пирамидные слои игнорируются. Больший контроль над пирамидами дает следующей инструмент Построить пирамидные слои.
В параметрах среды Сжатие учитывается только тип сжатия. Это относится ко всем растровым форматам, кроме Esri Grid.
Параметры
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 (Дополнительный) | Метод, определяющий, как будут присвоены значения ячейкам, если на одну ячейку попадает более одного объекта.
| String |
priority_field (Дополнительный) | Это поле используется для определения, какой пространственный объект должен быть предпочтительнее другого в той же ячейке. При его использовании для конвертации всегда выбирается объект с наибольшим положительным приоритетом, независимо от выбранного Метода присвоения значений ячейкам. | Field |
cellsize (Дополнительный) | Размер ячейки для создаваемого выходного набора растровых данных. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, а если и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. Использование. | Analysis Cell Size |
build_rat (Дополнительный) | Определяет, будет ли у выходного растра таблица атрибутов. Данный параметр применяется только к целочисленным растрам.
| Boolean |
Пример кода
Конвертирует полигональные пространственные объекты в набор растровых данных.
import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.PolygonToRaster("ca_counties.shp", "NAME",
"c:/output/ca_counties.img",
"MAXIMUM_AREA", "MALES", 0.25)Конвертирует полигональные пространственные объекты в набор растровых данных.
# 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)Параметры среды
Информация о лицензиях
- Basic: Обязательно Spatial Analyst или 3D Analyst
- Standard: Обязательно Spatial Analyst или 3D Analyst
- Advanced: Да