Décrire un cube spatio-temporel (Exploration des modèles spatio-temporels)

Synthèse

Résume le contenu et les caractéristiques d’un cube spatio-temporel. L’outil décrit l’étendue temporelle et spatiale du cube spatio-temporel, les variables dans le cube spatio-temporel, les analyses effectuées sur chaque variable, ainsi que les thèmes d’affichage 2D et 3D disponibles pour chaque variable.

Illustration

Illustration de l’outil Décrire un cube spatio-temporel

Utilisation

  • Cet outil accepte les fichiers netCDF créés à l’aide de divers outils figurant dans la boîte à outils Exploration des modèles spatio-temporels.

    En savoir plus sur la création d’un cube spatio-temporel

  • L’outil présente les applications potentielles suivantes :

  • Les messages de géotraitement décrivent les caractéristiques et le contenu du cube spatio-temporel en entrée. Pour accéder aux messages, passez le curseur de la souris sur la barre d’avancement et cliquez sur le bouton de menu contextuel ou développez la section des messages dans la fenêtre Géotraitement. Les messages comprennent les informations suivantes :

    • La date et l’heure auxquelles le cube spatio-temporel a été créé.
    • La version d’ArcGIS AllSource utilisée pour créer le cube spatio-temporel.
    • Le type de cube spatio-temporel. Les types possibles incluent Cube d’emplacements définis, Cube de grille, Cube d’emplacements définis (à partir d’un raster multidimensionnel), Cube de prévision et Cube de sous-ensemble. Pour en savoir plus sur les différents types de cube spatio-temporel, reportez-vous à la rubrique Fonctionnement de l’outil Créer un cube spatio-temporel.
      Remarque :

      Si le cube spatio-temporel a été créé avec l’outil Créer un cube spatio-temporel à partir d’une couche raster multidimensionnelle d’ArcGIS Pro 2.8 ou version antérieure, le type affiché est Cube d’emplacements définis plutôt que Cube d’emplacements définis (à partir d’un raster multidimensionnel).

    • Section Caractéristiques du cube spatio-temporel qui décrit les propriétés spatiales et temporelles du cube spatio-temporel. Pour obtenir des détails sur ces caractéristiques, reportez-vous à la rubrique Fonctionnement de l’outil Créer un cube spatio-temporel.
    • Section Contenu du cube spatio-temporel dans laquelle chaque ligne correspond à une variable dans le cube spatio-temporel en entrée. Chaque ligne comprend les statistiques de récapitulation de la variable, l’outil ayant créé la variable (avec le type d’agrégation et de remplissage), ainsi que les options de thème d’affichage disponibles dans les outils Visualiser le cube spatio-temporel en 2D et Visualiser le cube spatio-temporel en 3D.
    • Si le cube spatio-temporel a été créé à l’aide de l’outil Créer un cube spatio-temporel en agrégeant des points, les messages comprennent une ou plusieurs sous-sections dans la section Emplacements et groupes du cube spatio-temporel. La sous-section Nombre et chaque sous-section Champ de récapitulation facultative comprend le nombre de groupes et d’emplacements contenant au moins un point. La faible densité (pourcentage de groupes contenant un décompte nul) est également répertoriée dans la table dans la sous-section Nombre.
    • Si le cube spatio-temporel a été créé à l’aide d’un outil issu du jeu d’outils Prévision de séries chronologiques, les messages comprennent une section Détails de la prévision qui récapitule les méthodes de prévision ayant été appliquées.
    • Les messages comprennent une ou plusieurs sections sous Tendances du cube spatio-temporel. Les sections comprennent la statistique de tendance de Mann-Kendall pour chaque variable dans le cube spatio-temporel.
  • Si une valeur est spécifiée pour le paramètre Table des caractéristiques en sortie, l’outil crée une table qui comprend les caractéristiques spatiales et temporelles du cube spatio-temporel en entrée. Les valeurs figurant dans la table des caractéristiques s’affichent également dans les messages de géotraitement. Ces valeurs peuvent être utilisées dans ModelBuilder pour créer un processus d’analyse spatio-temporelle.

  • Si une valeur est spécifiée pour le paramètre Entités d’étendue spatiale en sortie, l’outil produit une classe d’entités surfaciques ayant un rectangle unique qui représente l’étendue du cube spatio-temporel en entrée. Si le cube spatio-temporel en entrée a été créé à l’aide de l’outil Créer un cube spatio-temporel par des emplacements définis avec un point unique, une classe d’entités ponctuelles est créée à la place d’une classe d’entités surfaciques. Si le cube spatio-temporel a été créé à partir d’un cube modèle, l’étendue reflète l’étendue du cube modèle.

  • La valeur du paramètre Entités d’étendue spatiale en sortie peut ne pas refléter l’étendue des emplacements du cube spatio-temporel si un cube modèle ou l’environnement d’étendue a été utilisé lors de la création du cube spatio-temporel.

Paramètres

ÉtiquetteExplicationType de données
Cube spatio-temporel en entrée

Cube spatio-temporel à décrire. Les cubes spatio-temporels présentent une extension de fichier .nc et sont créés à l’aide de divers outils dans la boîte à outils Exploration des modèles spatio-temporels.

File
Table des caractéristiques en sortie
(Facultatif)

Table contenant des informations récapitulatives sur le cube spatio-temporel en entrée.

Table
Entités d’étendue spatiale en sortie
(Facultatif)

Classe d’entités ayant un rectangle unique qui représente l’étendue spatiale du cube spatio-temporel en entrée.

Feature Class

arcpy.stpm.DescribeSpaceTimeCube(in_cube, {out_characteristics_table}, {out_spatial_extent})
NomExplicationType de données
in_cube

Cube spatio-temporel à décrire. Les cubes spatio-temporels présentent une extension de fichier .nc et sont créés à l’aide de divers outils dans la boîte à outils Exploration des modèles spatio-temporels.

File
out_characteristics_table
(Facultatif)

Table contenant des informations récapitulatives sur le cube spatio-temporel en entrée.

Table
out_spatial_extent
(Facultatif)

Classe d’entités ayant un rectangle unique qui représente l’étendue spatiale du cube spatio-temporel en entrée.

Feature Class

Exemple de code

Exemple 1 d’utilisation de l’outil DescribeSpaceTimeCube (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l’utilisation de la fonction DescribeSpaceTimeCube.

import arcpy
arcpy.stpm.DescribeSpaceTimeCube("input_cube.nc")
Exemple 2 d’utilisation de l’outil DescribeSpaceTimeCube (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de la fonction 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")

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.