Сводка
Определяет расстояния от входных точечных объектов до всех точек среди ближайших объектов на заданном радиусе поиска.
Прежние версии:
Это устаревший инструмент. Эта функциональность заменена инструментами Ближайший объект и Построить таблицу соседних объектов которые рассчитывают расстояние между точечными, линейными или полигональными объектами.
Иллюстрация
Использование
Инструмент создает таблицу расстояний между двумя наборами точек. Если используется радиус поиска по умолчанию, вычисляются расстояния от всех входных точек до всех ближайших точек. Выходная таблица может быть достаточно большой. Например, если в классах входных и ближайших объектов хранится по 1000 точек, выходная таблица может содержать миллион записей.
Используйте корректное значение радиуса поиска, чтобы ограничить размер выходных данных и оптимизировать производительность инструмента. Выходная таблица содержит только те записи, у которых ближайшие точки расположены в радиусе поиска.
Результаты записываются в выходную таблицу, содержащую следующую информацию:
- INPUT_FID: идентификатор входных объектов.
- NEAR_FID: идентификатор ближайших объектов.
- DISTANCE: расстояние от входного до ближайшего объекта. Значение данного поля представляет собой линейную единицу измерения системы координат входных объектов.
И Входные объекты, и Ближайшие объекты могут быть одним и тем же набором данных. В том случае, если входной и ближайший объекты – это одна запись, этот результат будет пропущен, чтобы не сообщать, что каждый объект находится на расстоянии 0 единиц от самого себя.
Синтаксис
arcpy.analysis.PointDistance(in_features, near_features, out_table, {search_radius})| Parameter | Объяснение | Тип данных |
in_features | Точечные объекты, от которых будут вычисляться расстояния до ближайших объектов. | Feature Layer |
near_features | Точки, до которых будут вычисляться расстояния от входных объектов. Расстояния между точками в одном классе пространственных объектов или слое могут быть определены, если вы зададите один и тот же класс пространственных объектов или слой и для входных, и для ближайших объектов. | Feature Layer |
out_table | Таблица, в которой содержится перечень входных объектов и информация обо всех ближайших объектах в пределах радиуса поиска. Если не задан радиус поиска, вычисляются расстояния от всех входных объектов до всех ближайших объектов. | Table |
search_radius (Дополнительный) | Расстояние, в пределах которого проводится поиск потенциальных ближайших объектов. В выходной класс записываются только те ближайшие объекты, которые расположены в окружности, определяемой заданным радиусом. Если значение не задано, то есть параметр Радиус поиска оставлен пустым по умолчанию, в вычислениях участвуют все ближайшие пространственные объекты. По умолчанию для радиуса поиска используются единицы измерения, заданные для входных объектов. Эти единицы можно изменить на любые другие. Однако это не скажется на единицах измерения выходного поля DISTANCE (расстояние), которые наследуются из системы координат входных объектов. | Linear Unit |
Пример кода
Пример скрипта окна Python для использования функции PointDistance в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data/pointdistance.gdb"
arcpy.PointDistance_analysis("police_stations", "crime_location", "crime_distances")В следующем скрипте Python показано, как использовать функцию PointDistance в автономном скрипте.
# Description: Finds distance of each near point from each input point and outputs to a table.
# import system modules
import arcpy
# set workspace environment
arcpy.env.workspace = "C:/data/pointdistance.gdb"
# set variables
in_features = "police_stations"
near_features = "crime_location"
out_table = "crime_distance4"
search_radius = "22000 Feet"
# find crime locations within the search radius
arcpy.PointDistance_analysis(in_features, near_features, out_table, search_radius)Environments
Информация о лицензиях
- Basic: Нет
- Standard: Нет
- Advanced: Да