Multipatch Footprint (3D Analyst Tools)

Summary

Creates polygon footprints representing the two-dimensional area of multipatch features.

Illustration

Multipatch Footprint tool illustration

Usage

The output footprint will have the same fields as the input feature, along with the following fields:
- Z_Min—The smallest z-value from the multipatch feature.
- Z_Max—The largest z-value from the multipatch feature.
Use the Group Field parameter if a structure comprises multiple features that share a common identifier in the attribute table.
Input multipatch features that have no 2D area, such as a vertical walls modeled using vertical faces, will result in 2D extent boxes rather than their true 2D footprint since the footprint more closely resembles a line than a polygon.

Label	Explanation	Data type
Input Feature Class	The multipatch feature whose footprint will be generated.	Feature Layer
Output Feature Class	The resulting footprint polygon feature class.	Feature Class
Group Field (Optional)	The field that will be used for combining multipatch features so that they contribute to the same footprint polygon.	Field

arcpy.3d.MultiPatchFootprint(in_feature_class, out_feature_class, {group_field})

Name	Explanation	Data type
in_feature_class	The multipatch feature whose footprint will be generated.	Feature Layer
out_feature_class	The resulting footprint polygon feature class.	Feature Class
group_field (Optional)	The field that will be used for combining multipatch features so that they contribute to the same footprint polygon.	Field

Code sample

MultiPatchFootprint example 1 (Python window)

The following sample demonstrates the use of this tool in the Python window:

arcpy.env.workspace = "C:/data"
arcpy.ddd.MultiPatchFootprint("multipatch.shp","multipatch_footprint.shp")

MultiPatchFootprint example 2 (stand-alone script)

The following sample demonstrates the use of this tool in a stand-alone Python script:

'''****************************************************************************
Name: MultiPatchFootprint Example
Description: Creates footprint polygons for all multipatches in a workspace.
****************************************************************************'''
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'
fcList = arcpy.ListFeatureClasses()
if fcList:
    for fc in fcList:
        # Determine if the feature class is a multipatch
        desc = arcpy.Describe(fc)
        if desc.shapeType is "MultiPatch":
            outPoly = "{0}_Footprint.shp".format(desc.baseName)
            # Run MultiPatchFootprint
            arcpy.ddd.MultiPatchFootprint(fc, outPoly)

Environments

Current Workspace, Extent, Output Coordinate System, Geographic Transformations, XY Resolution, XY Tolerance, Output CONFIG Keyword, Auto Commit

Licensing information

Basic: Yes
Standard: Yes
Advanced: Yes