Intersect 3D Line With Surface (3D Analyst Tools)

Summary

Computes the geometric intersection of 3D line features and one or more surfaces to return the intersection as segmented line features and points.

Illustration

Intersect 3D Line With Surface tool illustration

Usage

All of the input line features will be in the output line feature class even if they do not intersect a surface.
The following fields are included in the output line feature class:
- OID_ORG—The OBJECTID value from the original 3D line feature
- SURF_FROM—The surface where the 3D line segment began
- SURF_TO—The surface where the 3D line segment was drawn
The following fields are included in the optional output point feature class:
- OID_LINE—The OBJECTID value from the original 3D line feature
- SURFACE—The surface name where the intersecting point was generated
- DIST_ALONG—The distance from the beginning of the 3D line to the point of intersection

Label	Explanation	Data type
Input Line Features	The input 3D line features.	Feature Layer
Input Surfaces	One or more surfaces that will be used to determine intersections. Supported inputs are raster and TIN datasets.	Mosaic Layer; Raster Layer; TIN Layer
Output Lines	The output line features that represent the input line features split at the points of intersection with the surface.	Feature Class
Output Points (Optional)	The optional point features that represent the input line's intersection with a surface .	Feature Class

arcpy.3d.Intersect3DLineWithSurface(in_line_features, in_surfaces, out_line_feature_class, {out_point_feature_class})

Name	Explanation	Data type
in_line_features	The input 3D line features.	Feature Layer
in_surfaces [in_surfaces,...]	One or more surfaces that will be used to determine intersections. Supported inputs are raster and TIN datasets.	Mosaic Layer; Raster Layer; TIN Layer
out_line_feature_class	The output line features that represent the input line features split at the points of intersection with the surface.	Feature Class
out_point_feature_class (Optional)	The optional point features that represent the input line's intersection with a surface .	Feature Class

Code sample

Intersect3DLineWithSurface example 1 (Python window)

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

arcpy.env.workspace = 'C:/data'
arcpy.ddd.Intersect3DLineWithSurface('lines.shp', 'dtm_tin; elev.tif',
                                     'intersect_lines.shp', 'intersect_pts.shp')

Intersect3DLineWithSurface example 2 (stand-alone script)

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

import arcpy

arcpy.env.workspace = 'C:/data'
arcpy.ddd.Intersect3DLineWithSurface('lines.shp', 'dtm_tin; elev.tif',
                                     'intersect_lines.shp', 'intersect_pts.shp')

Environments

Current Workspace, Extent, Output Coordinate System, Geographic Transformations, XY Resolution, XY Tolerance, Z Resolution, Z Tolerance, Output CONFIG Keyword, Auto Commit, Output XY Domain, Output Z Domain, Minimize memory use during analysis on terrains

Licensing information

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