Point

Сводка

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

Описание

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

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

Синтаксис

 Point ({X}, {Y}, {Z}, {M}, {ID})
ParameterОбъяснениеТип данных
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, {relation})

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

contains является противоположностью within.

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

Возможно содержит отношения
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, {relation})

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

within является противоположностью оператора contains.

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

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

Базовая геометрия находится внутри сравниваемой геометрии, если она является пересечением геометрий, и пересечение их внутренних частей не является пустым. within является оператором Клементини, за исключением случаев, когда базовая геометрия пуста.

Методы

clone (point_object)
ParameterОбъяснениеТип данных
point_object

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

Point
contains (second_geometry, {relation})
ParameterОбъяснениеТип данных
second_geometry

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

Object
relation

Типы пространственных отношений.

  • BOUNDARY У отношений нет ограничений для внутренних частей или границ.
  • CLEMENTINI Внутренние части геометрии должны пересекаться. Указание CLEMENTINI эквивалентно None. Используется по умолчанию.
  • PROPER Границы геометрии не должны пересекаться.

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

String
Значение отраженного сигнала
Тип данныхОбъяснение
Boolean

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

crosses (second_geometry)
ParameterОбъяснениеТип данных
second_geometry

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

Object
Значение отраженного сигнала
Тип данныхОбъяснение
Boolean

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

disjoint (second_geometry)
ParameterОбъяснениеТип данных
second_geometry

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

Object
Значение отраженного сигнала
Тип данныхОбъяснение
Boolean

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

equals (second_geometry)
ParameterОбъяснениеТип данных
second_geometry

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

Object
Значение отраженного сигнала
Тип данныхОбъяснение
Boolean

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

overlaps (second_geometry)
ParameterОбъяснениеТип данных
second_geometry

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

Object
Значение отраженного сигнала
Тип данныхОбъяснение
Boolean

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

touches (second_geometry)
ParameterОбъяснениеТип данных
second_geometry

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

Object
Значение отраженного сигнала
Тип данныхОбъяснение
Boolean

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

within (second_geometry, {relation})
ParameterОбъяснениеТип данных
second_geometry

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

Object
relation

Типы пространственных отношений.

  • BOUNDARY У отношений нет ограничений для внутренних частей или границ.
  • CLEMENTINI Внутренние части геометрии должны пересекаться. Указание CLEMENTINI эквивалентно None. Используется по умолчанию.
  • PROPER Границы геометрии не должны пересекаться.

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

String
Значение отраженного сигнала
Тип данныхОбъяснение
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))

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