Feature Envelope To Polygon (Data Management)—ArcGIS Pro

Available with Advanced license.

Summary

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

Illustration

Usage

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.

Parameters

Label	Explanation	Data Type
Input Features	The input features that can be multipoint, line, polygon, or annotation.	Feature Layer
Output Feature Class	The output polygon feature class.	Feature Class
Create multipart features (Optional)	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. Unchecked—Uses one envelope containing an entire multipart feature; therefore, the resulting polygon will be singlepart. This is the default. Checked—Uses one envelope for each part of a multipart feature; the resulting polygon of the multipart feature will remain multipart.	Boolean

arcpy.management.FeatureEnvelopeToPolygon(in_features, out_feature_class, {single_envelope})

Name	Explanation	Data Type
in_features	The input features that can be multipoint, line, polygon, or annotation.	Feature Layer
out_feature_class	The output polygon feature class.	Feature Class
single_envelope (Optional)	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. SINGLEPART —Uses 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.	Boolean

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"
arcpy.FeatureEnvelopeToPolygon_management("urban_analysis.gdb/parks",
                                          "c:/output/output.gdb/parks_extent",
                                          "SINGLEPART")

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, 
                                          "SINGLEPART")

Environments

Current Workspace, Scratch Workspace, Default Output Z Value, M Resolution, M Tolerance, Output M Domain, Output Z Domain, Output Coordinate System, Extent, Output has M values, Output has Z values, XY Resolution, XY Tolerance, Z Resolution, Z Tolerance

Licensing information

Basic: No
Standard: No
Advanced: Yes