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

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

Резюме

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

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

Рисунок

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

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

Синтаксис

GenerateNearTable_analysis (in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count})
ПараметрОбъяснениеТип данных
in_features

Входные объекты, которые могут быть точечного, полилинейного, полигонального или мультиточечного типа.

Feature Layer
near_features
[near_features,...]

Значение, используемое для поиска ближайших объектов для входных объектов. Может быть один или несколько классов ближайших объектов; каждый объект может быть точечного, полилинейного, полигонального или мультиточечного типа. Если задано несколько классов ближайших объектов, во входную таблицу добавляется новое поле NEAR_FC, в котором для каждого ближайшего объекта будет указан путь к соответствующему классу ближайших объектов.

Feature Layer
out_table

Выходная таблица, в которой будет содержаться информация близости (например, IN_FID, NEAR_FID и NEAR_DIST) и другие атрибуты (например, местоположение (NEAR_X, NEAR_Y) и угол (NEAR_ANGLE)) ближайшего объекта и NEAR_FC, если необходимо.

Table
search_radius
(дополнительно)

Расстояние, в пределах которого проводится поиск потенциальных ближайших объектов. В выходной класс записываются только те ближайшие объекты, которые расположены в окружности, определяемой заданным радиусом. Если значение не задано, т.е. параметр Радиус поиска (Search radius) оставлен пустым (по умолчанию), в вычислениях участвуют все ближайшие пространственные объекты. По умолчанию для радиуса поиска используются единицы измерения, определенные в системе координат входных объектов. Эти единицы можно изменить на любые другие. Однако это не скажется на единицах измерения NEAR_DIST, которые основываются на единицах измерения системы координат входных объектов.

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

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

  • NO_LOCATION —Координаты x и y ближайшего местоположения не будут записаны. Это значение используется по умолчанию.
  • LOCATION —Координаты x и y ближайшего местоположения будут записаны в поля NEAR_X and NEAR_Y.
Boolean
angle
(дополнительно)

Задает, будут ли вычислены значения углов до ближайших объектов в десятичных градусах и записаны в новое поле, NEAR_ANGLE. Угловое значение измеряется от оси x (горизонтальная ось) по направлению линии, соединяющей входной объект с ближайшим объектом в ближайшем местоположении; этот угол находится в пределах диапазона от 0 до 180 или от 0 до -180 десятичных градусов — 0 для востока, 90 для севера, 180 (-180°) для запада и -90 для юга.

  • NO_ANGLE —Значения углов не будут записаны. Это значение используется по умолчанию.
  • ANGLE —Угловые значения ближайшего объекта будут записаны в поле NEAR_ANGLE.
Boolean
closest
(дополнительно)

Указывает, что будут находиться и возвращаться лишь ближайшие пространственные объекты, либо все пространственные объекты, попавшие в радиус поиска.

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

Находит только заданное количество ближайших объектов. Этот параметр не будет использоваться, если отмечена опция Найти только ближайшие объекты (Find only closest feature).

Long

Пример кода

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

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

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

try:
    # find crime locations within the search radius
    arcpy.GenerateNearTable_analysis(in_features, near_features, out_table, search_radius, 
                                     location, angle, closest, closest_count)
except:
    print arcpy.GetMessages()

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

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

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

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

ArcGIS for Desktop Basic: Требует Нет
ArcGIS for Desktop Standard: Требует Нет
ArcGIS for Desktop Advanced: Требует Да
Информация об авторском праве © Esri, 1995-2013. Все права защищены.
9/10/2013