Créer un cube spatio-temporel en agrégeant des points (Exploration des modèles spatio-temporels)

Synthèse

Synthétise un ensemble de points dans une structure de données netCDF en les agrégeant dans des groupes spatio-temporels. Au sein de chaque groupe, les points sont comptabilisés et les attributs spécifiés sont agrégés. Pour tous les emplacements des groupes, l'évolution de la comptabilisation, ainsi que les valeurs de champ de récapitulation, sont évaluées.

Pour en savoir plus sur le fonctionnement de l'outil Créer un cube spatio-temporel en agrégeant des points

Illustration

Illustration de l’outil Créer un cube spatio-temporel

Utilisation

  • Cet outil agrège les entités ponctuelles en entrée dans des groupes spatio-temporels. La structure de données qui en résulte peut être considérée comme un cube tridimensionnel constitué de groupes spatio-temporels, les dimensions x et y représentant l’espace et la dimension t représentant le temps.

    Groupes spatio-temporels dans un cube tridimensionnel

  • Chaque groupe présente une position fixe dans l'espace (x,y) et dans le temps (t). Les groupes couvrant la même surface (x,y) partagent le même ID d'emplacement. Les bins englobant la même durée partagent le même ID d'intervalle temporel.

    Emplacements dans le cube spatio-temporel

  • Chaque groupe dans le cube spatio-temporel présente des valeurs de champ LOCATION_ID, time_step_ID et COUNT, ainsi que des valeurs pour tous les champs spécifiés dans le paramètre Champs de récapitulation qui ont été agrégés lors de la création du cube. Les groupes associés à la même localisation physique partagent le même ID de localisation et constituent ensemble une série chronologique. Les groupes associés au même intervalle temporel partagent le même ID d’intervalle temporel et constituent ensemble une tranche temporelle. La valeur numérique de chaque bin représente le nombre de points présents à l'emplacement associé de l'intervalle temporel associé.

  • La valeur du paramètre Entités en entrée doit correspondre à des points. Il peut s’agir, par exemple, de délits ou d’incendies, de maladies, de données sur les ventes clients ou d’accidents de la circulation. Une date doit être associée à chaque point. Le champ contenant l’horodatage de l’événement doit être de type date. L'outil requiert un minimum de 60 points et divers horodatages. L’outil échoue si les paramètres spécifiés génèrent un cube comportant plus de 2 milliards de groupes.

  • Cet outil nécessite des données projetées pour mesurer précisément les distances.

  • La sortie produite par cet outil est une représentation netCDF des points en entrée, ainsi que des messages récapitulant les caractéristiques du cube. Les messages sont écrits au bas de la fenêtre Géotraitement au cours de l’exécution de l’outil. Pour accéder aux messages, survolez la barre de progression et cliquez sur le bouton contextuel Bouton contextuel ou développez la section des messages dans la fenêtre Géotraitement. Vous pouvez également accéder aux messages d’une précédente exécution de l’outil dans l’historique du géotraitement. Vous pouvez utiliser le fichier netCDF en entrée dans d’autres outils, comme Analyse de points chauds émergents ou Analyse de valeurs aberrantes locales. Reportez-vous à la rubrique Visualisation du cube spatio-temporel pour savoir comment consulter le contenu d’un cube.

  • Sélectionnez un champ de type date pour le paramètre Champ temporel. Ce champ doit contenir l'horodatage associé à chaque entité ponctuelle. S’il s’agit d’un champ à haute précision (contenant des valeurs en millisecondes), l’horodatage de chaque groupe spatio-temporel n’inclura que des secondes, et les millisecondes seront ignorées.

  • Le paramètre Intervalle temporel indique le mode de partitionnement des points agrégés dans le temps. Vous pouvez agréger les points avec des intervalles d’un jour, d’une semaine ou d’un an, par exemple. Les intervalles temporels sont toujours des durées fixes et l’outil requiert un minimum de dix phases. Si vous n’indiquez aucune valeur dans Intervalle temporel, l’outil en calcule une. Reportez-vous à la rubrique En savoir plus sur le fonctionnement de l’outil Créer un cube spatio-temporel en agrégeant des points pour obtenir des informations sur le calcul des intervalles temporels par défaut. Les unités d’intervalles temporels valides sont les années, les mois, les heures, les minutes et les secondes.

    Remarque :

    Plusieurs unités de temps apparaissent dans la liste déroulante Intervalle temporel ; l’outil ne prend cependant en charge que les unités Années, Mois, Semaines, Jours, Heures, Minutes et Secondes.

  • Si le cube spatio-temporel ne peut pas être créé, il est possible que l’outil ne soit pas parvenu à structurer les données en entrée que vous avez fournies en 10 intervalles temporels. Si un message d’erreur s’affiche à l’exécution de cet outil, examinez les horodatages des points en entrée pour vérifier qu’ils incluent une plage de valeurs. La plage de valeurs doit couvrir au moins 10 secondes, car il s’agit du plus petit incrément temporel pris en charge par l’outil. 10 intervalles temporels sont requis par la statistique Mann-Kendall.

  • Lorsque vous créez un cube spatio-temporel avec des données d’incident, selon la valeur Intervalle temporel que vous spécifiez, il est possible de créer un groupe au début ou à la fin du cube qui ne comprend aucune donnée durant toute la période temporelle. Par exemple, si vous spécifiez 1 mois comme valeur Intervalle temporel et que les données ne se décomposent pas de manière régulière en intervalles d’un mois, alors une phase temporelle dont l’intégralité de la période ne comporte aucune donnée est insérée au début ou à la fin. Cela peut altérer les résultats car la phase déformée temporellement semble comporter beaucoup moins de points que les autres phases temporelles, ce qui est un résultat artificiel du schéma d’agrégation. Le message indique si une déformation temporelle a lieu dans la première ou la dernière phase temporelle. Pour résoudre ce problème, vous pouvez créer un jeu de sélection des données afin qu’elles soient réparties équitablement au sein de la valeur Intervalle temporel spécifiée.

  • Il n'est pas rare pour un jeu de données que sa distribution temporelle soit espacée régulièrement. Par exemple, vous pouvez avoir des données annuelles qui tombent toutes le 1er janvier de chaque année et des données mensuelles toutes horodatées le premier de chaque mois. Ce type de données est souvent désigné sous le nom de données de panel. Avec les données de panel, les calculs de déformation temporelle présentent fréquemment de très forts pourcentages. Ceci est normal, car chaque groupe couvre une seule unité de temps en particulier dans l'intervalle donné. Par exemple, si vous spécifiez 1 an comme valeur Intervalle temporel et que les données tombent le 1er janvier de chaque année, chaque groupe ne couvre qu’un jour de l’année. Ceci est acceptable, car cela s’applique à chaque groupe. La déformation temporelle pose problème lorsqu'elle est uniquement présente pour certains groupes en raison des paramètres de création des groupes au lieu d'une distribution réelle des données. Il est important d’évaluer la déformation temporelle en termes de couverture attendue dans chaque groupe en fonction de la distribution des données.

  • La déformation temporelle dans le rapport en sortie est calculée en tant que pourcentage de la période temporelle qui ne comporte aucune donnée. Par exemple, un groupe vide aurait une déformation temporelle de 100 pour cent. Un groupe associé à une période d’un mois et une valeur Alignement d’intervalle temporel de fin qui ne comporte des données que pour les deux dernières semaines du premier intervalle temporel aura une déformation temporelle de 50 pour cent dans le premier intervalle temporel. Un groupe associé à une période d’un mois et une valeur Alignement d’intervalle temporel de début qui ne comporte des données que pour les deux premières semaines du dernier intervalle temporel aura une déformation temporelle de 50 pour cent dans le dernier intervalle temporel.

  • Une fois le cube spatio-temporel créé, l'étendue spatiale du cube ne peut jamais être étendue. Si une analyse plus poussée du cube spatio-temporel implique l’utilisation d’une zone d’étude (telle qu’une valeur Masque d’analyse surfacique dans l’outil Analyse de points chauds émergents), vous devez vérifier que la valeur Masque d’analyse surfacique ne s’étend pas au-delà de l’étendue de la valeur Entités en entrée lorsque vous créez le cube. La configuration des polygones de la zone d’étude que vous utiliserez dans des analyses futures comme environnement d’étendue pour créer le cube permet de s’assurer que l’étendue du cube est aussi vaste que nécessaire au début de l’analyse.

    Héritage :

    La méthode qu’utilise l’outil Créer un cube spatio-temporel en agrégeant des points pour créer l’étendue du cube spatio-temporel a changé dans les versions ArcGIS AllSource 1.3 et ArcMap 10.5. Pour en savoir plus sur cette modification, reportez-vous à la rubrique Ajustement par déformation du cube spatio-temporel. Le nouvel ajustement par déformation offre de meilleurs résultats, mais si vous devez recréer le cube avec l’étendue précédente, vous pouvez spécifier l’étendue via le paramètre Environnement d’étendue.

  • Vous pouvez créer une valeur pour Cube modèle à utiliser chaque fois que vous exécutez l’analyse, en particulier si vous souhaitez comparer des données d’une série de périodes. Le même cube modèle assure la cohérence permanente de l’étendue de l’analyse, de la taille de groupe, de l’intervalle temporel, de la référence temporelle et de l’alignement des intervalles temporels.

  • Si vous indiquez une valeur Cube modèle, les points en entrée qui se trouvent en dehors de l’étendue du cube modèle sont exclus de l’analyse. De plus, si la référence spatiale associée aux entités ponctuelles en entrée est différente de la référence spatiale associée au cube modèle, l’outil projette la valeur Entités en entrée en vue d’apparier le cube modèle avant d’entamer le processus d’agrégation. La référence spatiale associée au cube modèle remplace également le paramètre d’environnement Système de coordonnées en sortie. En outre, une fois spécifiée, la valeur Cube modèle détermine l’étendue de traitement utilisée, même si vous indiquez une étendue de traitement différente. Reportez-vous à la rubrique Fonctionnement de l'outil Créer un cube spatio-temporel pour plus d'informations.

  • La valeur de paramètre Référence temporelle peut être une valeur de date et d’heure, ou simplement une valeur de date, mais pas uniquement une valeur d’heure. Le format attendu est fonction des paramètres régionaux de l’ordinateur.

  • Utilisez le paramètre Type de forme d’agrégation pour indiquer le mode d’agrégation spatiale des points. Si vous souhaitez les agréger dans une grille de forme régulière, vous pouvez spécifier un quadrillage ou une forme hexagonale. Bien que les quadrillages soient généralement utilisés, les hexagones peuvent être préférables pour certaines analyses. Si vous possédez des limites ou des localisations qui sont logiques pour l’analyse (par exemple des secteurs de recensement ou des secteurs de police), vous pouvez également les utiliser pour agréger les points à l’aide de l’option Localisations définies.

    Remarque :

    Si les entités en entrée utilisées pour l’option Localisations définies sont enregistrées dans une géodatabase fichier et contiennent des courbes vraies (stockées sous forme d’arcs et non avec des sommets), les formes surfaciques seront déformées une fois stockées dans le cube spatio-temporel. Pour savoir si les entités Localisations définies contiennent des courbes vraies, exécutez l’outil Vérifier les géométries avec le paramètre Méthode de validation défini sur OGC. Si un message d’erreur stipulant que l’option sélectionnée ne prend pas en charge les segments non linéaires apparaît, des courbes vraies sont présentes dans le jeu de données. Elles peuvent être éliminées et remplacées par des sommets via l’outil Densifier avec le paramètre Méthode de densification défini sur Angle avant la création du cube spatio-temporel.

  • Puisqu’un cube de grilles est toujours rectangulaire, même si les données ponctuelles ne le sont pas, certaines localisations présenteront un nombre de points nul pour tous les intervalles temporels. Pour de nombreuses analyses, seules les localisations comportant des données avec au moins un nombre de points supérieur à 1 pour au moins un intervalle temporel seront incluses dans l’analyse.

  • Lorsque vous créez un cube agrégé avec des emplacements définis, tous les emplacements définis fournis par l’utilisateur sont inclus, même ceux qui ne disposent d’aucun point dans les intervalles temporels.

  • Utilisez le paramètre Intervalle de distance pour indiquer la largeur des groupes spatio-temporels. Les groupes permettent d’agréger les données ponctuelles. Vous pouvez créer, par exemple, des quadrillages de 50 mètres sur 50 mètres. Si vous optez pour l’agrégation en hexagones, la valeur Intervalle de distance correspond à la hauteur de chaque hexagone et la largeur des hexagones obtenus est de 2 fois la hauteur divisée par la racine carrée de 3. Si vous ne spécifiez aucune valeur pour le paramètre Cube modèle, le groupe dans l’angle supérieur gauche du cube est centré sur l’angle supérieur gauche de l’étendue spatiale pour la valeur du paramètre Entités en entrée.

    Intervalle de distance des hexagones et des quadrillages

  • Indiquez une valeur Intervalle de distance ayant un sens pour l’analyse. Trouvez un juste équilibre entre un intervalle de distance trop important qui se traduirait par la perte des modèles sous-jacents dans les données ponctuelles et un intervalle de distance trop petit qui produirait un cube aux nombres de points nuls. Si vous n’indiquez aucune valeur dans Intervalle de distance, l’outil en calcule une. Reportez-vous à la rubrique Fonctionnement de l’outil Créer un cube spatio-temporel en agrégeant des points pour en savoir plus sur le calcul des intervalles de distance par défaut. Les unités d’intervalle de distance prises en charge sont les kilomètres, les mètres, les miles et les pieds.
  • L'analyse de tendance réalisée sur les données de total agrégées et les valeurs de champ de récapitulation repose sur la statistique de Mann-Kendall.

  • Cet outil permet les opérations statistiques suivantes pour l’agrégation des attributs : somme, moyenne, minimum, maximum, écart type et médiane.

  • Lorsque vous remplissez des groupes vides avec le type de remplissage SPATIAL_NEIGHBORS, une contiguïté de type Queens Case (contiguïté basée sur les tronçons et les nœuds) du 2e ordre est utilisée (elle inclut les voisins et les voisins des voisins). Un minimum de quatre voisins spatiaux est nécessaire pour remplir le groupe vide à l’aide de cette option.

  • Lorsque vous remplissez des groupes vides avec le type de remplissage SPACE_TIME_NEIGHBORS, une contiguïté de type Queens Case (contiguïté basée sur les tronçons et les nœuds) du 2e ordre est utilisée (elle inclut les voisins et les voisins des voisins). En outre, des voisins temporels sont utilisés pour chacun des groupes identifiés comme étant des voisins spatiaux en se déplaçant vers l'avant et l'arrière de 2 intervalles temporels. Un minimum de 13 voisins spatio-temporels est nécessaire pour remplir le groupe vide à l'aide de cette option.

  • Lorsque vous remplissez des groupes vides avec le type de remplissage TEMPORAL_TREND, les groupes des deux premières et des deux dernières périodes temporelles à une localisation donnée doivent comporter des valeurs afin d’interpoler les valeurs à d’autres périodes temporelles pour cette localisation.

  • L’option TEMPORAL_TREND utilise la méthode de spline univariée interpolée du paquetage d’interpolation de SciPy.

  • Les valeurs nulles qui sont présentes dans les enregistrements des champs de récapitulation entraînent l’exclusion de ces entités du cube en sortie. Si des valeurs nulles sont présentes dans le paramètre Entités en entrée, il est recommandé d’exécuter d’abord l’outil Remplacer les valeurs manquantes. Si, après l’exécution de l’outil Remplacer les valeurs manquantes, des valeurs nulles sont toujours présentes et que le total des points dans chaque groupe fait partie de votre stratégie d’analyse, vous pouvez créer des cubes distincts, un pour le total (sans une valeur Champs de récapitulation) et un avec une valeur Champs de récapitulation. Si l’ensemble de valeurs nulles est différent pour chaque champ de récapitulation, vous pouvez également créer un cube distinct pour chaque champ de récapitulation.

  • Cet outil peut tirer parti des performances accrues disponibles dans les systèmes équipés de plusieurs processeurs (ou de processeurs multicœurs). L’outil fonctionne par défaut avec 50 pour cent des processeurs disponibles. Toutefois, le nombre de processeurs peut être augmenté ou réduit à l’aide de l’environnement Facteur de traitement parallèle. L’augmentation de la vitesse de traitement est davantage visible lors de la création de cubes spatio-temporels plus volumineux.

Paramètres

ÉtiquetteExplicationType de données
Entités en entrée

Classe d’entités points en entrée à agréger en groupes spatio-temporels.

Feature Layer
Cube spatio-temporel en sortie

Cube de données netCDF en sortie qui sera créé pour contenir les totaux et les récapitulations des données de points des entités en entrée.

File
Champ temporel

Champ contenant la date et l'heure (horodatage) de chaque point. Ce champ doit être de type date.

Field
Cube modèle
(Facultatif)

Cube spatio-temporel de référence qui permet de définir l’étendue du paramètre Cube spatio-temporel en sortie de l’analyse, les dimensions des groupes et l’alignement des groupes. Les valeurs des paramètres Intervalle temporel, Intervalle de distance et Référence temporelle sont également obtenues à partir du cube modèle. Ce cube modèle doit être un cube netCDF (fichier .nc) créé avec cet outil.

Un cube spatio-temporel créé par l’agrégation avec la valeur du paramètre Localisations définies ne peut pas servir de cube modèle.

File
Intervalle temporel
(Facultatif)

Nombre de secondes, minutes, heures, jours, semaines ou années qui représenteront une seule phase. Tous les points avec les mêmes valeurs de paramètre Intervalle temporel et Intervalle de distance seront agrégés.

Si la valeur du paramètre Cube modèle est fournie, ce paramètre est inactif et la valeur Intervalle temporel est obtenue à partir du cube modèle.

Time Unit
Alignement de l’intervalle temporel
(Facultatif)

Définit la manière dont l’agrégation sera effectuée en fonction de la valeur du paramètre Intervalle temporel indiquée. Si la valeur du paramètre Cube modèle est indiquée, l’alignement temporel associé à la valeur Cube modèle remplace cette valeur de paramètre et l’alignement temporel de la valeur Cube modèle est utilisé.

  • Heure de finLes phases s’alignent sur le dernier événement temporel et s’agrègent dans le passé.
  • Heure de débutLes phases s’alignent sur le premier événement temporel et s’agrègent dans le futur.
  • Référence temporelleLes phases s’alignent sur une date/heure en particulier que vous spécifiez. Si la valeur d’horodatage de tous les points des entités en entrée est supérieure à la référence temporelle que vous avez spécifiée (ou si elle correspond exactement à l’heure de début des entités en entrée), l’intervalle temporel commence par cette référence temporelle et procède à une agrégation dans le futur (comme avec l’option Heure de début). Si la valeur d’horodatage de tous les points des entités en entrée est inférieure à la référence temporelle que vous avez spécifiée (ou si elle correspond exactement à l’heure de fin des entités en entrée), l’intervalle temporel se termine par cette référence temporelle et procède à une agrégation dans le passé (comme avec l’option Heure de fin). Si la référence temporelle que vous indiquez se trouve au milieu de l’étendue temporelle des données, un intervalle temporel est créé qui se termine par la référence temporelle que vous indiquez (comme avec l’option Heure de fin). Des intervalles supplémentaires seront créés avant et après la référence temporelle jusqu’à ce que l’étendue temporelle complète des données soit couverte.
String
Référence temporelle
(Facultatif)

Date et heure à utiliser pour aligner les intervalles temporels. Si vous souhaitez regrouper les données de façon hebdomadaire du lundi au dimanche, par exemple, définissez l’heure de référence du dimanche à minuit pour garantir la séparation des groupes entre le dimanche et le lundi à minuit.

Si une valeur est indiquée pour le paramètre Cube modèle, ce paramètre est inactif et la référence temporelle repose sur la valeur Cube modèle.

Date
Intervalle de distance
(Facultatif)

Taille des groupes utilisés pour agréger la valeur du paramètre Entités en entrée. Tous les points qui se trouvent au sein des mêmes valeurs de paramètre Intervalle temporel et Intervalle de distance seront agrégés. Lorsque vous effectuez l'agrégation dans un quadrillage, cette distance sert de hauteur pour construire les polygones hexagonaux.

Si une valeur est indiquée pour le paramètre Cube modèle, ce paramètre est inactif et la valeur d’intervalle de distance repose sur la valeur Cube modèle.

Linear Unit
Champs de récapitulation

Champ numérique contenant les valeurs attributaires qui permettent de calculer les statistiques indiquées lors de l’agrégation dans un cube spatio-temporel. Vous pouvez spécifier plusieurs combinaisons de statistiques et de champs. Les valeurs nulles présentes dans les champs spécifiés entraînent la suppression de ces entités du cube en sortie. Si des valeurs nulles figurent dans les entités en entrée, il est recommandé d’exécuter l’outil Remplacer les valeurs manquantes avant de créer un cube spatio-temporel.

Les types de statistiques disponibles sont les suivants :

  • SUM — La valeur totale du champ spécifié au sein de chaque groupe est calculée.
  • MEAN - La moyenne du champ spécifié au sein de chaque groupe est calculée.
  • MIN - La valeur la plus faible parmi tous les enregistrements du champ spécifié au sein de chaque groupe est identifiée.
  • MAX - La valeur la plus élevée parmi tous les enregistrements du champ spécifié au sein de chaque groupe est identifiée.
  • STD — L’écart type des valeurs du champ spécifié au sein de chaque groupe est calculé.
  • MEDIAN - La valeur centrale triée de tous les enregistrements du champ spécifié au sein de chaque groupe est identifiée.

Les types de remplissage disponibles sont les suivants :

  • ZEROS - Les groupes vides sont remplis avec des zéros.
  • SPATIAL_NEIGHBORS - Les groupes vides sont remplis avec la valeur moyenne des voisins spatiaux.
  • SPACE_TIME_NEIGHBORS — Les groupes vides sont remplacés par la valeur moyenne des voisins spatio-temporels.
  • TEMPORAL_TREND - Les groupes vides sont remplis à l’aide d’un algorithme de spline univariée interpolée.

Remarque :

Les valeurs nulles présentes dans les enregistrements des champs de récapitulation entraînent l’exclusion de ces entités du cube en sortie. Si des valeurs nulles figurent dans la valeur de paramètre Entités en entrée, il est recommandé d’exécuter d’abord l’outil Remplacer les valeurs manquantes. Si, après l’exécution de l’outil Remplacer les valeurs manquantes, des valeurs nulles sont toujours présentes et que le total des points dans chaque groupe fait partie de votre stratégie d’analyse, vous pouvez créer des cubes distincts, un pour le total (sans une valeur de paramètre Champs de récapitulation) et un pour la valeur Champs de récapitulation. Si l’ensemble de valeurs nulles est différent pour chaque champ de récapitulation, vous pouvez également créer un cube distinct pour chaque champ de récapitulation.

Value Table
Type de forme d'agrégation
(Facultatif)

Spécifie la forme du maillage de polygones dans lequel les données ponctuelles des entités en entrée seront agrégées.

  • QuadrillageLes entités en entrée seront agrégées dans une grille de cellules carrées (quadrillage).
  • HexagoneLes entités en entrée seront agrégées dans une grille de cellules hexagonales.
  • Emplacements définisLes entités en entrée seront agrégées dans les emplacements fournis.
String
Emplacements surfaciques définis
(Facultatif)

Les entités surfaciques dans lesquelles les entités ponctuelles en entrée seront agrégées. Elles peuvent représenter les limites des comtés, les secteurs de police ou les secteurs de vente, par exemple.

Feature Layer
ID d'emplacement
(Facultatif)

Le champ numérique contenant le numéro d’identification de chaque localisation unique.

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})
NomExplicationType de données
in_features

Classe d’entités points en entrée à agréger en groupes spatio-temporels.

Feature Layer
output_cube

Cube de données netCDF en sortie qui sera créé pour contenir les totaux et les récapitulations des données de points des entités en entrée.

File
time_field

Champ contenant la date et l'heure (horodatage) de chaque point. Ce champ doit être de type date.

Field
template_cube
(Facultatif)

Cube spatio-temporel de référence qui permet de définir l’étendue du paramètre output_cube de l’analyse, les dimensions des groupes et l’alignement des groupes. Les valeurs des paramètres time_step_interval, distance_interval et reference_time sont également obtenues à partir du cube modèle. Ce cube modèle doit être un cube netCDF (fichier .nc) créé avec cet outil.

Un cube spatio-temporel créé par l’agrégation avec la valeur du paramètre DEFINED_LOCATIONS ne peut pas servir de cube modèle.

File
time_step_interval
(Facultatif)

Nombre de secondes, minutes, heures, jours, semaines ou années qui représenteront une seule phase. Tous les points avec les mêmes valeurs de paramètre time_step_interval et distance_interval seront agrégés.

Si une valeur est indiquée pour le paramètre template_cube, ce paramètre est ignoré et la valeur time_step_interval est obtenue à partir du cube modèle. Voici un exemple de valeurs valides pour ce paramètre : 1 semaine, 13 jours ou 1 mois.

Time Unit
time_step_alignment
(Facultatif)

Définit la manière dont l’agrégation est effectuée en fonction de la valeur du paramètre time_step_interval indiquée. Si la valeur du paramètre template_cube est fournie, l’alignement temporel associé à la valeur template_cube remplace ce paramètre et l’alignement de l’intervalle temporel de la valeur template_cube est utilisé.

  • END_TIMELes phases s’alignent sur le dernier événement temporel et s’agrègent dans le passé.
  • START_TIMELes phases s’alignent sur le premier événement temporel et s’agrègent dans le futur.
  • REFERENCE_TIMELes phases s’alignent sur une date/heure en particulier que vous spécifiez. Si la valeur d’horodatage de tous les points des entités en entrée est supérieure à la référence temporelle que vous avez spécifiée (ou si elle correspond exactement à l’heure de début des entités en entrée), l’intervalle temporel commence par cette référence temporelle et procède à une agrégation dans le futur (comme avec l’option START_TIME). Si la valeur d’horodatage de tous les points des entités en entrée est inférieure à la référence temporelle que vous avez spécifiée (ou si elle correspond exactement à l’heure de fin des entités en entrée), l’intervalle temporel se termine par cette référence temporelle et procède à une agrégation dans le passé (comme avec l’option END_TIME). Si la référence temporelle que vous indiquez se trouve au milieu de l’étendue temporelle des données, un intervalle temporel est créé, lequel se termine par la référence temporelle que vous indiquez (comme avec l’option END_TIME). Des intervalles supplémentaires seront créés avant et après la référence temporelle jusqu’à ce que l’étendue temporelle complète des données soit couverte.
String
reference_time
(Facultatif)

Date et heure à utiliser pour aligner les intervalles temporels. Si vous souhaitez regrouper les données de façon hebdomadaire du lundi au dimanche, par exemple, définissez l’heure de référence du dimanche à minuit pour garantir la séparation des groupes entre le dimanche et le lundi à minuit.

Lorsque la valeur du paramètre template_cube est fournie, ce paramètre est ignoré et la référence temporelle repose sur la valeur template_cube.

Date
distance_interval
(Facultatif)

Taille des groupes utilisés pour agréger la valeur du paramètre in_features. Tous les points qui se trouvent au sein des mêmes valeurs de paramètre distance_interval et time_step_interval seront agrégés. Lorsque vous effectuez l'agrégation dans un quadrillage, cette distance sert de hauteur pour construire les polygones hexagonaux.

Si une valeur de paramètre template_cube est fournie, ce paramètre est ignoré et la valeur d’intervalle de distance repose sur la valeur template_cube.

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

Champ numérique contenant les valeurs attributaires qui permettent de calculer les statistiques indiquées lors de l’agrégation dans un cube spatio-temporel. Vous pouvez spécifier plusieurs combinaisons de statistiques et de champs. Les valeurs nulles présentes dans les champs spécifiés entraînent la suppression de ces entités du cube en sortie. Si des valeurs nulles figurent dans les entités en entrée, il est recommandé d’exécuter l’outil Remplacer les valeurs manquantes avant de créer un cube spatio-temporel.

Les types de statistiques disponibles sont les suivants :

  • SUM — La valeur totale du champ spécifié au sein de chaque groupe est calculée.
  • MEAN - La moyenne du champ spécifié au sein de chaque groupe est calculée.
  • MIN - La valeur la plus faible parmi tous les enregistrements du champ spécifié au sein de chaque groupe est identifiée.
  • MAX - La valeur la plus élevée parmi tous les enregistrements du champ spécifié au sein de chaque groupe est identifiée.
  • STD — L’écart type des valeurs du champ spécifié au sein de chaque groupe est calculé.
  • MEDIAN - La valeur centrale triée de tous les enregistrements du champ spécifié au sein de chaque groupe est identifiée.

Les types de remplissage disponibles sont les suivants :

  • ZEROS - Les groupes vides sont remplis avec des zéros.
  • SPATIAL_NEIGHBORS - Les groupes vides sont remplis avec la valeur moyenne des voisins spatiaux.
  • SPACE_TIME_NEIGHBORS — Les groupes vides sont remplacés par la valeur moyenne des voisins spatio-temporels.
  • TEMPORAL_TREND - Les groupes vides sont remplis à l’aide d’un algorithme de spline univariée interpolée.

Remarque :

Les valeurs nulles présentes dans les enregistrements des champs de récapitulation entraînent l’exclusion de ces entités du cube en sortie. Si des valeurs nulles figurent dans la valeur de paramètre Entités en entrée, il est recommandé d’exécuter d’abord l’outil Remplacer les valeurs manquantes. Si, après l’exécution de l’outil Remplacer les valeurs manquantes, des valeurs nulles sont toujours présentes et que le total des points dans chaque groupe fait partie de votre stratégie d’analyse, vous pouvez créer des cubes distincts, un pour le total (sans une valeur de paramètre Champs de récapitulation) et un pour la valeur Champs de récapitulation. Si l’ensemble de valeurs nulles est différent pour chaque champ de récapitulation, vous pouvez également créer un cube distinct pour chaque champ de récapitulation.

Value Table
aggregation_shape_type
(Facultatif)

Spécifie la forme du maillage de polygones dans lequel les données ponctuelles des entités en entrée seront agrégées.

  • FISHNET_GRIDLes entités en entrée seront agrégées dans une grille de cellules carrées (quadrillage).
  • HEXAGON_GRIDLes entités en entrée seront agrégées dans une grille de cellules hexagonales.
  • DEFINED_LOCATIONSLes entités en entrée seront agrégées dans les emplacements fournis.
String
defined_polygon_locations
(Facultatif)

Les entités surfaciques dans lesquelles les entités ponctuelles en entrée seront agrégées. Elles peuvent représenter les limites des comtés, les secteurs de police ou les secteurs de vente, par exemple.

Feature Layer
location_id
(Facultatif)

Le champ numérique contenant le numéro d’identification de chaque localisation unique.

Field

Exemple de code

Exemple 1 de la fonction CreateSpaceTimeCube (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction 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")
Exemple 2 d'utilisation de l'outil CreateSpaceTimeCube (script autonome)

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

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

# Import system modules
import arcpy

# Set arcpy to overwrite existing output by default
arcpy.env.overwriteOutput = True

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

# 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")

Environnements

Cas particuliers

Système de coordonnées en sortie

La référence spatiale associée au cube de modèle, s'il est spécifié, remplace le paramètre d'environnement Système de coordonnées en sortie.

Étendue

L'étendue de traitement du cube de modèle, s'il est spécifié, remplace l'étendue de traitement du paramètre d'environnement.