Объект в полигон (Управление данными (Data Management))
Краткая информация
Создает класс пространственных объектов, содержащий полигоны, построенные из областей, охваченных входными линейными или полигональными объектами.
Рисунок
 |
Объект в полигон (Feature To Polygon) |
Использование
-
Новый полигональный объект строится из области, сформированной одним или несколькими входными объектами и записывается в выходной класс объектов. Выходные атрибуты будут варьироваться в зависимости от опции Сохранить атрибуты (Preserve attributes) диалогового окна (параметр attributes в скриптах) и опции Надписать объекты (Label Features) диалогового окна (параметр Надписать объекты (Label Features) в скрипте).
-
Если в списке входных объектов задано несколько классов пространственных объектов или слоев, порядок объектов в списке не влияет на тип выходных объектов, но пространственная привязка верхнего объекта в диалоговом окне инструмента (первый объект в скриптах) в списке будет использоваться в процессе обработки и будет установлена на выходные данные.
-
Параметрические (истинные) кривые в входных объектах останутся истинными кривыми в выходных полигонах, даже если они разбиты. Не применяется к данным шейп-файла.
-
Примечание:Параметр Сохранить атрибуты (Preserve attributes) (параметр attributes в скриптах) не работает, и его не следует использовать. Параметр не может быть удален для обратной совместимости скриптов или моделей. Схема выходных атрибутивных полей и значения атрибутов для конкретных комбинаций описаны ниже; большинство из них формируются самопроизвольно.
Если отмечена опция Сохранить атрибуты (Preserve attributes) диалогового окна (параметр attributes установлен на ATTRIBUTES в скриптах), выходная схема атрибутов и значения поля будут зависеть от того, будут ли созданы объекты меток (точки):
- Если Надписать объекты (Label Features) отсутствуют, атрибутивная схема (имена и свойства полей, а не значения полей) из каждой входной записи будет перенесена в выходные данные, в порядке их перечисления в списке входных данных. В выходные данные для каждого входного элемента добавляется новое поле — FID_xxx, где xxx - это имя исходного класса пространственных объектов конкретной входной записи. Данному полю присваивается значение -1. Всем остальным полям присваивается значение 0 или они не имеют значений.
- Если Надписать объекты (Label Features) отмечено, схемы входных атрибутов не переносятся в выходной класс пространственных объектов; в выходной класс пространственных объектов включаются только атрибуты надписей объектов. Если выходной полигон содержит точечный объект-метку, значения полей полигона будут взяты из атрибутов объекта-метки. Если выходной полигон содержит более одной метки, значения полей будут взяты из одной из меток.
Если в диалоговом окне не отмечена опция Сохранить атрибуты (Preserve attributes) (параметр атрибуты (attributes) установлен на NO_ATTRIBUTES в скриптах), входные схемы атрибутов сохраняются в выходных данных, но значения атрибутов являются пустыми. Укажите точечный класс пространственных объектов, который не имеет атрибутов для параметра Объекты метки (Label Features), чтобы атрибуты отсутствовали в выходном полигональном классе объектов.
-
Если входные полигональные объекты разбиты на меньшие выходные полигональные пространственные объекты, параметр Идентичность (Identity) может быть использован для переноса атрибутов из входных полигональных объектов в результирующие полигональные пространственные объекты.
-
Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости. Для получения более подробной информации см. Геообработка больших наборов данных.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_features [in_features,...] |
Входные объекты, которые могут быть линейными или полигональными, или и теми и другими. | Feature Layer |
out_feature_class |
Выходной класс полигональных объектов. | Feature Class |
cluster_tolerance (дополнительно) |
Минимальное допустимое расстояние между координатами пространственного объекта, и расстояние, на которое может переместиться координата по X, Y, или и то и то в пространственных вычислениях. Для входных объектов, являющихся параметрическими (истинными) кривыми, выходные линии будут оставаться истинными кривыми, даже если они разбиты. | Linear unit |
attributes (дополнительно) |
Устанавливает, сохранять ли схему входных атрибутов или атрибуты из объектов меток в выходном классе объектов, или пропускать входные атрибуты в выходном классе объектов. Этот параметр не работает. Параметр не может быть удален для обратной совместимости скриптов или моделей. Схема выходных атрибутивных полей и значения атрибутов для конкретных комбинаций описаны в советах по использованию; большинство из них формируются самопроизвольно.
| Boolean |
label_features (дополнительно) |
Дополнительные входные точечные объекты, содержащие атрибуты, которые будут перенесены в выходные полигональные объекты. | Feature Layer |
Пример кода
Пример скрипта Python для выполнения функции Объект в полигон (Feature To Polygon) с запуском из окна Python в ArcGIS.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.FeatureToPolygon_management(["mainroads.shp","streets.shp"],
"c:/output/output.gdb/streetblocks",
"", "NO_ATTRIBUTES", "")
Пример скрипта Python для выполнения функции Объект в полигон (Feature To Polygon) в автономном режиме.
# Name: FeatureToPolygon_Example2.py
# Description: Use FeatureToPolygon function to construct habitat areas
# from park boundaries and rivers.
# Author: ESRI
# import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data/parks_analysis.gdb"
# Set local parameters
inFeatures = ["park_boundaries", "rivers"]
outFeatureClass = "c:/output/output.gdb/habitat_areas"
clusTol = "0.05 Meters"
# Use the FeatureToPolygon function to form new areas
arcpy.FeatureToPolygon_management(inFeatures, outFeatureClass, clusTol,
"NO_ATTRIBUTES", "")