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

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

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

Будут обработаны пространственные объекты, которые пройдут через выходной экстент.

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

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

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

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

    Данная опция не доступна в диалоговом окне Параметры среды. Он доступен только из параметра инструмента, с экстентом в качестве типа данных, или на вкладке Параметры среды диалогового окна инструмента.

    Примечание:

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

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

    У каждого слоя карте есть следующие опции:

    • Все объекты Выбрать все - экстент всех объектов слоя.
    • Выбранные объектыArea from Selected Features - экстент всех выбранных объектов слоя.
    • Отображаемые объекты Extent Indicator - экстент всех отображаемых объектов слоя.
      Примечание:

      Экстенты опций Выбранные объекты Area from Selected Features и Отображаемые объекты Extent Indicator доступны только для векторных слоев.

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

    Координаты экстента копируются в буфер обмена и вставляются из него с использованием того же форматирования и порядка, что и для объекта 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"

Разделенные пробелом координаты, определяющие экстент в системе координат, в которой хранятся входные данные.

Имя пути

путь к набору данных. Будет использоваться экстент набора данных.

Синтаксис extent

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

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"