范围（环境设置）

支持“范围”环境的工具仅处理位于此设置中所指定范围内的要素或栅格。

“范围”环境用于定义工具将处理的要素或栅格。 如果只处理大型数据集的一部分，则此项设置非常适用。 您可将此项设置视为用于选择输入要素或栅格以便进行处理的一个矩形。 矩形只用于选择要素，而非裁剪。 输出数据集的范围通常会大于“范围”环境，以便将穿过范围矩形的要素或像元包括在内。

用法说明

• 工具将使用在范围坐标系可折叠部分下列出的坐标系解释范围坐标的位置，该坐标系不会受到输出坐标系环境的影响。
• 当前显示范围 、绘制范围 和图层范围 选项使用活动地图的坐标系。
• 浏览 和剪贴板 选项使用数据集的或粘贴的坐标系。
• 输入的交集 和输入的并集 选项将在工具运行时确定坐标系并使用第一个输入数据集的坐标系。
• 如果指定的范围没有坐标系，则该范围将使用工具所用的第一个输入数据集的坐标系。

对话框语法

• 当前显示范围 - 范围基于活动地图或场景。 仅在存在活动地图时，才可使用此选项。
• 绘制范围 - 范围将基于在地图或场景上绘制的矩形。 此选项将在工程地理数据库中创建要素类并将图层添加至地图。 该要素类的坐标系将与地图相同。

  注：

  环境对话框中不提供此选项。 只能在具有范围数据类型的工具参数中或工具对话框的环境选项卡中找到此选项。

  注：

  当选中从“编辑”选项卡启用和禁用编辑编辑选项时，必须在编辑功能区选项卡上启用编辑才能绘制范围。

• 图层范围 - 范围基于活动地图图层。 使用下拉列表选择可用图层，或使用所有图层中数据的范围选项获取所有活动地图图层（不包括底图）的组合范围。 仅在存在具有图层的活动地图时，才可使用此选项。

  每个地图图层具有以下选项：

  • 所有要素 - 图层中所有要素的范围。
  • 选定要素 - 图层中选定要素的范围。
  • 可见要素 - 图层中可见要素的范围。

    注：

    选定要素 和可见要素 选项中的范围仅适用于要素图层。

• 浏览 - 范围基于现有数据集。
• 输入的交集 - 范围将基于所有输入的最小或交叉范围。 如果输入未重叠，则结果为包含所有零值的空范围。
• 输入的并集 - 范围将基于所有输入的最大或合并范围。
• 剪贴板 - 可在剪贴板中复制和粘贴范围。
  • 复制范围 - 将范围坐标和坐标系复制到剪贴板。
  • 粘贴范围 - 从剪贴板粘贴范围坐标和（可选）坐标系。 如果剪贴板值不包含坐标系，则范围将使用地图的坐标系。

  注：

  将使用与 ArcPy Extent 对象相同的格式和顺序从剪贴板中复制和粘贴范围坐标：x-min、y-min、x-max、y-max 和空间参考。

• 重置范围 - 将范围重置为默认值。
• 手动输入坐标 - 坐标必须是数值，并且与活动地图的坐标系相匹配。

  警告：

  地图可能使用与输入的坐标不同的显示单位。 不支持使用主方向（N、S、E、W）。 在南纬和西经坐标中使用负号。

当使用当前显示范围 、绘制范围 、图层范围 或浏览 选项时，系统会读取范围并将其存储在该时刻；稍后，如果对地图、图层或数据集进行更改，则该范围不会更新。 输入的交集 和输入的并集 选项将在工具运行时确定约束坐标和坐标系。

脚本语法

arcpy.env.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"