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
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.((C - P) / P) * 100
Sintaxis
SummarizePercentChange(in_features, in_current_features, in_previous_features, out_feature_class, {search_radius})
Parámetro | Explicación | Tipo 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
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")
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")
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí