Ближайший объект (Near)

Доступно с лицензией Advanced.

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

Вычисляет расстояние от каждой точки в покрытии до ближайшей дуги, точки или узла в другом покрытии.

Рисунок

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

• Радиус поиска – это максимальное расстояние от текущей точки до пространственного объекта, выраженное в единицах покрытия, при котором этот объект рассматривается как ближайший объект. По умолчанию это ширина или высота границы (BND) близкого покрытия, поделенная на 100 (берется большее из этих значений).

• Результаты записываются в таблицу атрибутов точек (РАТ) Выходного покрытия. Элементы для DISTANCE и внутреннего номера ближайшего объекта добавляются или обновляются; элементы для x- и y-координат добавляются, когда отмечена опция Записать x,y-координаты ближайшего объекта (Record x,y coordinates of nearest feature). Если в пределах радиуса поиска не найдено ни одного объекта, значения всех элементов будут равны нулю.

• Если элемент DISTANCE уже существует во входном покрытии, его значения пересчитываются. Если элемент DISTANCE добавляется, он будет иметь ту же точность, что и покрытие.

  Элементы на выходе инструмента Близкий (NEAR) включают:

  

  Эти элементы добавляются в таблицу РАТ входного покрытия. Если элемент DISTANCE уже существует, значения будут пересчитаны. Если элемент DISTANCE добавляется, он будет иметь ту же точность, что и покрытие. Если в пределах радиуса поиска для данной точки входного покрытия не найдено совпадения, значения обоих элементов будут равны нулю.

• Расчетным расстоянием от точки до дуги является расстояние от точки до ближайшей точки дуги. Расчетным расстояниям от точки до узла является расстояние между ближайшими узлами на дугах.

• Расстояние и внутренний номер ближайшего объекта сохраняются как новые элементы в таблице атрибутов объектов входного покрытия.

• Инструмент Близкий (NEAR) пропускает повторяющиеся номера узлов, чтобы увеличить время операции.

• Инструмент Близкий (NEAR) не меняет точность координат входного покрытия.

• Инструмент Близкий (NEAR) можно использовать для присвоения атрибутов точек ближайшим дугам и наоборот. Эту операцию можно использовать для присвоения диапазонов адресов дугам; связывания с узлами атрибутов точек, например номеров узлов DIME; или нахождения ближайшей доступной линии в сети (например, определения коллекторной линии, к которой можно было бы подключить землевладение).

• Инструмент Близкий (Near) обычно имеет следующее применение:

  • Присвоение атрибутов точек ближайшим дугам и наоборот.
  • Присвоение диапазонов адресов дугам.
  • Связывание с узлами атрибутов точек, например номеров узлов DIME.
  • Нахождение ближайшей доступной линии в сети.

Синтаксис

Near_arc (in_cover, near_cover, out_cover, {feature_type}, {search_radius}, {location})

Параметр	Объяснение	Тип данных
in_cover	Покрытие, содержащее точки, от которых вычисляются расстояния до каждой ближайшей дуги, точки или узла в <near_cover:>.	Coverage
near_cover	Линейное или точечное покрытие, объекты которого используются для вычисления расстояний от каждой точки входного покрытия. Оно должно отличаться от входного покрытия.	Coverage
out_cover	Покрытие, которое будет создано. <input_cover> копируется в <output_cover:>, и к <output_cover:> применяется инструмент Близкий (NEAR).	Coverage
feature_type (дополнительно)	Тип объекта для нахождения объекта, ближайшего к точкам, и вычисления расстояния между ними. LINE —Будет определено расстояние от точки до дуги. В таблицу РАТ покрытия <input_cover> будут добавлены новые элементы для расстояния и внутреннего номера ближайшей дуги в <near_cover:>. Это является опцией по умолчанию. ТОЧКА (POINT) —Будет определено расстояние от точки до точки. В таблицу РАТ покрытия <input_cover> будут добавлены новые элементы для расстояния и внутреннего номера ближайшей точки в <near_cover:>. NODE —Будет определено расстояние от точки до узла. В таблицу РАТ покрытия <input_cover> будут добавлены новые элементы для расстояния и внутреннего номера узла ближайшего узла в <near_cover:>.	String
search_radius (дополнительно)	Максимальное расстояние в единицах покрытия между объектами входного покрытия и объектами близкого покрытия, для которых будут определены расстояние и внутренний номер. Если в пределах радиуса поиска для данной точки или линии входного покрытия отсутствует объект близкого покрытия, значения внутреннего номера и расстояния на выходе инструмента Близкий (NEAR) будут равны нулю. По умолчанию радиус поиска равен значению ширины или высоты BND близкого покрытия, поделенному на 100 (берется большее из этих значений). Радиус поиска по умолчанию используется, когда аргумент радиуса поиска равен нулю или пропущен.	Double
location (дополнительно)	Определяет, будут ли сохранены x,y-координаты "ближайшей точки" ближайшей дуги, точки или узла, а также cover# и расстояние. Новыми элементами будут X-COORD и Y-COORD. NO_LOCATION —x,y-координаты ближайшей точки не сохраняются. Это значение используется по умолчанию. LOCATION —x,y- координаты ближайшей точки, а также cover# и расстояние сохраняются.	Boolean

Пример кода

Пример Near (автономный скрипт)

В следующем автономном скрипте показано, как вычислить расстояния между скважинами в одном покрытии и дорогами в другом.

# Name: Near_Example.py
# Description: Computes the distances between wells and roads
# Requirements: ArcInfo Workstation

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
inCover = "wells142"
nearCover = "road"
outCover = "C:/output/nearwells"
featureType = "LINE"
searchRadius = 12000
location = "LOCATION"

# #Execute Near
arcpy.Near_arc(inCover, nearCover, outCover, featureType, 
               searchRadius, location)

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

• Текущая рабочая область (Current Workspace)
• Степень сравнения между файлами проекций (Level of Comparison Between Projection Files)
• Точность для вычисляемых покрытий (Precision For Derived Coverages)
• Точность для новых покрытий (Precision For New Coverages)
• Временная рабочая область (Scratch Workspace)

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

• ArcGIS for Desktop Basic: Нет
• ArcGIS for Desktop Standard: Нет
• ArcGIS for Desktop Advanced: Требует установленная ArcInfo Workstation

Отзыв по этому разделу?