| Подпись | Описание | Тип данных |
Входные объекты | Входные объекты, которые могут быть линейными или полигональными, или и теми и другими. | Feature Layer |
Выходной класс пространственных объектов | Выходной класс линейных объектов. | Feature Class |
Допуск XY (Дополнительный) | Минимальное допустимое расстояние между координатами пространственного объекта, и расстояние, на которое может переместиться координата по X, Y, или и то и то в пространственных вычислениях. Для входных объектов, являющихся параметрическими (истинными) кривыми, выходные линии будут оставаться истинными кривыми, даже если они разбиты. Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Сохранить атрибуты (Дополнительный) | Указывает, сохранять или не сохранять входные атрибуты пространственных объектов в выходном классе пространственных объектов.
| Boolean |
Краткая информация
Создает класс пространственных объектов, содержащий линии, созданные путем конвертации границ полигонов в линии, или путем разбиения линий, полигонов, или двух пространственных объектов в их пересечении.
Иллюстрация
Использование
Входные атрибуты, если необходимо, можно сохранить в выходном классе пространственных объектов, отметив в диалоговом окне опцию Сохранить атрибуты (параметр attributes в скриптах).
Если в списке входных объектов задано несколько классов пространственных объектов или слоёв, порядок объектов в списке не влияет на тип выходных объектов, но пространственная привязка верхнего объекта в диалоговом окне инструмента (первый объект в скриптах) в списке будет использоваться в процессе обработки и будет установлена на выходные данные.
В точках касания, пересечения или наложения входных линий или полигонов, кроме начальной и конечной вершин, линии будут разбиты на фрагменты; каждый фрагмент станет выходным линейным объектом. Если входную линию или полигон не пересекают другие пространственные объекты, линия или полигон целиком копируется в выходной класс объектов, как линейный объект.
Для составных входных объектов, выходные линии будут состоять из одной части.
Для входных объектов, являющихся параметрическими (истинными) кривыми, выходные линии будут оставаться истинными кривыми, даже если они разбиты. Не применяется к данным шейп-файла.
Если в диалоговом окне включена опция Сохранить атрибуты (параметр attributes установлен на ATTRIBUTES в скриптах), атрибуты входных элементов будут сохранены в выходных данных в той же последовательности, что элементы входного списка. В выходные данные для каждого входного элемента будет добавлено новое поле, FID_xxx, где xxx – это имя исходного класса объектов конкретной входной записи; в поле копируются идентификаторы исходных объектов. Выходные линии ассоциируются с атрибутами следующими способами:
- Для совпадающих линий и границ полигонов в одном наборе входных объектов (например, граница, разделяющая два полигона) в выходной класс объектов будут записаны два линейных объекта с идентичной геометрией, и каждому будут приписаны атрибуты исходного объекта.
- Для совпадающих линий или границ полигонов из двух различных наборов входных объектов, например, линия, совпадающая с границей полигона, в выходные данные будет записан только один линейный объект с атрибутами двух исходных объектов.
- Если выходная линия не совпадает с каким-либо пространственным объектом в конкретном наборе входных объектов, она будет иметь значение -1 в поле FID_xxx и нулевые значения в других полях из этого набора объектов.
Если в диалоговом окне не включена опция Сохранить атрибуты (параметр attributes установлен на NO_ATTRIBUTES в скриптах), ни один из входных атрибутов не будет скопирован в выходной класс объектов; для каждого набора совпадающих линий или границ полигонов в выходные данные будет записан один линейный объект.
Если входные объекты содержат смежные полигоны, для получения выходных линейных объектов, представляющих общую границу смежных полигонов, с атрибутами, содержащими идентификаторы левого и правого полигона, используйте инструмент Полигон в линию.
Для повышения производительности и масштабируемости этот инструмент использует разбиение на листы при обработке очень больших наборов данных. Для получения более подробной информации см. Обработка больших наборов данных с разбиением на листы.
Параметры
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 (Дополнительный) | Указывает, сохранять или нет входные атрибуты в выходном классе объектов.
| Boolean |
Пример кода
В следующем скрипте окна 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 в среде скриптов.
# 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")