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

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

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной растр

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

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

Raster Layer
Выходные полилинейные объекты

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

Feature Class
Значение фона
(Дополнительный)

Укажите значение ячеек фона. Набор растровых данных содержит ячейки, представляющие передний план и фон. Линейные объекты формируются из приоритетных (расположенных на переднем плане) ячеек.

  • НольФон состоит из ячеек с нулевым значением, значением ниже нуля или со значением NoData. Все ячейки со значениями, большими нуля, определяются как ячейки переднего плана.
  • NoDataФон состоит из ячеек со значением NoData. Все ячейки со значениями, отличными от Nodata, будут считаться ячейками переднего плана.
String
Мин. длина висячей дуги
(Дополнительный)

Минимальная длина "висячей" линии, которая может быть сохранена. Значение по умолчанию равно нулю.

Double
Упростить полилинии
(Дополнительный)

Упрощает полилинию, удаляя незначительную зубчатость, с сохранением основной формы.

  • Отмечена – Полилинии будут сглажены в более простые формы так, чтобы каждая содержала минимальное число сегментов. Это значение по умолчанию
  • Отметка снята – Полилинии не будут упрощены.
Boolean
Поле
(Дополнительный)

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

Это может быть целочисленное или строковое поле.

Field

arcpy.conversion.RasterToPolyline(in_raster, out_polyline_features, {background_value}, {minimum_dangle_length}, {simplify}, {raster_field})
ИмяОписаниеТип данных
in_raster

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

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

Raster Layer
out_polyline_features

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

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

Укажите значение ячеек фона. Набор растровых данных содержит ячейки, представляющие передний план и фон. Линейные объекты формируются из приоритетных (расположенных на переднем плане) ячеек.

  • ZEROФон состоит из ячеек с нулевым значением, значением ниже нуля или со значением NoData. Все ячейки со значениями, большими нуля, определяются как ячейки переднего плана.
  • NODATAФон состоит из ячеек со значением NoData. Все ячейки со значениями, отличными от Nodata, будут считаться ячейками переднего плана.
String
minimum_dangle_length
(Дополнительный)

Минимальная длина "висячей" линии, которая может быть сохранена. Значение по умолчанию равно нулю.

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

Упрощает полилинию, удаляя незначительную зубчатость, с сохранением основной формы.

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

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

Это может быть целочисленное или строковое поле.

Field

Пример кода

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

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

import arcpy
arcpy.env.workspace = "c:/data"
arcpy.conversion.RasterToPolyline("flowstr", "c:/output/streams.shp", "ZERO",
                                  50, "SIMPLIFY")
RasterToPolyline, пример (автономный скрипт)

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

# Name: RasterToPolyline_Ex_02.py
# Description: Converts a raster dataset to polyline features.
# Requirements: None

# Import system modules
import arcpy

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

# Set local variables
inRaster = "flowstr"
outLines = "c:/output/flowstream.shp"
backgrVal = "ZERO"
dangleTolerance = 50
field = "VALUE"

# Run RasterToPolygon
arcpy.conversion.RasterToPolyline(inRaster, outLines, backgrVal, 
                                  dangleTolerance, "SIMPLIFY", field)