| Подпись | Описание | Тип данных |
Входные объекты | Входные объекты, которые могут быть точечного, полилинейного, полигонального или мультиточечного типа. | Feature Layer |
Ближайшие объекты | Один или несколько слоев или классов пространственных объектов, содержащих потенциальные ближайшие объекты. Ближайшие объекты могут быть точками, полилиниями, полигонами или мультиточками. Если задано несколько слоев или классов объектов, во входную таблицу добавляется поле NEAR_FC, в котором для каждого ближайшего объекта будет указан путь к его исходному классу объектов. Входные и ближайшие объекты могут быть представлены одним и тем же классом объектов или слоем. | Feature Layer |
Выходная таблица |
Выходная таблица, содержащая результаты анализа. | Table |
Радиус поиска (Дополнительный) | Радиус поиска ближайших объектов. Если значение не указано, в вычисления включаются все ближайшие объекты. Если расстояние введено, но единица измерения не задана или установлена на Unknown, используются единицы системы координат входных объектов. Если опция Геодезический используется для параметра Метод, используйте линейные единицы, например, километры или мили. | Linear Unit |
Местоположение (Дополнительный) | Определяет, будут ли записаны в поля FROM_X, FROM_Y, NEAR_X и NEAR_Y координаты x и y точки входного объекта и ближайшей точки ближайшего объекта.
| Boolean |
Угол (Дополнительный) | Определяет, будут ли вычислены и записаны в поле NEAR_ANGLE выходной таблицы угловые направления к ближайшим объектам. Угол до ближайшего объекта измеряет направление линии, соединяющей входной объект и ближайший объект по кратчайшему расстоянию. Если значением параметра Метод является Плоскостные, угол может принимать значения в диапазоне от -180° до 180°, где 0° – восток, 90° – север, 180° (или -180°) – запад и -90° – юг. Если используется метод Геодезические, угол может принимать значения в диапазоне от -180° до 180°, где 0° – север, 90° – восток, 180° (или -180°) – юг и -90° – запад.
| Boolean |
Найти только ближайшие объекты (Дополнительный) | Определяет, будет ли инструмент возвращать только самые близкие объекты или несколько объектов.
| Boolean |
Максимальное число ближайших совпадений (Дополнительный) | Ограничивает число ближайших объектов, указываемых для каждого входного объекта. Этот параметр отключен, если отмечена опция Найти только ближайший объект. | Long |
Метод (Дополнительный) | Определяет, будет ли инструмент использовать кратчайший путь на сфероиде (геодезический) или на плоской земной поверхности (плоскостной). Настоятельно рекомендуется использовать метод Геодезические, если данные хранятся в координатной системе, не подходящей для измерения расстояний (такой как Web Mercator и все географические системы координат), или если набор данных охватывает большую географическую область.
| String |
Краткая информация
Вычисляет расстояние и другую информацию о близости объектов в одном или нескольких классах пространственных объектов или слоях. В отличие от инструмента Ближайший объект, обновляющего входные данные, инструмент Построить таблицу соседних объектов записывает результаты в новую автономную таблицу и позволяет находить несколько ближайших объектов.
Более подробно о вычислении близости с помощью инструментов геообработки
Иллюстрация
Использование
Выходная таблица будет содержать следующие поля:
- IN_FID— ObjectID входного объекта.
- NEAR_FID— ObjectID ближайшего объекта.
- NEAR_DIST— Расстояние от входного до ближайшего объекта. Если значением параметра Метод является GEODESIC, и входные объекты заданы в географической системе координат, значения в этом поле указываются в линейных единицах измерения системы координат входных объектов или в метрах.
- NEAR_FC— Путь к классу объектов, содержащему ближайший объект. Это поле добавляется в выходную таблицу только в том случае, если указано несколько Ближайших объектов.
- NEAR_RANK— Целочисленное значение, ранжирующее все ближайшие объекты по их близости к данному входному объекту. Значение в поле NEAR_RANK для самого близкого объекта будет 1, NEAR_RANK следующего по близости объекта будет 2 и т.д.
Если отмечен параметр Местоположение (параметр location имеет значение LOCATION в Python), в выходную таблицу будут добавлены следующие поля. Единицы измерения значений полей зависят от метода, заданного параметром Метод. Если выбрано PLANAR, значение дается в линейных единицах измерения системы координат входных объектов. Если выбрано GEODESIC, значение дается в географической системе координат, связанной с системой координат входных объектов.
- FROM_X— X-координата точки входного объекта, наиболее близкой к ближайшему объекту. FROM_X— Y-координата точки входного объекта, наиболее близкой к ближайшему объекту.
- NEAR_X— X-координата точки ближайшего объекта, наиболее близкой к входному объекту.
- NEAR_Y— Y-координата точки ближайшего объекта, наиболее близкой к входному объекту.
Если отмечен параметр Угол (параметр angle в скрипте имеет значение ANGLE), в выходную таблицу будет добавлено следующее поле.
- NEAR_ANGLE— угол линии в местоположениях FROM_X и FROM_Y, которая соединяет входные объекты с ближайшим объектом.
Если входной и ближайший объекты пересекаются, в выходную таблицу записываются следующие значения:
- NEAR_ANGLE и NEAR_DIST будет задан как 0.0.
- FROM_X и FROM_Y будет совпадать с NEAR_X и NEAR_Y, и будет представлять точку в области пересечения двух объектов.
Значения в поле NEAR_DIST указываются в линейных единицах измерения системы координат входных объектов. Если входные объекты заданы в географической системе координат, и значением параметра Метод является GEODESIC, единицами NEAR_DIST будут метры.
Выходную таблицу можно присоединить обратно к входным объектам или к ближайшим объектам с помощью полей IN_FID и NEAR_FID, соответственно.
Если задан Радиус поиска (Search Radius), но ближайшие объекты не найдены, выходная таблица не имеет записей.
Если Радиус поиска не задан, инструмент включает в вычисления все ближайшие объекты.
Если Радиус поиска не задан, и при этом опция Найти только ближайшие объекты не отмечена (значением closest является ALL в Python), а параметр Максимальное число ближайших объектов имеет значение по умолчанию (0 или пустое), выходная таблица будет содержать расстояния между всеми входными объектами и всеми ближайшими объектами. Их вычисление может занять довольно много времени, и выходная таблица может быть весьма большой. Так, если у вас есть 1000 входных объектов и 1000 ближайших объектов, в выходной таблице будет миллион записей.
Входные и ближайшие объекты могут быть представлены одним и тем же классом объектов или слоем. В этом случае каждый входной объект исключается из ближайших к нему объектов, поскольку в противном случае все объекты оказались бы ближайшими к самим себе.
Когда значением является Плоскостной для параметра Метод, входные объекты должны находиться в проекции, позволяющей корректно измерять расстояния, например, в равнопромежуточной проекции.
Более подробно о картографических проекциях и системах координат
Для визуализации местоположений FROM_X, FROM_Y, NEAR_X и NEAR_Y выходная таблица может использоваться в качестве входных данных для инструмента Создать слой событий XY или XY в линию.
Параметры
arcpy.analysis.GenerateNearTable(in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count}, {method})| Имя | Описание | Тип данных |
in_features | Входные объекты, которые могут быть точечного, полилинейного, полигонального или мультиточечного типа. | Feature Layer |
near_features [near_features,...] | Один или несколько слоев или классов пространственных объектов, содержащих потенциальные ближайшие объекты. Ближайшие объекты могут быть точками, полилиниями, полигонами или мультиточками. Если задано несколько слоев или классов объектов, во входную таблицу добавляется поле NEAR_FC, в котором для каждого ближайшего объекта будет указан путь к его исходному классу объектов. Входные и ближайшие объекты могут быть представлены одним и тем же классом объектов или слоем. | Feature Layer |
out_table |
Выходная таблица, содержащая результаты анализа. | Table |
search_radius (Дополнительный) | Радиус поиска ближайших объектов. Если значение не указано, в вычисления включаются все ближайшие объекты. Если расстояние введено, но единица измерения не задана или установлена на Unknown, используются единицы системы координат входных объектов. Если используется опция GEODESIC в параметре method, необходимо выбирать линейные единицы измерения, например, километры или мили. | Linear Unit |
location (Дополнительный) | Определяет, будут ли записаны в поля FROM_X, FROM_Y, NEAR_X и NEAR_Y координаты x и y точки входного объекта и ближайшей точки ближайшего объекта.
| Boolean |
angle (Дополнительный) | Определяет, будут ли вычислены и записаны в поле NEAR_ANGLE выходной таблицы угловые направления к ближайшим объектам. Угол до ближайшего объекта измеряет направление линии, соединяющей входной объект и ближайший объект по кратчайшему расстоянию. Если метод PLANAR используется в параметре method, угол может принимать значения в диапазоне от -180° до 180°, где 0° – восток, 90° – север, 180° (или -180°) – запад и -90° – юг. Если используется метод GEODESIC, угол может принимать значения в диапазоне от -180° до 180°, где 0° – север, 90° – восток, 180° (или -180°) – юг и -90° – запад.
| Boolean |
closest (Дополнительный) | Определяет, будет ли инструмент возвращать только самые близкие объекты или несколько объектов.
| Boolean |
closest_count (Дополнительный) | Ограничивает число ближайших объектов, указываемых для каждого входного объекта. Этот параметр игнорируется, если значением параметра closest является CLOSEST. | Long |
method (Дополнительный) | Определяет, будет ли инструмент использовать кратчайший путь на сфероиде (геодезический) или на плоской земной поверхности (плоскостной). Настоятельно рекомендуется использовать метод GEODESIC, если данные хранятся в координатной системе, не подходящей для измерения расстояний (такой как Web Mercator и все географические системы координат), или если набор данных охватывает большую географическую область.
| String |
Пример кода
Использование функции GenerateNearTable в окне Python.
import arcpy
arcpy.env.workspace = "C:/data/input/gnt.gdb"
arcpy.analysis.GenerateNearTable("campsites", ["parks", "trails"], "better_sites")Следующий скрипт Python демонстрирует использование функции GenerateNearTable в качестве автономного скрипта.
# Name: GenerateNearTable.py
# Description: Finds 3 nearest in the near feature class from the input feature class.
# import system modules
import arcpy
# set workspace environment
arcpy.env.workspace = "C:/data/input/gnt.gdb"
# set required parameters
in_features = "campsites"
near_features = ["parks", "trails"]
out_table = "near_parks_trails"
# optional parameters
search_radius = '1500 Meters'
location = 'NO_LOCATION'
angle = 'NO_ANGLE'
closest = 'ALL'
closest_count = 3
# find crime locations within the search radius
arcpy.analysis.GenerateNearTable(in_features, near_features, out_table, search_radius,
location, angle, closest, closest_count)Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да