Remplacer les valeurs manquantes (Exploration des modèles spatio-temporels)

Synthèse

Remplace les valeurs manquantes (nulles) par des valeurs estimées en fonction de voisins spatiaux, de voisins spatio-temporels, de valeurs chronologiques ou de valeurs statistiques globales.

Pour en savoir plus sur le fonctionnement de l’outil Remplacer les valeurs manquantes

Illustration

Illustration de l’outil Remplacer les valeurs manquantes

Utilisation

  • La valeur du paramètre Input Features or Table (Table ou entités en entrée) peut désigner des entités ponctuelles ou surfaciques, ou une table autonome.

  • Dans le cas d’une entité en entrée, les valeurs manquantes peuvent être estimées à l’aide de voisins spatiaux, de voisins spatio-temporels ou de valeurs chronologiques. Les valeurs manquantes peuvent se trouver dans les entités en entrée ou dans une table associée. Dans le cas de tables autonomes, les valeurs manquantes peuvent être estimées à l’aide de statistiques globales du champ en entrée ou de valeurs chronologiques. Puisque les tables autonomes ne comportent aucune information spatiale, il n’est pas possible de définir des voisins spatiaux pour les tables.

  • La sortie comporte trois champs pour chaque champ du paramètre Fields to Fill (Champs à remplir). Le premier contient à la fois les valeurs d’origine et renseignées, et le deuxième comporte un indicateur spécifiant que la valeur a été estimée. Le champ estimé conserve son nom d’origine, mais des alias de champ sont créés avec la convention d’affectation de noms suivante : <field>_FILLED et <field>_ESTIMATED. Pour les entités en entrée, le troisième champ correspond au nombre de voisins, <field>_ N_NEIGHBORS, utilisé dans les calculs de chaque valeur estimée. Pour les tables autonomes, le troisième champ indique le nombre d’enregistrements, <field>_NUM_REC_USED, utilisé dans les calculs de chaque valeur estimée.

  • Pour les entités en entrée, la sortie inclut également des champs contenant des valeurs susceptibles de vous aider à comprendre la plage des valeurs voisines et le nombre de voisins utilisés dans les calculs de la valeur manquante cible. Si le paramètre Fill Method (Méthode de remplissage) est défini sur Average (Moyenne), l’écart type (<field>_STD) des voisins utilisés dans les calculs est indiqué. La valeur voisine maximale (<field>_MAX) est indiquée pour l’option Maximum et la valeur voisine minimale (<field>_MIN) pour l’option Minimum. Si le paramètre Fill Method (Méthode de remplissage) est défini sur Median (Médiane), l’écart absolu moyen (<field>_MAD) des voisins est indiqué. Si des valeurs manquantes sont renseignées à l’aide de l’option Temporal Trend (Tendance temporelle), le champ <field>_RES contient la somme des valeurs résiduelles au carré de la spline. Le champ NNBRS indique le nombre de voisins utilisés pour calculer les valeurs estimées.

  • Pour les tables autonomes, la sortie inclut des champs contenant des valeurs susceptibles de vous aider à comprendre les statistiques et la plage des valeurs non nulles du champ utilisé dans les calculs de la valeur manquante cible. Si le paramètre Fill Method (Méthode de remplissage) est défini sur Average (Moyenne), l’écart type (<field>_STD) de toutes les valeurs non nulles du champ utilisé dans les calculs est indiqué. La valeur maximale (<field>_MAX) du champ en entrée est indiquée pour l’option Maximum et la valeur minimale (<field>_MIN) pour l’option Minimum. Si le paramètre Fill Method (Méthode de remplissage) est défini sur Median (Médiane), l’écart absolu moyen (<field>_MAD) des valeurs non nulles est indiqué. Si des valeurs manquantes sont renseignées à l’aide de l’option Temporal Trend (Tendance temporelle), le champ <field>_RES contient la somme des valeurs résiduelles au carré de la spline.

  • Vous pouvez inclure des champs qui ne contiennent pas de valeurs Null. Ces champs sont copiés dans la sortie, mais aucun champ supplémentaire ne leur est associé (comme <field>_FILLED ou <field>_ESTIMATED). Vous pouvez également fournir une valeur pour le paramètre Unique ID (ID unique). Elle est ajoutée à la sortie et permet de réintégrer les résultats dans les entités ou la table en entrée.

  • Le champ NUM_EST (TOT_EST si vous utilisez une table associée) correspond au nombre total de variables estimées pour l’enregistrement associé. Ce champ permet de rendre la carte en sortie.

  • Vous pouvez ajouter les champs supplémentaires à l’entité ou à la table en entrée à l’aide du paramètre Append Fields To Input (Ajouter les champs à l’entrée). Si vous ajoutez ces champs, il n’est pas possible d’indiquer une table associée.

  • Pour les entités en entrée, le paramètre Location ID (ID de localisation) peut être utilisé de différentes manières en fonction de la structure des données spatio-temporelles en entrée.

    • Si les données sont stockées dans une table associée (c’est-à-dire si vous disposez d’un jeu d’entités dans une classe d’entités avec une table associée contenant des attributs qui évoluent au fil du temps) et que vous souhaitez remplacer les valeurs manquantes dans la table associée, vous pouvez utiliser le paramètre Related Table (Table associée). La valeur du paramètre Location ID (ID de localisation) fait correspondre chaque entité de la classe d’entités en entrée à un ensemble d’enregistrements dans la table associée et doit être unique pour chaque entité en entrée.
    • Si les données sont stockées dans la même classe d’entités (c’est-à-dire, par la répétition des formes ou de la géométrie), le paramètre Location ID (ID de localisation) indique chaque localisation unique dans la classe d’entités. Par exemple, si vous disposez des données de population des comtés américains sur 10 ans, chaque comté sera répété 10 fois dans la classe d’entités et l’ID de comté sera utilisé pour spécifier la localisation unique de chaque comté. L’ID de localisation doit être unique pour chaque localisation, mais pas nécessairement pour chaque entité.

  • La valeur Location ID (ID de localisation) correspond à un champ de type entier ou texte et doit représenter une localisation unique et fixe. Ses coordonnées x,y ne doivent pas évoluer au fil du temps.

  • Cet outil peut être utilisé avec des données de panel stockées en tant que formes répétées ou avec une table associée. Si une valeur est fournie pour le paramètre Location ID (ID de localisation), l’outil reconnaît que l’entrée correspond à des données de panel et le paramètre Time Field (Champ temporel) est requis.

  • Dans le cas des tables autonomes, si une valeur est indiquée pour le paramètre Location ID (ID de localisation) et qu’aucune valeur n’est fournie pour le paramètre Time Field (Champ temporel), les valeurs estimées sont calculées à l’aide des enregistrements possédant le même ID de localisation que la localisation comportant la valeur nulle remplacée. Par exemple, si vous disposez de données au niveau des comtés américains et que vous souhaitez remplacer les valeurs manquantes à l’aide de la moyenne de tous les comtés du même État, vous pouvez utiliser un champ qui représente l’État pour l’ID de localisation.

  • Si les valeurs des deux paramètres Location ID (ID de localisation) et Time Field (Champ temporel) sont des tables autonomes en entrée, seule l’option Temporal Trend (Tendance temporelle) du paramètre Fill Method (Méthodede remplissage) est disponible.

  • Si l’option Fixed distance (Distance fixe), Contiguity edges only (Segments de contiguïté uniquement) ou Contiguity edges corners (Angles des segments de contiguïté) est sélectionnée pour le paramètre Conceptualization of Spatial Relationships (Conceptualisation des relations spatiales), il est possible de simuler une fenêtre spatio-temporelle en choisissant une valeur pour les paramètres Distance Band (Bande de distance) et Temporal Neighborhood (Voisinage temporel).

  • Si l’option Fixed distance (Distance fixe), Contiguity edges only (Segments de contiguïté uniquement) ou Contiguity edges corners (Angles des segments de contiguïté) est sélectionnée pour le paramètre Conceptualization of Spatial Relationships (Conceptualisation des relations spatiales), vous pouvez définir une valeur pour le paramètre Number of Spatial Neighbors (Nombre de voisins spatiaux) pour spécifier un nombre minimal de voisins.

  • L’option Temporal Trend (Tendance temporelle) du paramètre Fill Method (Méthode de remplissage) est disponible uniquement si des valeurs ont été définies pour les paramètres Location ID (ID de localisation) et Time Field (Champ temporel).

  • Lorsque vous utilisez l’option Temporal Trend (Tendance temporelle) pour renseigner les valeurs, la localisation qui correspond à une valeur nulle remplacée doit comporter au moins deux périodes avec des valeurs au début et au moins deux périodes avec des valeurs à la fin de la chronologie à remplir. En raison de cette exigence, les valeurs nulles présentes dans les deux premières ou dernières phases ne peuvent pas être remplacées à l’aide de l’option Temporal Trend (Tendance temporelle).

  • L’option Temporal Trend (Tendance temporelle) utilise la méthode de spline univariée interpolée du paquetage d’interpolation de SciPy.

  • Lors du remplacement des valeurs manquantes de données de panel avec des voisins spatiaux, le paramètre Temporal Neighborhood (Voisinage temporel) doit être défini sur 0.

  • Si les données sont des données de panel, vous pouvez utiliser le paramètre Temporal Neighborhood (Voisinage temporel) pour effectuer un filtrage selon le temps. De même, un paramètre Temporal Neighborhood (Voisinage temporel) défini sur la valeur 0 vous permet d’examiner les voisins spatiaux uniquement.

  • Il est important d’inspecter les valeurs renseignées obtenues pour vous assurer qu’elles conviennent à l’analyse. Par exemple, si le champ d’origine était un entier et que l’outil a été configuré de façon à effectuer le remplissage avec la moyenne des voisins spatiaux, des nombres décimaux figureront dans les résultats, ce qui risque de ne pas être logique si le champ en entrée était un total. En outre, selon la méthode utilisée pour le paramètre Temporal Trend (Tendance temporelle), le résultat risque d’être négatif même si aucune des valeurs existantes n’était négative. Ceci n'aurait aucun sens si le champ que vous remplissez concerne la population.

  • Le champ N_NEIGHBORS indique le nombre de voisins inclus dans les calculs pour cette entité. Si le paramètre Fill Method (Méthode de remplissage) est défini sur Temporal Trend (Tendance temporelle), ce nombre correspond au nombre de valeurs qui existent dans la série chronologie pour cette valeur de Location ID (ID de localisation) (par exemple, si une seule valeur était manquante dans la chronologie, il indiquerait le nombre d’intervalles temporels du jeu de données moins un). Si vous définissez le paramètre Conceptualization of Spatial Relationships (Conceptualisation des relations spatiales) sur la valeur K nearest neighbors (K voisins les plus proches) et que vous indiquez une valeur pour Temporal Neighborhood (Voisinage temporel), le nombre de voisins indiqués comprend les k voisins de l’entité situés dans la fenêtre horaire spécifiée.

  • Le paramètre Null Value (Valeur nulle) représente les valeurs nulles (manquantes). Ce paramètre est utilisé de différentes manières en fonction des formats en entrée et en sortie.

    • Pour les classes d’entités ou les tables de géodatabase, <Null> est considérée comme la valeur nulle (valeur manquante) si aucune valeur n’est indiquée pour le paramètre Null Value (Valeur nulle). Si une valeur est fournie, cette valeur et les valeurs <Null> sont estimées dans la sortie de l’outil.
    • Dans le cas des shapefiles et des tables dBASE, le paramètre Null Value (Valeur nulle) est requis. Vous devez indiquer une valeur qui représente les valeurs nulles ou manquantes dans les donnés en entrée (par exemple, -9999).
    • Si l’entrée est une classe d’entités ou une table de géodatabase fichier et que la sortie est un shapefile ou une table dBASE, ce paramètre est requis pour indiquer la manière dont les valeurs manquantes ne pouvant pas être estimées sont représentées dans la sortie de l’outil.

  • Les valeurs manquantes qui ne peuvent pas être estimées et remplacées sont signalées dans la sortie au format des valeurs nulles existantes d’origine ou tel qu’indiqué dans le paramètre Null Value (Valeur nulle).

  • Des messages décrivant les détails de l’analyse et les caractéristiques des champs renseignés sont écrits au bas de la fenêtre Geoprocessing (Géotraitement) pendant l’exécution de l’outil. Pour accéder aux messages, placez le pointeur de la souris sur la barre de progression et cliquez sur le bouton contextuel Pop-out (Fenêtre contextuelle) ou développez la section des messages dans la fenêtre Geoprocessing (Géotraitement). Vous pouvez également accéder aux messages d’une précédente exécution de l’outil Remplacer les valeurs manquantes via l’historique du géotraitement.

Paramètres

ÉtiquetteExplicationType de données
Input Features or Table (Table ou entités en entrée)

Classe d’entités ponctuelles ou surfaciques ou table autonome contenant les valeurs nulles à remplacer.

Si une valeur est indiquée pour le paramètre Related Table (Table associée), les valeurs nulles à remplacer figurent dans la table associée. Les entités en entrée sont appariées aux lignes de la table associée pour indiquer le voisinage spatio-temporel.

Table View
Output Features or Table (Table ou entités en sortie)
(Facultatif)

Entités ou table autonome en sortie qui contient les valeurs renseignées (estimées).

Si une valeur est indiquée pour le paramètre Related Table (Table associée), la sortie de ce paramètre contient le nombre de valeurs estimées à chaque localisation et la valeur du paramètre Output Table (Table en sortie) correspond aux valeurs renseignées (estimées).

Feature Class; Table
Champs à remplir

Les champs numériques contenant les données manquantes (valeurs Null).

Field
Méthode de remplissage

Spécifie le type de calcul appliqué. L’option Temporal Trend (Tendance temporelle) est disponible uniquement si des valeurs sont fournies pour les paramètres Location ID (ID de localisation) et Time Field (Champ temporel).

  • MoyenneLes valeurs nulles sont remplacées par la valeur moyenne des voisins de l’entité ou par la valeur moyenne du champ à renseigner pour les tables autonomes.
  • MinimumLes valeurs nulles sont remplacées par la valeur minimale (la plus faible) des voisins de l’entité ou par la valeur minimale du champ à renseigner pour les tables autonomes.
  • MaximumLes valeurs nulles sont remplacées par la valeur maximale (la plus élevée) des voisins de l’entité ou par la valeur maximale du champ à renseigner pour les tables autonomes.
  • MédianeLes valeurs nulles sont remplacées par la médiane (valeur du milieu triée) des voisins de l’entité ou par la valeur médiane du champ à renseigner pour les tables autonomes.
  • Tendance temporelleLes valeurs nulles sont remplacées en fonction de la tendance à cette localisation unique.
String
Conceptualisation de relations spatiales
(Facultatif)

Indique comment les relations spatiales sont définies parmi les entités.

  • Distance fixeLes entités voisines dans un rayon critique spécifié (valeur du paramètre Distance Band (Bande de distance)) de chaque entité sont comprises dans les calculs. Tout ce qui se trouve hors de la distance critique est exclu.
  • K voisins les plus prochesLes k entités les plus proches sont comprises dans les calculs, k étant un paramètre numérique spécifié.
  • Tronçons de contiguïté uniquementSeules les entités surfaciques voisines qui partagent une limite ou se chevauchent influencent les calculs de l'entité surfacique cible.
  • Angles des tronçons de contiguïtéLes entités surfaciques voisines qui partagent une limite, un nœud, ou qui se chevauchent influencent les calculs de l'entité surfacique cible.
  • Extraire les pondérations spatiales à partir du fichierLes relations spatiales sont définies par un fichier de pondérations spatiales spécifié. Le chemin d'accès au fichier de pondérations spatiales est donné par le paramètre Fichier de matrice des pondérations.
String
Canal de distance
(Facultatif)

Distance limite pour l’option Fixed distance (Distance fixe) du paramètre Conceptualization of Spatial Relationships (Conceptualisation de relations spatiales). Les entités situées hors de la limite spécifiée pour une entité cible sont ignorées dans les calculs concernant cette entité. Ce paramètre n’est pas disponible pour les options Contiguity edges only (Segments de contiguïté uniquement) et Contiguity edges corners (Angles des segments de contiguïté).

Linear Unit
Voisinage temporel
(Facultatif)

Intervalle précédent et suivant dans le temps qui indique les entités à utiliser dans les calculs concernant l’entité cible. Les entités qui ne figurent pas dans cet intervalle de l’entité cible sont ignorées dans les calculs concernant cette entité.

Time Unit
Time Field (Champ temporel)
(Facultatif)

Le champ contenant l'horodatage pour chaque enregistrement du jeu de données. Ce champ doit être de type Date.

Dans le cas d’une entité en entrée, le champ temporel définit les voisins temporels lors du remplacement des valeurs manquantes. Une valeur doit être indiquée si une table associée est fournie.

Dans le cas d’une entité et d’une table en entrée, le champ temporel est utilisé lors du remplacement des valeurs manquantes à l’aide de la tendance temporelle à la localisation.

Field
Nombre de voisins spatiaux
(Facultatif)

Nombre de voisins les plus proches à inclure dans les calculs.

Si l’option Fixed distance (Distance fixe), Contiguity edges only (Segments de contiguïté uniquement) ou Contiguity edges corners (Angles des segments de contiguïté) est sélectionnée pour le paramètre Conceptualization of Spatial Relationships (Conceptualisation de relations spatiales), ce nombre correspond au nombre minimal de voisins à inclure dans les calculs.

Long
ID d'emplacement
(Facultatif)

Champ de type entier ou texte contenant un ID unique pour chaque localisation.

Si une table associée est fournie, ce champ est utilisé pour faire correspondre chaque entité en entrée aux lignes de la table associée. Les valeurs de ce champ doivent être uniques pour chaque entité en entrée. Si aucune table associée n’est indiquée, ce champ est utilisé pour spécifier chaque localisation unique dans les entités en entrée afin de déterminer les voisins temporels. Dans ce cas, les valeurs de ce champ doivent être uniques pour chaque localisation, mais pas nécessairement pour chaque entité (car plusieurs entités peuvent avoir la même localisation).

Field
Table associée
(Facultatif)

Table ou vue tabulaire contenant les données temporelles de chaque entité du paramètre Input Features or Table (Table ou entités en entrée).

Table View
ID d'emplacement associé
(Facultatif)

Champ de type entier ou texte dans le paramètre Related Table (Table associée) qui contient la valeur du paramètre Location ID (ID de localisation) sur laquelle la relation est basée.

Field
Spatial Weights Matrix File (Fichier de matrice de pondérations spatiales)
(Facultatif)

Chemin d'accès à un fichier contenant des pondérations qui définissent les relations spatiales, et potentiellement les relations temporelles, entre des entités.

File
ID unique
(Facultatif)

Champ de type entier contenant une valeur différente pour chaque enregistrement dans la valeur du paramètre Input Features or Table (Table ou entités en entrée). Ce champ peut servir à réintégrer les résultats dans le jeu de données d’origine.

Si vous n’avez pas de champ Unique ID, vous pouvez en créer un en ajoutant un champ de type entier à la table attributaire de l’entité en entrée, puis en calculant les valeurs de champ égales au champ FID ou OBJECTID.

Field
Valeur nulle
(Facultatif)

La valeur qui représente les valeurs Null (manquantes). Si aucune valeur n’est fournie, <Null> est utilisé par défaut pour les classes d’entités et les tables de géodatabase. Si une valeur est indiquée, cette valeur et toutes les valeurs <Null> sont renseignées. Si l’entrée ou la sortie est un shapefile ou une table dBASE, une valeur numérique de l’emplacement réservé nul est requise.

Double
Table en sortie
(Facultatif)

La table en sortie contenant les valeurs remplies (estimées).

La table en sortie est requise si une table associée est indiquée.

Table
Append Fields to Input Data (Ajouter les champs aux données en entrée)
(Facultatif)

Indique si les champs des valeurs renseignées sont ajoutés aux données en entrée ou si une classe d’entités ou une table en sortie est créée avec les champs des valeurs renseignées. Si vous ajoutez les champs, vous ne pouvez pas indiquer de table associée et l’environnement du système de coordonnées en sortie est ignoré.

  • Activé – Les champs comprenant les valeurs renseignées sont ajoutés aux données en entrée. Cette option modifie les données en entrée.
  • Désactivé – Une classe d’entités ou une table en sortie contenant les champs des valeurs renseignées est créée. Il s’agit de l’option par défaut.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Updated Input Features or Table (Table ou entités en entrée mises à jour)

Tables ou entités en entrée mises à jour contenant les champs des valeurs renseignées.

Table View

arcpy.stpm.FillMissingValues(in_features, {out_features}, fields_to_fill, fill_method, {conceptualization_of_spatial_relationships}, {distance_band}, {temporal_neighborhood}, {time_field}, {number_of_spatial_neighbors}, {location_id}, {related_table}, {related_location_id}, {weights_matrix_file}, {unique_id}, {null_value}, {out_table}, {append_to_input})
NomExplicationType de données
in_features

Classe d’entités ponctuelles ou surfaciques ou table autonome contenant les valeurs nulles à remplacer.

Si une valeur est indiquée pour le paramètre related_table, les valeurs nulles à remplacer figurent dans la table associée. Les entités en entrée sont appariées aux lignes de la table associée pour indiquer le voisinage spatio-temporel.

Table View
out_features
(Facultatif)

Entités ou table autonome en sortie qui contient les valeurs renseignées (estimées).

Si une valeur est indiquée pour le paramètre related_table, la sortie de ce paramètre contient le nombre de valeurs estimées à chaque localisation et la valeur du paramètre out_table correspond aux valeurs renseignées (estimées).

Feature Class; Table
fields_to_fill
[fields_to_fill,...]

Les champs numériques contenant les données manquantes (valeurs Null).

Field
fill_method

Spécifie le type de calcul appliqué. L’option TEMPORAL_TREND est disponible uniquement si des valeurs sont fournies pour les paramètres location_id et time_field.

  • AVERAGELes valeurs nulles sont remplacées par la valeur moyenne des voisins de l’entité.
  • MINIMUMLes valeurs nulles sont remplacées par la valeur minimale (la plus faible) des voisins de l’entité.
  • MAXIMUMLes valeurs nulles sont remplacées par la valeur maximale (la plus élevée) des voisins de l’entité.
  • MEDIANLes valeurs nulles sont remplacées par la médiane (valeur du milieu triée) des voisins de l’entité.
  • TEMPORAL_TRENDLes valeurs nulles sont remplacées en fonction de la tendance à cette localisation unique.
String
conceptualization_of_spatial_relationships
(Facultatif)

Indique comment les relations spatiales sont définies parmi les entités.

  • FIXED_DISTANCELes entités voisines dans un rayon critique spécifié (valeur du paramètre distance_band) de chaque entité sont comprises dans les calculs. Tout ce qui se trouve hors de la distance critique est exclu.
  • K_NEAREST_NEIGHBORSLes k entités les plus proches sont comprises dans les calculs, k étant un paramètre numérique spécifié.
  • CONTIGUITY_EDGES_ONLYSeules les entités surfaciques voisines qui partagent une limite ou se chevauchent influencent les calculs de l'entité surfacique cible.
  • CONTIGUITY_EDGES_CORNERSLes entités surfaciques voisines qui partagent une limite, un nœud, ou qui se chevauchent influencent les calculs de l'entité surfacique cible.
  • GET_SPATIAL_WEIGHTS_FROM_FILELes relations spatiales sont définies par un fichier de pondérations spatiales spécifié. Le chemin d’accès au fichier de pondérations spatiales est indiqué par le paramètre Weights_Matrix_File.
String
distance_band
(Facultatif)

Distance limite pour l’option FIXED_DISTANCE du paramètre conceptualization_of_spatial_relationships. Les entités situées hors de la limite spécifiée pour une entité cible sont ignorées dans les calculs concernant cette entité. Ce paramètre n’est pas disponible pour les options CONTIGUITY_EDGES_ONLY et CONTIGUITY_EDGES_CORNERS.

Linear Unit
temporal_neighborhood
(Facultatif)

Intervalle précédent et suivant dans le temps qui indique les entités à utiliser dans les calculs concernant l’entité cible. Les entités qui ne figurent pas dans cet intervalle de l’entité cible sont ignorées dans les calculs concernant cette entité.

Time Unit
time_field
(Facultatif)

Le champ contenant l'horodatage pour chaque enregistrement du jeu de données. Ce champ doit être de type Date.

Dans le cas d’une entité en entrée, le champ temporel définit les voisins temporels lors du remplacement des valeurs manquantes. Une valeur doit être indiquée si une table associée est fournie.

Dans le cas d’une entité et d’une table en entrée, le champ temporel est utilisé lors du remplacement des valeurs manquantes à l’aide de la tendance temporelle à la localisation.

Field
number_of_spatial_neighbors
(Facultatif)

Nombre de voisins les plus proches à inclure dans les calculs.

Si l’option FIXED_DISTANCE, CONTIGUITY_EDGES_ONLY ou CONTIGUITY_EDGES_CORNERS est sélectionnée pour le paramètre conceptualization_of_spatial_relationships, ce nombre correspond au nombre minimal de voisins à inclure dans les calculs.

Long
location_id
(Facultatif)

Champ de type entier ou texte contenant un ID unique pour chaque localisation.

Si une table associée est fournie, ce champ est utilisé pour faire correspondre chaque entité en entrée aux lignes de la table associée. Les valeurs de ce champ doivent être uniques pour chaque entité en entrée. Si aucune table associée n’est indiquée, ce champ est utilisé pour spécifier chaque localisation unique dans les entités en entrée afin de déterminer les voisins temporels. Dans ce cas, les valeurs de ce champ doivent être uniques pour chaque localisation, mais pas nécessairement pour chaque entité (car plusieurs entités peuvent avoir la même localisation).

Field
related_table
(Facultatif)

Table ou vue tabulaire contenant les données temporelles de chaque entité du paramètre in_features.

Table View
related_location_id
(Facultatif)

Champ de type entier ou texte dans le paramètre related_table qui contient la valeur du paramètre location_id sur laquelle la relation est basée.

Field
weights_matrix_file
(Facultatif)

Chemin d'accès à un fichier contenant des pondérations qui définissent les relations spatiales, et potentiellement les relations temporelles, entre des entités.

File
unique_id
(Facultatif)

Champ de type entier contenant une valeur différente pour chaque enregistrement dans la valeur du paramètre in_features. Ce champ peut servir à réintégrer les résultats dans le jeu de données d’origine.

Si vous n’avez pas de champ unique_id, vous pouvez en créer un en ajoutant un champ de type entier à la table de la classe d’entités, puis en calculant les valeurs de champ égales au champ FID ou OBJECTID.

Field
null_value
(Facultatif)

La valeur qui représente les valeurs Null (manquantes). Si aucune valeur n’est fournie, <Null> est utilisé par défaut pour les classes d’entités et les tables de géodatabase. Si une valeur est indiquée, cette valeur et toutes les valeurs <Null> sont renseignées. Si l’entrée ou la sortie est un shapefile ou une table dBASE, une valeur numérique de l’emplacement réservé nul est requise.

Double
out_table
(Facultatif)

La table en sortie contenant les valeurs remplies (estimées).

La table en sortie est requise si une table associée est indiquée.

Table
append_to_input
(Facultatif)

Indique si les champs des valeurs renseignées sont ajoutés aux données en entrée ou si une classe d’entités ou une table en sortie est créée avec les champs des valeurs renseignées. Si vous ajoutez les champs, vous ne pouvez pas indiquer de table associée et l’environnement du système de coordonnées en sortie est ignoré.

  • APPEND_TO_INPUTLes champs comprenant les valeurs renseignées sont ajoutés aux données en entrée. Cette option modifie les données en entrée.
  • NEW_FEATURESUne classe d’entités ou une table -en sortie contenant les champs des valeurs renseignées est créée. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
updated_features

Tables ou entités en entrée mises à jour contenant les champs des valeurs renseignées.

Table View

Exemple de code

Exemple 1 d'utilisation de l'outil FillMissingValues (fenêtre Python)

Le script de fenêtre Python suivant illustre l’utilisation de la fonction FillMissingValues.

import arcpy
arcpy.env.workspace = r"C:\STPM\Chicago.gdb"
arcpy.stpm.FillMissingValues("Chicago_Data", "Chicago_Filled", "COUNT", "AVERAGE",
                             "K_NEAREST_NEIGHBORS", "", "", "", 8)
Exemple 2 d'utilisation de l'outil FillMissingValues (script autonome)

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

# Fill missing values using a feature set and related table
# Use the results to create a space-time cube from defined locations
# Run Emerging Hot Spot Analysis on the data
# Visualize the results in 3d

# Import system modules
import arcpy

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

# Local variables ...
arcpy.env.workspace = r"C:\STPM\Chicago.gdb"

try:
    # Fill missing values in a feature class containing block group polygon 
    # shapes and a related table containing the incidents. Since some of the 
    # values are missing, you will fill them using the temporal trend method.
    arcpy.stpm.FillMissingValues(
            "Chicago_Feature", "Chicago_FilledFeature", "COUNT", 
            "TEMPORAL_TREND", "", "", NoneNone, "TIME", "", "MYID", 
            "Chicago_Table", "MYID", "", "", "", "Chicago_FilledTable")

    # Create a defined location space-time cube using a related table. Using a 
    # reference time at the start of the month to force binning fall on month 
    # breaks. Using temporal aggregation to sum multiple entries into one month.
    # Using the method drop location if missing values since you already filled 
    # using Fill Missing Values.
    arcpy.stpm.CreateSpaceTimeCubeDefinedLocations(
            "Chicago_FilledFeature", r"C:\STPM\Chicago_Cube.nc", "MYID",
            "APPLY_TEMPORAL_AGGREGATION", "TIME", "1 Months", "REFERENCE_TIME", 
            "10/1/2015", "", "COUNT SUM DROP_LOCATIONS", "Chicago_FilledTable",
            "MYID")

    # Run an emerging hot spot analysis on the defined locations cube. Using 
    # contiguity edges so only block groups that bound each other are considered 
    # neighbors.
    arcpy.stpm.EmergingHotSpotAnalysis(
            r"C:\STPM\Chicago_Cube.nc", "COUNT_SUM_NONE", 
            "Chicago_Cube_EmergingHotSpot", "", 1, "", "CONTIGUITY_EDGES_ONLY")

    # Use Visualize Cube in 3d to see the hot spot results for each time slice
    arcpy.stpm.VisualizeSpaceTimeCube3D(
            r"C:\STPM\Chicago_Cube.nc", "COUNT_SUM_NONE", 
            "HOT_AND_COLD_SPOT_RESULTS", "Chicago_Cube_Visualize3d")

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

Informations de licence

  • Basic: Oui
  • Standard: Oui
  • Advanced: Oui

Rubriques connexes