Analyze Airport Features (Aviation)

Available with Aviation Airports license.

Summary

Analyzes specified point features around an airfield to find and record information such as distance from a given runway centerline or the end of the nearest runway and its designation.

Usage

  • The Input Analysis Features values do not need specific field schema. Only the geometry field and OBJECTID field are required.

  • In the absence of shape z-values in the input airport features, when Shape Z is specified, a height of 0 (zero) will be used.

  • If Input Analysis Features contains a description field, the description field and values will be included in the output. The name of the description field can be one of the following:

    • DESC
    • DESCRIP
    • DESCRIPTION

  • A 5-nautical mile search radius will be used to filter searches made by the tool when it locates the nearest features to the Input Runway Features values.

  • If Input Runway Features contains a runway designation field, runway designation values will be included in the output. The name of the runway designation field can be one of the following:

    • RWYDESG
    • DESIGNATOR_TXT
    • RUNWAYDESIGNATORIDENTIFIER

  • If the input runway end-point or airport reference point features are not provided, the resulting output fields will be empty.

  • If Runway End Features contains a runway end designation field, runway end designation values will be included in the output. The name of the optional runway end designation field must be RUNWAYENDD. The optional RUNWAYENDD attribute will be used to populate the NearestRunway column in the output table.

  • The tool populates several fields in the Output Table parameter value. The following diagram illustrates how these fields are calculated:

    Analyze Airport Features field diagram

    The following table describes the fields in the Output Table value:

    Output column nameOutput column aliasDescription

    AGL

    AGL

    The above ground level height of the Input Analysis Feature parameter value.

    AGLVUOM

    AGL Vertical Unit of Measure

    The vertical unit of measure of the above ground level height.

    This will be reported as one of the following:

    • The coordinate system's vertical unit of measure belonging to the input analysis feature class. This will be used if the Input Analysis Features Height Unit value is derived from the SHAPE_Z value.
    • The unit specified in the Input Analysis Features Height Unit parameter when the specific value is chosen to represent the height.

    Description

    Description

    The Description attribute from the Input Analysis Features feature class.

    DirectionFromCenterline

    Direction From Centerline

    The intercardinal direction that the input analysis feature lies relative to the associated runway centerline.

    DirectionFromThreshold

    Direction From Threshold

    The intercardinal direction that the input analysis feature lies relative to the associated runway threshold.

    Dist_DTHR_PtAbeam

    Distance Displaced Threshold to Centerline Point Abeam

    The distance from the displaced threshold to the centerline (or extended centerline).

    Dist_THR_PtAbeam

    Distance Threshold to Centerline Point Abeam

    The distance from the threshold to the centerline (or extended centerline) point abeam the input point.

    DistanceFromCenterline

    Distance From Centerline

    The shortest distance from the runway centerline to the analysis point.

    DistanceFromExtendedCenterline

    Distance from Extended Centerline

    The shortest, perpendicular distance from the runway extended centerline to the analysis point.

    DistanceFromThreshold

    Distance from Threshold

    The direct distance from the threshold point to the analysis point. If the threshold point is not found, this value will be calculated from the runway end point.

    HUOM

    Horizontal Unit of Measure

    The coordinate system's horizontal unit of measure belonging to the input analysis feature class.

    NearestRunway

    Nearest Runway

    The runway end designator from the associated feature point in the Runway End Features feature class, from the RUNWAYENDD attribute.

    ObjectID

    ObjectID

    The ObjectID of the output table.

    OffsetDirection

    Offset Direction

    The side, left (L) or right (R), that the input feature lies relative to the landing direction of the extended runway centerline.

    PointID

    Point ID

    The ObjectID from the Input Analysis Feature parameter associated with this output row.

    PointSource

    Point Source

    The workspace path that the input analysis features are from.

    RWYDESIG

    Runway Designator

    The Runway Designator attribute from the associated polyline from the Input Runway Features feature class.

    X

    X

    The x-coordinate of the input analysis feature in the horizontal units of measure.

    Y

    Y

    The y-coordinate of the input analysis feature in the horizontal units of measure.

  • If the Runway End Features parameter value is not specified, the end of the input Input Runway Features polyline will be used as the end of the runway.

    Note:

    When no value is assigned to the Runway End Features parameter, there is no way to identify the runway end designator for the provided runway.

  • If the Airport Reference Point Features parameter value is specified, the input feature class must contain the following fields:

    Field nameData type
    POINTTYPE

    Text

    RUNWAYENDD

    Text

    These field values will be used to locate the nearest displaced threshold point. If the value specified for the Input Runway Features parameter does not contain these fields, the closest runway end point from the Runway End Features parameter value will be used.

    If the Airport Control Point Features parameter value is provided, the tool will search for the location of the runway threshold points by finding features with a POINTTYPE of DISPLACED_THRESHOLD. If the threshold point is not found, or if this feature class is not provided, the calculations for DistanceFromThreshold and Dist_DTHR_PtAbeam will be impacted.

Parameters

LabelExplanationData Type
Input Analysis Features

The input point features that will be analyzed and recorded in terms of their physical relationships to features in the other inputs.

Feature Layer
Input Runway Features

The input runway polyline features, specifically their centerlines, that will be used in the analysis.

Feature Layer
Output Table

The output table, with a row for each input airport feature, containing the analyzed results. The EGL and MSL columns will no longer be output.

Table View
Input Analysis Features Height
(Optional)

Specifies the name of a field in the input airport features dataset. The specified field must contain numeric values. The values in this field will be used to identify the height of each input airport feature. If the SHAPE_Z value is chosen as the location of the height, the Input Analysis Features Height Unit parameter value will be ignored.

  • SHAPE_ZHeight values will be derived from the z-values of the input point features. This is the default.
String
Input Analysis Features Height Unit
(Optional)

Specifies the linear unit of measure that will be used when the Input Analysis Features Height parameter value is specified.

  • KilometersThe unit will be kilometers.
  • MetersThe unit will be meters.
  • DecimetersThe unit will be decimeters.
  • CentimetersThe unit will be centimeters.
  • MillimetersThe unit will be millimeters.
  • Nautical MilesThe unit will be nautical miles.
  • MilesThe unit will be miles.
  • YardsThe unit will be yards.
  • FeetThe unit will be feet.
  • InchesThe unit will be inches.
  • Decimal DegreesThe unit will be decimal degrees.
  • PointsThe unit will be points.
  • UnknownThe unit will be unknown.
String
Runway End Features
(Optional)

The input runway end point features associated with the runways in the Input Runway Features parameter that represent the thresholds of those runways.

Feature Layer
Airport Control Point Features
(Optional)

The input airport control point features that contain the runway threshold points. The runway threshold points will be identified by searching for the POINTTYPE attribute equal to DISPLACED_THRESHOLD, and the attribute RUNWAYENDD equal to the runway end designator.

Feature Layer
Airport Control Point Elevation
(Optional)

Specifies the name of a field in the input airport reference point features dataset. The specified field must contain numeric values. The values in this field will be used to identify the height of each input airport reference point feature. If SHAPE_Z is chosen as the location of the height, the Airport Control Point Elevation Unit parameter value will be ignored.

  • SHAPE_ZThe z-value of each point will be used. This is the default.
String
Airport Reference Point Elevation Unit
(Optional)

Specifies the linear unit of measure that will be used when an airport reference point height is specified.

  • KilometersThe unit will be kilometers.
  • MetersThe unit will be meters.
  • DecimetersThe unit will be decimeters.
  • CentimetersThe unit will be centimeters.
  • MillimetersThe unit will be millimeters.
  • Nautical MilesThe unit will be nautical miles.
  • MilesThe unit will be miles.
  • YardsThe unit will be yards.
  • FeetThe unit will be feet.
  • InchesThe unit will be inches.
  • Decimal DegreesThe unit will be decimal degrees.
  • PointsThe unit will be points.
  • UnknownThe unit will be unknown.
String
Output Horizontal Unit of Measure
(Optional)

Specifies the output unit of measurement for the five output distances produced.

  • Same as inputThe horizontal units from the input coordinate system will be used. If the input data is not projected, this will be meters. This is the default
  • KilometersThe unit will be kilometers.
  • MetersThe unit will be meters.
  • DecimetersThe unit will be decimeters.
  • CentimetersThe unit will be centimeters.
  • MillimetersThe unit will be millimeters.
  • Nautical MilesThe unit will be nautical miles.
  • MilesThe unit will be miles.
  • YardsThe unit will be yards.
  • FeetThe unit will be feet.
  • InchesThe unit will be inches.
String

arcpy.aviation.AnalyzeAirportFeatures(in_features, in_runway_features, out_table, {in_features_height}, {in_features_height_unit}, {runway_end_features}, {airport_ref_point_features}, {ref_point_height}, {ref_point_height_unit}, {in_out_horizontal_unit})
NameExplanationData Type
in_features

The input point features that will be analyzed and recorded in terms of their physical relationships to features in the other inputs.

Feature Layer
in_runway_features

The input runway polyline features, specifically their centerlines, that will be used in the analysis.

Feature Layer
out_table

The output table, with a row for each input airport feature, containing the analyzed results. The EGL and MSL columns will no longer be output.

Table View
in_features_height
(Optional)

Specifies the name of a field in the input airport features dataset. The specified field must contain numeric values. The values in this field will be used to identify the height of each input airport feature. If the SHAPE_Z value is chosen as the location of the height, the Input Analysis Features Height Unit parameter value will be ignored.

  • SHAPE_ZHeight values will be derived from the z-values of the input point features. This is the default.
String
in_features_height_unit
(Optional)

Specifies the linear unit of measure that will be used when the in_features_height parameter value is specified.

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

The input runway end point features associated with the runways in the in_runway_features parameter that represent the thresholds of those runways.

Feature Layer
airport_ref_point_features
(Optional)

The input airport control point features that contain the runway threshold points. The runway threshold points will be identified by searching for the POINTTYPE attribute equal to DISPLACED_THRESHOLD, and the attribute RUNWAYENDD equal to the runway end designator.

Feature Layer
ref_point_height
(Optional)

Specifies the name of a field in the input airport reference point features dataset. The specified field must contain numeric values. The values in this field will be used to identify the height of each input airport reference point feature. If SHAPE_Z is chosen as the location of the height, the Airport Control Point Elevation Unit parameter value will be ignored.

  • SHAPE_ZThe z-value of each point will be used. This is the default.
String
ref_point_height_unit
(Optional)

Specifies the linear unit of measure that will be used when an airport reference point height is specified.

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

Specifies the output unit of measurement for the five output distances produced.

  • SAME_AS_INPUTThe horizontal units from the input coordinate system will be used. If the input data is not projected, this will be meters. This is the default
  • KILOMETERSThe unit will be kilometers.
  • METERSThe unit will be meters.
  • DECIMETERSThe unit will be decimeters.
  • CENTIMETERSThe unit will be centimeters.
  • MILLIMETERSThe unit will be millimeters.
  • NAUTICAL_MILESThe unit will be nautical miles.
  • MILESThe unit will be miles.
  • YARDSThe unit will be yards.
  • FEETThe unit will be feet.
  • INCHESThe unit will be inches.
String

Code sample

AnalyzeAirportFeatures example (Python)

The following Python script demonstrates how to use the AnalyzeAirportFeatures function.

import arcpy

arcpy.CheckOutExtension("Airports")

# Input Airport Feature Class
inAirportFeatures = r"C:\data\airport.gdb\AirportFeatures"

# Input RunwayCenterline Feature Class
inRunwayFeatures = r"C:\data\airport.gdb\Airfield\RunwayCenterline"

# Input Runway End Point Feature Class
inRunwayEndFeatures= r"C:\data\airport.gdb\Airfield\RunwayEnd"

# Input Airport Control Point Features
inACPFeatures = r"C:\data\airport.gdb\Geodetic\AirportControlPoint"

# Output Horizontal Units
inOutputHorizontalUnits = r"METERS"

# Output Table
outTable = r"C:\data\airport.gdb\AirportFeatureTable"

# Processing AnalyzeAirportFeatures
arcpy.aviation.AnalyzeAirportFeatures(inAirportFeatures, inRunwayFeatures, outTable, 
"Shape_Z", runway_end_features=inRunwayEndFeatures, airport_ref_point_features=inACPFeatures, in_out_horizontal_unit=inOutputHorizontalUnits)

arcpy.CheckInExtension("Airports")

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Requires Airports
  • Advanced: No

Related topics