Экстент (параметр среды)

Инструменты, использующие параметр среды Экстент, будут обрабатывать только те пространственные объекты или растры, которые находятся в пределах экстента, определенного в этом параметре.

Параметр среды Экстент определяет, какие пространственные объекты или растры будут обрабатываться инструментом. Он полезен, если вы обрабатываете только часть большого набора данных. Вы можете рассматривать этот параметр как прямоугольник, который используется для выборки входных объектов и растров для обработки. Прямоугольник используется только для выбора пространственных объектов, а не вырезания их. Экстент выходного набора данных, как правило, будет больше параметра Экстент для учета пространственных объектов или ячеек, проходящих через прямоугольник экстента.

Примечания по использованию

• Система координат, указанная в сворачиваемом разделе Система координат экстента, используется инструментами для интерпретации местоположения координат экстента и не зависит от среды Выходной системы координат.
• Опции Текущий экстент отображения , Нарисовать экстент и Экстент слоя используют систему координат активной карты.
• Опции Обзор и Буфер обмена используют систему координат набора данных или указанную систему координат.
• Опции Пересечение входных данных и Объединение входных данных определяют систему координат во время запуска инструмента и используют систему координат первого входного набора данных.
• Если указан экстент без системы координат, в экстенте будет использоваться система координат первого входного набора данных, используемого инструментом.

Синтаксис диалога

• Текущий экстент отображения — Экстент будет основан на активной карте или сцене.
• Нарисовать экстент - экстент будет основан прямоугольнике, нарисованном на карте или сцене.
• Экстент слоя — Экстент будет основан на активном слое карты. Выберите доступный слой или воспользуйтесь опцией Экстент данных во всех слоях. У каждого слоя карте есть следующие опции:
  • Все объекты - экстент всех объектов.
  • Выбранные объекты - экстент выбранных объектов.
  • Отображаемые объекты - экстент отображаемых объектов.

• Обзор - экстент будет основан на наборе данных.
• Пересечение входных данных - экстент будет основан на пересекающемся экстенте всех входных данных.
• Объединение входных данных - экстент будет комбинацией экстентов всех входных данных.
• Буфер обмена - экстент может быть скопирован в буфер обмена и из него.
  • Копировать экстент - копирует экстент и систему координат в буфер обмена.
  • Вставить экстент - вставляет экстент и систему координат из буфера обмена. Если буфер обмена не содержат систему координат, экстент будет использовать систему координат карты.
• Сбросить экстент - экстент будет сброшен до значения по умолчанию.

Примечание:

Если включена опция Включать и отключать редактирование на вкладке Редактирование, вы должны включить редактирование на вкладке ленты Редактирование, чтобы нарисовать экстент.

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

Когда вы используете опцию Текущий экстент отображения , Нарисовать экстент , Экстент слоя или Обзор , экстент считывается и сохраняется на данный момент; экстент позже не будет обновляться, если в карту, слой или набор данных будут внесены изменения. Опции Пересечение входных данных и Объединение входных данных будут определять экстент координат и систему координат во время работы инструмента.

Синтаксис скриптов

arcpy.env.extent = extent

Примечание:

Если задано, свойство параметра среды extent возвращается как объект Extent в Python.

Синтаксис extent

extent	Объяснение
Объект Extent	Объект Extent можно использовать для определения экстента.
MINOF	Экстент, в котором все входные объекты или растры перекрываются (взаимно пересекаются). Возможно, что ни один из пространственных объектов не перекрывается и что может быть создан нулевой экстент (нулевая ширина и высота). В этих случаях пространственные объекты или ячейки не будут обрабатываться.
MAXOF	Комбинированный экстент всех входных данных. Будут обрабатываться все пространственные объекты или ячейки.
"XMin, YMin, XMax, YMax"	Разделенные пробелом координаты, определяющие экстент в системе координат, в которой хранятся входные данные.
Имя пути	путь к набору данных. Будет использоваться экстент набора данных.

Пример скрипта

import arcpy

# Set the extent environment using a keyword
arcpy.env.extent = "MAXOF"

# Set the extent environment using the Extent class
arcpy.env.extent = arcpy.Extent(-107.0, 38.0, -104.0, 40.0)

# Set the extent environment using a space-delimited string
arcpy.env.extent = "-107.0 38.0 -104.0 40.0"

# Set the extent environment using a feature class
arcpy.env.extent = "C:/data/StudyArea_perim.shp"

# Set the extent environment using a raster
arcpy.env.extent = "C:/data/StudyArea.tif"