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

Доступно с лицензией Advanced.

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

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

Иллюстрация

Рисунок Объект в точку

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

  • Атрибуты входных объектов будут скопированы в выходной класс объектов. Новое поле 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")

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

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

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