Aggregate Obstacles (Aviation)

获得 Aviation Charting 许可后可用。

摘要

Aggregates obstacle features within a given radius so that the highest obstacle in the group represents the entire group.

The tool provides a better cartographic representation of obstacle data on dense or crowded charts. Instead of being displayed individually, obstacle data can be represented as groups of obstacles based on the location of the highest obstacle in each group.

使用情况

  • The tool uses the geometry and attribution of the obstacle at the highest Above Mean Sea Level (AMSL) elevation (measured at either the base or the top of the obstacle) to represent all obstacles within a search radius of that obstacle.

  • Obstacles are considered for grouping if they are as tall or taller (height above ground level) than the provided height threshold (or the built-up area height threshold if inside a built-up area polygon).

  • You can specify whether obstacle elevations are measured on the ground at the base of the obstacle or at the top of the obstacle.

参数

标注说明数据类型
Obstacle Features

The input obstacle features.

Feature Layer
Height Field

The field containing the height of the obstacle features.

String
Height Field Units

Specifies the units that will be used for obstacle height.

  • MetersThe obstacle height will be in meters.
  • DecimetersThe obstacle height will be in decimeters.
  • CentimetersThe obstacle height will be in centimeters.
  • MillimetersThe obstacle height will be in millimeters.
  • YardsThe obstacle height will be in yards.
  • FeetThe obstacle height will be in feet. This is the default.
  • InchesThe obstacle height will be in inches.
String
Elevation Field

The field containing the elevation of the obstacle features.

String
Elevation Field Units

Specifies the units that will be used for obstacle elevation.

  • MetersThe obstacle elevation will be in meters.
  • DecimetersThe obstacle elevation will be in decimeters.
  • CentimetersThe obstacle elevation will be in centimeters.
  • MillimetersThe obstacle elevation will be in millimeters.
  • YardsThe obstacle elevation will be in yards.
  • FeetThe obstacle elevation will be in feet. This is the default.
  • InchesThe obstacle elevation will be in inches.
String
Elevation Interpretation

Specifies how obstacle elevations will be measured.

  • On the GroundElevation values will be measured using the AMSL elevation of the base of the obstacle. The height value will be added to the elevation value to determine the elevation of the top of the obstacle.
  • Above the GroundElevation values will be measured using the AMSL elevation of the top of the obstacle. This is the default.
String
Target Obstacle Group Features

The output feature class to which aggregated obstacle features will be written.

Feature Layer
Target Obstacle Group Label

The text describing the obstacle grouping. The text is used to identify obstacle groups for different chart specifications that may be created using different parameters.

String
Obstacle Association Table

A table that will be populated with information linking each obstacle group feature to the obstacles it represents.

Table View
Search Radius
(可选)

The radius within which the obstacles will be grouped.

Linear Unit
Height Threshold
(可选)

The height threshold for an obstacle to be considered for grouping. Obstacles with a height value greater than or equal to this value will be considered.

Linear Unit
Built-Up Areas
(可选)

Polygon features designating built up areas. These represent areas where a different height threshold is required.

Feature Layer
Built-Up Areas Height Threshold
(可选)

The height threshold for an obstacle within a built-up area polygon to be considered for grouping. Obstacles with a height value equal to or greater than this value will be considered.

Linear Unit

派生输出

标注说明数据类型
Updated Obstacle Group Features

The updated obstacle group features.

Feature Layer

arcpy.aviation.AggregateObstacles(in_obstacle_features, height_field, height_field_units, elevation_field, elevation_field_units, elevation_interpretation, target_obstacle_group_features, target_obstacle_group_label, in_obstacle_assocation_table, {search_radius}, {height_threshold}, {builtup_areas_features}, {builtup_areas_height_threshold})
名称说明数据类型
in_obstacle_features

The input obstacle features.

Feature Layer
height_field

The field containing the height of the obstacle features.

String
height_field_units

Specifies the units that will be used for obstacle height.

  • METERSThe obstacle height will be in meters.
  • DECIMETERSThe obstacle height will be in decimeters.
  • CENTIMETERSThe obstacle height will be in centimeters.
  • MILLIMETERSThe obstacle height will be in millimeters.
  • YARDSThe obstacle height will be in yards.
  • FEETThe obstacle height will be in feet. This is the default.
  • INCHESThe obstacle height will be in inches.
String
elevation_field

The field containing the elevation of the obstacle features.

String
elevation_field_units

Specifies the units that will be used for obstacle elevation.

  • METERSThe obstacle elevation will be in meters.
  • DECIMETERSThe obstacle elevation will be in decimeters.
  • CENTIMETERSThe obstacle elevation will be in centimeters.
  • MILLIMETERSThe obstacle elevation will be in millimeters.
  • YARDSThe obstacle elevation will be in yards.
  • FEETThe obstacle elevation will be in feet. This is the default.
  • INCHESThe obstacle elevation will be in inches.
String
elevation_interpretation

Specifies how obstacle elevations will be measured.

  • ON_THE_GROUNDElevation values will be measured using the AMSL elevation of the base of the obstacle. The height value will be added to the elevation value to determine the elevation of the top of the obstacle.
  • ABOVE_THE_GROUNDElevation values will be measured using the AMSL elevation of the top of the obstacle. This is the default.
String
target_obstacle_group_features

The output feature class to which aggregated obstacle features will be written.

Feature Layer
target_obstacle_group_label

The text describing the obstacle grouping. The text is used to identify obstacle groups for different chart specifications that may be created using different parameters.

String
in_obstacle_assocation_table

A table that will be populated with information linking each obstacle group feature to the obstacles it represents.

Table View
search_radius
(可选)

The radius within which the obstacles will be grouped.

Linear Unit
height_threshold
(可选)

The height threshold for an obstacle to be considered for grouping. Obstacles with a height value greater than or equal to this value will be considered.

Linear Unit
builtup_areas_features
(可选)

Polygon features designating built up areas. These represent areas where a different height threshold is required.

Feature Layer
builtup_areas_height_threshold
(可选)

The height threshold for an obstacle within a built-up area polygon to be considered for grouping. Obstacles with a height value equal to or greater than this value will be considered.

Linear Unit

派生输出

名称说明数据类型
updated_obstacle_group_features

The updated obstacle group features.

Feature Layer

代码示例

AggregateObstacles example (stand-alone script)

The following script demonstrates how to use the AggregateObstacles function.

# Import system modules
import arcpy

# Check out extensions
arcpy.CheckOutExtension("Aeronautical")

# Set environment settings
arcpy.env.workspace = r"C:/data/AIS.gdb"

# Set local variables
in_obstacle_features = "Obstacle"
height_field = "HEIGHT_VAL"
height_field_units = "FEET"
elevation_field = "ELEV_VAL"
elevation_field_units = "FEET"
elevation_interpretation = "ABOVE_THE_GROUND"
target_obstacle_group_features = "ObstacleGroup"
target_obstacle_group_label = "Enroute Series"
in_obstacle_assocation_table = "ObstacleAssociation"
search_radius = "1.5 NauticalMiles"
height_threshold = "100 Feet"
builtup_areas_features = "BuiltUpAreas"
builtup_areas_height_threshold = "300 Feet"

# Call the AggregateObstacles tool
arcpy.aviation.AggregateObstacles(in_obstacle_features,\
                                  height_field, height_field_units, elevation_field,\
                                  elevation_field_units, elevation_interpretation,target_obstacle_group_features,\
                                  target_obstacle_group_label,\
                                  in_obstacle_assocation_table, search_radius,\
                                  height_threshold, builtup_areas_features,\
                                  builtup_areas_height_threshold)

# Check in extensions
arcpy.CheckInExtension('Aeronautical')

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 否
  • Standard: 需要 ArcGIS Aviation Charting
  • Advanced: 需要 ArcGIS Aviation Charting

相关主题