Extent

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

Экстентом является прямоугольник, заданный координатами левого нижнего угла и верхнего правого угла в единицах карты.

Обсуждение

Объект Extent обеспечивает работу операторов equal (==) и not equal (!=) для сравнения экстентов.

Примечание:

Если используются в качестве входных данных для инструментов Дополнительный модуль ArcGIS Spatial Analyst - Создать константный растр, Создать нормальный растр, Создать произвольный растр, Извлечь по прямоугольнику, Извлечь по маске и Топо в растр - то в них используются только значения XMin, YMin, XMax и YMax.

Синтаксис

 Extent  ({XMin}, {YMin}, {XMax}, {YMax}, {ZMin}, {ZMax}, {MMin}, {MMax}, {spatial_reference})
ПараметрОписаниеТип данных
XMin

Значение XMin экстента.

Double
YMin

Значение YMin экстента.

Double
XMax

Значение XMax экстента.

Double
YMax

Значение YMax экстента.

Double
ZMin

Значение ZMin экстента. None, если значения z отсутствуют.

Double
ZMax

Значение ZMax экстента. None, если значения z отсутствуют.

Double
MMin

Значение MMin экстента. None, если значения m отсутствуют.

Double
MMax

Значение MMax экстента. None, если значения m отсутствуют.

Double
spatial_reference

Пространственная привязка экстента.

SpatialReference

Свойства

СвойствоОписаниеТип данных
JSON
(только чтение)

Возвращает JSON-представление экстента в виде строки.

Подсказка:

Возвращаемая строка может быть конвертирована в словарь с помощью функции loads модуля json.

String
MMax
(только чтение)

Значение MMax экстента. None, если значения m отсутствуют.

Double
MMin
(только чтение)

Значение MMin экстента. None, если значения m отсутствуют.

Double
XMax
(только чтение)

Значение XMax экстента.

Double
XMin
(только чтение)

Значение XMin экстента.

Double
YMax
(только чтение)

Значение YMax экстента.

Double
YMin
(только чтение)

Значение YMin экстента.

Double
ZMax
(только чтение)

Значение ZMax экстента. None, если значения z отсутствуют.

Double
ZMin
(только чтение)

Значение ZMin экстента. None, если значения z отсутствуют.

Double
depth
(только чтение)

Значение глубины экстента. None, если значения глубины отсутствуют.

Double
geohash
(только чтение)

Возвращается строка экстента geohash.

String
geohashCovers
(только чтение)

Возвращается список до четырех самых длинных строк geohash, которые попадают в экстент.

String
geohashNeighbors
(только чтение)

Возвращается список строк экстента окрестности geohash.

String
height
(только чтение)

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

Double
lowerLeft
(только чтение)

Параметр нижней левой точки: Возвращается точечный объект.

Point
lowerRight
(только чтение)

Параметр нижней правой точки: Возвращается точечный объект.

Point
polygon
(только чтение)

Возвращается экстент в виде полигонального объекта.

Polygon
spatialReference
(только чтение)

Пространственная привязка экстента.

SpatialReference
upperLeft
(только чтение)

Параметр верхней левой точки: Возвращается точечный объект.

Point
upperRight
(только чтение)

Параметр верхней правой точки: Возвращается точечный объект.

Point
width
(только чтение)

Значение ширины экстента.

Double

Обзор метода

МетодОписание
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.

Возможные отношения наложения
projectAs (spatial_reference, {transformation_name})

Проецирует геометрию и при необходимости применяет географическую трансформацию.

Для проецирования у геометрии должна быть пространственная привязка, а не неизвестная система координат. Новая система пространственной привязки, переданная методу, определяет выходную систему координат. Если какая-либо пространственная привязка неизвестна, координаты не будут изменены. Значение z и m не меняются методом projectAs.

touches (second_geometry)

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

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

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

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

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

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

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

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

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

Методы

contains (second_geometry, {relation})
ПараметрОписаниеТип данных
second_geometry

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

Object
relation

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

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

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

String
Возвращаемое значение
Тип данныхОписание
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 указывает, что пересечение двух этих геометрий имеет такой же размер, как одна из входных геометрий.

projectAs (spatial_reference, {transformation_name})
ПараметрОписаниеТип данных
spatial_reference

The spatial reference of the projected geometry. This can be a SpatialReference object or the coordinate system name.

SpatialReference
transformation_name

The geotransformation name.

With ArcGIS Pro, if you do not specify a transformation, none will be applied. With ArcGIS Server, if you do not specify a transformation, a fallback transformation will be applied.

String
Возвращаемое значение
Тип данныхОписание
Object

Геометрия после проецирования.

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

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

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

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

within (second_geometry, {relation})
ПараметрОписаниеТип данных
second_geometry

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

Object
relation

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

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

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

String
Возвращаемое значение
Тип данныхОписание
Boolean

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

Пример кода

Образец экстента

Отображают свойства объекта Экстент (extent) для пространственных объектов.

import arcpy

feature_class = 'c:/Data/Florida.gdb/airports'

# Fetch each feature from the cursor and examine the extent properties
for row in arcpy.da.SearchCursor(feature_class, ['SHAPE@', 'CNTY_NAME']):
    extent = row[0].extent
    print('Extent of county {}:'.format(row[1]))
    print('XMin: {}, YMin: {}'.format(extent.XMin, extent.YMin))
    print('XMax: {}, YMax: {}'.format(extent.XMax, extent.YMax))

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