Analyze LAS Runway Obstacles (Aviation Tools)

Summary

Analyzes lidar data and obstruction identification surfaces (OIS) to determine if lidar points are penetrating.

Usage

The Input OIS Features parameter value must be a multipatch feature class that contains the OIS.
The Input LAS Obstacles parameter value 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 input LAS dataset and .las files must be in a projected coordinate system. You can use the Project LAS tool to project the LAS dataset or .las files.
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 that share the same names.
When specified to generate the LAS output, the .las file that is generated will contain the lidar points from the input penetrating the OIS surface.
This tool does not support in-memory output data for performance reasons.

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 human-made objects that may 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 decreases the distance between the height of the LAS point and the corresponding OIS surface, resulting in the likeliness that more points will be captured. Consequently, a larger 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 that will be used for the vertical clearance. Kilometers—The linear unit will be kilometers. Meters—The linear unit will be meters. Decimeters—The linear unit will be decimeters. Centimeters—The linear unit will be centimeters. Millimeters—The linear unit will be millimeters. Nautical miles—The linear unit will be nautical miles. Miles—The linear unit will be miles. Yards—The linear unit will be yards. Feet—The linear unit will be feet. Inches—The linear unit will be inches. Decimal degrees—The linear unit will be decimal degrees. Points—The linear unit will be points. Unknown—The linear unit will be unknown.	String

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 human-made objects that may 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 decreases the distance between the height of the LAS point and the corresponding OIS surface, resulting in the likeliness that more points will be captured. Consequently, a larger 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 that will be used for the vertical clearance. `KILOMETERS`—The linear unit will be kilometers. `METERS`—The linear unit will be meters. `DECIMETERS`—The linear unit will be decimeters. `CENTIMETERS`—The linear unit will be centimeters. `MILLIMETERS`—The linear unit will be millimeters. `NAUTICAL_MILES`—The linear unit will be nautical miles. `MILES`—The linear unit will be miles. `YARDS`—The linear unit will be yards. `FEET`—The linear unit will be feet. `INCHES`—The linear unit will be inches. `DECIMAL_DEGREES`—The linear unit will be decimal degrees. `POINTS`—The linear unit will be points. `UNKNOWN`—The linear unit will be unknown.	String

Code sample

AnalyzeLASRunwayObstacles example 1 (stand-alone script)

The following Python window script demonstrates how to use the AnalyzeLASRunwayObstacles function to generate point feature output.

import arcpy

# 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.aviation.AnalyzeLASRunwayObstacles(inOISFeatures, inLASObstacles, outObstacleFeatures)

AnalyzeLASRunwayObstacles example 2 (stand-alone script)

The following Python window script demonstrates how to use the AnalyzeLASRunwayObstacles function to generate a LAS dataset as output.

import arcpy

# 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.aviation.AnalyzeLASRunwayObstacles(inOISFeatures, inLASObstacles, None, outObstacleFolder, outObstacleDataset)

AnalyzeLASRunwayObstacles example 3 (stand-alone script)

The following Python window script demonstrates how to use the AnalyzeLASRunwayObstacles function using the vertical clearance value.

import arcpy

# 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.aviation.AnalyzeLASRunwayObstacles(inOISFeatures, inLASObstacles, None, outObstacleFolder, outObstacleDataset, 10, "METERS")

Environments

Current Workspace

Licensing information