Построить таблицу соседних объектов (Инструменты Анализа)

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

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

Узнайте больше о том, как рассчитывается близость с помощью инструментов геообработки

Иллюстрация

! Иллюстрация инструмента Построить таблицу соседних объектов

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

Выходная таблица будет содержать следующие поля:
- IN_FID—Object ID входного объекта.
- NEAR_FID—Object ID ближайшего объекта.
- NEAR_DIST—Расстояние между входным и ближайшим объектом. Если значением параметра Метод является Геодезический, и входные объекты заданы в географической системе координат, значения в этом поле указываются в линейных единицах измерения системы координат входных объектов или метрах.
- NEAR_FC—Путь к классу объектов, содержащему ближайший объект. Это поле добавляется в выходную таблицу только в том случае, если указано несколько значений параметра Ближайшие объекты.
- NEAR_RANK—Целочисленное значение, ранжирующее все ближайшие объекты по их близости к данному входному объекту. Ближайший объект получит значение 1, следующий по близости – 2 и т.д.
Если отмечен параметр Местоположение, в выходную таблицу будут добавлены следующие поля. Единицы измерения значений в поле зависят от значения параметра Метод. Если для параметра Метод задано Плоскостной, значение дается в линейных единицах измерения системы координат входных объектов. Если выбран Геодезический метод, значение будет в географической системе координат, связанной с системой координат входных объектов.
- FROM_X—Х-координата местоположения входного объекта, который находится ближе всего к ближайшему объекту
- FROM_Y—Y-координата местоположения входного объекта, который находится ближе всего к ближайшему объекту
- NEAR_X—Х-координата местоположения ближайшего объекта, наиболее близкого ко входному объекту.
- NEAR_Y—Y-координата местоположения ближайшего объекта, наиболее близкого ко входному объекту.
Если отмечен параметр Угол, в выходную таблицу будут добавлены следующие поля:
- NEAR_ANGLE—Угол, под которым направлена в местоположении FROM_X и FROM_Y линия, соединяющая входные объекты с ближайшим объектом.
Если входной и ближайший объекты пересекаются, в выходную таблицу будут записаны следующие значения:
- NEAR_ANGLE и NEAR_DIST будет задан как 0.0.
- FROM_X и FROM_Y будет совпадать с NEAR_X и NEAR_Y, и будет представлять точку в области пересечения двух объектов.
Значения в поле NEAR_DIST будут храниться в единицах измерения системы координат входных объектов. Если входные объекты заданы в географической системе координат, и значением параметра Метод является Геодезический, единицами в поле NEAR_DIST будут метры.
Выходную таблицу можно присоединить обратно к входным объектам с помощью поля IN_FID или к ближайшим объектам с помощью поля NEAR_FID.
Если задано значение параметра Радиус поиска, но ближайшие объекты не найдены, в выходной таблице не будет записей.
Если значение параметра Радиус поиска не указан, все ближайшие объекты будут рассматриваться как кандидаты.
Если параметр Радиус поиска не указан, параметр Найти только ближайшие объекты не включен, а параметр Максимальное число ближайших совпадений задан по умолчанию (0 или пустой), выходная таблица будет содержать вычисления расстояний между всеми входными объектами и всеми ближайшими объектами. Этот процесс может занять довольно много времени, и может быть создана большая выходная таблица. Например, если в классах входных и ближайших объектов хранится по 1000 точек, выходная таблица может содержать один миллион записей.
Для вычисления расстояния и дополнительной информации о близости внутри одного класса объектов или слоя можно использовать тот же класс объектов или слой. В этом случае каждый входной объект будет исключаться из кандидатов ближайших к нему объектов, поскольку в противном случае все объекты оказались бы ближайшими к самим себе.
Когда значением параметра Метод является Плоскостной, используйте проекцию для входных объектов, которая позволяет корректно измерять расстояния, например, равнопромежуточную проекцию.

Более подробно о проекциях и системах координат
Для визуализации значений полей FROM_X, FROM_Y, NEAR_X и NEAR_Y выходную таблицу можно использовать в качестве входной для инструментов Создать слой событий XY или XY в линию.
You can set a unit of measurement for the NEAR_DIST поле—например, метры, километры или мили — с использованием параметра Единицы расстояния.

Подпись	Объяснение	Тип данных
Входные объекты	Входные объекты могут быть точками, полилиниями, полигонами или мультиточками.	Feature Layer
Ближайшие объекты	Один или несколько слоев или классов пространственных объектов, содержащих потенциальные ближайшие объекты. Ближайшие объекты могут быть точками, полилиниями, полигонами или мультиточками. Если задано несколько слоев или классов объектов, во входную таблицу будет добавлено поле `NEAR_FC`, в котором для каждого ближайшего объекта будет указан путь к его исходному классу объектов. Один и тот же класс объектов или слой можно использовать как в качестве входных объектов, так и в качестве ближайших объектов.	Feature Layer
Выходная таблица	Выходная таблица, содержащая результаты анализа.	Table
Радиус поиска (Дополнительный)	Радиус, который будет использоваться для поиска ближайших объектов. Если значение не указано, в вычисления будут включены все ближайшие объекты. Если расстояние введено, но единица измерения не задана или неизвестна, будут использоваться единицы системы координат входных объектов. Если используется опция Геодезический для параметра Метод, используйте линейные единицы измерения, такие как километры или мили.	Linear Unit
Местоположение (Дополнительный)	Определяет, будут ли координаты x и y местоположения входного объекта и ближайшего местоположения ближайшего объекта записаны в поля `FROM_X`, `FROM_Y`, `NEAR_X` и `NEAR_Y`. Отмечено–Выходная таблица будет содержать информацию о местоположениях. Не отмечено–Выходная таблица не будет содержать информацию о местоположениях. Используется по умолчанию.	Boolean
Угол (Дополнительный)	Определяет, будут ли вычислены и записаны в поле `NEAR_ANGLE` выходной таблицы угловые направления к ближайшим объектам. Угол до ближайшего объекта измеряет направление линии, соединяющей входной объект и ближайший объект по кратчайшему расстоянию. Если для параметра `method` выбран метод `PLANAR`, угловое направление будет принимать значения в диапазоне от -180° до 180°, где 0° – восток, 90° – север, 180° (или -180°) – запад и -90° – юг. Если для параметра `method` используется метод `GEODESIC`, угол будет находиться в диапазоне от -180° до 180°, где 0° – север, 90° – восток, 180° (или -180°) – юг и -90° – запад. Отмечено–Угол до ближайшего объекта будет вычислен и в выходную таблицу будет добавлено поле `NEAR_ANGLE`. Не отмечено–Угол до ближайшего объекта вычисляться не будет, а поле `NEAR_ANGLE` не будет добавлено в выходную таблицу. Используется по умолчанию.	Boolean
Найти только ближайшие объекты (Дополнительный)	Указывает, будет ли в выходную таблицу записываться только ближайший объект. Отмечено–В выходную таблицу будет записан только самый близкий объект. Используется по умолчанию. Не отмечено–В выходную таблицу будут записаны несколько ближайших объектов (предельное число можно задать параметром `closest_count`).	Boolean
Максимальное число ближайших совпадений (Дополнительный)	Ограничивает число ближайших объектов, указываемых для каждого входного объекта. Этот параметр неактивен, если включен параметр Найти только ближайший объект.	Long
Метод (Дополнительный)	Определяет, будет ли инструмент использовать кратчайший путь на сфероиде (геодезический) или на плоской земной поверхности (плоскостной). Рекомендуется использовать метод Геодезический, если данные хранятся в координатной системе, не подходящей для измерения расстояний (такой как Web Mercator и все географические системы координат), или если набор данных охватывает большую географическую область. Плоскостной–Между объектами будут вычисляться расстояния на плоскости. Используется по умолчанию. Геодезический–Между объектами будут вычисляться геодезические расстояния. Этот метод учитывает кривизну сфероида и корректно обрабатывает данные вблизи полюсов и международной линии перемены дат.	String
Единицы измерения расстояния (Дополнительный)	Задает единицы измерения значений для поля `NEAR_DIST`. Если единицы измерения не заданы, значения в поле `NEAR_DIST` будут храниться в единицах измерения системы координат входных объектов. Если входные данные хранятся в географической системе координат и используется геодезический метод, единицами в поле `NEAR_DIST` будут метры. Километры–Единицами измерения будут километры. Метры–Единицами измерения будут метры. Международные морские мили–Единицами измерения будут международные морские мили. Сухопутные мили–Единицами измерения будут сухопутные мили. Международные ярды–Единицами измерения будут международные ярды. Международные футы–Единицами измерения будут международные футы. Геодезические морские мили США–Единицами измерения будут морские мили США. Геодезические мили США–Единицами измерения будут мили США. Геодезические ярды США–Единицами измерения будут ярды США. Геодезические футы США–Единицами измерения будут геодезические футы США.	String
Сопоставление полей (Дополнительный)	Пары полей из входных и ближайших объектов, которые будут использоваться для сопоставления атрибутов. При расчете близких объектов будут использоваться только те близкие объекты, значения сопоставляемых полей которых совпадают со значениями входных объектов. Столбцы таблицы значений: Input Fields–Fields from the input features that will be used for attribute matching. Near Fields–Fields from the near features that will be used for attribute matching.	Value Table

arcpy.analysis.GenerateNearTable(in_features, near_features, out_table, {search_radius}, {location}, {angle}, {closest}, {closest_count}, {method}, {distance_unit}, {match_fields})

Имя	Объяснение	Тип данных
in_features	Входные объекты могут быть точками, полилиниями, полигонами или мультиточками.	Feature Layer
near_features [near_features,...]	Один или несколько слоев или классов пространственных объектов, содержащих потенциальные ближайшие объекты. Ближайшие объекты могут быть точками, полилиниями, полигонами или мультиточками. Если задано несколько слоев или классов объектов, во входную таблицу будет добавлено поле `NEAR_FC`, в котором для каждого ближайшего объекта будет указан путь к его исходному классу объектов. Один и тот же класс объектов или слой можно использовать как в качестве входных объектов, так и в качестве ближайших объектов.	Feature Layer
out_table	Выходная таблица, содержащая результаты анализа.	Table
search_radius (Дополнительный)	Радиус, который будет использоваться для поиска ближайших объектов. Если значение не указано, в вычисления будут включены все ближайшие объекты. Если расстояние введено, но единица измерения не задана или неизвестна, будут использоваться единицы системы координат входных объектов. Если используется опция `GEODESIC` для параметра `method`, используйте линейные единицы измерения, такие как километры или мили.	Linear Unit
location (Дополнительный)	Определяет, будут ли координаты x и y местоположения входного объекта и ближайшего местоположения ближайшего объекта записаны в поля `FROM_X`, `FROM_Y`, `NEAR_X` и `NEAR_Y`. `LOCATION`–Выходная таблица будет содержать информацию о местоположениях. `NO_LOCATION`–Выходная таблица не будет содержать информацию о местоположениях. Используется по умолчанию.	Boolean
angle (Дополнительный)	Определяет, будут ли вычислены и записаны в поле `NEAR_ANGLE` выходной таблицы угловые направления к ближайшим объектам. Угол до ближайшего объекта измеряет направление линии, соединяющей входной объект и ближайший объект по кратчайшему расстоянию. Если для параметра `method` выбран метод `PLANAR`, угловое направление будет принимать значения в диапазоне от -180° до 180°, где 0° – восток, 90° – север, 180° (или -180°) – запад и -90° – юг. Если для параметра `method` используется метод `GEODESIC`, угол будет находиться в диапазоне от -180° до 180°, где 0° – север, 90° – восток, 180° (или -180°) – юг и -90° – запад. `ANGLE`–Угол до ближайшего объекта будет вычислен и в выходную таблицу будет добавлено поле `NEAR_ANGLE`. `NO_ANGLE`–Угол до ближайшего объекта вычисляться не будет, а поле `NEAR_ANGLE` не будет добавлено в выходную таблицу. Используется по умолчанию.	Boolean
closest (Дополнительный)	Указывает, будет ли в выходную таблицу записываться только ближайший объект. `CLOSEST`–В выходную таблицу будет записан только самый близкий объект. Используется по умолчанию. `ALL`–В выходную таблицу будут записаны несколько ближайших объектов (предельное число можно задать параметром `closest_count`).	Boolean
closest_count (Дополнительный)	Ограничивает число ближайших объектов, указываемых для каждого входного объекта. Этот параметр игнорируется, если параметр `closest` задан как `CLOSEST`.	Long
method (Дополнительный)	Определяет, будет ли инструмент использовать кратчайший путь на сфероиде (геодезический) или на плоской земной поверхности (плоскостной). Рекомендуется использовать метод `GEODESIC`, если данные хранятся в координатной системе, не подходящей для измерения расстояний (такой как Web Mercator и все географические системы координат), или если набор данных охватывает большую географическую область. `PLANAR`–Между объектами будут вычисляться расстояния на плоскости. Используется по умолчанию. `GEODESIC`–Между объектами будут вычисляться геодезические расстояния. Этот метод учитывает кривизну сфероида и корректно обрабатывает данные вблизи полюсов и международной линии перемены дат.	String
distance_unit (Дополнительный)	Задает единицы измерения значений для поля `NEAR_DIST`. Если единицы измерения не заданы, значения в поле `NEAR_DIST` будут храниться в единицах измерения системы координат входных объектов. Если входные данные хранятся в географической системе координат и используется геодезический метод, единицами в поле `NEAR_DIST` будут метры. `Kilometers`–Единицами измерения будут километры. `Meters`–Единицами измерения будут метры. `NauticalMilesInt`–Единицами измерения будут международные морские мили. `MilesInt`–Единицами измерения будут сухопутные мили. `YardsInt`–Единицами измерения будут международные ярды. `FeetInt`–Единицами измерения будут международные футы. `NauticalMiles`–Единицами измерения будут морские мили США. `Miles`–Единицами измерения будут мили США. `Yards`–Единицами измерения будут ярды США. `Feet`–Единицами измерения будут геодезические футы США.	String
match_fields [[input_field, near_field],...] (Дополнительный)	Пары полей из входных и ближайших объектов, которые будут использоваться для сопоставления атрибутов. При расчете близких объектов будут использоваться только те близкие объекты, значения сопоставляемых полей которых совпадают со значениями входных объектов. Столбцы таблицы значений: `Input Fields`–Fields from the input features that will be used for attribute matching. `Near Fields`–Fields from the near features that will be used for attribute matching.	Value Table

Пример кода

Пример 1 GenerateNearTable (окно Python)

Ниже приведен пример использования функции GenerateNearTable в окне Python.

import arcpy

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

arcpy.analysis.GenerateNearTable("campsites", ["parks", "trails"], "better_sites")

Пример 2 GenerateNearTable (автономный скрипт)

В следующем скрипте 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: Да