Subdiviser un cube spatio-temporel (Exploration des modèles spatio-temporels)

Synthèse

Subdivise un cube spatio-temporel en fonction de l’étendue spatiale, de l’espace ou du temps.

L’outil génère les localisations et groupes du cube spatio-temporel en entrée qui répondent aux critères des méthodes de subdivision sélectionnées. L’outil peut subdiviser spatialement un cube spatio-temporel selon des entités, une étendue ou les localisations d’un autre cube spatio-temporel. L’outil peut aussi subdiviser temporellement un cube spatio-temporel selon une période, l’étendue temporelle d’un autre cube spatio-temporel ou en supprimant des intervalles temporels du début ou de la fin du cube spatio-temporel. Le cube spatio-temporel en sortie comprendra toutes les variables qui sont créées par les outils du jeu d’outils Création d’un cube spatio-temporel.

Illustration

Illustration de l’outil Subdiviser 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

  • Les applications possibles de cet outil sont les suivantes :

    • Utilisez une classe d’entités d’Afrique pour subdiviser spatialement un cube spatio-temporel qui contient des données globales.
    • Utilisez un cube spatio-temporel contenant des données pour la Californie afin de subdiviser spatialement un cube spatio-temporel qui comprend des données pour l’ensemble des États-Unis.
    • Appliquez une subdivision temporelle pour supprimer des intervalles temporels du début ou de la fin d’un cube spatio-temporel dans lequel de nombreux groupes ont un décompte nul.
    • Appliquez une subdivision temporelle pour supprimer les résultats prévus d’un cube spatio-temporel. Utilisez ensuite un outil du jeu d’outils Prévision de séries chronologiques sur le cube spatio-temporel.

  • Les variables d’analyse qui sont stockées dans le cube spatio-temporel en entrée ne sont pas transférées vers le cube spatio-temporel subdivisé en sortie. Les résultats d’analyse dans le cube spatio-temporel reposent sur sa structure spatio-temporelle. Si le cube spatio-temporel est subdivisé, les résultats d’analyse risquent de ne pas être valides. Pour récupérer les variables d’analyse, réexécutez les outils du jeu d’outils Analyse des modèles spatio-temporels et du jeu d’outils Prévision de séries chronologiques sur le cube spatio-temporel subdivisé en sortie.

  • L’outil génère des messages de géotraitement. 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 :

    • Une section Résumé de la subdivision qui compare les caractéristiques du cube spatio-temporel en entrée à celles du cube spatio-temporel subdivisé en sortie.
    • Section Caractéristiques du cube spatio-temporel qui décrit les propriétés spatiales et temporelles du cube spatio-temporel. Dans cette section, la valeur Durée des entités en entrée indique l’étendue temporelle des entités qui ont été utilisées pour créer le cube spatio-temporel d’origine. Cette valeur ne change pas si vous subdivisez un cube spatio-temporel. Pour plus d’informations 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 Localisation et groupes du cube spatio-temporel. La sous-section Nombre et chaque sous-section Champ de récapitulation facultative comprennent le nombre de groupes et de localisations contenant au moins un point. La faible densité (pourcentage de groupes contenant un décompte nul) est également répertoriée 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. Dans cette section, l’étendue temporelle utilisée dans la prévision indique l’étendue temporelle des entités qui ont été utilisées pour créer le cube spatio-temporel d’origine. Cette valeur ne change pas si vous subdivisez un cube spatio-temporel.
    • 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 le paramètre Méthode de subdivision spatiale est défini sur Entités, vérifiez que le système de coordonnées des entités subdivisées en entrée correspond à celui du cube spatio-temporel en entrée. Utilisez l’outil Projeter pour modifier le système de coordonnées des entités de subdivision en entrée. Si les systèmes de coordonnées ne concordent pas, la subdivision risque de ne pas être possible ou les localisations dans le cube spatio-temporel en sortie peuvent se retrouver dans des endroits inattendus.

  • L’application d’une subdivision spatiale ne modifie pas la géométrie d’une localisation du cube spatio-temporel. Chaque localisation est incluse ou exclue du cube spatio-temporel en sortie en fonction des critères de subdivision spatiale sélectionnés.

  • L’application d’une subdivision temporelle ne change pas l’intervalle temporel dans le cube spatio-temporel et l’étendue temporelle des groupes. Chaque groupe est inclus ou exclu du cube spatio-temporel en sortie en fonction des critères de subdivision temporelle sélectionnés. Si le paramètre Méthode de subdivision temporelle est défini sur Définie par l’utilisateur ou Cube spatio-temporel et que les dates/heures de début ou de fin se trouvent dans un groupe, le groupe entier est inclus dans le cube spatio-temporel en sortie. Dans ce cas, il est possible que la plage temporelle du cube spatio-temporel en sortie ne concorde pas avec les dates/heures de début ou de fin spécifiées ou avec l’intervalle temporel du cube de subdivision temporelle. Par exemple, si un cube spatio-temporel présente un intervalle temporel d’un mois et qu’il est subdivisé temporellement par un cube spatio-temporel doté d’un intervalle temporel qui s’étend du 24/01/2020 au 24/12/2020, l’intervalle temporel du cube spatio-temporel en sortie s’étendra du 01/01/2020 au 31/12/2020.

  • Chaque intervalle temporel d’un cube spatio-temporel est exclusif de la date et de l’heure de début du groupe et inclusif de la date et de l’heure de fin du groupe. Par exemple, si un groupe a pour date et heure de début 01/01/2020 00:00:00 et pour date et heure de fin 01/01/2021 00:00:00, le groupe inclut les données ultérieures au 01/01/2020 à 00:00:00 et antérieures au ou datant du 01/01/2021 à 00:00:00. Si la colonne Heure de début du paramètre Période de la subdivision indique 01/01/2021 00:00:00, le cube spatio-temporel en sortie du sous-ensemble commence le 01/01/2020 à 00:00:00 de sorte que les données datant du 01/01/2021 à 00:00:00 soient comprises dans le cube spatio-temporel en sortie.

  • Si un cube spatio-temporel est subdivisé temporellement, le cube spatio-temporel en sortie doit contenir au moins 10 intervalles temporels pour que l’outil puisse s’exécuter.

  • Si les outils subdivisent un cube de localisations définies, toute localisation qui ne répond pas aux critères de subdivision sera supprimée du cube spatio-temporel en sortie. Toutefois, si les outils subdivisent un cube de grilles, toute localisation qui ne répond pas aux critères de subdivision sera uniquement masquée dans le cube spatio-temporel en sortie. Les localisations masquées demeurent dans le cube spatio-temporel, mais elles sont exclues de l’analyse.

    En savoir plus sur la structure des cubes spatio- temporels

  • Si un cube spatio-temporel a été créé à l’aide de l’outil Créer un cube spatio-temporel en agrégeant des points, il peut contenir des variables qui disposent de différentes localisations masquées. Cela impacte la façon dont l’outil Subdiviser un cube spatio-temporel applique une subdivision spatiale.

    • Si le cube spatio-temporel est défini comme valeur du paramètre Cube de subdivision spatial en entrée, les localisations de la variable de décompte serviront à subdiviser spatialement le cube spatio-temporel en entrée.
    • Si le cube spatio-temporel est le cube spatio-temporel en entrée et que l’outil applique une subdivision spatiale, chaque variable doit être présente dans au moins une localisation du cube spatio-temporel subdivisé en sortie. Sinon, l’outil connaît un échec.
    • Identifiez la variable du cube spatio-temporel qui détermine la subdivision spatiale en recréant le cube spatio-temporel avec uniquement la variable d’intérêt. Commencez par utiliser l’outil Visualiser le cube spatio-temporel en 3D pour visualiser les valeurs du cube spatio-temporel. Appliquez ensuite l’outil Créer un cube spatio-temporel à partir de localisations définies pour créer un nouveau cube spatio-temporel à partir de l’entité en sortie. Sélectionnez la variable d’intérêt.
  • Si vous subdivisez temporellement un cube de prévision et supprimez tous les intervalles temporels prévus, le cube spatio-temporel en sortie n’est plus un cube de prévision. Le cube spatio-temporel obtenu peut être utilisé en entrée dans n’importe quel outil du jeu d’outils Prévision de séries chronologiques.

Paramètres

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

Cube spatio-temporel à subdiviser. 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
Cube spatio-temporel en sortie

Subdivision du cube spatio-temporel qui répond aux critères spatiaux et temporels spécifiés par les paramètres Méthode de subdivision spatiale et Méthode de subdivision temporelle. Les variables d’analyse stockées dans le cube spatio-temporel en entrée seront exclues du cube spatio-temporel en sortie.

File
Méthode de subdivision spatiale

Indique la méthode à utiliser pour subdiviser spatialement le cube spatio-temporel en entrée. Toute localisation dans le cube spatio-temporel en entrée qui répond à ces critères de subdivision spatiale sera incluse dans le cube spatio-temporel en sortie.

  • EntitésUne classe d’entités avec des polygones, des points ou des lignes sera utilisée pour subdiviser le cube spatio-temporel en entrée. Le paramètre Relation spatiale indique comment la couche d’entités subdivise le cube spatio-temporel.
  • ÉtendueL’étendue spécifiée par le paramètre Étendue permettra de subdiviser le cube spatio-temporel en entrée. Le cube spatio-temporel en sortie inclura toutes les localisations du cube spatio-temporel en entrée qui intersectent l’étendue.
  • Cube spatio-temporelLa localisation du cube spatio-temporel spécifié par le paramètre Cube de subdivision spatiale en entrée permettra de subdiviser un cube spatio-temporel. Le paramètre Relation spatiale indique comment ce cube spatio-temporel va subdiviser le cube spatio-temporel en entrée.
  • AucunAucune subdivision spatiale n’est appliquée au cube spatio-temporel en entrée.
  • EntitésUne classe d’entités avec des polygones, des points ou des lignes sera utilisée pour subdiviser le cube spatio-temporel en entrée. Le paramètre spatial_relationship indique comment la couche d’entités subdivise le cube spatio-temporel.
  • ÉtendueL’étendue spécifiée par le paramètre spatial_extent permettra de subdiviser le cube spatio-temporel en entrée. Le cube spatio-temporel en sortie inclura toutes les localisations du cube spatio-temporel en entrée qui intersectent l’étendue.
  • Cube spatio-temporelLa localisation du cube spatio-temporel spécifié par le paramètre in_spatial_cube permettra de subdiviser un cube spatio-temporel. Le paramètre spatial_relationship indique comment ce cube spatio-temporel va subdiviser le cube spatio-temporel en entrée.
  • AucunAucune subdivision spatiale n’est appliquée au cube spatio-temporel en entrée.
String
Méthode de subdivision temporelle

Indique la méthode à utiliser pour subdiviser temporellement un cube spatio-temporel. Tout intervalle temporel dans le cube spatio-temporel en entrée qui répond aux critères de subdivision temporelle sera inclus dans le cube spatio-temporel en sortie.

  • Défini par l’utilisateurLa plage temporelle spécifiée par les valeurs Heure de début ou Heure de fin du paramètre Période de subdivision permettra de subdiviser temporellement le cube spatio-temporel en entrée.
  • Nombre d’intervalles temporelsUn certain nombre d’intervalles temporels à partir du début et de la fin du cube spatio-temporel en entrée permettra de subdiviser temporellement le cube spatio-temporel. Le nombre d’intervalles temporels à supprimer est indiqué par les valeurs À partir du début ou À partir de la fin du paramètre Nombre d’intervalles temporels à supprimer.
  • Cube spatio-temporelL’étendue temporelle du cube spatio-temporel spécifié par le paramètre Cube de subdivision temporelle en entrée permettra de subdiviser temporellement le cube spatio-temporel en entrée.
  • AucunAucune subdivision temporelle n’est appliquée au cube spatio-temporel en entrée.
String
Entités de subdivision en entrée
(Facultatif)

Classe d’entités qui contient des polygones, des points ou des lignes pour subdiviser un cube spatio-temporel. La relation spatiale entre les entités de subdivision en entrée et le cube spatio-temporel est spécifiée par le paramètre Relation spatiale.

Feature Layer
Relation spatiale
(Facultatif)

Indique la relation spatiale qui sera appliquée entre la valeur du paramètre Entités de subdivision en entrée ou Cube de subdivision spatiale en entrée et le cube spatio-temporel en entrée pour subdiviser spatialement le cube spatio-temporel. Les options disponibles pour la relation spatiale dépendent de la géométrie du cube spatio-temporel en entrée et des entités de subdivision en entrée ou du cube de subdivision spatiale en entrée.

  • IntersecterLe cube spatio-temporel en sortie inclura les localisations dans le cube spatio-temporel qui intersectent la valeur du paramètre Entités de subdivision en entrée ou Cube de subdivision spatiale en entrée. Il s’agit de l’option par défaut.
  • ContientLe cube spatio-temporel en sortie inclura les localisations dans le cube spatio-temporel qui contiennent la valeur du paramètre Entités de subdivision en entrée ou Cube de subdivision spatiale en entrée.
  • DansLe cube spatio-temporel en sortie inclura les localisations dans le cube spatio-temporel qui se trouvent dans la valeur du paramètre Entités de subdivision en entrée ou Cube de subdivision spatiale en entrée.
  • Ont leur centre dansLe cube spatio-temporel en sortie inclura les localisations dans le cube spatio-temporel dont le centre se trouve dans la valeur du paramètre Entités de subdivision en entrée ou Cube de subdivision spatiale en entrée.
String
Étendue
(Facultatif)

Étendue spatiale qui va subdiviser spatialement le cube spatio-temporel en entrée. Le cube spatio-temporel en sortie inclura les localisations du cube spatio-temporel en entrée qui intersectent l’étendue.

Extent
Cube de subdivision spatiale en entrée
(Facultatif)

Cube spatio-temporel qui va subdiviser spatialement le cube spatio-temporel en entrée. La relation spatiale entre le cube spatio-temporel en entrée et le cube spatio-temporel est spécifiée par le paramètre Relation spatiale.

File
Période de la subdivision
(Facultatif)

Intervalle temporel qui va subdiviser temporellement le cube spatio-temporel en entrée. Tout intervalle temporel qui se trouve dans cet intervalle ou qui contient les valeurs de colonnes Heure de début ou Heure de fin est inclus dans le cube spatio-temporel en sortie.

Value Table
Nombre d’intervalles temporels à supprimer
(Facultatif)

Nombre d’intervalles temporels à partir du début ou de la fin du cube spatio-temporel en entrée qui seront supprimés du cube spatio-temporel en sortie.

Value Table
Cube de subdivision temporelle en entrée
(Facultatif)

Cube spatio-temporel qui va subdiviser temporellement le cube spatio-temporel en entrée. L’étendue temporelle du cube de subdivision temporelle définit l’étendue temporelle du cube spatio-temporel en sortie. Tout intervalle temporel qui se trouve dans l’étendue temporelle du cube de subdivision temporelle en entrée ou qui contient l’heure de début ou l’heure de fin du cube de subdivision temporelle sera inclus dans le cube spatio-temporel en sortie.

File

arcpy.stpm.SubsetSpaceTimeCube(in_cube, out_cube, spatial_subset_method, temporal_subset_method, {in_subset_features}, {spatial_relationship}, {spatial_extent}, {in_spatial_cube}, {time_span_subset}, {remove_time_steps}, {in_temporal_cube})
NomExplicationType de données
in_cube

Cube spatio-temporel à subdiviser. 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_cube

Subdivision du cube spatio-temporel qui répond aux critères spatiaux et temporels spécifiés par les paramètres spatial_subset_method et temporal_subset_method. Les variables d’analyse stockées dans le cube spatio-temporel en entrée seront exclues du cube spatio-temporel en sortie.

File
spatial_subset_method

Indique la méthode à utiliser pour subdiviser spatialement le cube spatio-temporel en entrée. Toute localisation dans le cube spatio-temporel en entrée qui répond à ces critères de subdivision spatiale sera incluse dans le cube spatio-temporel en sortie.

  • FEATURESUne classe d’entités avec des polygones, des points ou des lignes sera utilisée pour subdiviser le cube spatio-temporel en entrée. Le paramètre spatial_relationship indique comment la couche d’entités subdivise le cube spatio-temporel.
  • EXTENTL’étendue spécifiée par le paramètre spatial_extent permettra de subdiviser le cube spatio-temporel en entrée. Le cube spatio-temporel en sortie inclura toutes les localisations du cube spatio-temporel en entrée qui intersectent l’étendue.
  • SPACE_TIME_CUBELa localisation du cube spatio-temporel spécifié par le paramètre in_spatial_cube permettra de subdiviser un cube spatio-temporel. Le paramètre spatial_relationship indique comment ce cube spatio-temporel va subdiviser le cube spatio-temporel en entrée.
  • NONEAucune subdivision spatiale n’est appliquée au cube spatio-temporel en entrée.
String
temporal_subset_method

Indique la méthode à utiliser pour subdiviser temporellement un cube spatio-temporel. Tout intervalle temporel dans le cube spatio-temporel en entrée qui répond aux critères de subdivision temporelle sera inclus dans le cube spatio-temporel en sortie.

  • USER_DEFINEDLa plage temporelle spécifiée par les valeurs d’heure de début ou d’heure de fin du paramètre time_span_subset permettra de subdiviser temporellement le cube spatio-temporel en entrée.
  • NUMBER_OF_TIME_STEPSUn certain nombre d’intervalles temporels à partir du début et de la fin du cube spatio-temporel en entrée permettra de subdiviser temporellement le cube spatio-temporel. Le nombre d’intervalles temporels à supprimer est indiqué par les valeurs À partir du début ou À partir de la fin du paramètre remove_time_steps.
  • SPACE_TIME_CUBEL’étendue temporelle du cube spatio-temporel spécifié par le paramètre in_temporal_cube permettra de subdiviser temporellement le cube spatio-temporel en entrée.
  • NONEAucune subdivision temporelle n’est appliquée au cube spatio-temporel en entrée.
String
in_subset_features
(Facultatif)

Classe d’entités qui contient des polygones, des points ou des lignes pour subdiviser un cube spatio-temporel. La relation spatiale entre les entités de subdivision en entrée et le cube spatio-temporel est spécifiée par le paramètre spatial_relationship.

Feature Layer
spatial_relationship
(Facultatif)

Indique la relation spatiale qui sera appliquée entre la valeur du paramètre in_subset_features ou in_spatial_cube et le cube spatio-temporel en entrée pour subdiviser spatialement le cube spatio-temporel. Les options disponibles pour la relation spatiale dépendent de la géométrie du cube spatio-temporel en entrée et des entités de subdivision en entrée ou du cube de subdivision spatiale en entrée.

  • INTERSECTLe cube spatio-temporel en sortie inclura les localisations du cube spatio-temporel en entrée qui intersectent la valeur du paramètre in_subset_features ou in_spatial_cube. Il s’agit de l’option par défaut.
  • CONTAINSLe cube spatio-temporel en sortie inclura les localisations du cube spatio-temporel en entrée qui contiennent la valeur du paramètre in_subset_features ou in_spatial_cube.
  • WITHINLe cube spatio-temporel en sortie inclura les localisations du cube spatio-temporel en entrée qui se trouvent dans la valeur du paramètre in_subset_features ou in_spatial_cube.
  • HAVE_THEIR_CENTER_INLe cube spatio-temporel en sortie inclura les localisations dans le cube spatio-temporel dont le centre se trouve dans la valeur du paramètre in_subset_features ou in_spatial_cube.
String
spatial_extent
(Facultatif)

Étendue spatiale qui va subdiviser spatialement le cube spatio-temporel en entrée. Le cube spatio-temporel en sortie inclura les localisations du cube spatio-temporel en entrée qui intersectent l’étendue.

Extent
in_spatial_cube
(Facultatif)

Cube spatio-temporel qui va subdiviser spatialement le cube spatio-temporel en entrée. La relation spatiale entre le cube spatio-temporel en entrée et le cube spatio-temporel est spécifiée par le paramètre spatial_relationship.

File
time_span_subset
[time_span_subset,...]
(Facultatif)

Intervalle temporel qui va subdiviser temporellement le cube spatio-temporel en entrée. Tout intervalle temporel qui se trouve dans cet intervalle ou qui contient les valeurs d’heure de début ou d’heure de fin sera inclus dans le cube spatio-temporel en sortie.

Value Table
remove_time_steps
[remove_time_steps,...]
(Facultatif)

Nombre d’intervalles temporels à partir du début ou de la fin du cube spatio-temporel en entrée qui seront supprimés du cube spatio-temporel en sortie.

Value Table
in_temporal_cube
(Facultatif)

Cube spatio-temporel qui va subdiviser temporellement le cube spatio-temporel en entrée. L’étendue temporelle du cube de subdivision temporelle définit l’étendue temporelle du cube spatio-temporel en sortie. Tout intervalle temporel qui se trouve dans l’étendue temporelle du cube de subdivision temporelle en entrée ou qui contient l’heure de début ou l’heure de fin du cube de subdivision temporelle sera inclus dans le cube spatio-temporel en sortie.

File

Exemple de code

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

Le script Python ci-dessous montre comment utiliser la fonction SubsetSpaceTimeCube.


import arcpy
arcpy.env.workspace = "C:\STPM"
arcpy.stpm.SubsetSpaceTimeCube("input_cube.nc", "subset_cube.nc", 
                               "SPACE_TIME_CUBE", "NONE", None, None, None, 
                               "spatial_subset_cube.nc")
Exemple 2 d’utilisation de l’outil SubsetSpaceTimeCube (script autonome)

Le script Python autonome ci-dessous illustre l’utilisation de la fonction SubsetSpaceTimeCube.


# Use the Subset Space Time Cube tool to subset a space-time cube by time 
# and space.

# Import system modules
import arcpy
import os

# Set workspace
arcpy.env.workspace = r"C:\Analysis"
gdb = os.path.join(arcpy.env.workspace, "continents.gdb")
arcpy.env.overwriteOutput = True

# Temporally subset a space-time cube
temperature_stc = "Temperature_STC.nc"
temporal_subset_stc = "Temperature_STC_temporal_subset.nc"

arcpy.stpm.SubsetSpaceTimeCube(temperature_stc, temporal_subset_stc, "NONE", 
                               "USER_DEFINED", None, "", "DEFAULT", None, 
                               "1/1/2012 1/1/2022")

# Spatially subset the data for every continent in the space-time cube
continents = ["Africa", "North_America", "Antarctica", "South_America", "Asia", 
              "Europe", "Australia"]
for continent in continents:
    feature = os.path.join(gdb, c)
    arcpy.stpm.SubsetSpaceTimeCube(temporal_subset_stc, 
                                   continent + "_temperature_subset.nc", 
                                   "FEATURES", "NONE", feature, "INTERSECT")