Построить таблицу соседних объектов (Generate Near Table) (Анализ)

Уровень лицензии:BasicStandardAdvanced

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

Вычисляет расстояние и другую информацию о близости объектов в одном или нескольких классах пространственных объектов или слоях. В отличие от инструмента Ближайший объект (Near), обновляющего входные данные, инструмент Построить таблицу соседних объектов (Generate Near Table) записывает результаты в новую автономную таблицу и позволяет находить несколько ближайших объектов.

Более подробно о вычислении близости с помощью инструментов геообработки

Рисунок

Построить таблицу соседних объектов (Generate Near Table)

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

Синтаксис

GenerateNearTable_analysis (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), используются единицы системы координат входных объектов. Если значением параметра Метод (Method) является GEODESIC, должна использоваться линейная единица измерения, такая как километры или мили.

Linear unit
location
(дополнительно)

Определяет, будут ли записаны в поля FROM_X, FROM_Y, NEAR_X и NEAR_Y координаты x и y точки входного объекта и ближайшей точки ближайшего объекта.

  • NO_LOCATION — Выходная таблица не будет содержать информацию о местоположениях. Это значение используется по умолчанию.
  • LOCATION — Выходная таблица будет содержать информацию о местоположениях.
Boolean
angle
(дополнительно)

Определяет, будут ли вычислены и записаны в поле NEAR_ANGLE выходной таблицы угловые направления к ближайшим объектам. Угловое направление к ближайшему объекту – это направление линии, соединяющей входной и ближайший объекты по кратчайшему расстоянию. Если значением параметра method является PLANAR, угловое направление может принимать значения в диапазоне от -180° до 180°, где 0° – восток, 90° – север, 180° (или -180°) – запад и -90° – юг. Если используется метод GEODESIC, угловое направление может принимать значения в диапазоне от -180° до 180°, где 0° – север, 90° – восток, 180° (или -180°) – юг и -90° – запад.

  • NO_ANGLE —Выходная таблица не будет содержать значений NEAR_ANGLE. Это значение используется по умолчанию.
  • ANGLE —Выходная таблица будет содержать значения NEAR_ANGLE.
Boolean
closest
(дополнительно)

Определяет, будет ли инструмент возвращать только самые близкие объекты или несколько объектов.

  • CLOSEST (ближайший) —В выходную таблицу будет записан только самый близкий объект. Это значение используется по умолчанию.
  • ALL —В выходную таблицу будут записаны несколько ближайших объектов (предельное число можно задать параметром closest_count).
Boolean
closest_count
(дополнительно)

Ограничивает число ближайших объектов, указываемых для каждого входного объекта. Этот параметр игнорируется, если значением параметра closest является CLOSEST.

Long
method
(дополнительно)

Определяет, будет ли инструмент использовать кратчайший путь на сфероиде (geodesic) или на плоской земной поверхности (planar). Настоятельно рекомендуется использовать метод GEODESIC, если данные хранятся в координатной системе, не подходящей для измерения расстояний (такой как Web Mercator и все географические системы координат), или если набор данных охватывает большую географическую область.

  • PLANAR —Использует планарные расстояния между объектами. Это значение используется по умолчанию.
  • GEODESIC —Использует геодезические расстояния между объектами. Этот метод учитывает кривизну сфероида и корректно обрабатывает данные вблизи демаркационной линии суточного времени и полюсов.
String

Пример кода

Построить таблицу соседних объектов. Пример 1 (окно Python)

Пример использования функции Построить таблицу соседних объектов (GenerateNearTable) в окне Python.

import arcpy

arcpy.env.workspace = "C:/data/input/gnt.gdb"

arcpy.GenerateNearTable_analysis("campsites", ["parks", "trails"], "better_sites")
Построить таблицу соседних объектов. Пример 2 (автономный скрипт Python)

Пример скрипта Python для использования функции Построить таблицу соседних объектов в автономном режиме.

# 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.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius, 
                                 location, angle, closest, closest_count)

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

Связанные темы

Обзор группы инструментов Близость (Proximity)

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

ArcGIS for Desktop Basic: Нет
ArcGIS for Desktop Standard: Нет
ArcGIS for Desktop Advanced: Да
Copyright © 1995-2014 Esri. All rights reserved.
5/10/2014