输出范围（环境设置）

支持“输出范围”环境的工具只会处理落入此设置中所指定范围内的要素或栅格。

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

用法说明

• 警告:

  即使设置了输出坐标系环境，仍将假设键入的范围位于存储输入数据时所使用的坐标系。如果工具需要处理多个输入数据集，则将使用第一个数据集定义范围的坐标系。

对话框语法

• 默认 - 由所使用的工具决定处理范围。所有工具都有一个根据输入数据计算得出的默认范围。此默认范围很少在工具参考页面中记录，但范围通常显而易见。例如，相交工具只处理彼此相交的要素，联合工具可处理所有要素，而裁剪只会处理裁剪要素范围内的要素。
• 输入的并集 - 所有输入数据的组合范围。所有要素或栅格都会被处理。
• 输入的交集 - 所有输入要素或栅格所叠置的范围（彼此相交）。请注意，有可能所有要素都不叠置，因此可能生成空范围（宽度和高度均为零）。这种情况下，不会处理任何要素。
• 如下面的指定 - 输入矩形的坐标（XMin、YMin、XMax、YMax）。
• 与显示相同 - 在 ArcMap、ArcScene 或 ArcGlobe 中，均将使用当前显示的范围。例如，如果已放大到某一特定研究区域，则可使用此选项处理落入当前显示范围内的要素。
  警告:

  首次将范围指定为与显示相同时，会读取并存储该显示的范围。下次检查“范围”设置时，它将读取如下面的指定。如果随后更改了显示的范围，则“范围”设置不更新，因此必须重设“范围”环境。

• 与图层相同 <名称> - 列出所有图层，您可以选择一个作为范围。类似于与显示相同选项，将读取并存储该图层的范围。下次检查“范围”设置时，它将读取如下面的指定。

脚本语法

arcpy.env.extent = extent

注：

如果已设置，则范围环境属性将在 Python 中返回 Extent 对象。

范围	说明
Extent 对象	用于定义范围的范围类。
MINOF	所有输入要素或栅格叠置的范围（彼此相交）。请注意，有可能所有要素都不叠置，因此可能生成空范围（宽度和高度均为零）。这种情况下，不会处理任何要素。
MAXOF	所有输入数据的组合范围。将处理所有要素或栅格。
XMin、YMin、XMax、YMax	用于定义范围的以空格分隔的坐标，位于存储输入数据的坐标系。
pathname	数据集的路径。将使用数据集的范围。

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"