Point (arcpy)
Краткая информация
Объект point часто используется с курсорами. Точечные объекты вместо массива точечных объектов возвращают единственный объект point. Все другие типы объектов – полигоны, полилинии и мультиточки – возвращают массив точечных объектов или, если объект имеет несколько частей, выходной массив содержит массивы точечных объектов.
Обсуждение
Point не является классом геометрии, но обычно используется для построения геометрии. В приведенном ниже примере, Point используется для создания объекта PointGeometry.
point = arcpy.Point(25282, 43770)
ptGeometry = arcpy.PointGeometry(point)
Синтаксис
Параметр | Объяснение | Тип данных |
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. |
crosses (second_geometry) |
Указывает на то, что две геометрии пересекаются в геометрии меньшего типа формы. Две полилинии пересекаются, если только они имеют точки соприкосновения, по крайней мере, одна из которых не является конечной точкой. Полилиния и полигон пересекаются, если они имеют общую линию или точку (для вертикальной линии) внутри полигона, который не эквивалентен всей полилинии. На этом рисунке показаны только отношения True. |
disjoint (second_geometry) |
Указывает, что базовая и сопоставляемая геометрия не имеют общих точек. Две геометрии пересекаются, если disjoint возвращает False. На этом рисунке показаны только отношения True. |
equals (second_geometry) |
Указывает, имеют ли основная и сравнительная геометрии одинаковый тип формы и определяют ли они один и то же набор точек на плоскости. Сравнение производится только в 2D; значения M и Z не учитываются. На этом рисунке показаны только отношения True. |
overlaps (second_geometry) |
Показывает, если пересечение двух геометрий имеет тот же тип формы, что и входная геометрия и не эквивалентно любой из входных геометрий. На этом рисунке показаны только отношения True. |
touches (second_geometry) |
Указывает на то, что границы геометрии пересекаются. Две геометрии соприкасаются, если пересечение геометрий не является пустым, а пересечение их внутренних частей пусто. Например, точка касается полилинии, только, если точка совпадает с одной из конечных точек полилинии. На этом рисунке показаны только отношения True. |
within (second_geometry) |
Показывает, если базовая геометрия находится внутри сравнения геометрии. операторнаходится в (within) является обратным оператору содержит (contains). На этом рисунке показаны только отношения True. |
Методы
Параметр | Объяснение | Тип данных |
point_object |
Точечный объект. | Point |
Параметр | Объяснение | Тип данных |
second_geometry |
Вторая геометрия. | Object |
Тип данных | Объяснение |
Boolean |
Возвращенное логическое значение True указывает, что данная геометрия содержит вторую геометрию. |
Параметр | Объяснение | Тип данных |
second_geometry |
Вторая геометрия. | Object |
Тип данных | Объяснение |
Boolean | Возвращенное логическое значение True указывает пересечение двух геометрий в геометрии меньшего типы формы. |
Параметр | Объяснение | Тип данных |
second_geometry |
Вторая геометрия. | Object |
Тип данных | Объяснение |
Boolean | Возвращенное логическое значение True указывает, что у двух геометрий нет общих точек. |
Параметр | Объяснение | Тип данных |
second_geometry |
Вторая геометрия. | Object |
Тип данных | Объяснение |
Boolean |
Полученное логическое значение Истина (True) указывает на то, что обе эти геометрии имеют одинаковый тип формы и определяют один и тот же набор точек на плоскости. |
Параметр | Объяснение | Тип данных |
second_geometry |
Вторая геометрия. | Object |
Тип данных | Объяснение |
Boolean | Полученное логическое значение True указывает, что пересечение двух этих геометрий имеет такой же размер, как одна из входных геометрий. |
Параметр | Объяснение | Тип данных |
second_geometry |
Вторая геометрия. | Object |
Тип данных | Объяснение |
Boolean | Возвращенное логическое значение True указывает, что границы геометрий пересекаются. |
Параметр | Объяснение | Тип данных |
second_geometry |
Вторая геометрия. | Object |
Тип данных | Объяснение |
Boolean | Возвращенное логическое значение True указывает, что данная геометрия содержится внутри второй геометрии. |
Пример кода
Создает объект 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 в полигональном объекте 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))