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

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

Сводка

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

Иллюстрация

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

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

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

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

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

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

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

Синтаксис

arcpy.management.FeatureToPoint(in_features, out_feature_class, {point_location})
ParameterОбъяснениеТип данных
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: Да

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