Суммировать процент изменения (Анализ преступности и безопасности)

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

Вычисляет процент изменения для объектов, соответствующим точечным объектам, представляющим два сравниваемых временных периода.

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

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

  • К выходным данным будут добавлены следующие поля:

    • CUR_CNT - число точек из значений параметра Входные точечные объекты текущего периода, которые совпадают со значениями параметра Входные объекты.
    • PREV_CNT - число точек из значений параметра Входные точечные объекты предыдущего периода, которые совпадают со значениями параметра Входные объекты.
    • DIFF_CNT - разница между полями CUR_CNT и PREV_CNT.
    • PERC - процент изменения между полями CUR_CNT и PREV_CNT.Вычисляется по формуле
      ((C - P) / P) * 100
      где C – текущее количество, а P – предыдущее. Если текущее количество 0, процент изменения также нулевой. Когда значения процента изменения равно нулю, эти объекты обозначаются в выходной классификации символов как не имеющие процентов.

Параметры

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

Совпадающие объекты, по которым подсчитываются и сравниваются временные периоды.

Feature Layer
Входные точечные объекты текущего периода

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

Например, преступления за предыдущие 14 дней.

Feature Layer
Входные точечные объекты предыдущего периода

Точечные объекты, отфильтрованные по временному периоду, предшествовавшему текущему периоду. Это период времени должен быть такой же продолжительности, что и текущий, чтобы сравнение было точным.

Например, если текущий период содержит объекты с 15 по 28 января, предыдущий должен содержать объекты с 1 по 14 января.

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

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

Feature Class
Радиус поиска
(Дополнительный)

Максимальное расстояние от точечных или линейных Входных объектов, на котором точечный объект будет считаться совпадающим.

Параметр активен только когда входными объектами являются точечные или линейные.

Linear Unit

arcpy.ca.SummarizePercentChange(in_features, in_current_features, in_previous_features, out_feature_class, {search_radius})
ИмяОписаниеТип данных
in_features

Совпадающие объекты, по которым подсчитываются и сравниваются временные периоды.

Feature Layer
in_current_features

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

Например, преступления за предыдущие 14 дней.

Feature Layer
in_previous_features

Точечные объекты, отфильтрованные по временному периоду, предшествовавшему текущему периоду. Это период времени должен быть такой же продолжительности, что и текущий, чтобы сравнение было точным.

Например, если текущий период содержит объекты с 15 по 28 января, предыдущий должен содержать объекты с 1 по 14 января.

Feature Layer
out_feature_class

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

Feature Class
search_radius
(Дополнительный)

Максимальное расстояние от точечных или линейных Входных объектов, на котором точечный объект будет считаться совпадающим.

Параметр активен только когда входными объектами являются точечные или линейные.

Linear Unit

Пример кода

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

Пример скрипта окна Python для использования функции SummarizePercentChange в режиме прямого запуска.

import arcpy
arcpy.env.workspace = r"C:\data\city_pd.gdb"
arcpy.ca.SummarizePercentChange("Precincts", "crimes_q3", "crimes_q2",
                                "crimes_percent_change_by_precinct_q2_to_q3")
SummarizePercentChange, пример 2 (автономный скрипт)

В следующем скрипте Python показано, как использовать функцию SummarizePercentChange в автономном скрипте.

# Name: SummarizePercentChange.py
# Description: Compare the number of crimes committed in the second quarter to 
#              the third quarter by precincts, and determine the percent 
#              change.
# import system modules 
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\data\city_pd.gdb"
# Execute SummarizePercentChange
arcpy.ca.SummarizePercentChange("Precincts", "crimes_q3", "crimes_q2",
                                "crimes_percent_change_by_precinct_q2_to_q3")

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

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

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