Point (arcpy)

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

Объект point часто используется с курсорами. Точечные объекты вместо массива точечных объектов возвращают единственный объект point. Все другие типы объектов – полигоны, полилинии и мультиточки – возвращают массив точечных объектов или, если объект имеет несколько частей, выходной массив содержит массивы точечных объектов.

Обсуждение

Point не является классом геометрии, но обычно используется для построения геометрии. В приведенном ниже примере, Point используется для создания объекта PointGeometry.

point = arcpy.Point(25282, 43770)
ptGeometry = arcpy.PointGeometry(point)

Синтаксис

Point ({X}, {Y}, {Z}, {M}, {ID})
ПараметрОбъяснениеТип данных
X

X-координата точки.

(Значение по умолчанию — 0.0)

Double
Y

Y-координата точки.

(Значение по умолчанию — 0.0)

Double
Z

Z-координата точки.

(Значение по умолчанию — None)

Double
M

M-значение точки.

(Значение по умолчанию — None)

Double
ID

ID формы точки.

(Значение по умолчанию — 0)

Integer

Свойства

СвойствоОбъяснениеТип данных
ID
(чтение и запись)

Целое число, используемое для уникальной идентификации точки

Integer
M
(чтение и запись)

Значение измерения в точке.

Double
X
(чтение и запись)

Горизонтальная координата точки.

Double
Y
(чтение и запись)

Вертикальная координата точки.

Double
Z
(чтение и запись)

Значение высоты точки.

Double

Обзор метода

МетодОбъяснение
clone (point_object)

Клонирует точечный объект.

contains (second_geometry)

Показывает, если базовая геометрия содержит сравнение геометрии.

содержит (contains) является обратной ситуацией находится в (within).

На этом рисунке показаны только отношения True.

Возможные отношения содержит (contains)
crosses (second_geometry)

Указывает на то, что две геометрии пересекаются в геометрии меньшего типа формы.

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

На этом рисунке показаны только отношения True.

Возможные отношения пересечения (crosses)
disjoint (second_geometry)

Указывает, что базовая и сопоставляемая геометрия не имеют общих точек.

Две геометрии пересекаются, если disjoint возвращает False.

На этом рисунке показаны только отношения True.

Возможные отношения дизъюнктный (disjoint)
equals (second_geometry)

Указывает, имеют ли основная и сравнительная геометрии одинаковый тип формы и определяют ли они один и то же набор точек на плоскости. Сравнение производится только в 2D; значения M и Z не учитываются.

На этом рисунке показаны только отношения True.

Возможные отношения тождества (equals)
overlaps (second_geometry)

Показывает, если пересечение двух геометрий имеет тот же тип формы, что и входная геометрия и не эквивалентно любой из входных геометрий.

На этом рисунке показаны только отношения True.

Возможные отношения наложения
touches (second_geometry)

Указывает на то, что границы геометрии пересекаются.

Две геометрии соприкасаются, если пересечение геометрий не является пустым, а пересечение их внутренних частей пусто. Например, точка касается полилинии, только, если точка совпадает с одной из конечных точек полилинии.

На этом рисунке показаны только отношения True.

Возможные отношения касания (touches)
within (second_geometry)

Показывает, если базовая геометрия находится внутри сравнения геометрии.

операторнаходится в (within) является обратным оператору содержит (contains).

На этом рисунке показаны только отношения True.

Возможные отношения находится в (within)

Методы

clone (point_object)
ПараметрОбъяснениеТип данных
point_object

Точечный объект.

Point
contains (second_geometry)
ПараметрОбъяснениеТип данных
second_geometry

Вторая геометрия.

Object
Возвращено значение
Тип данныхОбъяснение
Boolean

Возвращенное логическое значение True указывает, что данная геометрия содержит вторую геометрию.

crosses (second_geometry)
ПараметрОбъяснениеТип данных
second_geometry

Вторая геометрия.

Object
Возвращено значение
Тип данныхОбъяснение
Boolean

Возвращенное логическое значение True указывает пересечение двух геометрий в геометрии меньшего типы формы.

disjoint (second_geometry)
ПараметрОбъяснениеТип данных
second_geometry

Вторая геометрия.

Object
Возвращено значение
Тип данныхОбъяснение
Boolean

Возвращенное логическое значение True указывает, что у двух геометрий нет общих точек.

equals (second_geometry)
ПараметрОбъяснениеТип данных
second_geometry

Вторая геометрия.

Object
Возвращено значение
Тип данныхОбъяснение
Boolean

Полученное логическое значение Истина (True) указывает на то, что обе эти геометрии имеют одинаковый тип формы и определяют один и тот же набор точек на плоскости.

overlaps (second_geometry)
ПараметрОбъяснениеТип данных
second_geometry

Вторая геометрия.

Object
Возвращено значение
Тип данныхОбъяснение
Boolean

Полученное логическое значение True указывает, что пересечение двух этих геометрий имеет такой же размер, как одна из входных геометрий.

touches (second_geometry)
ПараметрОбъяснениеТип данных
second_geometry

Вторая геометрия.

Object
Возвращено значение
Тип данныхОбъяснение
Boolean

Возвращенное логическое значение True указывает, что границы геометрий пересекаются.

within (second_geometry)
ПараметрОбъяснениеТип данных
second_geometry

Вторая геометрия.

Object
Возвращено значение
Тип данныхОбъяснение
Boolean

Возвращенное логическое значение True указывает, что данная геометрия содержится внутри второй геометрии.

Пример кода

Point, пример

Создает объект Point и отображает его свойства.

import arcpy

# Create point object
point = arcpy.Point(2000, 2500)

# Print point properties
print("Point properties:")
print(" ID: {0}".format(point.ID))
print(" X:  {0}".format(point.X))
print(" Y:  {0}".format(point.Y))
Point, пример 2

Изучает объекты point в полигональном объекте array, возвращенном из объекта geometry.

import arcpy

# Create cursor to retrieve Hawaii shape
feature_class = "c:/data/Hawaii.shp"
cursor = arcpy.da.SearchCursor(feature_class, ["SHAPE@"])

for row in cursor:
    # Get the geometry object from the shape field
    print("Number of Hawaiian islands: {0}".format(row[0].partCount))

    # GetPart returns an array of point objects for each part.
    for island in row[0].getPart():
        print("Vertices in island: {0}".format(island.count))
        for point in island:
            print("X: {0}, Y: {1})".format(point.X, point.Y))

Связанные темы

5/10/2014