Инструменты, использующие параметр среды Экстент, будут обрабатывать только те пространственные объекты или растры, которые находятся в пределах экстента, определенного в этом параметре.
Параметр среды Экстент определяет, какие пространственные объекты или растры будут обрабатываться инструментом. Он полезен, если вы обрабатываете только часть большого набора данных. Вы можете рассматривать этот параметр как прямоугольник, который используется для выборки входных объектов и растров для обработки. Прямоугольник используется только для выбора пространственных объектов, а не вырезания их. Экстент выходного набора данных, как правило, будет больше параметра Экстент для учета пространственных объектов или ячеек, проходящих через прямоугольник экстента.
Примечания по использованию
- Система координат, указанная в сворачиваемом разделе Система координат экстента, используется инструментами для интерпретации местоположения координат экстента и не зависит от среды Выходной системы координат.
- Опции Текущий экстент отображения
, Нарисовать экстент 
и Экстент слоя 
используют систему координат активной карты. - Опции Обзор
и Буфер обмена 
используют систему координат набора данных или содержания буфера обмена. - Опции Пересечение входных данных
и Объединение входных данных 
определяют систему координат во время запуска инструмента и используют систему координат первого входного набора данных. - Если указан экстент без системы координат, в экстенте будет использоваться система координат первого входного набора данных, используемого инструментом.
Синтаксис диалога
- Текущий экстент отображения — Экстент будет основан на активной карте или сцене. Эта опция доступна только при наличии активной карты.
- Нарисовать экстент - экстент будет основан прямоугольнике, нарисованном на карте или сцене. Эта опция создает класс пространственных объектов в базе геоданных проекта и добавляет слой на карту. Класс объектов будет иметь ту же систему координат, что и карта.
Примечание:
Данная опция не доступна в диалоговом окне Параметры среды. Он доступен только из параметра инструмента, с экстентом в качестве типа данных, или на вкладке Параметры среды диалогового окна инструмента.
Примечание:
Если включена опция Включать и отключать редактирование на вкладке Редактирование, вы должны включить редактирование на вкладке ленты Редактирование, чтобы нарисовать экстент.
- Экстент слоя — Экстент будет основан на активном слое карты. Используйте раскрывающийся список, чтобы выбрать доступный слой, или используйте опцию Экстент данных во всех слоях, чтобы получить объединенный экстент всех активных слоев карты, за исключением базовой карты. Эта опция доступна только при наличии активной карты со слоями.
У каждого слоя карте есть следующие опции:
- Все объекты
- экстент всех объектов слоя. - Выбранные объекты
- экстент всех выбранных объектов слоя. - Отображаемые объекты
- экстент всех отображаемых объектов слоя.Примечание:
Экстенты опций Выбранные объекты
и Отображаемые объекты доступны только для векторных слоев.
- Все объекты
- Обзор — Экстент будет основан на существующем наборе данных.
- Пересечение входных данных — Экстент будет основан на минимальном или пересекающемся экстенте всех входных данных. Если никакие входные данные не перекрываются, получится пустой экстент со всеми нулями.
- Объединение входных данных — Экстент будет основан на максимальном или объединенном экстенте всех входных данных.
- Буфер обмена - экстент может быть скопирован в буфер обмена и из него.
- Копировать экстент
- копирует координаты экстента и систему координат в буфер обмена. - Вставить экстент - вставляет координаты экстента и, дополнительно, систему координат из буфера обмена. Если значения буфера обмена не содержат систему координат, экстент будет использовать систему координат карты.
Примечание:
Координаты экстента копируются в буфер обмена и вставляются из него с использованием того же форматирования и порядка, что и для объекта ArcPy Extent: x-min, y-min, x-max, y-max и пространственная привязка.
- Копировать экстент
- Сбросить экстент
— Экстент будет сброшен до значения по умолчанию. - Координаты, введенные вручную – Координаты должны быть числовыми значениями и находиться в системе координат активной карты.
Внимание:
На карте могут использоваться единицы отображения, отличные от введенных координат. Использование направления по сторонам света (N, S, E, W) не поддерживается. Используйте знак отрицательного значения для координат юга и запада.
Когда вы используете опцию Текущий экстент отображения , Нарисовать экстент , Экстент слоя или Обзор , экстент считывается и сохраняется на данный момент; экстент позже не будет обновляться, если в карту, слой или набор данных будут внесены изменения. Опции Пересечение входных данных и Объединение входных данных будут определять экстент координат и систему координат во время работы инструмента.
Синтаксис скриптов
arcpy.env.extent = extent
Примечание:
Если задано, свойство параметра среды extent возвращается как объект Extent в Python.
| 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"