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

Synthèse

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

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

Illustration

Illustration de l’outil Remplir les valeurs manquantes

Utilisation

  • La valeur du paramètre Entités ou tables en entrée peut désigner une entité ponctuelle ou surfacique ou une table autonome.

  • Pour 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. Pour des tables autonomes, les valeurs manquantes peuvent être estimées à l’aide des statistiques globales du champ en entrée ou de valeurs chronologiques. Parce que les tables autonomes sont dépourvues d’informations spatiales, les voisins spatiaux ne peuvent pas être définis pour les tables.

  • La sortie contient trois champs pour chacun des champs du paramètre Champs à remplir. Le premier contient à la fois les valeurs d’origine et remplies et le second contient un indicateur mentionnant que la valeur a été estimée. Le champ estimé conserve son nom d’origine, mais des alias seront créés avec la convention d’appellation suivante : <field>_FILLED et <field>_ESTIMATED. Pour les entités en entrée, le troisième champ est le champ du nombre de voisins, <field>_ N_NEIGHBORS, utilisé dans les calculs de chaque valeur estimée. Pour les tables en entrée autonomes, le troisième champ est le champ du 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 comprend également des champs renfermant des valeurs pouvant vous aider à comprendre le nombre de voisins et la plage des valeurs voisines utilisés lors des calculs de la valeur manquante cible. Si le paramètre Méthode de remplissage est défini sur Moyenne, l’écart type (<field>_STD) des voisins utilisés dans les calculs est indiqué. La valeur voisine maximum (<field>_MAX) est indiquée pour l’option Maximum et la valeur voisine minimum (<field>_MIN) pour l’option Minimum. Si le paramètre Méthode de remplissage est défini sur Médiane, l’écart absolu moyen (<field>_MAD) des voisins est indiqué. Si des valeurs manquantes sont remplies à l’aide de l’option Tendance temporelle, le champ <field>_RES contiendra la somme des valeurs résiduelles au carré de la spline. Le champ NNBRS contient le nombre de voisins servant au calcul des valeurs estimées.

  • Pour les tables autonomes, la sortie comprend des champs renfermant des valeurs pouvant vous aider à comprendre les statistiques et la plage des valeurs autres que Null du champ utilisé lors des calculs de la valeur manquante cible. Si le paramètre Méthode de remplissage est défini sur Moyenne, l’écart type (<field>_STD) de toutes les valeurs autres que Null dans le champ utilisé lors du calcul est indiqué. La valeur maximum du champ en entrée (<field>_MAX) est indiquée pour l’option Maximum et la valeur minimum (<field>_MIN) pour l’option Minimum. Si le paramètre Méthode de remplissage est défini sur Médiane, l’écart absolu moyen (<field>_MAD) des valeurs autres que Null est indiqué. Si des valeurs manquantes sont remplies à l’aide de l’option Tendance temporelle, le champ <field>_RES contiendra 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é en sortie (par exemple, <field>_FILLED ou <field>_ESTIMATED). Vous pouvez également fournir une valeur pour le paramètre ID unique qui sera ajouté à la sortie et peut servir à réintégrer les résultats dans la table ou les entités 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 à la table ou à la classe d’entités en entrée à l’aide du paramètre Ajouter des champs à l’entrée. Si vous ajoutez ces champs, une table associée ne peut pas être fournie.

  • Pour les entités en entrée, le paramètre ID d’emplacement peut être utilisé de différentes manières selon 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 que vous disposez d’un ensemble d’entités dans une classe d’entités accompagnée d’une table associée contenant des attributs qui évoluent au fil du temps), vous pouvez utiliser le paramètre Table associée. La valeur du paramètre ID d’emplacement apparie chaque valeur dans 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 en répétant les formes ou la géométrie), le paramètre ID d’emplacement spécifie chaque emplacement unique dans la classe d’entités. Par exemple, si vous disposez des données sur la population américaine au niveau des comtés, chaque comté est répété dix fois dans la classe d’entités et l’ID de comté est utilisé pour spécifier l’emplacement de chaque comté unique. L’ID d’emplacement doit être unique pour chaque emplacement mais pas nécessairement pour chaque entité.

  • La valeur ID d’emplacement est un champ d’entier ou de texte et doit représenter un emplacement unique et stationnaire. Ses coordonnées x,y ne doivent pas évoluer au fil du temps.

  • Cet outil peut être utilisé avec des données de volet stockées en tant que formes répétées ou dans une table associée. Si une valeur est spécifiée pour le paramètre ID d’emplacement, l’outil reconnaît que l’entrée correspond à des données de panel et le paramètre Champ temporel est nécessaire.

  • Dans le cas des tables autonomes, si une valeur est fournie pour le paramètre Location ID (ID d’emplacement) mais aucune pour le paramètre Champ temporel, les valeurs estimées sont calculées à l’aide des enregistrements ayant le même ID d’emplacement que l’emplacement dont la valeur Null est renseignée. Par exemple, si vous disposez de données couvrant les comtés américains et souhaitez spécifier les valeurs manquantes à l’aide de la moyenne de tous les comtés figurant dans le même État, vous pouvez utiliser un champ représentant cet État en tant qu’ID d’emplacement.

  • Si les valeurs des paramètres ID d’emplacement et Champ temporel sont des tables autonomes en entrée, seule l’option Tendance temporelle du paramètre Méthode de remplissage est disponible.

  • Si l’option Distance fixe, Tronçons de contiguïté uniquement ou Angles des tronçons de contiguïté est choisie pour le paramètre Conceptualisation de relations spatiales, une fenêtre spatio-temporelle peut être simulée en sélectionnant une valeur pour les paramètres Canal de distance et Voisinage temporel.

  • Si l’option Distance fixe, Tronçons de contiguïté uniquement ou Angles des tronçons de contiguïté est choisie pour le paramètre Conceptualisation de relations spatiales, une valeur du paramètre Nombre de voisins spatiaux peut être définie pour spécifier un nombre minimum de voisins.

  • L’option Tendance temporelle du paramètre Méthode de remplissage n’est disponible que si des valeurs ont été définies pour les paramètres ID d’emplacement et Champ temporel.

  • Lorsque vous utilisez l’option Tendance temporelle pour remplir les valeurs, l’emplacement présentant une valeur Null en cours de remplissage doit comporter au moins deux périodes temporelles avec des valeurs au début et au moins deux périodes temporelles avec des valeurs à la fin de la série temporelle afin d’être renseigné. En raison de cette exigence, les valeurs Null présentes dans les deux premières ou dernières phases ne peuvent pas être remplies à l’aide de l’option Tendance temporelle.

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

  • Lors du remplissage des valeurs manquantes de données de panel avec des voisins spatiaux, définissez le paramètre Voisinage temporel sur 0

  • Si vos données sont des données de volet, le paramètre Voisinage temporel peut servir à filtrer par période temporelle. De même, une valeur Voisinage temporel égale à 0 vous permet d’examiner les voisins spatiaux uniquement.

  • Il est important d’inspecter les valeurs remplies obtenues pour s’assurer qu’elles conviennent à votre analyse. Par exemple, si votre champ d’origine est un entier et que l’outil a été configuré de façon à effectuer le remplissage avec la moyenne des voisins spatiaux, des décimales seront incluses dans les résultats, ce qui risque de ne pas être logique si votre champ en entrée est un total. En outre, selon la méthode utilisée avec le paramètre Tendance temporelle, il se peut que le résultat soit un nombre négatif même si aucune de vos valeurs existantes n’est 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 de cette entité. Si le paramètre Méthode de remplissage est défini sur Tendance temporelle, ce nombre désigne le nombre de valeurs existant dans la série chronologique pour cette valeur ID d’emplacement (lorsque, par exemple, une seule valeur manque dans la série chronologique, il signale le nombre d’intervalles temporels dans votre jeu de données moins un). Si vous utilisez une valeur du paramètre Conceptualisation de relations spatiales de K voisins les plus proches et une valeur Voisinage temporel, le nombre de voisins signalé inclut les K voisins pour l’entité comprise dans la fenêtre horaire spécifiée.

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

    • Pour les tables ou les classes d’entités de géodatabase, la valeur <Null> est considérée comme la valeur nulle (valeur manquante) si aucune valeur n’est fournie pour le paramètre Valeur Null. Si une valeur est fournie, cette valeur et les valeurs <Null> sont estimées dans la sortie de l’outil.
    • Pour les fichiers de formes et les tables dBASE, le paramètre Valeur Null est requis. Vous devez fournir une valeur représentant les valeurs Null ou manquantes dans les données en entrée (par exemple, -9999).
    • Si l’entrée est une table ou une classe d’entités de géodatabase d’entreprise et la sortie un fichier de formes ou une table dBASE, ce paramètre est nécessaire pour indiquer comment les valeurs manquantes impossibles à estimer sont représentées dans la sortie de l’outil.

  • Les valeurs manquantes ne pouvant pas être estimées et remplies sont indiquées dans la sortie au format dans lequel se trouvaient les valeurs Null à l’origine ou telles que spécifiées dans le paramètre Valeur Null.

  • Des messages décrivant les détails de l’analyse et les caractéristiques des champs remplis sont écrits au bas de la fenêtre Géotraitement lors de l’exécution de l’outil. Pour accéder aux messages, passez le curseur de la souris sur la barre d’avancement et cliquez sur le bouton de menu contextuel Menu contextuel 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 Remplir les valeurs manquantes via l’historique du géotraitement.

Paramètres

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

La classe d’entités ponctuelles ou surfaciques ou la table autonome contenant les valeurs Null à remplir.

Si la valeur du paramètre Table associée est fournie, les valeurs Null à spécifier sont contenues dans la table associée. Les entités en entrée sont appariées aux lignes de la table associée pour spécifier le voisinage spatio-temporel.

Feature Layer; Table View
Entités ou table en sortie
(Facultatif)

Les entités ou la table autonome en sortie allant inclure les valeurs remplies (estimées).

Si la valeur du paramètre Table associée est fournie, la sortie de ce paramètre contient le nombre de valeurs estimées à chaque emplacement et la valeur du paramètre Table en sortie contient les valeurs spécifié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 allant être appliqué. L’option Tendance temporelle n’est disponible que si la valeur des paramètres ID d’emplacement et Champ temporel est spécifiée.

  • MoyenneLes valeurs Null sont remplacées par la valeur moyenne des voisins de l’entité ou du champ à renseigner pour les tables autonomes.
  • MinimumLes valeurs Null sont remplacées par la valeur minimum (la plus basse) des voisins de l’entité ou du champ à renseigner pour les tables autonomes.
  • MaximumLes valeurs Null sont remplacées par la valeur maximum (la plus élevée) des voisins de l’entité ou du champ à renseigner pour les tables autonomes.
  • MédianeLes valeurs Null sont remplacées par la valeur médiane (valeur centrale triée) des voisins de l’entité ou du champ à renseigner pour les tables autonomes.
  • Tendance temporelleLes valeurs Null sont remplacées en fonction de la tendance de cet emplacement unique.
String
Conceptualisation des relations spatiales
(Facultatif)

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

  • Distance fixeLes entités voisines au sein d’une distance critique spécifiée (valeur du paramètre Canal 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 incluses dans les calculs ; k est un paramètre numérique spécifié.
  • Segments 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 segments 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)

La distance de limite de l’option Distance fixe du paramètre Conceptualisation de relations spatiales. Les entités se trouvant à l’extérieur de la limite spécifiée pour une entité cible ne sont pas prises en compte dans les calculs pour cette entité. Ce paramètre n’est pas disponible pour l’option Tronçons de contiguïté uniquement ou Angles des tronçons de contiguïté.

Linear Unit
Voisinage temporel
(Facultatif)

Intervalle avant et arrière dans le temps qui détermine quelles 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
Champ temporel
(Facultatif)

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

Pour l’entrée des entités, le champ temporel définit les voisins temporels tout en renseignant les valeurs manquantes. Une valeur doit être spécifiée si une table associée est fournie.

Pour l’entrée des entités et des tables, le champ temporel est utilisé afin de renseigner les valeurs manquantes à l’aide de la tendance temporelle à l’emplacement.

Field
Nombre de voisins spatiaux
(Facultatif)

Nombre de voisins les plus proches allant être inclus dans les calculs.

Si l’option Distance fixe, Tronçons de contiguïté uniquement ou Angles des tronçons de contiguïté du paramètre Conceptualisation de relations spatiales est choisie, ce nombre correspond au nombre minimum de voisins à inclure dans les calculs.

Long
ID d'emplacement
(Facultatif)

Un champ d’entier ou de texte contenant un ID unique pour chaque emplacement.

Si une table associée est fournie, ce champ est utilisé pour apparier chaque entité en entrée à des lignes de la table associée ; les valeurs de ce champ doivent être uniques pour chaque entité en entrée. Si une table associée n’est pas fournie, ce champ est utilisé pour spécifier chaque emplacement unique dans les entités en entrée pour déterminer les voisins temporels. Dans ce cas, les valeurs de ce champ doivent être uniques pour chaque emplacement mais n’ont pas besoin de l’être pour chaque entité (car plusieurs entités peuvent avoir le même emplacement).

Field
Table associée
(Facultatif)

La table ou vue tabulaire contenant les données temporelles de chaque entité dans le paramètre Entités ou table en entrée.

Table View
ID d'emplacement associé
(Facultatif)

Un champ d’entier ou de texte dans le paramètre Table associée qui contient la valeur du paramètre ID d’emplacement sur lequel reposera la relation.

Field
Fichier 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)

Un champ d’entier contenant une valeur différente pour chaque enregistrement dans le paramètre Entités ou table 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 aucun champ Unique ID, vous pouvez en créer un en ajoutant un champ d’entier à la table attributaire de l’entité en entrée et 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 spécifiée, <Null> est utilisé par défaut pour les tables et les classes d’entités de géodatabase. Si une valeur est spécifiée, la valeur et toutes les valeurs <Null> sont spécifiées. Si l’entrée ou la sortie est un fichier de formes ou une table dBASE, une valeur numérique de l’espace réservé Null 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 fournie.

Table
Ajouter des champs aux données en entrée
(Facultatif)

Indique si les champs de valeur remplis 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 de valeur remplis. Si vous ajoutez les champs, vous ne pouvez pas fournir de table associée et l’environnement de système de coordonnées en sortie est ignoré.

  • Coché : les champs contenant les valeurs spécifiées sont ajoutés aux données en entrée. Cette option modifie les données en entrée.
  • Décoché : une classe d’entités ou une table en sortie est créée contenant les champs de valeur remplis. Il s’agit de l’option par défaut.

Boolean

Sortie obtenue

ÉtiquetteExplicationType de données
Entités ou table en entrée mises à jour

Entités ou table en entrée mises à jour contenant les champs de valeur remplis

Feature Layer, 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

La classe d’entités ponctuelles ou surfaciques ou la table autonome contenant les valeurs Null à remplir.

Si la valeur du paramètre related_table est fournie, les valeurs Null à spécifier sont contenues dans la table associée. Les entités en entrée sont appariées aux lignes de la table associée pour spécifier le voisinage spatio-temporel.

Feature Layer; Table View
out_features
(Facultatif)

Les entités ou la table autonome en sortie allant inclure les valeurs remplies (estimées).

Si la valeur du paramètre related_table est fournie, la sortie de ce paramètre contient le nombre de valeurs estimées à chaque emplacement et la valeur du paramètre out_table contient les valeurs spécifié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 allant être appliqué. L’option TEMPORAL_TREND n’est disponible que si la valeur des paramètres location_id et time_field est spécifiée.

  • AVERAGELes valeurs Null sont remplacées par la valeur moyenne des voisins de l’entité.
  • MINIMUMLes valeurs Null sont remplacées par la valeur minimum (la plus faible) des voisins de l’entité.
  • MAXIMUMLes valeurs Null sont remplacées par la valeur maximum (la plus élevée) des voisins de l’entité.
  • MEDIANLes valeurs Null sont remplacées par la valeur médiane (valeur centrale triée) des voisins de l’entité.
  • TEMPORAL_TRENDLes valeurs Null sont remplacées en fonction de la tendance de cet emplacement unique.
String
conceptualization_of_spatial_relationships
(Facultatif)

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

  • FIXED_DISTANCELes entités voisines au sein d’une distance critique spécifiée (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 incluses dans les calculs ; k est 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 donné par le paramètre Weights_Matrix_File.
String
distance_band
(Facultatif)

La distance de limite de l’option FIXED_DISTANCE du paramètre conceptualization_of_spatial_relationships. Les entités se trouvant à l’extérieur de la limite spécifiée pour une entité cible ne sont pas prises en compte dans les calculs pour cette entité. Ce paramètre n’est pas disponible pour l’option CONTIGUITY_EDGES_ONLY ou CONTIGUITY_EDGES_CORNERS

Linear Unit
temporal_neighborhood
(Facultatif)

Intervalle avant et arrière dans le temps qui détermine quelles 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.

Pour l’entrée des entités, le champ temporel définit les voisins temporels tout en renseignant les valeurs manquantes. Une valeur doit être spécifiée si une table associée est fournie.

Pour l’entrée des entités et des tables, le champ temporel est utilisé afin de renseigner les valeurs manquantes à l’aide de la tendance temporelle à l’emplacement.

Field
number_of_spatial_neighbors
(Facultatif)

Nombre de voisins les plus proches allant être inclus dans les calculs.

Si l’option FIXED_DISTANCE, CONTIGUITY_EDGES_ONLY ou CONTIGUITY_EDGES_CORNERS du paramètre conceptualization_of_spatial_relationships est choisie, ce nombre correspond au nombre minimum de voisins à inclure dans les calculs.

Long
location_id
(Facultatif)

Un champ d’entier ou de texte contenant un ID unique pour chaque emplacement.

Si une table associée est fournie, ce champ est utilisé pour apparier chaque entité en entrée à des lignes de la table associée ; les valeurs de ce champ doivent être uniques pour chaque entité en entrée. Si une table associée n’est pas fournie, ce champ est utilisé pour spécifier chaque emplacement unique dans les entités en entrée pour déterminer les voisins temporels. Dans ce cas, les valeurs de ce champ doivent être uniques pour chaque emplacement mais n’ont pas besoin de l’être pour chaque entité (car plusieurs entités peuvent avoir le même emplacement).

Field
related_table
(Facultatif)

La table ou vue tabulaire contenant les données temporelles de chaque entité dans le paramètre in_features.

Table View
related_location_id
(Facultatif)

Un champ d’entier ou de texte dans le paramètre related_table qui contient la valeur du paramètre location_id sur lequel reposera la relation.

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)

Un champ d’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 aucun champ unique_id, vous pouvez en créer un en ajoutant un champ d’entier à la table de classe d’entités et 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 spécifiée, <Null> est utilisé par défaut pour les tables et les classes d’entités de géodatabase. Si une valeur est spécifiée, la valeur et toutes les valeurs <Null> sont spécifiées. Si l’entrée ou la sortie est un fichier de formes ou une table dBASE, une valeur numérique de l’espace réservé Null 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 fournie.

Table
append_to_input
(Facultatif)

Indique si les champs de valeur remplis 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 de valeur remplis. Si vous ajoutez les champs, vous ne pouvez pas fournir de table associée et l’environnement de système de coordonnées en sortie est ignoré.

  • APPEND_TO_INPUTLes champs contenant les valeurs spécifié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 est créée contenant les champs de valeur remplis. Il s’agit de l’option par défaut.
Boolean

Sortie obtenue

NomExplicationType de données
updated_features

Entités ou table en entrée mises à jour contenant les champs de valeur remplis

Feature Layer, Table View

Exemple de code

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

Le script ci-dessous pour la fenêtre Python 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 autonome Python 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())