Intersect 3D (3D Analyst Tools)

Summary

Computes the intersection of multipatch features to produce closed multipatches encompassing the overlapping volumes, open multipatch features from the common surface areas, or lines from the intersecting edges.

Illustration

Intersect 3D tool illustration

Usage

Use caution when determining the data for this analysis. Highly detailed features may produce complex geometries that can affect performance due to the total number of vertices and orientation.
When one input is provided, the intersection of features in that multipatch dataset will be evaluated. When two inputs are provided, the intersection of features from both datasets will be determined and intersections found in only one input will be ignored.

Note:

When using two input features, attributes from both features will be concatenated in the output.
Textures and colors from the input multipatch features will not be preserved in the output.
When the Output Geometry Type parameter is specified as Solid, the input multipatches must be closed. The Surface and Line options do not require closed multipatches as input. Use the Is Closed 3D tool to determine if multipatches are closed.

Label	Explanation	Data type
Input Multipatch Features	The multipatch features that will be intersected. When only one input feature layer or feature class is provided, the output will indicate the intersection of its own features.	Feature Layer
Output Feature Class	The feature class that will be produced.	Feature Class
Input Multipatch Features (Optional)	The second multipatch feature layer or feature class that will intersect the first.	Feature Layer
Output Geometry Type (Optional)	Specifies the type of intersection geometry that will be created. Solid—A closed multipatch representing the overlapping volumes between input features will be created. This is the default. Surface—A multipatch surface representing coincident areas of faces between input features will be created. Line—Lines representing the intersection between faces of input features will be created.	String

arcpy.3d.Intersect3D(in_feature_class_1, out_feature_class, {in_feature_class_2}, {output_geometry_type})

Name	Explanation	Data type
in_feature_class_1	The multipatch features that will be intersected. When only one input feature layer or feature class is provided, the output will indicate the intersection of its own features.	Feature Layer
out_feature_class	The feature class that will be produced.	Feature Class
in_feature_class_2 (Optional)	The second multipatch feature layer or feature class that will intersect the first.	Feature Layer
output_geometry_type (Optional)	Specifies the type of intersection geometry that will be created. `SOLID`—A closed multipatch representing the overlapping volumes between input features will be created. This is the default. `SURFACE`—A multipatch surface representing coincident areas of faces between input features will be created. `LINE`—Lines representing the intersection between faces of input features will be created.	String

Code sample

Intersect3D example 1 (Python window)

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

import arcpy

arcpy.env.workspace = 'C:/data'
arcpy.ddd.Intersect3D('inMultipatch1.shp', 'outMultipatch.shp',
                      'inMultipatch2.shp')

Intersect3D example 2 (stand-alone script)

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

'''****************************************************************************
Name: Intersect3D Example
Description: This script demonstrates how to use the
             Intersect3D tool
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'

# Set Local Variables
inMP1 = 'Boston_MP_Small.shp'
inMP2 = 'Boston_MP.shp'

# Ensure output has a unique name
outMP = arcpy.CreateUniqueName('Intersect.shp')

# Run Intersect3D
arcpy.ddd.Intersect3D(inMP1, outMP, inMP2)

Environments

Current Workspace, Extent, Output Coordinate System, Geographic Transformations, Output CONFIG Keyword, Auto Commit, Output XY Domain, Output Z Domain

Licensing information

Basic: Requires 3D Analyst
Standard: Requires 3D Analyst
Advanced: Requires 3D Analyst