Feature Envelope To Polygon (Data Management)

Available with Advanced license.

Summary

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

Illustration

Feature Envelope To Polygon 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.

Syntax

arcpy.management.FeatureEnvelopeToPolygon(in_features, out_feature_class, {single_envelope})
ParameterExplanationData 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.

  • 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.
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")

Licensing information

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

Related topics