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

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

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

Иллюстрация

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

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

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

Параметры

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

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

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

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

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

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

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

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

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

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

  • Мультиточечные объекты — Выходная точка будет совпадать с одной из точек в мультиточке.
  • Линейные объекты — Выходная точка будет на линии. Если линия является параметрической (истинной) кривой, выходная точка будет на средней точке линии.
  • Полигональные объекты — Выходная точка будет находиться внутри полигона.

Boolean

arcpy.management.FeatureToPoint(in_features, out_feature_class, {point_location})
ИмяОписаниеТип данных
in_features

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

Feature Layer
out_feature_class

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

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

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

  • CENTROIDВыходная точка будет расположена в центроиде входного объекта. Выходная точка не всегда может содержаться во входном объекте. Это значение по умолчанию
  • INSIDEВыходная точка будет расположена внутри входного объекта.

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

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

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

  • Мультиточечные объекты — Выходная точка будет совпадать с одной из точек в мультиточке.
  • Линейные объекты — Выходная точка будет на линии. Если линия является параметрической (истинной) кривой, выходная точка будет на средней точке линии.
  • Полигональные объекты — Выходная точка будет находиться внутри полигона.

Boolean

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPoint("parcels.shp", "c:/data/output/parcels_center.shp", 
                                "CENTROID")
FeatureToPoint пример 2 (автономный скрипт)

Пример скрипта Python является простым примером выполнения функции 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.management.FeatureToPoint(inFeatures, outFeatureClass, "INSIDE")