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 |
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
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
Parameters
arcpy.ddd.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
The following sample demonstrates the use of this tool in the Python window.
arcpy.env.workspace = 'C:/data'
arcpy.Intersect3DLineWithSurface_3d('lines.shp', 'dtm_tin; elev.tif',
'intersect_lines.shp', 'intersect_pts.shp')
The following sample demonstrates the use of this tool in a stand-alone Python script.
import arcpy
from arcpy import env
env.workspace = 'C:/data'
arcpy.Intersect3DLineWithSurface_3d('lines.shp', 'dtm_tin; elev.tif',
'intersect_lines.shp', 'intersect_pts.shp')