Skip To Content

Generate OIS Profile Data

Summary

Generates a JSON string that is stored in the ProfileJSON field on your Obstruction Identification Surface feature class that contains the data necessary to depict the terrain, runway, and OIS in the Terrain and Obstacle Profile layout element.

For each runway feature, the tool finds each of the approach surfaces associated with that runway. With each approach surface, the tool uses the sampling distance parameter to extend from the runway and collect the centerline, the highest and lowest values for the terrain along a parallel extending from edge to edge. It also collects the profile information for the runway and the approach surface. The resulting 3D points representing the terrain, runway, and approach surface are stored in JSON format and saved in the corresponding approach OIS feature.

Usage

  • The Input Runway Features parameter must be z-aware and include one of the following fields:

    • RWYDESG
    • LANDINGSTRIPDESIGNATORIDENTIFIER
    • DESIGNATOR_TXT
    Tip:

    Recommended input features may be RunwayCenterline from the Airports data models (18B or 18C) or ADHPSurfaceLine from the AIS datamodel.

  • With each approach surface, the tool will use the underlying digital elevation model (DEM) to determine the minimum and maximum elevations between the left and right edges of the approach surface, sampled along the length of the approach.

  • The Target OIS Features parameter must include the following fields:

    • RWYDESG or LANDINGSTRIPDESIGNATORIDENTIFIER or DESIGNATOR_TXT
    • Name
    • ProfileJSON
      Tip:

      Recommended input features may be ObstructionIdSurface_MP from the Airports 18B or 18C data models.

      Note:

      The field length must be at least 50,000 characters. A warning appears if the JSON output exceeds the length of the ProfileJSON field.

  • The tool will use a flight path ID field (PATHID) to associate curved approach polylines with specific approach surfaces. This is required if you have Input Flight Path Features value provided.

Syntax

GenerateOISProfileData_aviation (in_runway_features, in_dems, target_ois_features, {in_flightpath_features}, {sampling_distance}, {sample_profile_ois}, {sample_profile_runways})
ParameterExplanationData Type
in_runway_features

This is the input runway dataset. The feature class must be z-enabled and contain polylines.

Feature Layer
in_dems
[in_dems,...]

The DEMs covering the runways and their approach obstruction identification surfaces.

Raster Layer
target_ois_features

The multipatch features with defined Airport schema. The feature class must be z-enabled.

Feature Layer
in_flightpath_features
(Optional)

The polyline features that define curved approaches to the specified runways. If unspecified, all input features will be processed as straight approaches.

Feature Layer
sampling_distance
(Optional)

The distance, in meters, between generated points. The default is 30.

Double
sample_profile_ois
(Optional)

Specifies whether elevation points for OIS features will be generated.

  • PROFILE_OISGenerates elevation points.
  • NO_PROFILE_OISElevation points will not be generated. This is default.
Boolean
sample_profile_runways
(Optional)

Specifies whether elevation points along the runways will be generated.

  • PROFILE_RUNWAYGenerates elevation points along the runways.
  • NO_PROFILE_RUNWAYUses only the start and end points of the runways. This is default.
Boolean

Derived Output

NameExplanationData Type
out_ois_features

The updated feature class containing the generated obstruction identification surfaces.

Feature Layer

Code sample

GenerateOISProfileData example (stand-alone script)

The following Python window script demonstrates how to use the GenerateOISProfileData tool.

import arcpy

# set gp environment
arcpy.CheckOutExtension("Airports")

# Input RunwayCenterline Feature Class
inRunwayFeatures = r"C:\data\ois.gdb\RunwayCenterlines"

# Input Terrain DEM Raster
inDEMRaster= ["C:\data\ois.gdb\AirportFirstDEM",
              "C:\data\ois.gdb\AirportSecondDEM"]

# Input Obstruction Identification Surface Feature Class
targetOISFeatures = r"C:\data\ois.gdb\ObstructionIdSurface"

# Input Curved Approach Feature Class
inCurvedApproachFeatures = r"C:\data\ois.gdb\CurvedApproach"

# Processing GenerateOISProfileData
arcpy.GenerateOISProfileData_aviation(inRunwayFeatures, inDEMRaster,
                                      targetOISFeatures,
                                      inCurvedApproachFeatures)

arcpy.CheckInExtension("Airports")

Environments

Licensing information

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

Related topics