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

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

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

Иллюстрация

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

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

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

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

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

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

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

Параметры

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

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

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

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

Feature Class
Внутри
(Дополнительный)

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

  • Не отмечено – использует относительный центр входного объекта в качестве выходного местоположения точки. Это местоположение не всегда должно содержаться внутри входного объекта. Это значение по умолчанию
  • Отмечено: для определения местоположения выходной точки используется местоположение внутри входного пространственного объекта.

Boolean

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")