Skip to main content

Validate Spot Heights (Topographic Production Tools)

Summary

Validates that spot heights are higher than or equal to their respective contour top, and based on the contour interval, that a contour top is not missing a contour line between it and a spot height.

Usage

Caution:

This tool modifies the input data. See Tools that modify or update the input data for more information and strategies to avoid undesired data changes.

  • This tool identifies features in the Input Spot Features parameter value that don't pass the validation. Review the values in the IS_VALID field of the selected features.

  • Contour tops refer to an elevation surrounded by lower elevation contour lines. Contour tops must be polylines that start and end at the same vertex.

  • The Contour Interval parameter value is used to determine if there is a missing contour line between the contour top and the spot height. For example, if the Contour Interval parameter value is 20, and the elevation difference between the spot height and contour top is 40, the spot height will be selected.

  • This tool will update the values for the IS_VALID field as follows:

    Value

    Details

    0

    Valid

    1

    Not highest point in top

    Note:

    This value can only be returned when the Use Input Rasters for Validation parameter is checked.

    2

    Incorrect contour interval

    3

    Invalid contour or spot elevation

    Note:

    This can occur when a contour is a depression and, as a result, the spot's elevation is higher than that of the contour, or vice versa.

    4

    Spot not in contour

    If the IS_VALID field does not exist on the feature class, the tool will create it.

  • When the Use Input Rasters for Validation parameter is unchecked, it is assumed that all contours are tops, and spots that are lower than their surrounding contour will be flagged. The tool will still validate that there is no missing contour line between a contour top and its associated spot height using the Contour Interval parameter value.

  • Using an elevation raster provides the tool with more logic to validate spot heights. The raster is used to identify contour tops and bottoms, as well as compare the raster height values with the height values for the spot heights.

  • Ensure that the height values of the elevation raster closely match the height values of the Input Contours and Input Spot Heights parameter values. The more the elevation values differ, the more likely false positives will be returned by the tool. For best results, use the elevation raster that was used to generate the contour lines and spot heights.

  • If an elevation raster with height values that closely match the height values of the Input Contours and Input Spot Heights parameter values is not available, uncheck the Use Input Rasters for Validation parameter.

Parameters

Label Explanation Data type

Input Contours

The contour features that will be used to validate the spot heights.

Feature Layer

Contour Height Field

The field that contains elevation values for the Input Contours parameter value. The field type must be numeric.

Field

Contour Interval

The interval, or distance, between contour lines. The value can be any positive number. The default is 20.

Long

Input Rasters

The rasters that will be used to derive elevations of points inside contours.

Raster Layer; Mosaic Layer

Input Spot Features

An existing point feature layer that contains spot heights that will be validated.

Feature Layer

Spot Height Field

The field that contains elevation values for the Input Spot Features parameter value.

Field

Area of Interest

(Optional)

The extent that contains the spot heights that will be validated. This parameter does not accept point layers as valid input and must have only one selected feature.

Feature Layer

Z Factor

(Optional)

The unit conversion factor that will be used when validating spot heights to convert the contour elevation value unit of measurement to match the raster's unit of measurement. The default is 1.

For example, if the input raster's elevation values are in meters but the contours are in feet, set the z-factor to 3.28084 (1 meter = 3.28084 feet).

Double

Use Input Rasters for Validation

(Optional)

Specifies whether the Input Rasters parameter value will be used to validate the spot heights.

Note:

When unchecked, the tool will run with Named User Licensing using ArcGIS Enterprise as a licensing portal with a Professional user type that has the ArcGIS Topographic Mapping extension enabled.

  • Checked—The Input Rasters parameter value will be used to validate the spot heights. This is the default.

  • Unchecked—The Input Rasters parameter value will not be used to validate the spot heights.

Boolean

Derived output

Label Explanation Data type

Updated Spot Features

The Input Spot Features parameter value with updated attribution for spot heights.

Feature Layer

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
    When the Use Input Rasters for Validation parameter is unchecked, the tool will run with Named User Licensing using ArcGIS Enterprise as a licensing portal with a Professional user type that has the ArcGIS Topographic Mapping extension enabled.
  • Standard: No
    When the Use Input Rasters for Validation parameter is unchecked, the tool will run with Named User Licensing using ArcGIS Enterprise as a licensing portal with a Professional user type that has the ArcGIS Topographic Mapping extension enabled.
  • Advanced: Requires Topographic Mapping
    When the Use Input Rasters for Validation parameter is unchecked, the tool will run with Named User Licensing using ArcGIS Enterprise as a licensing portal with a Professional user type that has the ArcGIS Topographic Mapping extension enabled.