Ближайший 3D (Инструменты 3D Analyst)

Краткая информация

Вычисляет трехмерное расстояние от каждого входного объекта до ближайших, находящихся в одном или нескольких классах объектов.

Использование

У всех входных объектов должны быть Z-значения. Поддерживаются все типы геометрии. Входные объекты можно также задавать в качестве ближайших для определения ближайших объектов в пределах того же класса.
В таблицу атрибутов входных объектов можно добавить следующие поля:
- NEAR_FID—FID ближайшего объекта. Значение, равное -1, означает, что не было найдено соответствия в пределах указанного радиуса поиска
- NEAR_DIST—2D расстояние (по горизонтали) между ближайшей точкой входного объекта и ближайшей точкой ближайшего найденного объекта.
- NEAR_DIST3—3D расстояние (по уклонам) между ближайшей точкой входного объекта и ближайшей точкой ближайшего найденного объекта.
- NEAR_DELTX—Расстояние вдоль оси X между ближайшей точкой входного объекта и ближайшей точкой ближайшего найденного объекта.
- NEAR_DELTY—Расстояние вдоль оси Y между ближайшей точкой входного объекта и ближайшей точкой ближайшего найденного объекта.
- NEAR_DELTZ—Расстояние вдоль оси Z между ближайшей точкой входного объекта и ближайшей точкой ближайшего найденного объекта.
- NEAR_FROMX—X-координата точки входного объекта, наиболее близко расположенной к ближайшему объекту.
- NEAR_FROMY—Y-координата точки входного объекта, наиболее близко расположенной к ближайшему объекту.
- NEAR_FROMZ—Z-координата точки входного объекта, наиболее близко расположенной к ближайшему объекту.
- NEAR_X—X-координата ближайшей точки ближайшего объекта.
- NEAR_Y—Y-координата ближайшей точки ближайшего объекта.
- NEAR_Z—Z-координата ближайшей точки ближайшего объекта.
- NEAR_ANG_H—Горизонтальный арифметический угол направления к ближайшей точке, выраженный в градусах.
- NEAR_ANG_V—Вертикальный угол направления к ближайшей точке, выраженный в градусах. Горизонтальному направлению соответствует 0, направлению вертикально вверх – 90, вертикально вниз – -90.
- NEAR_FC—Путь к классу объектов, содержащему ближайший найденный объект. Это поле добавляется, если выбрано несколько ближайших объектов.
Примечание:

Если эти поля уже существуют, их значения обновляются.

Подпись	Объяснение	Тип данных
Входные объекты	Входной класс, к объектам которого будут присоединены атрибуты с информацией о ближайшем объекте.	Feature Layer
Ближайшие объекты	Один или несколько объектов, для которых будет вычисляться близость к входным объектам. Если задано несколько классов объектов, во входной класс объектов добавляется поле с названием `NEAR_FC` для определения того, в каком классе ближайших объектов находится самый ближний объект.	Feature Layer
Радиус поиска (Дополнительный)	Максимальное расстояние, в пределах которого определяются ближайшие к заданному объекты. Если ничего не указано, будет найден ближайший объект, независимо от расстояния, на котором он находится.	Linear Unit
Местоположение (Дополнительный)	Определяет, будут ли добавлены во входную таблицу атрибутов координаты ближайшей точки входного и ближайшего объекта. Отмечено–The coordinates are added to the input feature. Не отмечено–The coordinates are not added to the input feature. This is the default.	Boolean
Угол (Дополнительный)	Определяет, будут ли добавлены во входную таблицу атрибутов значения горизонтального арифметического и вертикального углов направления на ближайший объект. Отмечено–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. Не отмечено–The angles will not be added to the input's attribute table. This is the default.	Boolean
Дельта (Дополнительный)	Определяет, будут ли добавлены во входную таблицу атрибутов расстояния вдоль осей X, Y и Z между входным объектом и ближайшим объектом. Отмечено–Distances along the X, Y, and Z axes will be calculated in the `NEAR_DELTX`, `NEAR_DELTY`, and `NEAR_DELTZ` fields. Не отмечено–No distances will be added to the input attribute table. This is the default.	Boolean

Производные выходные данные

Подпись	Объяснение	Тип данных
Обновленные входные объекты	Обновленные входные объекты	Feature Layer

arcpy.3d.Near3D(in_features, near_features, {search_radius}, {location}, {angle}, {delta})

Имя	Объяснение	Тип данных
in_features	Входной класс, к объектам которого будут присоединены атрибуты с информацией о ближайшем объекте.	Feature Layer
near_features [near_features,...]	Один или несколько объектов, для которых будет вычисляться близость к входным объектам. Если задано несколько классов объектов, во входной класс объектов добавляется поле с названием `NEAR_FC` для определения того, в каком классе ближайших объектов находится самый ближний объект.	Feature Layer
search_radius (Дополнительный)	Максимальное расстояние, в пределах которого определяются ближайшие к заданному объекты. Если ничего не указано, будет найден ближайший объект, независимо от расстояния, на котором он находится.	Linear Unit
location (Дополнительный)	Определяет, будут ли добавлены во входную таблицу атрибутов координаты ближайшей точки входного и ближайшего объекта. `LOCATION`–The coordinates are added to the input feature. `NO_LOCATION`–The coordinates are not added to the input feature. This is the default.	Boolean
angle (Дополнительный)	Определяет, будут ли добавлены во входную таблицу атрибутов значения горизонтального арифметического и вертикального углов направления на ближайший объект. `ANGLE`–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. `NO_ANGLE`–The angles will not be added to the input's attribute table. This is the default.	Boolean
delta (Дополнительный)	Определяет, будут ли добавлены во входную таблицу атрибутов расстояния вдоль осей X, Y и Z между входным объектом и ближайшим объектом. `DELTA`–Distances along the X, Y, and Z axes will be calculated in the `NEAR_DELTX`, `NEAR_DELTY`, and `NEAR_DELTZ` fields. `NO_DELTA`–No distances will be added to the input attribute table. This is the default.	Boolean

Производные выходные данные

Имя	Объяснение	Тип данных
out_feature_class	Обновленные входные объекты	Feature Layer

Пример кода

Near3D, пример 1 (окно Python)

В следующем примере показано использование этого инструмента в окне Python:

arcpy.env.workspace = "C:/data"
arcpy.ddd.Near3D("points_3D.shp", "buildings_multipatch.shp", "30", "LOCATION", "ANGLE", "DELTA")

Near3D, пример 2 (автономный скрипт)

В следующем примере показано использование этого инструмента в автономном скрипте Python:

'''****************************************************************************
Name: Near 3D Example
Description: This script demonstrates how to use
             the Near 3D tool to identify the nearest z-aware features
             that satisfy the results from a queried feature.
****************************************************************************'''
# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data'
# Set Local Variables
inFC = 'homes.shp'
nearFC = 'radiotowers.shp'
# See the 'Building an SQL expression' topic for more information
# Query the field 'MATERIAL' for the string 'Reinforced Concrete'
SQL_Expression = "'"'MATERIAL'"' = 'Reinforced Concrete'"
# Run Make Feature Layer
arcpy.management.MakeFeatureLayer(nearFC, 'Near Layer', SQL_Expression)
result = arcpy.management.GetCount('Near Layer')
if int(result.getOutput(0)) == 0:
    arcpy.AddMessage('{0} has no features that satisfy the query: {1}'\
         .format(nearFC, SQL_Expression))
else:
    # Run Near3D
    arcpy.ddd.Near3D(inFC, 'nearLayer', '', 'LOCATION', 'ANGLE')

Параметры среды

Текущая рабочая область, Экстент

Информация о лицензировании

Basic: Требуется 3D Analyst
Standard: Требуется 3D Analyst
Advanced: Требуется 3D Analyst

Ближайший 3D (Инструменты 3D Analyst)

Краткая информация

Использование

Примечание:

Параметры

Производные выходные данные

Параметры среды

Информация о лицензировании

Связанные разделы