Describir cubo de espacio-tiempo (Minería de patrones en espacio-tiempo)

Resumen

Resume los contenidos y características de un cubo de espacio-tiempo. Esta herramienta describe la extensión temporal y espacial del cubo de espacio-tiempo, las variables del cubo de espacio-tiempo, los análisis realizados en cada variable y los temas de visualización 2D y 3D disponibles para cada variable.

Ilustración

Ilustración de la herramienta Describir cubo de espacio-tiempo

Uso

  • Esta herramienta acepta archivos netCDF creados por varias herramientas en la caja de herramientas Minería de patrones en espacio-tiempo.

    Más información sobre la creación de un cubo de espacio-tiempo

  • Esta herramienta tiene las siguientes aplicaciones potenciales:

  • Los mensajes de geoprocesamiento describen las características y el contenido del cubo de espacio-tiempo de entrada. Para acceder a los mensajes, pase el cursor sobre la barra de progreso y haga clic en el botón emergente o expanda la sección de mensajes del panel Geoprocesamiento. Estos mensajes incluyen la siguiente información:

    • La fecha y la hora en que se creó el cubo de espacio-tiempo.
    • La versión de AllSource utilizada para crear el cubo de espacio-tiempo.
    • El tipo de cubo de espacio-tiempo. Los tipos posibles incluyen Cubo de ubicaciones definidas, Cubo de cuadrícula, Cubo de ubicaciones definidas (a partir de un ráster multidimensional), Cubo de predicción y Cubo de subconjunto. Para obtener más información sobre los diferentes tipos de cubos de espacio-tiempo, consulte Cómo funciona Crear cubo de espacio-tiempo.
      Nota:

      Si el cubo de espacio-tiempo se creó con la herramienta Crear cubo de espacio-tiempo a partir de una capa ráster multidimensional en ArcGIS Pro 2.8 o versiones anteriores, el tipo mostrado será Cubo de ubicaciones definidas en lugar de Cubo de ubicaciones definidas (a partir de un ráster multidimensional).

    • Una sección de Características del cubo de espacio-tiempo que describe las propiedades de espacio y tiempo del cubo de espacio-tiempo. Para obtener más detalles sobre estas características, consulte Cómo funciona Crear cubo de espacio-tiempo.
    • Una sección de Contenido del cubo de espacio-tiempo en la que cada fila corresponde a una variable en el cubo de espacio-tiempo de entrada. Cada fila incluye las estadísticas de resumen de la variable, la herramienta que creó la variable (junto con el tipo de relleno y agregación) y las opciones de tema de visualización que están disponibles en las herramientas Visualizar cubo de espacio-tiempo en 2D y Visualizar cubo de espacio-tiempo en 3D.
    • Si el cubo de espacio-tiempo se creó con la herramienta Crear cubo de espacio-tiempo agregando puntos, los mensajes incluirán una o más subsecciones en la sección Ubicaciones y bins de cubo de espacio-tiempo. La subsección Recuento y cada subsección de Campo de resumen opcional incluye la cantidad de bins y ubicaciones que contenían al menos un punto. La dispersión (porcentaje de bins que contienen un recuento cero) también se incluye en la tabla de la subsección Recuento.
    • Si el cubo de espacio-tiempo se creó con una herramienta del conjunto de herramientas Previsión de serie temporal, los mensajes incluirán una sección de Detalles de la previsión que resume los métodos de previsión aplicados.
    • Los mensajes incluirán una o más secciones bajo Tendencias de cubo de espacio-tiempo. Las secciones incluyen la estadística de tendencias de Mann-Kendall general para cada variable del cubo de espacio-tiempo.
  • Si se especifica un valor para el parámetro Tabla de características de salida, la herramienta crea una tabla que incluye las características de espacio y tiempo del cubo de espacio-tiempo de entrada. Los valores de la tabla de características también se muestran en los mensajes de geoprocesamiento. Estos valores se pueden utilizar en ModelBuilder para crear un flujo de trabajo de análisis de espacio-tiempo.

  • Si se especifica un valor para el parámetro Entidades de extensión espacial de salida, la herramienta genera una clase de entidad de polígono con un solo rectángulo que representa la extensión del cubo de espacio-tiempo de entrada. Si el cubo de espacio-tiempo de entrada se creó con la herramienta Crear cubo de espacio-tiempo por ubicaciones definidas usando un solo punto, se crea una clase de entidad de punto en lugar de una clase de entidad de polígono. Si el cubo de espacio-tiempo se creó a partir de un cubo de plantilla, la extensión refleja la extensión del cubo de plantilla.

  • Es posible que el valor del parámetro Entidades de extensión espacial de salida no refleje la extensión de las ubicaciones del cubo de espacio-tiempo si se utilizó un cubo de plantilla o el entorno Extensión cuando se creó el cubo de espacio-tiempo.

Parámetros

EtiquetaExplicaciónTipo de datos
Cubo de espacio-tiempo de entrada

El cubo de espacio-tiempo que se va a describir. Los cubos de espacio-tiempo tienen una extensión de archivo .nc y se crean utilizando varias herramientas de la caja de herramientas Minería de patrones en espacio-tiempo.

File
Tabla de características de salida
(Opcional)

La tabla que contiene información de resumen sobre el cubo de espacio-tiempo de entrada.

Table
Entidades de extensión espacial de salida
(Opcional)

Una clase de entidad con un solo rectángulo que representa la extensión espacial del cubo de espacio-tiempo de entrada.

Feature Class

arcpy.stpm.DescribeSpaceTimeCube(in_cube, {out_characteristics_table}, {out_spatial_extent})
NombreExplicaciónTipo de datos
in_cube

El cubo de espacio-tiempo que se va a describir. Los cubos de espacio-tiempo tienen una extensión de archivo .nc y se crean utilizando varias herramientas de la caja de herramientas Minería de patrones en espacio-tiempo.

File
out_characteristics_table
(Opcional)

La tabla que contiene información de resumen sobre el cubo de espacio-tiempo de entrada.

Table
out_spatial_extent
(Opcional)

Una clase de entidad con un solo rectángulo que representa la extensión espacial del cubo de espacio-tiempo de entrada.

Feature Class

Muestra de código

Ejemplo 1 de DescribeSpaceTimeCube (ventana de Python)

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

import arcpy
arcpy.stpm.DescribeSpaceTimeCube("input_cube.nc")
Ejemplo 2 de DescribeSpaceTimeCube (script independiente)

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

# Use the output from the Describe Space Time Cube tool to 
# test whether a set of space-time cubes match a set of criteria. Input the 
# space-time cubes that pass the criteria to the Evaluate Forecast by Location 
# tool.

# Import system modules
import os
import glob
import arcpy

# Set Workspace
arcpy.env.workspace = r"C:\Describe"
out_gdb = os.path.join(arcpy.env.workspace, "GDB.gdb")
arcpy.env.overwriteOutput = True

# Assign global variables
check_fields = ['MIN_X', 'MIN_Y', 'MAX_X', 'MAX_Y', 'NUM_FORECAST', 
          'FIRST_FORECAST_START', 'FIRST_FORECAST_END',
          'LAST_FORECAST_START','LAST_FORECAST_END', 'VALIDATION_TIME_STEPS']

# Iterate through all the space-time cubes in a folder
evaluate_cubes = ''

for cube in glob.glob(os.path.join(arcpy.env.workspace, '*.nc')):
    cube_suffix = os.path.basename(cube)
    cube_name = os.path.splitext(cube_suffix)[0]

    out_describe_fc_name = ("describe" + "_{}").format(cube_name)
    out_table = os.path.join(out_gdb, out_describe_fc_name)
    
    # Run the Describe Space Time Cube tool and save a characteristics table into a GDB
    arcpy.stpm.DescribeSpaceTimeCube(cube, out_table, None)
    lstFields = arcpy.ListFields(out_table)

    for field in lstFields:
        # Check if the space-time cube is a forecast cube
        if field.name == "NUM_FORECAST":     
            with arcpy.da.SearchCursor(out_table, check_fields) as cursor:       
                # Check if the extent, start forecast, end forecast, and validation steps  
                # are all the same
                for row in cursor:
                    if str(row[0]) == '-13847325.1116' and str(row[1]) == '3833847.5631' and \
                       str(row[2]) == '-12704362.5439' and str(row[3]) == '5161307.7693' and \
                       str(row[4]) == '14' and str(row[5]) == '2022-02-27 00:00:02' and \
                       str(row[6]) == '2022-02-28 00:00:01' and str(row[7]) == '2022-03-12 00:00:01' and \
                       str(row[8]) == '2022-03-13 00:00:01' and str(row[9]) == '14':
               
                        # Add the space-time cubes that match the criteria to a string 
                        # that will be input into the Evaluate Forecast by Location tool
                        evaluate_cubes += cube + ';'


# Run the Evaluate Forecast by Location tool
evaluate_output = os.path.join(out_gdb, "Evaluate_Covid19_Forecasts")

arcpy.stpm.EvaluateForecastsByLocation(evaluate_cubes.replace('\\', '/'), evaluate_output, None, "USE_VALIDATION")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.