Feature Envelope To Polygon (Data Management)

Available with Advanced license.


Creates a feature class containing polygons, each of which represents the envelope of an input feature.


Feature Envelope To Polygon illustration


  • The attributes of the input features will be maintained in the output feature class. A new field, ORIG_FID, will be added to the output feature class and set to the input feature IDs.

  • Since the envelope of a perfectly horizontal line (parallel to the x-axis) has a zero height and the envelope of a perfectly vertical line (parallel to the y-axis) has a zero width, the resulting polygon from either line would have a zero area; such invalid polygons will be omitted in the output. The same applies to a part in a multipart line feature.


FeatureEnvelopeToPolygon(in_features, out_feature_class, {single_envelope})
ParameterExplanationData Type

The input features that can be multipoint, line, polygon, or annotation.

Feature Layer

The output polygon feature class.

Feature Class

Specifies whether to use one envelope for each entire multipart feature or one envelope per part of a multipart feature. This parameter will affect the results of multipart input features only.

  • SINGLEPARTUses one envelope containing an entire multipart feature; therefore, the resulting polygon will be singlepart. This is the default.
  • MULTIPART Uses one envelope for each part of a multipart feature; the resulting polygon of the multipart feature will remain multipart.

Code sample

FeatureEnvelopeToPolygon Example 1 (Python window)

The following Python window script demonstrates how to use the FeatureEnvelopeToPolygon function in immediate mode.

import arcpy
from arcpy import env
env.workspace = "C:/data"
FeatureEnvelopeToPolygon Example 2 (stand-alone script)

The following stand-alone script is a simple example of how to apply the FeatureEnvelopeToPolygon function in a scripting environment.

# Name: FeatureEnvelopeToPolygon_Example2.py
# Description: Use FeatureEnvelopeToPolygon function to find 
#              the general extent of features.
# Author: ESRI

# import system modules 
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data/urban_analysis.gdb"

# Set local variables
inFeatures = "houses"
outFeatureClass = "c:/output/output.gdb/houses_extent"

# Execute FeatureEnvelopeToPolygon
arcpy.FeatureEnvelopeToPolygon_management(inFeatures, outFeatureClass, 

Licensing information

  • Basic: No
  • Standard: No
  • Advanced: Yes

Related topics