Сводка
Находит объекты, расположенные в пределах заданного расстояния от объектов входного слоя, и вычисляет статистику для этих ближайших объектов. Расстояние может быть измерено по прямой, по времени в пути (например, в пределах 10 минут) или по расстоянию пути (в пределах 5 км). Для измерения расстояния и времени в пути необходимо войти с использованием учетной записи организации ArcGIS Online с правами на выполнение Сетевого анализа; эти операции платные.
Примеры использования инструмента Суммировать близлежащие:
- Расчет общей численности населения в пределах пяти минут езды от предложенного местоположения нового магазина.
- Расчёт числа съездов с автотрассы в пределах одной мили от предлагаемого местоположения нового магазина, которые будут использоваться в качестве измерения степени доступности магазина.
Иллюстрация
Использование
Можно указать несколько расстояний, и для всех значений расстояния будут построены соответствующие зоны вокруг каждого входного объекта. Например, если вы указали два расстояния, вокруг каждого входного объекта будут построены две буферные зоны, и выходные данные будут содержать две области – для двух соответствующих значений расстояния – для каждого объекта.
Инструменты Суммировать в пределах и Суммировать близлежащие очень похожи. С помощью инструмента Суммировать в пределах вы суммируете объекты в пределах существующих полигонов, а при работе с инструментом Суммировать близлежащие – создаете области вокруг точек, линий и полигонов, а затем суммируете объекты в пределах этих вычисленных областей.
Вы можете создавать группы, задав для входных точек поле группы. К примеру, при суммировании преступлений, совершенных на определенном расстоянии от соседних границ, можно выбрать атрибут Crime_type, который может содержать пять разных видов преступлений. Каждая группа представляет уникальный тип преступления, и выбранный вами тип статистики может быть вычислен для каждого уникального значения в поле Crime_type.
Лицензия:
Для использования опций измерения расстояния и времени в пути необходимо выполнить вход под учетной записью организации ArcGIS Online с правами на выполнение сетевого анализа. При каждом успешном запуске инструмента с вашей подписки считываются сервисные кредиты, их количество зависит от используемого сервиса и полученных результатов. Подробная информация о сервисных кредитах изложена на странице Сервисные кредитыArcGIS Online.
Синтаксис
arcpy.analysis.SummarizeNearby(in_features, in_sum_features, out_feature_class, distance_type, distances, {distance_units}, {time_of_day}, {time_zone}, {keep_all_polygons}, {sum_fields}, {sum_shape}, {shape_unit}, {group_field}, {add_min_maj}, {add_group_percent}, {Output_Grouped_Table})| Parameter | Объяснение | Тип данных |
in_features | Точечные, линейные или полигональные объекты, для которых будут строиться буферные зоны, использующиеся для суммирования входных объектов. | Feature Layer |
in_sum_features | Суммируемые точечные, линейные или полигональные объекты. | Feature Layer |
out_feature_class | Выходной класс полигональных объектов с буферными зонами вокруг входных объектов, их входными, а также новыми атрибутами, содержащими информацию о числе точек, длине линий, площади полигонов внутри каждой зоны и статистическими данными этих объектов. | Feature Class |
distance_type | Определяет, какое измерение расстояния используется для создания буферных зон вокруг входных объектов. Расстояние пути и время пути используют дорожную сеть и учитывают различные ограничения, такие как улицы с односторонним движением. Время пути также учитывает известные ограничения скорости. Для использования опций измерения расстояния и времени в пути необходимо выполнить вход под учетной записью организации ArcGIS Online с правами на выполнение сетевого анализа. При каждом успешном запуске инструмента с вашей подписки считываются сервисные кредиты, их количество зависит от используемого сервиса и полученных результатов. Подробная информация о сервисных кредитах изложена на странице Сервисные кредитыArcGIS Online. Все типы расстояния, кроме прямолинейного, используют маршрутизацию ArcGIS Online и сетевые сервисы.
| String |
distances [distance,...] | Значения расстояния определяют зону поиска (для расстояния по прямой, длины пути на легковом и грузовом автомобиле и длины пути пешехода). Объекты, находящиеся в пределах указанных расстояний, будут суммироваться. Можно задать несколько значений. Для каждого значения расстояния будет создана одна зона вокруг каждого входного объекта. | Double |
distance_units (Дополнительный) | Единицы измерения расстояния.
| String |
time_of_day (Дополнительный) | Задайте, будут ли при вычисления времени в пути учитываться данные о загруженности дорог. Загруженность дорог, особенно для городских территорий, может значительно изменить конфигурацию области, соответствующей указанному времени в пути. Если не введены дата и время, при расчете расстояния, покрываемого за указанное время, не будет учитываться загруженность дорог. Используемые условия дорожного движения могут быть как реальными (в реальном масштабе времени), так и расчетными для заданного времени и заданной даты на основании исторических данных. Реальные данные трафика хранятся в Esri в течение 12 часов, а прогнозные значения трафика рассчитываются на период до 12 часов в будущем. Если указанные вами дата и время находятся в пределах этого 24 часового окна, будут использоваться данные о загруженности дорог в реальном времени. Если они находятся вне окна, будут использоваться исторические данные. | Date |
time_zone (Дополнительный) | Часовой пояс для указанного времени суток. Часовые пояса можно задавать в локальном времени либо времени UTC.
| String |
keep_all_polygons (Дополнительный) | Определяет, будут ли скопированы в выходной класс объектов буферы всех входных объектов либо пересекающих или содержащих как минимум один из входных суммированных объектов.
| Boolean |
sum_fields [[summary_field, statistic_type],...] (Дополнительный) | Список имен атрибутивных полей входных суммируемых объектов и типы статистического суммирования, которые вы хотите выполнить для этих полей – для всех точек в пределах каждого входного буфера. Поля суммирования должны быть числовыми. Текстовые поля и поля других типов не поддерживаются. Типы статистических данных следующие:
| Value Table |
sum_shape (Дополнительный) | Определяет, будет ли содержать выходной класс объектов такие атрибуты, как число точек, длина линий и площадь полигонов – суммированные для каждого входного буфера.
| Boolean |
shape_unit (Дополнительный) | Единицы, в которых будут вычисляться суммированные атрибуты объекта. Если входными данными являются точки, единицы измерения не используются, а в этом случае добавляется только число точек в пределах буфера каждого входного объекта. Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.
| String |
group_field (Дополнительный) | Атрибутивное поле входных суммируемых объектов, используемое для группирования. Объекты, имеющие одинаковые значения поля группы, комбинируются и суммируются с другими объектами с теми же значениями поля группы. При выборе поля группы создается дополнительная выходная таблица, местоположение которой нужно указать в параметре out_grouped_table. | Field |
add_min_maj (Дополнительный) | Эта опция активна в случае, если вы выбрали поле группы. Это позволит вам определить, какое значение поля группы относится к меньшинству (редко встречается), а какое – к большинству (часто встречается) для буфера каждого входного объекта.
| Boolean |
add_group_percent (Дополнительный) | Эта опция активна в случае, если вы выбрали поле группы. Это позволит вам вычислить процент для каждого значения атрибута каждой группы.
| Boolean |
Output_Grouped_Table (Дополнительный) | Если указано поле группы, требуется выходная таблица группировки. Выходная таблица, содержащая поля суммирования для каждой группы суммированных объектов для буфера каждого входного объекта. Таблица будет содержать следующие поля атрибутов:
| Table |
Пример кода
Скрипт окна Python, демонстрирующий использование инструмента SummarizeNearby.
import arcpy
arcpy.env.workspace = "C:/data/city.gdb"
arcpy.SummarizeNearby_analysis("new_store_location", "census_blocks",
"new_store_population", "STRAIGHT_LINE", "1;2",
"Miles", "", "", "KEEP_ALL", "Pop2014 SUM")Автономный скрипт – пример использования функции SummarizeNearby .
# Description: Use SummarizeNearby to summarize population
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/city.gdb"
# Set local variables
newStore = "new_store_location"
censusInfo = "census_blocks"
outFeatureClass = "crimes_aggregated"
distanceType = "TRAVEL_TIME"
distance = "10;20"
distanceUnit = "Minutes"
time = "10/15/2014 2:14:19 PM"
timeZone = "GEOLOCAL"
keepPolys = True
sumFields = [["Pop2010", "Sum"],["OWNERS", "Sum"]]
addShapeSum = True
arcpy.SummarizeNearby_analysis(newStore, censusInfo, outFeatureClass,
distanceType, distance, distanceUnit,
time, timeZone, keepPolys, sumFields,
addShapeSum)Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да