Объект в линию (Управление данными)

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

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

Иллюстрация

Иллюстрация инструмента Объект в линию

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

  • Входные атрибуты, если необходимо, можно сохранить в выходном классе пространственных объектов, отметив в диалоговом окне опцию Сохранить атрибуты (параметр attributes в скриптах).

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

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

  • Для составных входных объектов, выходные линии будут состоять из одной части.

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

  • Если в диалоговом окне включена опция Сохранить атрибуты (параметр attributes установлен на ATTRIBUTES в скриптах), атрибуты входных элементов будут сохранены в выходных данных в той же последовательности, что элементы входного списка. В выходные данные для каждого входного элемента будет добавлено новое поле, FID_xxx, где xxx – это имя исходного класса объектов конкретной входной записи; в поле копируются идентификаторы исходных объектов. Выходные линии ассоциируются с атрибутами следующими способами:

    • Для совпадающих линий и границ полигонов в одном наборе входных объектов (например, граница, разделяющая два полигона) в выходной класс объектов будут записаны два линейных объекта с идентичной геометрией, и каждому будут приписаны атрибуты исходного объекта.
    • Для совпадающих линий или границ полигонов из двух различных наборов входных объектов, например, линия, совпадающая с границей полигона, в выходные данные будет записан только один линейный объект с атрибутами двух исходных объектов.
    • Если выходная линия не совпадает с каким-либо пространственным объектом в конкретном наборе входных объектов, она будет иметь значение -1 в поле FID_xxx и нулевые значения в других полях из этого набора объектов.

    Если в диалоговом окне не включена опция Сохранить атрибуты (параметр attributes установлен на NO_ATTRIBUTES в скриптах), ни один из входных атрибутов не будет скопирован в выходной класс объектов; для каждого набора совпадающих линий или границ полигонов в выходные данные будет записан один линейный объект.

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

  • Для повышения производительности и масштабируемости этот инструмент использует разбиение на листы при обработке очень больших наборов данных. Для получения более подробной информации см. Обработка больших наборов данных с разбиением на листы.

Параметры

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

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

Feature Layer
Выходной класс пространственных объектов

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

Feature Class
Допуск XY
(Дополнительный)

Минимальное допустимое расстояние между координатами пространственного объекта, и расстояние, на которое может переместиться координата по X, Y, или и то и то в пространственных вычислениях. Для входных объектов, являющихся параметрическими (истинными) кривыми, выходные линии будут оставаться истинными кривыми, даже если они разбиты.

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit
Сохранить атрибуты
(Дополнительный)

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

  • Отмечено: сохраняет входные атрибуты в выходных пространственных объектах. Это значение по умолчанию
  • Не отмечено: входные атрибуты в выходном классе пространственных объектов будут пропущены.
Boolean

arcpy.management.FeatureToLine(in_features, out_feature_class, {cluster_tolerance}, {attributes})
ИмяОписаниеТип данных
in_features
[in_features,...]

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

Feature Layer
out_feature_class

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

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

Минимальное допустимое расстояние между координатами пространственного объекта, и расстояние, на которое может переместиться координата по X, Y, или и то и то в пространственных вычислениях. Для входных объектов, являющихся параметрическими (истинными) кривыми, выходные линии будут оставаться истинными кривыми, даже если они разбиты.

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit
attributes
(Дополнительный)

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

  • ATTRIBUTESСохраняет входные атрибуты в выходных пространственных объектах. Это значение по умолчанию
  • NO_ATTRIBUTESПропускает входные атрибуты в выходном классе пространственных объектов.
Boolean

Пример кода

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

В следующем скрипте окна Python показано, как используется функция FeatureToLine в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.FeatureToLine_management(["majorrds.shp", "habitat_analysis.gdb/futrds"],
                               "c:/output/output.gdb/allroads",
                               "0.001 Meters", "ATTRIBUTES")
FeatureToLine, пример 2 (автономный скрипт)

Следующий автономный скрипт является примером применения функции FeatureToLine в среде скриптов.

# Name: FeatureToLine_Example2.py
# Description: Use FeatureToLine function to combine features from two 
#                  street feature classes into a single feature class,
#                  then determine an area of impact around all streets
#                  by buffering

# import system modules 
import arcpy

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

#  Set local variables
oldStreets = "majorrds.shp"
newStreets = "habitat_analysis.gdb/futrds"
uptodateStreets = "c:/output/output.gdb/allroads"

# Use FeatureToLine function to combine features into single feature class
arcpy.FeatureToLine_management([oldStreets, newStreets], uptodateStreets,
                               "0.001 Meters", "ATTRIBUTES")

# Use Buffer function to determine area of impact around streets
roadsBuffer = "c:/output/output.gdb/buffer_output"
arcpy.Buffer_analysis(uptodateStreets, roadsBuffer, "50 Feet",
                      "FULL", "ROUND", "ALL")

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