Generate Clearance Surface (3D Analyst)

Summary

Generates a raster surface modeling the clearance zone around 3D line features.

Illustration

Generate Clearance Surface tool illustration

Usage

  • A clearance zone represents the theoretical height of an area around a particular feature that is to remain clear of intrusions from other features. In the context of electric transmission lines, this zone can represent the area of maximum height that vegetation can reach to minimize the risk of fire or other hazards; any vegetation that is higher than the clearance zone will need to be trimmed. In the context of streets and sidewalks, the clearance zone can represent the lowest height that vegetation can encroach over the paths of vehicles, cyclists, and pedestrians to not compromise safety. For shipping channels, the clearance zone can represent the navigable path that must be cleared of any sedimentary deposits.

  • The clearance surface can be compared to a height surface modeling real-world measurements to determine where clearance zones are violated. You can use the Cut Fill tool to evaluate the two surfaces to determine the surface area and volume of each contiguous clearance zone violation. The height surface created from real-world measurements should reflect the directional bias of the clearance zone. For example, if the clearance zone defines the maximum height of a potential source of intrusion, as is the case with vegetation encroachment of powerlines or sedimentary deposits along shipping channels, the height surface created from real-world measurements should have a bias for maximum height values of trees and sedimentary depositions. Likewise, if the clearance zone defines the minimum height of a potential source of intrusion, such as vegetation around sidewalks and roadways, the height surface created from real-world measurements should have a bias for minimum height values. The height surface of real-world measurements in LAS data can be created using the LAS Dataset To Raster tool, and the Point Cloud To Raster tool can be used for I3S point clouds.

  • Use the Extract Power Lines From Point Cloud tool with the option to eliminate the effect of wind when generating power lines that will be used as input for modeling clearance zones. The position of points capturing power lines are usually distorted by the effect of wind, which can cause significant deviations in the position of the power line. Eliminating for the effect of wind results in the creation of power lines reflecting the normal path of the conductor cable.

  • If the clearance zone requires the incorporation of multiple raster surfaces modeling different types of clearance requirements, use the Mosaic To New Raster tool with the appropriate merge operator for the type of clearance being modeled.

Parameters

LabelExplanationData Type
Input 3D Features

The 3D line features that will be used to generate the clearance zone.

Feature Layer
Horizontal Clearance

The horizontal displacement of the clearance zone from each side of the input features.

Linear Unit
Vertical Clearance

The vertical displacement of the clearance zone from each input feature. The direction of the vertical displacement is indicated by the Overlap Method parameter value. If the Lowest Clearance option is specified, the vertical displacement will be lower than the input features. If the Highest Clearance option is specified, the displacement will be higher than the input features.

Linear Unit
Output Raster Surface

The output raster surface that represents the clearance zone.

Raster Dataset
Cell Size

The cell size of the output raster surface.

Linear Unit
Overlap Method
(Optional)

Specifies the method that will be used to define the clearance zone in places where the zone around multiple features overlap.

  • Lowest ClearanceThe lowest clearance will be used to define the clearance zone. This is the default.
  • Highest ClearanceThe highest clearance will be used to define the clearance zone.
String
Flare Angle
(Optional)

The arithmetic angle that defines the direction of the flare at the end of the clearance zone. A positive value indicates the flare angle will extend upward, and a negative value indicates the flare will extend downward.

Double
Flare Distance
(Optional)

The 3D length that will extend from the edge of the clearance zone along the direction provided by the Flare Angle parameter. A flare angle of 45° and a flare distance of 7 meters mean the edge of the clearance zone defined by its horizontal distance will extended by 7 meters at an upward angle of 45°.

Linear Unit

arcpy.ddd.GenerateClearanceSurface(in_3d_features, horizontal_clearance, vertical_clearance, out_surface, cell_size, {overlap_method}, {flare_angle}, {flare_distance})
NameExplanationData Type
in_3d_features

The 3D line features that will be used to generate the clearance zone.

Feature Layer
horizontal_clearance

The horizontal displacement of the clearance zone from each side of the input features.

Linear Unit
vertical_clearance

The vertical displacement of the clearance zone from each input feature. The direction of the vertical displacement is indicated by the overlap_method parameter value. If the MINIMUM option is specified, the vertical displacement will be lower than the input features. If the MAXIMUM option is specified, the displacement will be higher than the input features.

Linear Unit
out_surface

The output raster surface that represents the clearance zone.

Raster Dataset
cell_size

The cell size of the output raster surface.

Linear Unit
overlap_method
(Optional)

Specifies the method that will be used to define the clearance zone in places where the zone around multiple features overlap.

  • MINIMUMThe lowest clearance will be used to define the clearance zone. This is the default.
  • MAXIMUMThe highest clearance will be used to define the clearance zone.
String
flare_angle
(Optional)

The arithmetic angle that defines the direction of the flare at the end of the clearance zone. A positive value indicates the flare angle will extend upward, and a negative value indicates the flare will extend downward.

Double
flare_distance
(Optional)

The 3D length that will extend from the edge of the clearance zone along the direction provided by the flare_angle parameter. A flare angle of 45° and a flare distance of 7 meters mean the edge of the clearance zone defined by its horizontal distance will extended by 7 meters at an upward angle of 45°.

Linear Unit

Code sample

GenerateClearanceSurface example (Python window)

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

import arcpy
arcpy.env.workspace = 'c:/data'
arcpy.ddd.GenerateClearanceSurface('VegManagement.gdb/PowerLines', '15 Meters', 
                                   '9 Meters', 'ClearanceZone.tif', 
                                   '50 Centimeters', 'MAXIMUM', 45, '5 Meters')

Related topics