GAIT (Topographic Production)

Summary

Validates data using the Geospatial Analysis Integrity Tool (GAIT), checking geometry, feature codes, attribute values and domains, and metadata.

Usage

  • You must have CYGWIN and GAIT installed to use this tool.

  • The tool writes its results as line and point shapefiles to an output directory.

  • GAIT can execute against data in MGCP and TDS data models.

  • The attribution schema must match the schema of the input feature layer.

  • The inspection profile represents a set of checks to run during GAIT and depends on the data model set in the Attribution Schema parameter. Valid domain values are included in the tool messages.

  • Every time the GAIT tool is run where a Reviewer workspace is defined, a new Reviewer session will be created.

  • The values of the Metadata Mapping Table parameter depend on the attribution schema. Valid domain values are included in the tool messages.

  • The results of the tool process are stored in two log files: GAITStdError.txt and GAITStdOutput.txt. The log files are located at C:\Users\<user_name>\AppData\Roaming\ESRI.

Parameters

LabelExplanationData Type
Input Features

The features to validate.

Feature Layer; Table View
GAIT Executable

The path to the GAIT executable file.

File
Output Directory

The shapefile export directory.

Folder
Attribution Schema

The data model that corresponds to the data displayed in the input feature layer.

String
Project Name

The name of the project. The project contains validation information, such as the checks run on the data and the results.

String
Inspection Profile

The set of checks to run on the data. This is specific to the data model listed in the attribution schema.

String
Metadata Mapping Table

The metadata mapping table that corresponds to the data model of the input feature layer and the attribution schema.

  • Esri metadata —Esri metadata
  • Intergraph metadata —Intergraph metadata
  • MGCP NGA metadata —MGCP NGA metadata
String
Run Silent

Indicates the amount of output messages to return from GAIT.exe.

  • Checked—Limit messaging from GAIT.exe. This is the default.
  • Unchecked—Run GAIT.exe in verbose mode.
Boolean
Reviewer Workspace
(Optional)

The workspace to write the output features. Each shapefile result record is written to the reviewer table in this workspace.

Workspace
Custom Inspection File
(Optional)

A file that defines custom checks.

File

Derived Output

LabelExplanationData Type
Output Feature Layers

Feature layers that have been validated through GAIT.

Table View; Feature Layer

arcpy.topographic.GAIT(in_features, gait_exe, folder, schema, project, format, metadata, silent, {reviewer_workspace}, {specfile})
NameExplanationData Type
in_features
[in_features,...]

The features to validate.

Feature Layer; Table View
gait_exe

The path to the GAIT executable file.

File
folder

The shapefile export directory.

Folder
schema

The data model that corresponds to the data displayed in the input feature layer.

String
project

The name of the project. The project contains validation information, such as the checks run on the data and the results.

String
format

The set of checks to run on the data. This is specific to the data model listed in the attribution schema.

String
metadata

The metadata mapping table that corresponds to the data model of the input feature layer and the attribution schema.

  • META_ESRIEsri metadata
  • META_INGRIntergraph metadata
  • META_MGCPNGAMGCP NGA metadata
String
silent

Indicates the amount of output messages to return from GAIT.exe.

  • SILENTLimit messaging from GAIT.exe. This is the default.
  • VERBOSERun GAIT.exe in verbose mode.
Boolean
reviewer_workspace
(Optional)

The workspace to write the output features. Each shapefile result record is written to the reviewer table in this workspace.

Workspace
specfile
(Optional)

A file that defines custom checks.

File

Derived Output

NameExplanationData Type
out_featurelayers

Feature layers that have been validated through GAIT.

Table View; Feature Layer

Code sample

GAIT example (stand-alone script)

This stand-alone script demonstrates running the GAIT tool to validate MGCP topographic data against industry standards.

# Name: GAIT_sample.py
# Description: Use the GAIT tool to validate topographic data against industry standards

# Import System Modules
import arcpy
import os

# Check Out Extensions
arcpy.CheckOutExtension('Defense')
arcpy.CheckOutExtension('DataReviewer')

# Setting Local Variables
workspace = r'C:\Testing\GAIT\TDS_6_1.gdb'
gait_exe = r'C:\Program Files\GAIT-WINDOWS-25\gait25.exe'
project_folder = r'C:\Testing\GAIT'
project_name = 'GAIT_TEST_1'

# Generate list of features to validate
in_features = []
for dir_path, dir_names, file_names in arcpy.da.Walk(workspace, datatype='FeatureClass'):
    for file_name in file_names:
        in_features.append(os.path.join(dir_path, file_name))

# Create reviewer workspace to manage GAIT errors
reviewer_workspace = arcpy.management.CreateFileGDB(project_folder, project_name + '_DR', 'CURRENT').getOutput(0)
arcpy.reviewer.EnableDataReviewer(reviewer_workspace, '#', '#', '#')

# Use the GAIT tool to validate topographic data
arcpy.topographic.GAIT(in_features, gait_exe, project_folder, 'TDS6', project_name, 'USE_TDSMASTER', 'META_ESRI', 'SILENT', reviewer_workspace)

# Check In Extensions
arcpy.CheckInExtension('Defense')
arcpy.CheckInExtension('DataReviewer')

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Requires Defense Mapping
  • Advanced: Requires Defense Mapping

Related topics