Crear cubo de espacio-tiempo agregando puntos (Minería de patrones en espacio-tiempo)

Resumen

Resume un conjunto de puntos en una estructura de datos de netCDF agregándola en bins de espacio-tiempo. Dentro de cada bin, se cuentan los puntos y se agregan los atributos especificados. Para todas las ubicaciones de bin, se evalúan la tendencia de los recuentos y los valores de los campos de resumen.

Más información sobre cómo funciona Crear cubo de espacio-tiempo agregando puntos

Ilustración

Ilustración de herramienta Cubo de espacio-tiempo

Uso

  • Esta herramienta agrega las Entidades de entrada de puntos en bins de espacio-tiempo. La estructura de datos que crea se puede interpretar como un cubo tridimensional compuesto de bins de espacio tiempo donde las dimensiones x e y representan el espacio y la dimensión t representa el tiempo.

    Bins de espacio-tiempo en un cubo tridimensional

  • Cada bin tiene una posición fija en el espacio (x,y) y en el tiempo (t). Los bins que abarcan la misma área (x,y) comparten el mismo Id. de ubicación. Los bins que abarcan la misma duración comparten el mismo Id. de periodo de tiempo.

    Ubicaciones en el cubo de espacio-tiempo

  • Cada bin del cubo de espacio-tiempo tiene un LOCATION_ID, un time_step_ID, un valor COUNT y valores para cualquier Campo de resumen que se haya agregado a la hora de crear el cubo. Los bins que estén asociados a la misma ubicación física compartirán el mismo Id. de ubicación y, conjuntamente, representarán una serie temporal. Los bins que estén asociados al mismo periodo de tiempo compartirán el mismo Id. de periodo de tiempo y, conjuntamente, formarán un intervalo de tiempo. El valor del recuento de cada bin refleja la cantidad de puntos que se han generado en la ubicación asociada junto con el intervalo de tiempo asociado.

  • Las Entidades de entrada deben ser puntos que representen datos de eventos, tales como actos delictivos o incendios, incidentes de enfermedades, datos de ventas a clientes o accidentes de tráfico. Cada punto debe tener una fecha asociada al mismo. El campo que contiene la marca de hora del evento debe ser del tipo Fecha. La herramienta requiere 60 puntos como mínimo y una variedad de marcas de hora. La herramienta fallará si los parámetros especificados dan lugar a un cubo con más de dos mil millones de bins.

  • Esta herramienta requiere los datos proyectados para medir distancias con precisión.

  • La salida de esta herramienta es una representación netCDF de los puntos de entrada, así como mensajes en los que se resumen las características del cubo. Los mensajes se escriben en la parte inferior del panel Geoprocesamiento durante la ejecución de la herramienta. Puede acceder a los mensajes desplazándose por la barra de progreso, haciendo clic en el botón emergente Emergente o ampliando la sección de mensajes en el panel Geoprocesamiento. También puede acceder a los mensajes de una ejecución previa de la herramienta Crear cubo de espacio-tiempo agregando puntos a través del Historial de geoprocesamiento. Puede utilizar el archivo netCDF como entrada para otras herramientas como, por ejemplo, Análisis de puntos calientes emergentes o Análisis de valores atípicos locales. Consulte Visualización del cubo de espacio-tiempo para obtener estrategias con las que podrá consultar el contenido del cubo.

  • Seleccione un campo de tipo Fecha para el parámetro Campo de tiempo. Este campo debe incluir la marca de hora asociada a cada entidad de puntos. Si el campo es de alta precisión (contiene valores en milisegundos), la marca de tiempo de cada bin de espacio-tiempo incluirá solo segundos y se ignorarán los milisegundos.

  • El Intervalo de periodo de tiempo define cómo desea realizar la partición de los puntos agregados a lo largo del tiempo. Puede elegir agregar puntos utilizando intervalos de un día, una semana o un año, por ejemplo. Los intervalos de periodos de tiempo son siempre duraciones fijas y la herramienta requiere diez periodos de tiempo como mínimo. Si no proporciona un valor de Intervalo de periodo de tiempo, la herramienta calculará uno automáticamente. Consulte Más información sobre cómo funciona la herramienta Crear cubo de espacio-tiempo agregando puntos para obtener información sobre cómo se calculan los intervalos de periodos de tiempo predeterminados. Las unidades válidas para los intervalos de periodos de tiempo son: años, meses, días, horas, minutos y segundos.

    Nota:

    Aunque en la lista desplegable de Intervalo de periodo de tiempo se incluyen varias unidades de tiempo, la herramienta solo admite años, meses, semanas, días, horas, minutos y segundos.

  • Si no es posible crear el cubo de espacio-tiempo, puede que la herramienta no haya podido estructurar los datos de entrada que proporcionó en diez intervalos de periodos de tiempo. Si aparece un mensaje de error mientras ejecuta esta herramienta, examine las marcas de hora de los puntos de entrada para asegurarse de que incluyen un rango de valores. El rango de valores debe abarcar al menos diez segundos, pues este es el incremento de tiempo más pequeño que utilizará la herramienta. La estadística de Mann-Kendall necesita diez intervalos de tiempo.

  • Al crear un cubo de espacio-tiempo con datos de incidentes, en función del Intervalo de período de tiempo seleccionado, se puede crear un bin al principio o al final del cubo que no contenga datos en ningún momento de todo el intervalo de tiempo. Por ejemplo, si se selecciona 1 mes como Intervalo de periodo de tiempo y los datos no están distribuidos uniformemente a intervalos de 1 mes, habrá un periodo de tiempo al principio o al final periodo que no contendrá datos en su duración. Esto puede sesgar los resultados porque parecerá que el periodo de tiempo sesgado temporalmente tiene menos puntos de forma significativa que el resto de periodos, lo cual es, realmente, un resultado artificial debido a la forma de agregación. Los mensajes indican si hay un sesgo temporal en el primer o el último paso. Una solución es crear un conjunto de selección de los datos que quede repartido uniformemente dentro del Intervalo de periodo de tiempo deseado.

  • No es raro que el dataset tenga una distribución temporal con un espaciado regular. Por ejemplo, puede tener datos anuales que caigan siempre en el 1 de enero de cada año, o datos mensuales que tengan todos una marca de tiempo correspondiente al primer día de cada mes. Este tipo de datos recibe con frecuencia el nombre de datos de panel. Con los datos de panel, los cálculos de sesgo temporal mostrarán con frecuencia porcentajes muy altos. Este es el comportamiento esperado, pues cada bin cubrirá únicamente una unidad de tiempo concreta en el periodo de tiempo dado. Por ejemplo, si eligiera un Intervalo de periodo de tiempo de 1 año y sus datos coincidieran con el 1 de enero de cada año, cada bin abarcaría solo un día del año. Esto es perfectamente aceptable, pues se aplica a cada bin. El sesgo temporal se convierte en un problema cuando solo está presente para ciertos bins debido a los parámetros de creación de bins en lugar de a la distribución real de datos. Resulta importante evaluar el sesgo temporal a efectos de la cobertura esperada en cada bin, basándose en la distribución de sus datos.

  • El sesgo temporal del informe de salida se calcula en forma de porcentaje del intervalo de tiempo que no contiene datos. Por ejemplo, un bin vacío tendría un 100 % de sesgo temporal. Un bin con un periodo de tiempo de 1 mes y una Alineación de periodos de tiempo final que solo contenga datos para las dos segundas semanas del primer intervalo de tiempo tendría un sesgo temporal del 50 % en el primer intervalo de tiempo. Un bin con un intervalo de tiempo de 1 mes y una Alineación de periodos de tiempo inicial que solo contenga datos para las dos primeras semanas del último intervalo de tiempo tendría un sesgo temporal del 50 % en el último intervalo de tiempo.

  • Una vez que crea un cubo de espacio-tiempo, la extensión espacial del cubo no puede ampliarse nunca. Si un análisis posterior del cubo de espacio-tiempo implica el uso de un área de estudio (como la Máscara de análisis de polígonos en la herramienta Análisis de puntos calientes emergentes), tendrá que asegurarse de que la Máscara de análisis de polígonos no se extiende más allá del alcance de las entidades de entrada a la hora de crear el cubo. Si configura el polígono o polígonos del área de estudio que utilizará en los análisis futuros como la configuración del Entorno de extensión a la hora de crear el cubo, se asegurará de que la extensión del cubo tiene el tamaño que necesita al comenzar el análisis.

    Heredado:

    El método con el que la herramienta Crear cubo de espacio-tiempo agregando puntos crea la extensión del cubo de espacio-tiempo ha cambiado en las versiones de ArcGIS Pro 1.3 y ArcMap 10.5. Puede obtener más información sobre este cambio en Ajuste de sesgo de cubo de espacio-tiempo. Aunque el nuevo ajuste del sesgo proporcionará mejores resultados, si por cualquier motivo necesita volver a crear el cubo con la extensión anterior, puede especificar la extensión mediante la configuración del entorno de la extensión.

  • Es posible crear un Cubo de plantilla que se puede usar cada vez que se desee ejecutar el análisis, en especial si se desea comparar datos de una serie de periodos de tiempo. Con un mismo cubo de plantilla se asegura de que la extensión del análisis, el tamaño de bin, el intervalo de periodo de tiempo, el tiempo de referencia y la alineación del periodo de tiempo sean siempre coherentes.

  • Si proporciona un Cubo de plantilla, los puntos de entrada que queden fuera de la extensión de cubo de plantilla se excluirán del análisis. Además, si la referencia espacial asociada a las entidades de punto de entrada es distinta de la referencia espacial asociada al cubo de plantilla, la herramienta proyectará las Entidades de entrada para que coincidan con el cubo de plantilla antes de comenzar el proceso de agregación. La referencia espacial asociada al cubo de plantilla invalidará también la configuración del Sistema de coordenadas de salida. De hecho, el Cubo de plantilla, cuando se especifica, determinará la extensión de procesamiento utilizada, incluso si especifica una extensión de procesamiento distinta. Consulte Cómo funciona la herramienta Crear cubo de espacio-tiempo para obtener más información.

  • El Tiempo de referencia puede ser un valor de fecha y hora o simplemente un valor de fecha; no debe ser solo un valor de hora. El formato esperado está determinado por la configuración de tiempo regional del equipo.

  • Existen varias opciones respecto a cómo se agregan los puntos espacialmente utilizando el parámetro Tipo de forma de agregación. Si desea agregar en una cuadrícula con forma regular, puede elegir una forma de malla o hexagonal. Aunque las cuadrículas de red son la forma de agregación de uso más común, los hexágonos pueden resultar una opción mejor para determinados análisis. Si tiene límites o ubicaciones relevantes para su análisis (por ejemplo, bloques censales o zonas de patrullaje), también puede utilizarlos para la agregación mediante la opción Ubicaciones definidas.

    Nota:

    Si las ubicaciones definidas están almacenadas en una geodatabase de archivos y contienen curvas verdaderas (almacenadas como arcos y no con vértices), las formas poligonales se distorsionarán cuando se almacenen en el cubo de espacio-tiempo. Para comprobar si las Ubicaciones definidas contienen curvas verdaderas, ejecute la herramienta Verificar geometría con el Método de validación OGC. Si aparece un mensaje de error que indica que la opción seleccionada no admite segmentos no lineales, significa que hay curvas verdaderas en el dataset y que pueden eliminarse y reemplazarse por vértices usando la herramienta Densificar con el Método de densificación Ángulo antes de crear el cubo de espacio-tiempo.

  • Dado que el cubo de la cuadrícula siempre es rectangular, aunque los datos de puntos no lo sean, algunas ubicaciones tendrán un recuento de puntos de cero para todos los periodos de tiempo. En muchos análisis solo se incluirán las ubicaciones con datos que tengan al menos un recuento de puntos superior a 1.

  • Al crear un cubo agregándolo en ubicaciones definidas, se incluirán todas las ubicaciones definidas que proporcione el usuario, incluidas aquellas que no tengan puntos en ningún intervalo de tiempo.

  • El Intervalo de distancia indica el tamaño que deben tener los bins de espacio-tiempo. Los bins se utilizan para agregar los datos de puntos. Por ejemplo, puede decidir que cada bin de red sea de 50 x 50 metros. Si va a agregar a hexágonos, el Intervalo de distancia será la altura de cada hexágono y el ancho de los hexágonos resultantes será el doble de la altura dividido entre la raíz cuadrada de 3. Salvo que se especifique un Cubo de plantilla, el bin de la esquina superior izquierda del cubo se centrará en la esquina superior izquierda de la extensión espacial de las Entidades de entrada.

    Intervalo de distancia de hexágonos frente a cuadrículas de red

  • Puede seleccionar un Intervalo de distancia adecuado para su análisis. Debe buscar el equilibrio entre hacer que el intervalo de la distancia sea demasiado grande y perder los patrones subyacentes en los datos de puntos o bien hacer que el intervalo de la distancia sea demasiado pequeño y acabar con un cubo con recuentos de cero. Si no indica un valor de Intervalo de distancia, la herramienta calculará uno automáticamente. Consulte Cómo funciona Crear cubo de espacio-tiempo agregando puntos para obtener información sobre cómo se calculan los intervalos de distancia predeterminados. Las unidades para los intervalos de distancia admitidas son: kilómetros, metros, millas y pies.
  • El análisis de tendencias realizado en los datos de recuento agregados y los valores de los campos de resumen se basan en la estadística de Mann-Kendall.

  • Las operaciones estadísticas siguientes están disponibles para agregar atributos con esta herramienta: Suma. Media, Mínimo, Máximo, Desviación estándar y Mediana.

  • Al rellenar bins vacíos con SPATIAL_NEIGHBORS, se utiliza la contigüidad de tipo Caso de la reina (basada en bordes y nodos) de 2.º orden (incluye los vecinos y los vecinos de los vecinos). Con esta opción, se necesitan por lo menos 4 vecinos espaciales para rellenar el bin vacío.

  • Al rellenar bins vacíos con SPACE_TIME_NEIGHBORS, se utiliza la contigüidad de tipo Caso de la reina (basada en bordes y nodos) de 2.º orden (incluye los vecinos y los vecinos de los vecinos). Además, se utilizan los vecinos temporales para cada uno de los bins que se determine que son vecinos espaciales hacia delante o hacia atrás 2 pasos en el tiempo. Con esta opción, se necesitan por lo menos 13 vecinos en el espacio-tiempo para rellenar el bin vacío.

  • Al rellenar bins vacíos con una TEMPORAL_TREND, los dos primeros periodos de tiempo y los dos últimos periodos de tiempo de una ubicación determinada deben tener valores en sus bins para poder interpolar valores en otros periodos de tiempo para esa ubicación.

  • El tipo de relleno TEMPORAL_TREND utiliza el método Spline univariante interpolada del paquete de interpolación de SciPy.

  • Los valores nulos presentes en cualquiera de los registros de los campos de resumen darán lugar a que esas entidades se excluyan del cubo de salida. Si existen valores nulos en sus Entidades de entrada, se recomienda encarecidamente ejecutar primero la herramienta Rellenar valores que faltan. Si después de ejecutar la herramienta Rellenar valores que faltan todavía hay valores nulos y el recuento de puntos de cada bin forma parte de su estrategia de análisis, tal vez deba considerar crear cubos separados, uno para el recuento (sin campos de resumen) y otro para campos de resumen. Si el conjunto de valores nulos es distinto para cada campo de resumen, también puede pensar en crear un cubo separado para cada campo de resumen.

  • Esta herramienta puede aprovechar el aumento de rendimiento disponible en sistemas que utilizan varias CPU (o varias CPU multinúcleo). De forma predeterminada, la herramienta se ejecutará con el 50 % de los procesadores disponibles; no obstante, el número de CPU utilizadas se puede aumentar o disminuir con el entorno Factor de procesamiento en paralelo. La velocidad de procesamiento aumentada es más notable al crear cubos de espacio-tiempo más grandes.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

La clase de entidad de punto de entrada que agregar en bins de espacio-tiempo.

Feature Layer
Cubo de espacio-tiempo de salida

El cubo de datos de netCDF de salida que se creará para contener recuentos y resúmenes de los datos de puntos de entidades de entrada.

File
Campo de tiempo

El campo que contiene la fecha y hora (marca de hora) de cada punto. Este campo de tiempo debe ser de tipo Fecha.

Field
Cubo de plantilla
(Opcional)

Cubo de espacio-tiempo de referencia utilizado para definir la extensión del análisis, las dimensiones de bin y la alineación de bin del Cubo de espacio-tiempo de salida. La información de Intervalo de periodo de tiempo, Intervalo de distancia y Tiempo de referencia también se obtiene del cubo de plantilla. Este cubo de plantilla debe ser un archivo netCDF (.nc) creado utilizando esta herramienta.

Un cubo de espacio-tiempo creado agregándolo a Ubicaciones definidas no se puede utilizar como un Cubo de plantilla.

File
Intervalo de periodo de tiempo
(Opcional)

El número de segundos, minutos, horas, días, semanas o años que representará un periodo de tiempo único. Se agregarán todos los puntos dentro del mismo Intervalo de periodo de tiempo e Intervalo de distancia. (Si se indica un Cubo de plantilla, este parámetro se ignora y el valor de Intervalo de periodo de tiempo se obtiene del cubo de plantilla).

Time Unit
Alineación de periodo de tiempo
(Opcional)

Especifica cómo se debe realizar la agregación sobre la base de un Intervalo de periodo de tiempo determinado. Si se proporciona un Cubo de plantilla, la Alineación de periodos de tiempo asociada con el Cubo de plantilla sobrescribe el ajuste de este parámetro y se utiliza la Alineación de periodos de tiempo del Cubo de plantilla.

  • Hora de finalizaciónLos periodos de tiempo se alinean con el último evento en el tiempo y se agregan hacia atrás en el tiempo.
  • Hora de inicioLos periodos de tiempo se alinean con el último evento en el tiempo y se agregan hacia delante en el tiempo.
  • Tiempo de referenciaLos periodos de tiempo se alinean a una fecha/hora particular que especifique. Si todos los puntos de las entidades de entrada tienen una marca de tiempo mayor que el Tiempo de referencia indicado (o si es exactamente el punto de tiempo inicial de las entidades de entrada), el intervalo del paso de tiempo empezará en ese instante de referencia y se agregará hacia delante en el tiempo (como sucede con la alineación Tiempo Inicial). Si todos los puntos de las entidades de entrada tienen una marca de tiempo menor que el instante de tiempo de referencia indicado (o si es exactamente el punto de tiempo final de las entidades de entrada), el intervalo del paso de tiempo finalizará en ese instante de referencia y se agregará hacia atrás en el tiempo (como sucede con la alineación Tiempo de finalización). Si el Tiempo de referencia indicado está en la mitad de la extensión de tiempo de sus datos, se creará un intervalo de periodo de tiempo que terminará con el tiempo de referencia indicado (como sucede con la alineación Tiempo final). Se crearán intervalos adicionales tanto antes como después del tiempo de referencia hasta que se haya cubierto toda la extensión de tiempo de los datos.
String
Tiempo de referencia
(Opcional)

La fecha/hora que se va a utilizar para alinear los intervalos de periodos de tiempo. Si desea colocar en el bin los datos semanalmente de lunes a domingo, por ejemplo, puede establecer un tiempo de referencia el domingo a medianoche para garantizar que los bins cortan entre domingo y lunes a medianoche. (Cuando se indica un Cubo de plantilla, este parámetro se deshabilita y el Tiempo de referencia se basa en el Cubo de plantilla.)

Date
Intervalo de distancia
(Opcional)

El tamaño de los bins utilizado para agregar las Entidades de entrada. Se agregarán todos los puntos que quedan dentro del mismo Intervalo de distancia e Intervalo de periodo de tiempo. Al agregar a una cuadrícula hexagonal, esta distancia se utiliza como la altura para construir los polígonos hexagonales. (Cuando se indica un Cubo de plantilla, este parámetro se deshabilita y el valor del intervalo de distancia se basará en el Cubo de plantilla).

Linear Unit
Campos de resumen

Campo numérico que contiene valores de atributos que se utilizan para calcular la estadística especificada al agregar dentro de un cubo de espacio-tiempo. Se pueden especificar varias estadísticas y combinaciones de campos. Los valores nulos presentes en cualquiera de los campos especificados darán lugar a que dicha entidad se excluya del cubo de salida. Si existen valores nulos en sus entidades de entrada, se recomienda encarecidamente ejecutar la herramienta Rellenar valores que faltan antes de crear un cubo de espacio-tiempo.

Los tipos de estadística disponibles son:

  • SUM: suma el valor total para el campo especificado dentro de cada bin.
  • MEAN: Calcula el valor medio para el campo especificado dentro de cada bin.
  • MIN: busca el valor más pequeño para todos los registros del campo especificado dentro de cada bin.
  • MAX: Busca el valor mayor de todos los registros del campo especificado dentro de cada bin.
  • STD: busca la desviación estándar de los valores en el campo especificado dentro de cada bin.
  • MEDIAN: Halla el valor medio ordenado de todos los registros del campo especificado dentro de cada bin.

Los tipos de relleno disponibles son:

  • ZEROS: rellena los bins vacíos con ceros.
  • SPATIAL_NEIGHBORS: Rellena los bins vacíos con el valor medio de los vecinos espaciales.
  • SPACE_TIME_NEIGHBORS: rellena los bins vacíos con el valor medio de los vecinos en el espacio-tiempo.
  • TEMPORAL_TREND: rellena los bins vacíos con un algoritmo de spline univariante interpolada.

Nota:

Los valores nulos presentes en cualquiera de los registros de los campos de resumen darán lugar a que esas entidades se excluyan del cubo de salida. Si existen valores nulos en sus Entidades de entrada, se recomienda encarecidamente ejecutar primero la herramienta Rellenar valores que faltan. Si después de ejecutar la herramienta Rellenar valores que faltan todavía hay valores nulos y el recuento de puntos de cada bin forma parte de su estrategia de análisis, tal vez deba considerar crear cubos separados, uno para el recuento (sin campos de resumen) y otro para campos de resumen. Si el conjunto de valores nulos es distinto para cada campo de resumen, también puede pensar en crear un cubo separado para cada campo de resumen.

Value Table
Tipo de forma de agregación
(Opcional)

Especifica la forma de la malla del polígono a la que se agregarán los datos de puntos de la entidad de entrada.

  • Cuadrícula de redLas entidades de entrada se agregarán a una cuadrícula de celdas cuadradas (red).
  • Cuadrícula hexagonalLas entidades de entrada se agregarán a una cuadrícula de celdas hexagonales.
  • Ubicaciones definidasLas entidades de entrada se agregarán a las ubicaciones indicadas.
String
Ubicaciones de polígonos definidas
(Opcional)

Las entidades poligonales en las que se agregarán los puntos de entrada. Estas pueden representar límites de condados, zonas de patrullaje o territorios de ventas, por ejemplo.

Feature Layer
Id. de ubicación
(Opcional)

El campo que contiene el número de Id. para cada ubicación única.

Field

arcpy.stpm.CreateSpaceTimeCube(in_features, output_cube, time_field, {template_cube}, {time_step_interval}, {time_step_alignment}, {reference_time}, {distance_interval}, summary_fields, {aggregation_shape_type}, {defined_polygon_locations}, {location_id})
NombreExplicaciónTipo de datos
in_features

La clase de entidad de punto de entrada que agregar en bins de espacio-tiempo.

Feature Layer
output_cube

El cubo de datos de netCDF de salida que se creará para contener recuentos y resúmenes de los datos de puntos de entidades de entrada.

File
time_field

El campo que contiene la fecha y hora (marca de hora) de cada punto. Este campo de tiempo debe ser de tipo Fecha.

Field
template_cube
(Opcional)

Un cubo de espacio-tiempo de referencia utilizado para definir la extensión del análisis, las dimensiones de bin y la alineación de bin del output_cube. Los valores de time_step_interval, distance_interval y reference_time también se obtienen a partir del cubo de plantilla. Este cubo de plantilla debe ser un archivo netCDF (.nc) creado utilizando esta herramienta.

Un cubo de espacio-tiempo creado agregándolo a DEFINED_LOCATIONS no se puede utilizar como template_cube.

File
time_step_interval
(Opcional)

El número de segundos, minutos, horas, días, semanas o años que representará un periodo de tiempo único. Se agregarán todos los puntos que queden dentro del mismo time_step_interval e distance_interval. (Si se proporciona un template_cube, este parámetro se ignora y el valor de time_step_interval se obtiene a partir del cubo de plantilla). Estos serían algunos ejemplos de entradas válidas para este parámetro: 1 semana, 13 días o 1 mes.

Time Unit
time_step_alignment
(Opcional)

Especifica cómo se debe realizar la agregación sobre la base de un time_step_interval determinado. Si se proporciona un template_cube, el time_step_alignment asociado con el template_cube sobrescribe el ajuste de este parámetro y se utiliza el time_step_alignment del template_cube.

  • END_TIMELos periodos de tiempo se alinean con el último evento en el tiempo y se agregan hacia atrás en el tiempo.
  • START_TIMELos periodos de tiempo se alinean con el último evento en el tiempo y se agregan hacia delante en el tiempo.
  • REFERENCE_TIMELos periodos de tiempo se alinean a una fecha/hora particular que especifique. Si todos los puntos de las entidades de entrada tienen una marca de tiempo mayor que el instante de tiempo de referencia indicado (o si es exactamente el punto de tiempo inicial de las entidades de entrada), el intervalo del periodo de tiempo empezará en ese instante de referencia y se agregará hacia delante en el tiempo (como sucede con la alineación START_TIME). Si todos los puntos de las entidades de entrada tienen una marca de tiempo menor que el instante de tiempo de referencia indicado (o si es exactamente el punto de tiempo final de las entidades de entrada), el intervalo del periodo de tiempo finalizará en ese instante de referencia y se agregará hacia atrás en el tiempo (como sucede con la alineación END_TIME). Si el tiempo de referencia indicado está en la mitad de la extensión de tiempo de sus datos, se creará un intervalo de periodo de tiempo que terminará por el tiempo de referencia indicado (como sucede con la alineación END_TIME). Se crearán intervalos adicionales tanto antes como después del tiempo de referencia hasta que se haya cubierto toda la extensión de tiempo de los datos.
String
reference_time
(Opcional)

La fecha/hora que se va a utilizar para alinear los intervalos de periodos de tiempo. Si desea colocar en el bin los datos semanalmente de lunes a domingo, por ejemplo, puede establecer un tiempo de referencia el domingo a medianoche para garantizar que los bins cortan entre domingo y lunes a medianoche. (Cuando se indica un template_cube, este parámetro se ignora y el reference_time se basa en el template_cube).

Date
distance_interval
(Opcional)

El tamaño de los bins utilizado para agregar las in_features. Se agregarán todos los puntos que queden dentro del mismo distance_interval e time_step_interval. Al agregar a una cuadrícula hexagonal, esta distancia se utiliza como la altura para construir los polígonos hexagonales. (Cuando se indica un template_cube, este parámetro se ignora y el valor del intervalo de distancia se basará en el template_cube).

Linear Unit
summary_fields
[[Field, Statistic, Fill Empty Bins with],...]

Campo numérico que contiene valores de atributos que se utilizan para calcular la estadística especificada al agregar dentro de un cubo de espacio-tiempo. Se pueden especificar varias estadísticas y combinaciones de campos. Los valores nulos presentes en cualquiera de los campos especificados darán lugar a que dicha entidad se excluya del cubo de salida. Si existen valores nulos en sus entidades de entrada, se recomienda encarecidamente ejecutar la herramienta Rellenar valores que faltan antes de crear un cubo de espacio-tiempo.

Los tipos de estadística disponibles son:

  • SUM: suma el valor total para el campo especificado dentro de cada bin.
  • MEAN: Calcula el valor medio para el campo especificado dentro de cada bin.
  • MIN: busca el valor más pequeño para todos los registros del campo especificado dentro de cada bin.
  • MAX: Busca el valor mayor de todos los registros del campo especificado dentro de cada bin.
  • STD: busca la desviación estándar de los valores en el campo especificado dentro de cada bin.
  • MEDIAN: Halla el valor medio ordenado de todos los registros del campo especificado dentro de cada bin.

Los tipos de relleno disponibles son:

  • ZEROS: rellena los bins vacíos con ceros.
  • SPATIAL_NEIGHBORS: Rellena los bins vacíos con el valor medio de los vecinos espaciales.
  • SPACE_TIME_NEIGHBORS: rellena los bins vacíos con el valor medio de los vecinos en el espacio-tiempo.
  • TEMPORAL_TREND: rellena los bins vacíos con un algoritmo de spline univariante interpolada.

Nota:

Los valores nulos presentes en cualquiera de los registros de los campos de resumen darán lugar a que esas entidades se excluyan del cubo de salida. Si existen valores nulos en sus Entidades de entrada, se recomienda encarecidamente ejecutar primero la herramienta Rellenar valores que faltan. Si después de ejecutar la herramienta Rellenar valores que faltan todavía hay valores nulos y el recuento de puntos de cada bin forma parte de su estrategia de análisis, tal vez deba considerar crear cubos separados, uno para el recuento (sin campos de resumen) y otro para campos de resumen. Si el conjunto de valores nulos es distinto para cada campo de resumen, también puede pensar en crear un cubo separado para cada campo de resumen.

Value Table
aggregation_shape_type
(Opcional)

Especifica la forma de la malla del polígono a la que se agregarán los datos de puntos de la entidad de entrada.

  • FISHNET_GRIDLas entidades de entrada se agregarán a una cuadrícula de celdas cuadradas (red).
  • HEXAGON_GRIDLas entidades de entrada se agregarán a una cuadrícula de celdas hexagonales.
  • DEFINED_LOCATIONSLas entidades de entrada se agregarán a las ubicaciones indicadas.
String
defined_polygon_locations
(Opcional)

Las entidades poligonales en las que se agregarán los puntos de entrada. Estas pueden representar límites de condados, zonas de patrullaje o territorios de ventas, por ejemplo.

Feature Layer
location_id
(Opcional)

El campo que contiene el número de Id. para cada ubicación única.

Field

Muestra de código

Ejemplo 1 de CreateSpaceTimeCube (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función CreateSpaceTimeCube.

import arcpy
arcpy.env.workspace = r"C:\STPM"
arcpy.stpm.CreateSpaceTimeCube("Homicides.shp", "Homicides.nc", "OccDate", "#", 
                               "3 Months", "End time", "#", "3 Miles", 
                               "Property MEDIAN SPACETIME; Age STD ZEROS", 
                               "HEXAGON_GRID")
Ejemplo 2 de CreateSpaceTimeCube (script independiente)

El siguiente script independiente de Python muestra cómo utilizar la función CreateSpaceTimeCube.

# Create Space Time Cube of homicide incidents in a metropolitan area

# Import system modules
import arcpy

# Set geoprocessor object property to overwrite existing output, by default
arcpy.env.overwriteOutput = True

# Local variables...
workspace = r"C:\STPM"

try:
    # Set the current workspace (to avoid having to specify the full path to the feature 
    # classes each time)
    arcpy.env.workspace = workspace

    # Create Space Time Cube of homicide incident data with 3 months and 3 miles settings
				# Also aggregate the median of property loss, no date predicted by space-time neighbors
				#	Also aggregate the standard deviation of the victim's age, fill the no-data with zeros
    # Process: Create Space Time Cube By Aggregating Points
    cube = arcpy.stpm.CreateSpaceTimeCube("Homicides.shp", "Homicides.nc", "MyDate", "#", 
                                          "3 Months", "End_time", "#", "3 Miles", 
                                          "Property MEDIAN SPACETIME; Age STD ZEROS", 
																																										"HEXAGON_GRID")

    # Create a polygon that defines where incidents are possible  
    # Process: Minimum Bounding Geometry of homicide incident data
    arcpy.management.MinimumBoundingGeometry("Homicides.shp", "bounding.shp", "CONVEX_HULL",
                                             "ALL", "#", "NO_MBG_FIELDS")

    # Emerging Hot Spot Analysis of homicide incident cube using 5 Miles neighborhood 
    # distance and 2 neighborhood time step to detect hot spots
    # Process: Emerging Hot Spot Analysis 
    cube = arcpy.stpm.EmergingHotSpotAnalysis("Homicides.nc", "COUNT", "EHS_Homicides.shp", 
                                              "5 Miles", 2, "bounding.shp")

except arcpy.ExecuteError:
    # If any error occurred when running the tool, print the messages
    print(arcpy.GetMessages(2))

Entornos

Casos especiales

Sistema de coordenadas de salida

La referencia espacial asociada al cubo de plantilla, si se especifica, invalidará la configuración del entorno del sistema de coordenadas de salida.

Extensión

La extensión de procesamiento del Cubo de plantilla, si se especifica, invalidará la extensión de procesamiento de la configuración del entorno.