Near 3D (3D Analyst)

ArcGIS Pro 3.4 | | Help archive

Summary

Calculates the three-dimensional distance from each input feature to the nearest feature that resides in one or more near feature classes.

Usage

  • All input features must have Z values, and all geometry types are supported. The input features can also be specified as the near features to determine the closest features within the same feature class.

  • The following fields may be added to the input feature's attribute table:

    • NEAR_FID—The FID of the nearest feature. A value of -1 indicates no match was found within the specified search radius
    • NEAR_DIST—The 2D distance (horizontal distance) between the nearest point on an input feature and the nearest point on the nearest feature.
    • NEAR_DIST3—The 3D distance (slope distance) between the nearest point on an input feature and the nearest point on the nearest feature.
    • NEAR_DELTX—The distance along the X axis from the nearest point on the input feature to the nearest point on the nearest feature.
    • NEAR_DELTY—The distance along the Y axis from the nearest point on the input feature to the nearest point on the nearest feature.
    • NEAR_DELTZ—The distance along the Z axis from the nearest point on the input feature to the nearest point on the nearest feature.
    • NEAR_FROMX—The X coordinate of the nearest point on the input feature to the nearest feature.
    • NEAR_FROMY—The Y coordinate of the nearest point on the input feature to the nearest feature.
    • NEAR_FROMZ—The Z coordinate of the nearest point on the input feature to the nearest feature.
    • NEAR_X—The X coordinate of the nearest point on the nearest feature.
    • NEAR_Y—The Y coordinate of the nearest point on the nearest feature.
    • NEAR_Z—The Z coordinate of the nearest point on the nearest feature.
    • NEAR_ANG_H—The horizontal arithmetic angle to the nearest point expressed in degrees.
    • NEAR_ANG_V—The angle of elevation to the nearest point expressed in degrees. Horizontal is zero, straight up is 90, straight down is -90.
    • NEAR_FC—The path of the feature class containing the nearest feature. This field is only added when multiple Near Features are specified.
    Note:

    If the aforementioned fields already exist, their values will be updated.

Parameters

LabelExplanationData Type
Input Features

The input feature class whose features will be attributed with information about the nearest feature.

Feature Layer
Near Features

The one or more features whose proximity to the input features will be calculated. If multiple feature classes are specified, an additional field named NEAR_FC will be added to the input feature class to identify which near feature class contained the closest feature.

Feature Layer
Search Radius
(Optional)

The maximum distance for which the nearest features from a given input will be determined. If no value is specified, the nearest feature at any distance will be determined.

Linear Unit
Location
(Optional)

Determines whether the coordinates of the nearest point in the input and near feature will be added to the input's attribute table.

  • Unchecked—The coordinates are not added to the input feature. This is the default.
  • Checked—The coordinates are added to the input feature.
Boolean
Angle
(Optional)

Determines whether the horizontal arithmetic angle and vertical angle between the input feature and the nearest feature will be added to the input attribute table.

  • Unchecked—The angles will not be added to the input's attribute table. This is the default.
  • Checked—The horizontal arithmetic angle and vertical angle will be added to the NEAR_ANG_H and NEAR_ANG_V fields in the input's attribute table.
Boolean
Delta
(Optional)

Determines whether the distances along the X, Y, and Z axes between the input feature and the nearest feature will be added to the input attribute table.

  • Unchecked—No distances will be added to the input attribute table. This is the default.
  • Checked—Distances along the X, Y, and Z axes will be calculated in the NEAR_DELTX, NEAR_DELTY, and NEAR_DELTZ fields.
Boolean

Derived Output

LabelExplanationData Type
Updated Input Features

The updated input features.

Feature Layer

Licensing information

  • Basic: Requires 3D Analyst
  • Standard: Requires 3D Analyst
  • Advanced: Requires 3D Analyst

Related topics