Resumir cambio porcentual (Análisis de criminalidad y seguridad)

Resumen

Calcula el cambio porcentual de las entidades que se corresponden con entidades de puntos que representan dos periodos de tiempo de comparación iguales.

Uso

  • Las Entidades de puntos del periodo actual de entrada y Entidades de puntos del periodo anterior de entrada se pueden crear realizando selecciones de fecha y hora en un dataset grande y guardando esas selecciones en capas nuevas.

  • Los campos siguientes se agregarán a la salida:

    • CUR_CNT: la cantidad de puntos de los valores del parámetro Entidades de puntos del periodo actual de entrada que coinciden con los valores del parámetro Entidades de entrada.
    • PREV_CNT: la cantidad de puntos de los valores del parámetro Entidades de puntos del periodo anterior de entrada que coinciden con los valores del parámetro Entidades de entrada.
    • DIFF_CNT: la diferencia entre los campos CUR_CNT y PREV_CNT.
    • PERC: el porcentaje de cambio entre los campos CUR_CNT y PREV_CNT. Se calcula con la fórmula
      ((C - P) / P) * 100
      donde C es el recuento actual y P es el recuento anterior. Si el recuento actual es 0, el valor del cambio porcentual será nulo. Cuando el valor del cambio porcentual es nulo, estas entidades se designan como sin porcentaje en la clasificación de simbología de salida.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Las entidades coincidentes para las que se contarán y compararán los periodos de tiempo de comparación.

Feature Layer
Entidades de puntos del periodo actual de entrada

Las entidades de puntos filtradas al periodo de tiempo de comparación más reciente.

Por ejemplo, los delitos de los últimos 14 días.

Feature Layer
Entidades de puntos del periodo anterior de entrada

Las entidades de puntos filtradas al periodo de tiempo inmediatamente anterior al periodo actual. Este periodo de tiempo debe tener la misma longitud que el periodo actual a fin de ofrecer una comparación precisa.

Por ejemplo, si el periodo actual contiene entidades desde el 15 de enero hasta el 28 de enero, el periodo anterior contendrá entidades desde el 1 de enero hasta el 14 de enero.

Feature Layer
Clase de entidad de salida

La clase de entidad de salida con recuentos de diferencias y cálculos de cambio porcentual para la comparación del periodo de tiempo.

Feature Class
Radio de Búsqueda
(Opcional)

La distancia máxima desde las Entidades de entrada de línea o punto que una entidad de punto considerará coincidente.

Este parámetro solo está activo cuando se utilizan entidades de línea o de punto como entidades de entrada.

Linear Unit

arcpy.ca.SummarizePercentChange(in_features, in_current_features, in_previous_features, out_feature_class, {search_radius})
NombreExplicaciónTipo de datos
in_features

Las entidades coincidentes para las que se contarán y compararán los periodos de tiempo de comparación.

Feature Layer
in_current_features

Las entidades de puntos filtradas al periodo de tiempo de comparación más reciente.

Por ejemplo, los delitos de los últimos 14 días.

Feature Layer
in_previous_features

Las entidades de puntos filtradas al periodo de tiempo inmediatamente anterior al periodo actual. Este periodo de tiempo debe tener la misma longitud que el periodo actual a fin de ofrecer una comparación precisa.

Por ejemplo, si el periodo actual contiene entidades desde el 15 de enero hasta el 28 de enero, el periodo anterior contendrá entidades desde el 1 de enero hasta el 14 de enero.

Feature Layer
out_feature_class

La clase de entidad de salida con recuentos de diferencias y cálculos de cambio porcentual para la comparación del periodo de tiempo.

Feature Class
search_radius
(Opcional)

La distancia máxima desde las Entidades de entrada de línea o punto que una entidad de punto considerará coincidente.

Este parámetro solo está activo cuando se utilizan entidades de línea o de punto como entidades de entrada.

Linear Unit

Muestra de código

Ejemplo 1 de SummarizePercentChange (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función SummarizePercentChange en modo inmediato.

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")
Ejemplo 2 de SummarizePercentChange (script independiente)

El siguiente script de Python muestra cómo utilizar la función SummarizePercentChange en un script independiente.

# 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")

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados