Inside 3D (3D Analyst Tools)

Summary

Determines if 3D features from an input feature class are contained inside a closed multipatch, and writes an output table recording the features that are partially or fully inside the multipatch.

Illustration

Inside 3D tool graphic

Usage

All input features must have Z information stored as part of their geometry. If field based height measurements are present in a 2D feature class, the Feature To 3D By Attribute tool can be used to create a 3D feature class.
Closed multipatch geometry is required for this analysis. The Is Closed 3D tool can be used to determine if a multipatch feature class contains closed features, and the Enclose Multipatch tool can be used to eliminate gaps in multipatch features.
If the Complex Output Table option is selected, a record is created for each multipatch that a given input feature intersects. A feature may fall within multiple closed multipatch features and have multiple entries in the output table.
The following fields are present in the output table:
- Target_ID—The unique ID of the input feature.
- Status—Indicates if the feature identified by the Target_ID field is inside or partially inside a multipatch.
- Contain_ID—Identifies the unique ID of the multipatch that intersects the input features are inside or partially inside. Only included if the Complex Output Table option is selected

Label	Explanation	Data type
Input Features	The input multipatch or 3D point, line, or polygon feature class.	Feature Layer
Input Multipatch Features	The closed multipatch features that will be used as the containers for the input features.	Feature Layer
Output Table	The output table providing a list of 3D features in the Input Features parameter value that are inside or partially inside the Input Multipatch Features parameter value which are closed. The output table contains an `OBJECTID` (object ID), `Target_ID`, and `Status` field. The `Status` field will state if the input feature (`Target_ID`) is inside or partially inside a multipatch.	Table
Complex Output Table (Optional)	Specifies whether the output table will identify the relationship between the Input Features and the Input Multipatch Features parameter values through the creation of a `Contain_ID` field that identifies the multipatch feature that contains the input feature. Checked—The multipatch feature that contains an input feature will be identified. Unchecked—The multipatch feature that contains an input feature will not be identified. This is the default.	Boolean

arcpy.3d.Inside3D(in_target_feature_class, in_container_feature_class, out_table, {complex_output})

Name	Explanation	Data type
in_target_feature_class	The input multipatch or 3D point, line, or polygon feature class.	Feature Layer
in_container_feature_class	The closed multipatch features that will be used as the containers for the input features.	Feature Layer
out_table	The output table providing a list of 3D features in the `in_target_feature_class` parameter value that are inside or partially inside the `in_container_feature_class` parameter value which are closed. The output table contains an `OBJECTID` (object ID), `Target_ID`, and `Status` field. The `Status` field will state if the input feature (`Target_ID`) is inside or partially inside a multipatch.	Table
complex_output (Optional)	Specifies whether the output table will identify the relationship between the `in_target_feature_class` and the `in_container_feature_class` parameter values through the creation of a `Contain_ID` field that identifies the multipatch feature that contains the input feature. `COMPLEX`—The multipatch feature that contains an input feature will be identified. `SIMPLE`—The multipatch feature that contains an input feature will not be identified. This is the default.	Boolean

Code sample

Inside3D example 1 (Python window)

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.Inside3D('inFeature.shp', 'sample.gdb/multipatch', 'sample.gdb/output_table')

Inside3D example 2 (stand-alone script)

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

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

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

# Set Local Variables
inFC = 'Points_3D.shp' # the input feature
inMP = 'Buildings.shp' # the input multi-patch

# Ensure output has a unique name
outTbl = arcpy.CreateUniqueName('Output_Table.dbf')

# Run Inside3D
arcpy.ddd.Inside3D(inFC, inMP, outTbl)

Environments

Current Workspace, Output CONFIG Keyword, Auto Commit, Extent

Licensing information

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