Подпись | Описание | Тип данных |
Входные объекты | Точечные, линейные или полигональные объекты, для которых будут строиться буферные полигоны. Эти буферные полигоны будут использованы для суммирования входных объектов. | Feature Layer |
Входные суммируемые объекты | Суммируемые точечные, линейные или полигональные объекты. | Feature Layer |
Выходной класс объектов | Выходной класс полигональных объектов с буферными полигонами вокруг входных объектов, их входными, а также новыми атрибутами, содержащими информацию о числе точек, длине линий, площади полигонов внутри каждой зоны и статистическими данными этих объектов. | Feature Class |
Вычисление расстояния | Указывает тип изменения расстояния, который будет использован для создания буферных областей. Расстояние пути и время пути используют дорожную сеть и учитывают различные ограничения, такие как улицы с односторонним движением. Время пути также учитывает известные ограничения скорости. Для использования опций измерения расстояния и времени в пути необходимо войти с использованием учетной записи организации ArcGIS Online с правами на выполнение Сетевого анализа. При каждом успешном запуске инструмента с вашей подписки списываются кредиты, их количество зависит от используемого сервиса и полученных результатов. Подробная информация о кредитах изложена на странице Кредиты. Все типы расстояния, кроме прямолинейного, используют маршрутизацию ArcGIS Online и сетевые сервисы.
| String |
Расстояние | Значения расстояния определяют зону поиска (для расстояния по прямой, длины пути на легковом и грузовом автомобиле и длины пути пешехода). Объекты, находящиеся в пределах указанных расстояний, будут суммироваться. Можно задать несколько значений. Для каждого значения расстояния будет создана одна зона вокруг каждого входного объекта. | Double |
Единицы расстояния (Дополнительный) | Указывает единицы измерения, которые будут использованы для значений расстояния.
| String |
Время суток (Дополнительный) | Дата или время, когда время движения рассчитывается с учетом условий трафика. Загруженность дорог, особенно для городских территорий, может значительно изменить конфигурацию области, соответствующей указанному времени в пути. Если не введены дата и время, при расчете расстояния, покрываемого за указанное время, не будет учитываться загруженность дорог. Данные о загруженности дорог могут быть в реальном времени или историческими, которые отражают типичную загруженность для соответствующей даты и времени. Esri сохраняет данные о загруженности дорог в реальном времени за последние 12 часов и вычисляет прогноз загруженности дорог на следующие 12 часов. Если указанные вами дата и время находятся в пределах этого 24 часового окна, будут использоваться данные о загруженности дорог в реальном времени. Если они находятся вне окна, будут использоваться исторические данные. | Date |
Часовой пояс (Дополнительный) | Указывает часовой пояс, который используется для определения времени суток. Часовые пояса можно задавать в локальном времени либо использовать всемирное координированное время (UTC).
| String |
Сохранять полигоны без точек (Дополнительный) | Определяет, будут ли скопированы в выходной класс объектов буферы всех входных объектов либо только пересекающих или содержащих как минимум один из входных суммированных объектов.
| Boolean |
Поля суммирования (Дополнительный) | Список имен атрибутивных полей входных суммируемых объектов и типы статистического суммирования, которые будут выполнены для этих полей – для всех точек в пределах каждого входного буфера. Поля суммирования должны быть числовыми. Текстовые поля и поля других типов не поддерживаются. Поддерживаются следующие типы статистики:
| Value Table |
Добавить суммированные атрибуты объекта (Дополнительный) | Определяет, будут ли атрибуты, такие как число точек, длина линий и площадь полигонов – суммированные для каждого входного буфера (форма суммирования атрибутов) присоединены к выходному классу объектов.
| Boolean |
Единицы измерения объекта (Дополнительный) | Указывает единицы, в которых будут вычисляться суммированные атрибуты объекта. Если входными данными являются точки, единицы измерения геометрии не нужны, так как в этом случае добавляется только число точек в пределах буфера каждого входного объекта. Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.
| String |
Поле группировки (Дополнительный) | Атрибутивное поле входных суммируемых объектов, используемое для группирования. Объекты, имеющие одинаковые значения поля группы, комбинируются и суммируются с другими объектами с теми же значениями поля группы. Если указано поле группы, создается дополнительная выходная таблица группировки, местоположение которой нужно указать. Выходная таблица группировки необходима при использовании поля группы. | Field |
Добавить атрибуты меньшинства и большинства (Дополнительный) | Показывает, какое из значений будет поля группы – меньшинство (менее доминирующие) или большинство (более доминирующие) в пределах каждого объекта входного буфера будет добавлено к выходному классу объектов. Этот параметр активен, если вы задаете значение параметра Поле группировки.
| Boolean |
Добавить проценты в группе (Дополнительный) | Определяет, будет ли атрибутивное поле процентов добавляться к выходным данным. Этот параметр позволит вам вычислить процент для каждого значения атрибута в каждой группе. Этот параметр активен, если вы задаете значение параметра Поле группировки.
| Boolean |
Выходная таблица группировки (Дополнительный) | Выходная таблица, содержащая поля суммирования для каждой группы суммированных объектов для буфера каждого входного объекта. Если указано поле группы, требуется выходная таблица группировки. Таблица будет содержать следующие поля атрибутов:
| Table |
Краткая информация
Находит объекты, расположенные в пределах заданного расстояния от объектов входного слоя, и вычисляет статистику для этих ближайших объектов. Расстояние может быть измерено по прямой, по времени в пути (например, в пределах 10 минут) или по расстоянию пути (например, в пределах 5 км). Для измерения расстояния и времени в пути необходимо войти с использованием учетной записи организации ArcGIS Online с правами на выполнение Сетевого анализа. Обе опции измерения используют кредиты.
Ниже примеры использования инструмента Суммировать близлежащие:
- Расчет общей численности населения в пределах пяти минут езды от предложенного местоположения нового магазина.
- Расчёт числа съездов с автотрассы в пределах одной мили от предлагаемого местоположения нового магазина, которые будут использоваться в качестве измерения степени доступности магазина.
Иллюстрация
Использование
Можно указать несколько расстояний, и для всех значений расстояния будут построены соответствующие зоны вокруг каждого входного объекта. Например, если вы указали два расстояния, вокруг каждого входного объекта будут построены две буферные зоны, и выходные данные будут содержать две области – для двух соответствующих значений расстояния – для каждого объекта.
Инструменты Суммировать в пределах и Суммировать близлежащие очень похожи. С помощью инструмента Суммировать близлежащие вы создаете области вокруг точек, линий и полигонов, а затем суммируете объекты в пределах этих вычисленных областей. С помощью инструмента Суммировать в пределах вы суммируете объекты в пределах существующих полигонов.
Вы можете создавать группы, задав для входных точек поле группы. Например, при суммировании преступлений, совершенных в пределах определенного расстояния от границ района, можно выбрать атрибут Crime_type, который включает пять видов преступлений. Каждый уникальный тип преступления формирует группу, и выбранный вами тип статистики может быть вычислен для каждого уникального значения в поле Crime_type.
Пустые значения не включаются в расчет статистики. Например, среднее 6, 4, и пустого значения равно 5 ((6+4)/2).
Лицензия:
Для использования опций измерения расстояния и времени в пути необходимо выполнить вход под учетной записью организации 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})
Имя | Описание | Тип данных |
in_features | Точечные, линейные или полигональные объекты, для которых будут строиться буферные полигоны. Эти буферные полигоны будут использованы для суммирования входных объектов. | Feature Layer |
in_sum_features | Суммируемые точечные, линейные или полигональные объекты. | Feature Layer |
out_feature_class | Выходной класс полигональных объектов с буферными полигонами вокруг входных объектов, их входными, а также новыми атрибутами, содержащими информацию о числе точек, длине линий, площади полигонов внутри каждой зоны и статистическими данными этих объектов. | Feature Class |
distance_type | Указывает тип изменения расстояния, который будет использован для создания буферных областей. Расстояние пути и время пути используют дорожную сеть и учитывают различные ограничения, такие как улицы с односторонним движением. Время пути также учитывает известные ограничения скорости. Для использования опций измерения расстояния и времени в пути необходимо войти с использованием учетной записи организации 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 (Дополнительный) | Показывает, какое из значений будет поля группы – меньшинство (менее доминирующие) или большинство (более доминирующие) в пределах каждого объекта входного буфера будет добавлено к выходному классу объектов. Этот параметр включен, если вы задаете значение параметра group_field.
| Boolean |
add_group_percent (Дополнительный) | Определяет, будет ли значение процента каждого атрибутивного поля в каждой группе добавляться к выходным данным. Этот параметр позволит вам вычислить процент для каждого значения атрибута в каждой группе. Этот параметр включен, если вы задаете значение параметра group_field.
| Boolean |
Output_Grouped_Table (Дополнительный) | Выходная таблица, содержащая поля суммирования для каждой группы суммированных объектов для буфера каждого входного объекта. Если указано поле группы, требуется выходная таблица группировки. Таблица будет содержать следующие поля атрибутов:
| Table |
Пример кода
Пример скрипта в окне Python для использования функции SummarizeNearby.
import arcpy
arcpy.env.workspace = "C:/data/city.gdb"
arcpy.analysis.SummarizeNearby("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.analysis.SummarizeNearby(newStore, censusInfo, outFeatureClass,
distanceType, distance, distanceUnit,
time, timeZone, keepPolys, sumFields,
addShapeSum)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да