| Label | Explanation | Data Type |
Input OIS Features
| The input multipatch features representing one or more OIS. The feature class must be z-enabled. | Feature Layer |
Input LAS Obstacles
| The input LAS dataset that contains 3D data points covering the area around an airport. The points represent a 3D view of natural and man-made objects that could pose a hazard to flight. | LAS Dataset Layer |
Output Obstacle Feature Class
(Optional) | The output point features that represent lidar points in OIS features in which the height of the lidar point is greater than the height of the enclosing OIS feature at that point. This feature class is required output only if no output LAS dataset is requested. | Feature Layer |
Target Folder
(Optional) | The folder to which LAS files will be written. Each output file will have the same LAS file version and point record format as the input file. This folder is required output only if no output feature class is requested. | Folder |
Output LAS Obstacles
(Optional) | The output LAS dataset referencing the newly created LAS files. This LAS Dataset is created only when the output folder is specified to generate the LAS output. | LAS Dataset Layer |
Vertical Clearance
(Optional) | If a LAS point height is above the OIS surface, that point will be captured. The height of an OIS surface above a given LAS point is temporarily lowered by the specified vertical clearance value. This serves to decrease the distance between the height of the LAS point and the corresponding OIS surface, resulting in the likeliness that more points will be captured. Thus, you can be sure that a more liberal collection of ground features, represented by the LAS points penetrating through the OIS surface, will be captured. | Double |
Vertical Clearance Unit
(Optional) | The linear unit of the vertical clearance.
| String |
Available with Aviation Airports license.
Summary
Analyzes lidar data and obstruction identification surfaces (OIS) to determine if lidar points are penetrating.
Usage
The Input OIS Features parameter must be a multipatch feature class that contains the OIS.
The Input LAS Obstacles parameter is a lidar (LAS) dataset.
A point feature is generated, and output for each lidar point that falls within the area is covered by the OIS, where the height of that point exceeds the height of the OIS feature at that point. The x and y point coordinates are the same as the lidar point with which the output point is associated.
This tool requires an ArcGIS 3D Analyst extension license.
The optional output LAS files will match the LAS version, point record format, and compression of the input.
The optional LAS files and LAS dataset file will overwrite any files found that share the same names.
When specified to generate the LAS output, LAS file generated containing the lidar points from the input penetrating the OIS surface.
Parameters
arcpy.aviation.AnalyzeLASRunwayObstacles(in_ois_features, in_las_obstacles, {out_obstacle_feature_class}, {target_folder}, {out_las_obstacles}, {vertical_clearance}, {vertical_clearance_unit})| Name | Explanation | Data Type |
in_ois_features | The input multipatch features representing one or more OIS. The feature class must be z-enabled. | Feature Layer |
in_las_obstacles | The input LAS dataset that contains 3D data points covering the area around an airport. The points represent a 3D view of natural and man-made objects that could pose a hazard to flight. | LAS Dataset Layer |
out_obstacle_feature_class (Optional) | The output point features that represent lidar points in OIS features in which the height of the lidar point is greater than the height of the enclosing OIS feature at that point. This feature class is required output only if no output LAS dataset is requested. | Feature Layer |
target_folder (Optional) | The folder to which LAS files will be written. Each output file will have the same LAS file version and point record format as the input file. This folder is required output only if no output feature class is requested. | Folder |
out_las_obstacles (Optional) | The output LAS dataset referencing the newly created LAS files. This LAS Dataset is created only when the output folder is specified to generate the LAS output. | LAS Dataset Layer |
vertical_clearance (Optional) | If a LAS point height is above the OIS surface, that point will be captured. The height of an OIS surface above a given LAS point is temporarily lowered by the specified vertical clearance value. This serves to decrease the distance between the height of the LAS point and the corresponding OIS surface, resulting in the likeliness that more points will be captured. Thus, you can be sure that a more liberal collection of ground features, represented by the LAS points penetrating through the OIS surface, will be captured. | Double |
vertical_clearance_unit (Optional) | The linear unit of the vertical clearance.
| String |
Code sample
The following Python window script demonstrates how to use the AnalyzeLASRunwayObstacles tool to generate point feature output.
import arcpy
#set gp environment
arcpy.CheckOutExtension("Airports")
arcpy.CheckOutExtension("3D")
# Input Obstruction Identification Surface Feature Class
inOISFeatures = r"C:\data\ois.gdb\ObstructionIdSurface"
# Input LAS Obstacle Data
inLASObstacles = r"C:\data\PotentialObstacles.lasd"
# Feature class that will contain the output obstacles
outObstacleFeatures = r"C:\data\ois.gdb\ActualObstacles"
# Processing AnalyzeLASRunwayObstacles
arcpy.AnalyzeLASRunwayObstacles_aviation(inOISFeatures, inLASObstacles, outObstacleFeatures)
arcpy.CheckInExtension("3D")
arcpy.CheckInExtension("Airports")The following Python window script demonstrates how to use the AnalyzeLASRunwayObstacles tool to generate a LAS dataset as output.
import arcpy
#set gp environment
arcpy.CheckOutExtension("Airports")
arcpy.CheckOutExtension("3D")
# Input Obstruction Identification Surface Feature Class
inOISFeatures = r"C:\data\ois.gdb\ObstructionIdSurface"
# Input LAS Obstacle Data
inLASObstacles = r"C:\data\PotentialObstacles.lasd"
# Folder that will contain the LIDAR output
outObstacleFolder = r"C:\data\LasObstacles"
# Output LIDAR dataset
outObstacleDataset = r"C:\data\LasObstacles\LasObstacles.lasd"
# Processing AnalyzeLASRunwayObstacles
arcpy.AnalyzeLASRunwayObstacles_aviation(inOISFeatures, inLASObstacles, None, outObstacleFolder, outObstacleDataset)
arcpy.CheckInExtension("3D")
arcpy.CheckInExtension("Airports")The following Python window script demonstrates how to use the AnalyzeLASRunwayObstacles tool using the vertical clearance value.
import arcpy
#set gp environment
arcpy.CheckOutExtension("Airports")
arcpy.CheckOutExtension("3D")
# Input Obstruction Identification Surface Feature Class
inOISFeatures = r"C:\data\ois.gdb\ObstructionIdSurface"
# Input LAS Obstacle Data
inLASObstacles = r"C:\data\PotentialObstacles.lasd"
# Folder that will contain the LIDAR output
outObstacleFolder = r"C:\data\LasObstacles"
# Output LIDAR dataset
outObstacleDataset = r"C:\data\LasObstacles\LasObstacles.lasd"
# Processing AnalyzeLASRunwayObstacles
arcpy.AnalyzeLASRunwayObstacles_aviation(inOISFeatures, inLASObstacles, None, outObstacleFolder, outObstacleDataset, 10, “METERS”)
arcpy.CheckInExtension("3D")
arcpy.CheckInExtension("Airports")Environments
Licensing information
- Basic: No
- Standard: Requires Airports
- Advanced: No