ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Output Extent (Environment setting)

  • Usage notes
  • Dialog syntax
  • Scripting syntax

Tools that honor the Output Extent environment will only process features or rasters that fall within the extent specified in this setting.

The Output Extent environment setting defines what features or rasters will be processed by a tool. It is useful when you need to process only a portion of a larger dataset. You can think of this setting as a rectangle used to select input features and rasters for processing. Any feature or raster that passes through the rectangle will be processed and written to output. Note that the rectangle is used only to select features, not clip them. The extent of the output dataset will typically be larger than the Output Extent setting to account for features that pass through the extent rectangle.

Features that pass through the Output Extent will be processed

Usage notes

  • Caution:

    The extent entered is assumed to be in the coordinate system in which the input data is stored, even if the Output Coordinate System environment is set. If the tool takes multiple input datasets, the first dataset defines the coordinate system of the extent.

Dialog syntax

  • Default—The tool you are using will determine the processing extent. All tools have a default extent they calculate from their inputs. This default is rarely documented in the tool reference page but is usually obvious. For example, the Intersect tool will only process features that intersect one another, the Union tool processes all features, and the Clip tool will only process features within the extent of the clip features.
  • Union of Inputs—The combined extent of all input data. All features or rasters will be processed.
  • Intersection of Inputs—The extent where all input features or rasters overlap (intersect one another). Note that it is possible that none of the features overlap and that a null extent (zero width and height) may result. In such cases, no features will be processed.
  • As Specified Below—You enter the coordinates of the sides of the rectangle (Left, Right, Top, and Bottom).
  • Same as Display—In ArcMap, ArcScene, or ArcGlobe, the extent of the current display will be used. For example, if you are zoomed in to your particular study area, you can use this option to process features that fall within the current display extent.
    Caution:

    When you first specify the extent to be the same as the display, the extent of the display is read and stored. The next time you examine the Extent setting, it will read As Specified Below. If you subsequently change the extent of the display, the Extent setting is not updated—you will have to reset the Extent environment.

  • Same as layer <name>—All layers are listed, and you can choose one as the extent. Like the Same as Display option, the extent of the layer is read and stored. The next time you examine the Extent setting, it will read As Specified Below.

Scripting syntax

arcpy.env.extent = extent

Note:

When set, the extent environment property returns an Extent object in Python.

extentExplanation

Extent object

An Extent class can be used to define the extent.

MINOF

The extent where all input features or rasters overlap (intersect one another). Note that it is possible that none of the features overlap and that a null extent (zero width and height) may result. In such cases, no features will be processed.

MAXOF

The combined extent of all input data. All features or rasters will be processed.

XMin, YMin, XMax, YMax

Space-delimited coordinates that define the extent in the coordinate system in which the input data is stored.

pathname

Path to a dataset. The extent of the dataset will be used.

extent syntax

Script example

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"

Related Topics

  • An overview of geoprocessing environments
  • Environment levels and hierarchy
  • Setting geoprocessing environments
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal