Analyze LAS Runway Obstacles (Aviation)

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.

    Delta Z

  • 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 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.

    Delta Z Input Lidar
    Delta Z Output Lidar

  • This tool does not support in-memory output data for performance reasons.

Parameters

LabelExplanationData 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.

  • KilometersThe linear unit will be kilometers.
  • MetersThe linear unit will be meters.
  • DecimetersThe linear unit will be decimeters.
  • CentimetersThe linear unit will be centimeters.
  • MillimetersThe linear unit will be millimeters.
  • Nautical milesThe linear unit will be nautical miles.
  • MilesThe linear unit will be miles.
  • YardsThe linear unit will be yards.
  • FeetThe linear unit will be feet.
  • InchesThe linear unit will be inches.
  • Decimal degreesThe linear unit will be decimal degrees.
  • PointsThe linear unit will be points.
  • UnknownThe 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})
NameExplanationData 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.

  • KILOMETERSThe linear unit will be kilometers.
  • METERSThe linear unit will be meters.
  • DECIMETERSThe linear unit will be decimeters.
  • CENTIMETERSThe linear unit will be centimeters.
  • MILLIMETERSThe linear unit will be millimeters.
  • NAUTICAL_MILESThe linear unit will be nautical miles.
  • MILESThe linear unit will be miles.
  • YARDSThe linear unit will be yards.
  • FEETThe linear unit will be feet.
  • INCHESThe linear unit will be inches.
  • DECIMAL_DEGREESThe linear unit will be decimal degrees.
  • POINTSThe linear unit will be points.
  • UNKNOWNThe linear unit will be unknown.
String

Code sample

AnalyzeLASRunwayObstacles example (stand-alone script)

The following Python window script demonstrates how to use the AnalyzeLASRunwayObstacles function 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")
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

#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")
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

#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

Related topics