Суммировать близлежащие (Анализ)

Сводка

Находит объекты, расположенные в пределах заданного расстояния от объектов входного слоя, и вычисляет статистику для этих ближайших объектов. Расстояние может быть измерено по прямой, по времени в пути (например, в пределах 10 минут) или по расстоянию пути (в пределах 5 км). Для измерения расстояния и времени в пути необходимо войти с использованием учетной записи организации ArcGIS Online с правами на выполнение Сетевого анализа; эти операции платные.

Примеры использования инструмента Суммировать близлежащие:

  • Расчет общей численности населения в пределах пяти минут езды от предложенного местоположения нового магазина.
  • Расчёт числа съездов с автотрассы в пределах одной мили от предлагаемого местоположения нового магазина, которые будут использоваться в качестве измерения степени доступности магазина.

Иллюстрация

Суммировать близлежащие

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

    Лицензия:

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

  • Можно указать несколько расстояний, и для всех значений расстояния будут построены соответствующие зоны вокруг каждого входного объекта. Например, если вы указали два расстояния, вокруг каждого входного объекта будут построены две буферные зоны, и выходные данные будут содержать две области – для двух соответствующих значений расстояния – для каждого объекта.

  • Инструменты Суммировать в пределах и Суммировать близлежащие очень похожи. С помощью инструмента Суммировать в пределах вы суммируете объекты в пределах существующих полигонов, а при работе с инструментом Суммировать близлежащие – создаете области вокруг точек, линий и полигонов, а затем суммируете объекты в пределах этих вычисленных областей.

  • Вы можете создавать группы, задав для входных точек поле группы. К примеру, при суммировании преступлений, совершенных на определенном расстоянии от соседних границ, можно выбрать атрибут Crime_type, который может содержать пять разных видов преступлений. Каждая группа представляет уникальный тип преступления, и выбранный вами тип статистики может быть вычислен для каждого уникального значения в поле Crime_type.

Синтаксис

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 и сетевые сервисы.

  • DRIVING_DISTANCEРасстояние, пройденное легковым или другим небольшим автомобилем, например, пикапом. При проезде применяются правила, относящиеся к легковым автомобилям.
  • DRIVING_TIMEРасстояние, пройденное за определенное время легковым или другим небольшим автомобилем, например, пикапом. Скорости движения на основе данных загруженности дорог используются, в случае их доступности, при указании времени суток проезда. При проезде применяются правила, относящиеся к легковым автомобилям.
  • STRAIGHT_LINEЕвклидово, или прямолинейное расстояние.
  • TRUCKING_DISTANCEДлина построенных маршрутов грузовиков. При проезде применяются правила, относящиеся к легковым автомобилям, а также относящиеся к грузовикам.
  • TRUCKING_TIMEДлина маршрутов, пройденных за определенное время грузовиками. Скорости движения на основе данных загруженности дорог используются, в случае их доступности, при указании времени суток проезда. При проезде применяются правила, относящиеся к легковым автомобилям, а также относящиеся к грузовикам.
  • WALKING_DISTANCEДлина дорог и троп, на которых разрешено движение пешеходов.
  • WALKING_TIMEРасстояние, пройденное за указанное время по дорогам и тропам, на которых разрешено движение пешеходов.
String
distances
[distance,...]

Значения расстояния определяют зону поиска (для расстояния по прямой, длины пути на легковом и грузовом автомобиле и длины пути пешехода). Объекты, находящиеся в пределах указанных расстояний, будут суммироваться.

Можно задать несколько значений. Для каждого значения расстояния будет создана одна зона вокруг каждого входного объекта.

Double
distance_units
(Дополнительный)

Единицы измерения расстояния.

  • MILESМили
  • KILOMETERSКилометры
  • FEETФуты
  • YARDSЯрды
  • METERSМетры
  • HOURSЧасы
  • MINUTESМинуты
  • SECONDSСекунды
String
time_of_day
(Дополнительный)

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

Используемые условия дорожного движения могут быть как реальными (в реальном масштабе времени), так и расчетными для заданного времени и заданной даты на основании исторических данных. Реальные данные трафика хранятся в Esri в течение 12 часов, а прогнозные значения трафика рассчитываются на период до 12 часов в будущем. Если указанные вами дата и время находятся в пределах этого 24 часового окна, будут использоваться данные о загруженности дорог в реальном времени. Если они находятся вне окна, будут использоваться исторические данные.

Date
time_zone
(Дополнительный)

Часовой пояс для указанного времени суток. Часовые пояса можно задавать в локальном времени либо времени UTC.

  • GEOLOCALВремя суток учитывает часовой пояс (пояса) в котором находятся входные объекты. Это может привести к разному начальному времени в разных зонах. Используется по умолчанию.Например, при указании локального времени время старта для вычисления времен в пути для точек, расположенных в Восточном часовом поясе, будет 9:00. Восточного часового пояса и 9:00 Центрального времени. (т.е. начальное время будет различаться на один час реального времени (или UTC)).
  • UTCВремя суток определяется временем UTC. Начальные времена для всех точек являются синхронными, т.е. не зависят от часовых поясов.К примеру, в случае указания времени 9:00 UTC начальное время для точек Восточного часового пояса будет 4:00 Восточного времени, а для точек Центрального часового пояса – 3:00 Центрального времени. (т.е. старт будет одновременным.)
String
keep_all_polygons
(Дополнительный)

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

  • KEEP_ALLВ выходной класс объектов будут скопированы буферы всех входных объектов. Используется по умолчанию.
  • ONLY_INTERSECTINGВ выходной класс объектов будут скопированы буферы пересекающих или содержащих как минимум один из входных суммированных объектов.
Boolean
sum_fields
[[summary_field, statistic_type],...]
(Дополнительный)

Список имен атрибутивных полей входных суммируемых объектов и типы статистического суммирования, которые вы хотите выполнить для этих полей – для всех точек в пределах каждого входного буфера.

Поля суммирования должны быть числовыми. Текстовые поля и поля других типов не поддерживаются.

Типы статистических данных следующие:

  • Сумма – добавляет итоговое значение для всех точек каждого буфера.
  • Среднее – вычисляется среднее значение для всех точек каждого буфера.
  • Минимум – находит минимальное значение среди всех точек каждого буфера.
  • Максимум – находит максимальное значение среди всех точек каждого буфера.
  • Стандартное отклонение – находит стандартное отклонение для всех точек каждого буфера.

Value Table
sum_shape
(Дополнительный)

Определяет, будет ли содержать выходной класс объектов такие атрибуты, как число точек, длина линий и площадь полигонов – суммированные для каждого входного буфера.

  • ADD_SHAPE_SUMДобавлять суммированные атрибуты объекта в выходной класс объектов. Используется по умолчанию.
  • NO_SHAPE_SUMНе добавлять суммированные атрибуты объекта в выходной класс объектов.
Boolean
shape_unit
(Дополнительный)

Единицы, в которых будут вычисляться суммированные атрибуты объекта. Если входными данными являются точки, единицы измерения не используются, а в этом случае добавляется только число точек в пределах буфера каждого входного объекта.

Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.

  • METERSМетры
  • KILOMETERSКилометры
  • FEETФуты
  • YARDSЯрды
  • MILESМили
  • ACRESАкры
  • HECTARESГектары
  • SQUAREMETERSКвадратные метры
  • SQUAREKILOMETERSКвадратные километры
  • SQUAREFEETКвадратные футы
  • SQUAREYARDSКвадратные ярды
  • SQUAREMILESКвадратные мили
String
group_field
(Дополнительный)

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

При выборе поля группы создается дополнительная выходная таблица, местоположение которой нужно указать в параметре out_grouped_table.

Field
add_min_maj
(Дополнительный)

Эта опция активна в случае, если вы выбрали поле группы. Это позволит вам определить, какое значение поля группы относится к меньшинству (редко встречается), а какое – к большинству (часто встречается) для буфера каждого входного объекта.

  • NO_MIN_MAJНе добавлять к выходным данным поля меньшинства и большинства. Используется по умолчанию.
  • ADD_MIN_MAJДобавить к выходным данным поля меньшинства и большинства.
Boolean
add_group_percent
(Дополнительный)

Эта опция активна в случае, если вы выбрали поле группы. Это позволит вам вычислить процент для каждого значения атрибута каждой группы.

  • NO_PERCENTАтрибутивное поле процентов не добавляется. Используется по умолчанию.
  • ADD_PERCENTАтрибутивное поле процентов добавляется к выходным данным.
Boolean
Output_Grouped_Table
(Дополнительный)

Если указано поле группы, требуется выходная таблица группировки.

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

  • Join_ID – Идентификатор, соответствующий полю ID, добавленному в выходной класс объектов.
  • Поле группы.
  • Поле суммирования объекта, например, число точек или длина линий.
  • Одно поле для каждого из суммируемых полей.
  • Поле процентов.

Table

Пример кода

SummarizeNearby, пример 1 (окно Python)

Скрипт окна 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, пример 2 (автономный скрипт)

Автономный скрипт – пример использования функции 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)

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы