Skip To Content

Generate OIS Profile Data

Summary

Generates a JSON string to represent various relationships. This tool enhances select Obstruction Identification Surfaces (OIS) features by determining the minimum, maximum, and true elevations along the approach to their runways, adding collections of 3D points representing those elevations to those features using JSON.

Usage

  • The Input Runway Features parameter must be z-enabled.

  • The Input Runway Features parameter must include the following field:

    • Runway Designator (RWYDESG or LANDINGSTRIPDESIGNATORIDENTIFIER)

  • Using a multipatch OIS feature class generated by any of the OIS tools, for example FAA13A or FAA18B, is recommended, with all defined attributes populated in the Airport schema.

  • The tool will take each runway feature and find each of the approach surfaces associated with that runway.

  • 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.

  • Collections of true, minimum, and maximum elevation 3D points are then created and stored in JSON format and saved in the corresponding approach OIS features.

  • Straight runway approaches are assumed and extended to 25000 meters.

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

    • Runway Designator (RWYDESG or LANDINGSTRIPDESIGNATORIDENTIFIER)
    • Name
    • Description (DESCRIP)
    • PROFILEJSON
      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

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

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

Related topics