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

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

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

Иллюстрация

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

• Атрибуты входных объектов будут скопированы в выходной класс объектов. Новое поле ORIG_FID будет добавлено к выходному классу объектов, оно будет содержать ID входных объектов.

• Если в диалоговом окне опция Внутри не отмечена (параметр point_location задан как CENTROID), местоположение выходной точки будет определяться следующим образом:

  • Выходная точка входного мультиточечного объекта соответствует средней точке, вычисленной на основе координат x и y всех точек мультиточечного объекта.
  • Для входного линейного объекта: выходная точка будет располагаться на взвешенном среднем координат x и y средней точки всех линейных сегментов линейного объекта; где вес конкретной средней точки соответствует длине соответствующего линейного сегмента. Для параметрических (истинных) кривых сначала необходимо провести процедуру уплотнения.
  • Выходная точка входного полигонального объекта располагается в центроиде полигона.

  Если в диалоговом окне опция Внутри отмечена (параметр point_location задан как INSIDE), то местоположение соответствующей точки входного объекта будет содержаться во входном объекте и определяться следующим образом:

  • Выходная точка для входных данных мультиточки совмещается с одной из точек в мультиточке.
  • Для входной линии: выходная точка будет на линии. Если линия является параметрической (истинной) кривой, выходная точка будет на средней точке линии.
  • Выходная точка для входных данных полигона находится внутри полигона.

Параметры

Диалог

Подпись	Описание	Тип данных
Входные объекты	Входные объекты могут быть мультиточками, линиями, полигонами или аннотациями.	Feature Layer
Выходной класс пространственных объектов	Выходной класс точечных объектов.	Feature Class
Внутри (Дополнительный)	Устанавливает, использовать ли центральные точки входных объектов или точки, находящиеся внутри входных объектов, в качестве выходных местоположений точек. Не отмечено – использует относительный центр входного объекта в качестве выходного местоположения точки. Это местоположение не всегда должно содержаться внутри входного объекта. Это значение по умолчанию Отмечено: для определения местоположения выходной точки используется местоположение внутри входного пространственного объекта.	Boolean

Python

arcpy.management.FeatureToPoint(in_features, out_feature_class, {point_location})

Имя	Описание	Тип данных
in_features	Входные объекты могут быть мультиточками, линиями, полигонами или аннотациями.	Feature Layer
out_feature_class	Выходной класс точечных объектов.	Feature Class
point_location (Дополнительный)	Устанавливает, использовать ли центральные точки входных объектов или точки, находящиеся внутри входных объектов, в качестве выходных местоположений точек. CENTROID—Использует относительный центр входного объекта в качестве выходного местоположения точки. Это точечное местоположение не всегда должно содержаться внутри входного объекта. Это значение по умолчанию INSIDE—Для определения местоположения выходной точки используется местоположение внутри входного пространственного объекта.	Boolean

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.FeatureToPoint_management("parcels.shp", "c:/data/output/parcels_center.shp", 
                                "CENTROID")

FeatureToPoint пример 2 (автономный скрипт)

Следующий автономный сценарий представляет собой простой пример того, как применить функцию FeatureToPoint в среде разработки скриптов.

# Name: FeatureToPoint_Example2.py
# Description: Use FeatureToPoint function to find a point inside each park

# import system modules 
import arcpy

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

#  Set local variables
inFeatures = "parks.shp"
outFeatureClass = "c:/output/output.gdb/parks_pt"

# Use FeatureToPoint function to find a point inside each park
arcpy.FeatureToPoint_management(inFeatures, outFeatureClass, "INSIDE")

Параметры среды

Текущая рабочая область, Временная рабочая область, Выходное значение Z по умолчанию, Разрешение M, Допуск M, Выходной домен M, Выходной домен Z, Выходная система координат, Экстент, Выходные данные имеют M-значения, Выходные данные имеют Z-значения, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z

Информация о лицензиях

• Basic: Да
• Standard: Да
• Advanced: Да