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

Сводка

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

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

  • Входной растр может иметь любой размер ячейки и должен быть корректным целочисленным набором растровых данных.

  • Параметр Поле позволяет выбирать, какое атрибутивное поле входного набора растровых данных станет атрибутом в выходном классе объектов. Если поле не задано, значения ячеек входного растра (поле VALUE) станут столбцом с заголовком Gridcode в атрибутивной таблице выходного класса объектов.

  • На следующем изображении показано, как входной растр векторизуется во время конвертации в полигональный объект. Результат представлен для обеих настроек параметра Упростить.

    Выходные данные с различными настройками упрощения
    Сравнение выходных данных с различными настройками упрощения
  • Если отмечен параметр Создать составные объекты (MULTIPLE_OUTER_PART в Python), результатом будет класс составных объектов, и, как правило, обработка происходит быстрее. Однако если выходной класс объектов содержит очень большое количество объектов, это может вызвать ошибку переполнения памяти. Процесс группировки напоминает тот, который используется инструментом Слияние.

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

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

Синтаксис

arcpy.conversion.RasterToPolygon(in_raster, out_polygon_features, {simplify}, {raster_field}, {create_multipart_features}, {max_vertices_per_feature})
ParameterОбъяснениеТип данных
in_raster

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

Растр должен быть целочисленным.

Raster Layer
out_polygon_features

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

Feature Class
simplify
(Дополнительный)

Определяет, нужно ли сглаживать границы выходных полигонов для упрощения формы, или границы полигонов должны соответствовать границам ячеек.

  • SIMPLIFYПолигоны будут сглажены в более простые формы. Сглаживание выполняется таким образом, чтобы полигоны содержали минимальное число сегментов, оставаясь при этом как можно ближе к границам ячеек исходного растра. Это значение по умолчанию.
  • NO_SIMPLIFYГраницы полигонов будут проходить точно по границам ячеек входного растра. Если используется эта опция, то при конвертации класса полигональных объектов обратно в растр будет получен исходный растр.
Boolean
raster_field
(Дополнительный)

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

Может быть целочисленным, с плавающей точкой или строковым.

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

Указывает, будут ли выходные полигоны состоять из одиночных или составных объектов.

  • MULTIPLE_OUTER_PARTБудут созданы составные объекты на основе полигонов, имеющих одинаковые значения.
  • SINGLE_OUTER_PARTБудут созданы отдельные объекты для каждого полигона. Это значение по умолчанию.
Boolean
max_vertices_per_feature
(Дополнительный)

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

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

Long

Пример кода

Пример RasterToPolygon (окно Python)

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

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.RasterToPolygon_conversion("zone", "c:/output/zones.shp", "NO_SIMPLIFY",
                                  "VALUE")
Пример RasterToPolygon (автономный скрипт)

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

# Name: RasterToPolygon_Ex_02.py
# Description: Converts a raster dataset to polygon features.
# Requirements: None

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inRaster = "zone"
outPolygons = "c:/output/zones.shp"
field = "VALUE"

# Execute RasterToPolygon
arcpy.RasterToPolygon_conversion(inRaster, outPolygons, "NO_SIMPLIFY", field)

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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