Считывание геометрии
Каждый объект в классе объектов содержит набор точек, определяющий вершины полигона или линии, либо единичную координату, определяющую точечный объект. К этим точкам можно получить доступ с помощью объектов геометрии (Полигон (Polygon), Полилиния (Polyline), PointGeometry или Мультиточка (MultiPoint)), возвращающих их в массив Точечных (Point) объектов.
Объекты могут иметь несколько частей. Свойство partCount объекта геометрии возвращает его количество частей. Метод getPart возвращает массив точечных объектов для конкретной части геометрии при указанном индексе. Если индекс не указан, возвращается массив, содержащий массивы точечных объектов для каждой части геометрии.
Объекты PointGeometry вместо массива точечных объектов возвращают единственный объект Точка (Point). Все другие типы объектов ― полигоны, полилинии и мультиточки ― возвращают массив точечных объектов. В случае, если объект имеет несколько частей, выходной массив содержит массивы точечных объектов.
Если полигон имеет пробелы, он состоит из нескольких колец. Массив точечных объектов, возвращаемый для полигона, содержит точки внешнего кольца и всех внутренних. Внешнее кольцо всегда возвращается первым. За ним следуют внутренние кольца, разделяемые нулевыми точечными объектами. Когда скрипт считывает координаты для полигонов в базе геоданных или шейп-файле, он должен содержать логику обработки внутренних колец, если эта информация требуется скриптом. Иначе считывается только внешнее кольцо.
Составной объект включает несколько физических частей, но связан только с одним набором атрибутов в базе данных. Например, штат Гавайи в слое штатов может считаться составным объектом. Хотя он и состоит из нескольких островов, в базе данных он будет записан как один объект.
Кольцо ― это замкнутый путь, определяющий двухмерную область. Корректное кольцо состоит из корректного пути, в котором стартовая и конечная точки кольца имеют одинаковые координаты x и y. Направленное по часовой стрелке кольцо является внешним, направленное против часовой стрелки ― внутренним.
Более подробно о написании геометрии
Использование маркеров геометрии
Маркерами геометрии можно также пользоваться как ярлыками вместо доступа к полным объектам геометрии. Дополнительные маркеры геометрии можно использовать для доступа к конкретным сведениям о геометрии. Доступ к полной геометрии более затратен по времени. Если требуются только конкретные свойства геометрии, используйте маркеры, чтобы предоставить горячие клавиши для доступа к свойствам геометрии. Например, SHAPE@XY возвратит кортеж координат x и y, представляющий центроиду объекта.
Токен | Описание |
---|---|
SHAPE@ | Объект geometry (геометрия) для пространственного объекта. |
SHAPE@XY | Кортеж x, y координат центроида объекта. |
SHAPE@TRUECENTROID | Кортеж x, y координат истинного центроида объекта. |
SHAPE@X | Значение двойной точности координаты х объекта. |
SHAPE@Y | Значение двойной точности координаты y объекта. |
SHAPE@Z | Значение двойной точности координаты z объекта. |
SHAPE@M | Значение двойной точности m для объекта. |
SHAPE@JSON | Строка esri JSON, представляющая геометрию. |
SHAPE@WKB | Стандартное двоичное (well-known binary, WKB) представление для геометрии OGC. Он обеспечивает портативное представление значения геометрии в виде непрерывного потока байтов. |
SHAPE@WKT | Стандартное текстовое (well-known text, WKT) представление для геометрии OGC. Он обеспечивает портативное представление значения геометрии в виде текстовой строки. |
SHAPE@AREA | Значение двойной точности для площади объекта. |
SHAPE@LENGTH | Значение двойной точности для длины объекта. |
Считывание геометрии точек
В примере, приведенном ниже, SearchCursor используется для вывода координат всех объектов:
import arcpy
infc = arcpy.GetParameterAsText(0)
# Enter for loop for each feature
#
for row in arcpy.da.SearchCursor(infc, ["SHAPE@XY"]):
# Print x,y coordinates of each point feature
#
x, y = row[0]
print("{0}, {1}".format(x, y))
С описанным выше классом скрипт возвратит следующую информацию:
2.0 4.0
8.0 10.0
7.0 5.0
Считывание геометрии мультиточек
import arcpy
infc = arcpy.GetParameterAsText(0)
# Enter for loop for each feature
#
for row in arcpy.da.SearchCursor(infc, ["OID@", "SHAPE@"]):
# Print the current multipoint's ID
#
print("Feature {0}:".format(row[0]))
# For each point in the multipoint feature,
# print the x,y coordinates
for pnt in row[1]:
print("{0}, {1}".format(pnt.X, pnt.Y))
С описанным выше классом скрипт возвратит следующую информацию:
Feature 0:
3.0 8.0
4.0 4.0
6.0 6.0
Feature 1:
5.0 9.0
8.0 10.0
Feature 2:
9.0 5.0
Считывание геометрий полилиний или полигонов
import arcpy
infc = arcpy.GetParameterAsText(0)
# Enter for loop for each feature
#
for row in arcpy.da.SearchCursor(infc, ["OID@", "SHAPE@"]):
# Print the current multipoint's ID
#
print("Feature {0}:".format(row[0]))
partnum = 0
# Step through each part of the feature
#
for part in row[1]:
# Print the part number
#
print("Part {0}:".format(partnum))
# Step through each vertex in the feature
#
for pnt in part:
if pnt:
# Print x,y coordinates of current point
#
print("{0}, {1}".format(pnt.X, pnt.Y))
else:
# If pnt is None, this represents an interior ring
#
print("Interior Ring:")
partnum += 1
С описанным выше классом скрипт возвратит следующую информацию: Объект 0 ― это полигон из одной части, объект 1 ― это полигон из двух частей, объект 2 ― это полигон из одной части со внутренним кольцом.
Feature 0:
Part 0:
3.0 8.0
1.0 8.0
2.0 10.0
3.0 8.0
Feature 1:
Part 0:
5.0 3.0
3.0 3.0
3.0 5.0
5.0 3.0
Part 1:
7.0 5.0
5.0 5.0
5.0 7.0
7.0 5.0
Feature 2:
Part 0:
9.0 11.0
9.0 8.0
6.0 8.0
6.0 11.0
9.0 11.0
Interior Ring:
7.0 10.0
7.0 9.0
8.0 9.0
8.0 10.0
7.0 10.0