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

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

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

Иллюстрация

Иллюстрация Объект в полигон

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

  • Новый полигональный объект строится из области, сформированной одним или несколькими входными объектами и записывается в выходной класс объектов. Выходные атрибуты будут варьироваться в зависимости от значения параметров Сохранить атрибуты и Надписать объекты.

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

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

  • Примечание:

    Рекомендуется не использовать параметр Сохранить атрибуты, так как он больше не поддерживается и не работает. Однако он останется для обратной совместимости скриптов и моделей. Схема выходных атрибутивных полей и значения атрибутов для конкретных комбинаций описаны ниже; большинство из них формируются самопроизвольно.

    Если выбран параметр Сохранить атрибуты, то выходная схема атрибутов и значения полей будут зависеть от того, каким способом предоставляются объекты-метки (точки):

    • Если значения параметра Надписать объекты отсутствуют, атрибутивная схема (имена и свойства полей, а не значения полей) из каждой входной записи будет перенесена в выходные данные, в порядке их перечисления в списке входных данных. В выходные данные для каждого входного элемента добавляется новое поле FID_xxx, где xxx – это имя исходного класса пространственных объектов конкретной входной записи. Данному полю присваивается значение -1. Всем остальным полям присваивается значение 0 или они не имеют значений.
    • Если значение параметра Надписать объекты введено, схемы входных атрибутов не переносятся в выходной класс пространственных объектов; в выходной класс пространственных объектов включаются только атрибуты надписей объектов. Если выходной полигон содержит точечный объект-метку, значения полей полигона будут взяты из атрибутов объекта-метки. Если выходной полигон содержит более одной метки, значения полей будут взяты из одной из меток, иначе он будет имет нулевые значения или занчения null.
  • Если параметр Сохранять атрибуты не выбран, входные схемы атрибутов будут записаны в выходные данные, однако значения атрибутов будут пустыми. Укажите точечный класс пространственных объектов, который не имеет атрибутов для параметра Объекты метки, чтобы атрибуты отсутствовали в выходном полигональном классе объектов.

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

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

Параметры

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

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

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

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

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

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

Внимание:

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

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

Этот параметр более не поддерживается. Этот параметр остается для обратной совместимости скриптов и моделей. Более подробно см. в разделе Использование.

Boolean
Надписать объекты
(Дополнительный)

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

Feature Layer

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

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

Feature Layer
out_feature_class

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

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

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

Внимание:

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

Linear Unit
attributes
(Дополнительный)
Примечание:

Этот параметр более не поддерживается. Этот параметр остается для обратной совместимости скриптов и моделей. Более подробно см. в разделе Использование.

Boolean
label_features
(Дополнительный)

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

Feature Layer

Пример кода

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

Пример скрипта окна Python для использования функции FeatureToPolygon в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPolygon(["mainroads.shp","streets.shp"],
                                  "c:/output/output.gdb/streetblocks",
                                  "", "NO_ATTRIBUTES")
FeatureToPolygon, пример 2 (автономный скрипт)

Пример скрипта Python является простым примером выполнения функции FeatureToPolygon в среде написания скриптов.

# Name: FeatureToPolygon_Example2.py
# Description: Use FeatureToPolygon function to construct habitat areas
#              from park boundaries and rivers.

# Import system modules 
import arcpy

# Set environment settings
arcpy.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.management.FeatureToPolygon(inFeatures, outFeatureClass, clusTol,
                                  "NO_ATTRIBUTES")

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