Label | Explanation | Data 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.
| 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.
| 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.
| 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.
| String |
Output Horizontal Unit of Measure
(Optional) | Specifies the output unit of measurement for the five output distances produced.
| String |
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:
The following table describes the fields in the Output Table value:
Output column name Output column alias Description 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 name Data 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
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})
Name | Explanation | Data 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.
| 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.
| 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.
| String |
ref_point_height_unit (Optional) | Specifies the linear unit of measure that will be used when an airport reference point height is specified.
| String |
in_out_horizontal_unit (Optional) | Specifies the output unit of measurement for the five output distances produced.
| String |
Code sample
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
Licensing information
- Basic: No
- Standard: Requires Airports
- Advanced: No