Ближайший объект (Near) (Покрытие)
Краткая информация
Вычисляет расстояние от каждой точки в покрытии до ближайшей дуги, точки или узла в другом покрытии.
Рисунок
 |
Использование
-
Радиус поиска – это максимальное расстояние от текущей точки до пространственного объекта, выраженное в единицах покрытия, при котором этот объект рассматривается как ближайший объект. По умолчанию это ширина или высота границы (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.
- Нахождение ближайшей доступной линии в сети.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_cover |
Покрытие, содержащее точки, от которых вычисляются расстояния до каждой ближайшей дуги, точки или узла в <near_cover:>. | Coverage |
near_cover |
Линейное или точечное покрытие, объекты которого используются для вычисления расстояний от каждой точки входного покрытия. Оно должно отличаться от входного покрытия. | Coverage |
out_cover |
Покрытие, которое будет создано. <input_cover> копируется в <output_cover:>, и к <output_cover:> применяется инструмент Близкий (NEAR). | Coverage |
feature_type (дополнительно) |
Тип объекта для нахождения объекта, ближайшего к точкам, и вычисления расстояния между ними.
| String |
search_radius (дополнительно) |
Максимальное расстояние в единицах покрытия между объектами входного покрытия и объектами близкого покрытия, для которых будут определены расстояние и внутренний номер. Если в пределах радиуса поиска для данной точки или линии входного покрытия отсутствует объект близкого покрытия, значения внутреннего номера и расстояния на выходе инструмента Близкий (NEAR) будут равны нулю. По умолчанию радиус поиска равен значению ширины или высоты BND близкого покрытия, поделенному на 100 (берется большее из этих значений). Радиус поиска по умолчанию используется, когда аргумент радиуса поиска равен нулю или пропущен. | Double |
location (дополнительно) |
Определяет, будут ли сохранены x,y-координаты "ближайшей точки" ближайшей дуги, точки или узла, а также cover# и расстояние. Новыми элементами будут X-COORD и Y-COORD.
| Boolean |
Пример кода
В следующем автономном скрипте показано, как вычислить расстояния между скважинами в одном покрытии и дорогами в другом.
# 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)