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

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

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

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

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

Иллюстрация

Иллюстрация инструмента Суммировать близлежащие

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

    Лицензия:

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

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

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

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

  • Пустые значения не включаются в расчет статистики. Например, среднее 10, 5 и null будет 7.5 ((10+5) / 2).

Параметры

ПодписьОписаниеТип данных
Входные объекты

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

Feature Layer
Входные суммируемые объекты

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

Feature Layer
Выходной класс пространственных объектов

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

Feature Class
Вычисление расстояния

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

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

Все типы расстояния, кроме расстояния по прямой, используют маршрутизацию ArcGIS Online и сетевые сервисы.

  • Расстояние поездкиЭто будет расстояние, пройденное легковым или другим небольшим автомобилем, например, пикапом. При проезде применяются правила, относящиеся к легковым автомобилям.
  • Время в путиРасстояние, которое будет пройдено за определенное время легковым или другим небольшим автомобилем, например, пикапом. Скорости движения на основе данных загруженности дорог используются, в случае их доступности, при указании времени суток проезда. При проезде применяются правила, относящиеся к легковым автомобилям.
  • Прямая линияБудет использовано Евклидово расстояние (или расстояние по прямой).
  • Длина пути грузовикаРасстояние, которое будет пройдено вдоль маршрутов, предназначенных для грузовиков. При проезде применяются правила, относящиеся к легковым автомобилям, а также относящиеся к грузовикам.
  • Время проезда грузовикаРасстояние, которое будет пройдено за определенное время вдоль маршрутов, предназначенных для грузовиков. Скорости движения на основе данных загруженности дорог используются, в случае их доступности, при указании времени суток проезда. При проезде применяются правила, относящиеся к легковым автомобилям, а также относящиеся к грузовикам.
  • Расстояние пешкомРасстояние, которое будет пройдено по дорогам и тропам, где разрешено движение пешеходов.
  • Время пешкомРасстояние, которое будет пройдено за указанное время по дорогам и тропам, где разрешено движение пешеходов.
String
Расстояние

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

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

Double
Единицы измерения расстояния
(Дополнительный)

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

  • МилиЕдиницами измерения – мили.
  • КилометрыЕдиницами измерения – километры.
  • ФутыЕдиницами измерения – футы
  • ЯрдыЕдиницами измерения – ярды.
  • МетрыЕдиницей измерения – метры.
  • ЧасыЕдиницы измерения – часы.
  • МинутыЕдиницы измерения – минуты.
  • СекундыЕдиницы измерения – секунды.
String
Время суток
(Дополнительный)

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

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

Date
Часовой пояс
(Дополнительный)

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

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

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

  • Отмечено – в выходной класс объектов будут скопированы буферы всех входных объектов. Используется по умолчанию.
  • Не отмечено – в выходной класс объектов будут скопированы буферы пересекающих или содержащих как минимум один из входных суммированных объектов.
Boolean
Поля суммирования
(Дополнительный)

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

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

Поддерживаются следующие типы статистики:

  • Sum – вычисляется общее значение для всех точек в каждом буферном полигоне.
  • Mean – вычисляется среднее значение для всех точек в каждом буферном полигоне.
  • Min – находится минимальное значение среди всех точек в каждом буферном полигоне.
  • Max – находится максимальное значение среди всех точек в каждом буферном полигоне.
  • Stddev – вычисляется среднеквадратическое отклонение для всех точек в каждом буферном полигоне.

Value Table
Добавить суммированные атрибуты объекта
(Дополнительный)

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

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

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

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

  • МетрыЕдиницей измерения – метры.
  • КилометрыЕдиницами измерения – километры.
  • ФутыЕдиницами измерения – футы
  • ЯрдыЕдиницами измерения – ярды.
  • МилиЕдиницами измерения – мили.
  • АкрыЕдиницами измерения – акры.
  • ГектарыЕдиницами измерения – гектары.
  • Квадратные метрыЕдиницами измерения – квадратные метры.
  • Квадратные километрыЕдиницами измерения – квадратные километры.
  • Квадратные футыЕдиницами измерения – квадратные футы.
  • Квадратные ярдыЕдиницами измерения – квадратные ярды.
  • Квадратные милиЕдиницами измерения – квадратные мили.
String
Поле группы
(Дополнительный)

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

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

Field
Добавить атрибуты меньшинства и большинства
(Дополнительный)

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

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

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

Этот параметр активен, если вы задаете значение параметра Поле группировки.

  • Не отмечено – атрибутивное поле процентов не будет добавляться к выходным данным. Используется по умолчанию.
  • Отмечено – атрибутивное поле процентов будет добавляться к выходным данным.
Boolean
Выходная таблица группировки
(Дополнительный)

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

Таблица будет содержать следующие поля атрибутов:

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

Table

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

  • 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 утра по центральному времени. (т.е. начальное время будет различаться на один час реального времени (или UTC)).
  • UTCВремя суток определяется всемирным скоординированным временем (UTC). Начальные времена для всех точек являются синхронными, т.е. не зависят от часовых поясов.Например, установка времени начала на девять утра по UTC означает, что при вычислении времен в пути для точек в Восточном часовом поясе, будет 4 часа утра по восточному времени, а для точек в центральном часовом поясе - 3 утра по центральному времени. (т.е. старт будет одновременным.)
String
keep_all_polygons
(Дополнительный)

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

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

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

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

Поддерживаются следующие типы статистики:

  • Sum – вычисляется общее значение для всех точек в каждом буферном полигоне.
  • Mean – вычисляется среднее значение для всех точек в каждом буферном полигоне.
  • Min – находится минимальное значение среди всех точек в каждом буферном полигоне.
  • Max – находится максимальное значение среди всех точек в каждом буферном полигоне.
  • Stddev – вычисляется среднеквадратическое отклонение для всех точек в каждом буферном полигоне.

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
(Дополнительный)

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

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

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

Этот параметр включен, если вы задаете значение параметра group_field.

  • 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.analysis.SummarizeNearby("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.analysis.SummarizeNearby(newStore, censusInfo, outFeatureClass, 
                               distanceType, distance, distanceUnit,
                               time, timeZone, keepPolys, sumFields,
                               addShapeSum)

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

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

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