Définir les propriétés du fichier de modèle de statistiques spatiales (Statistiques spatiales)

Synthèse

Ajoute des descriptions et des unités aux variables stockées dans un fichier de modèle de statistiques spatiales.

Plus d’informations sur les fichiers de modèle de statistiques spatiales

Utilisation

• Les applications possibles de cet outil sont les suivantes :

  • Décrire les variables stockées dans un fichier de modèle afin d’offrir du contexte et des informations les concernant.
  • Inclure des unités pour les variables de façon à ce que celles-ci soient respectées lors de la réalisation de prévisions à l’aide du fichier de modèle dans l’outil Prévoir à l’aide d’un fichier de modèle de statistiques spatiales.

• Cet outil génère des messages de géotraitement en sortie qui décrivent les caractéristiques et le contenu du fichier de modèle. Vous pouvez accéder aux messages en passant le curseur de la souris sur la barre d’avancement, en cliquant sur le bouton de menu contextuel ou en développant la section de 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 via l’historique du géotraitement.

  Les messages comprennent les informations et tableaux suivants :

  • L’outil et la méthode utilisés pour créer le fichier de modèle de statistiques spatiales.
  • Le tableau Paramètres du modèle décrit la variable à prévoir et les variables explicatives utilisées pour créer le modèle. Le tableau contient également les unités de chaque variable pour garantir que celles-ci correspondent aux variables de prévision lorsque le modèle est utilisé pour effectuer des prévisions.
  • Les messages et diagnostics du modèle de l’outil utilisé pour créer le fichier de modèle. Consultez la documentation de l’outil pour obtenir des explications sur les messages et diagnostics.

• Vous pouvez créer le fichier de modèle à l’aide du paramètre Fichier du modèle entraîné en sortie de l’outil Régression linéaire généralisée, Classification et régression basées sur une forêt et boostées ou Prévision de présence seule.

  Pour les modèles créés par l’outil Régression linéaire généralisée, les messages indiquent le type de modèle utilisé (continu, binaire ou total). Pour l’outil Classification et régression basées sur une forêt et boostées, les messages indiqueront si un modèle basé sur une forêt ou dont le gradient est boosté pour la régression ou la classification a été utilisé. Pour l’outil Prévision de présence uniquement, les messages indiquent si des points d’arrière-plan ont été utilisés.

• Les unités des entités de distance d’entraînement explicatives ne peuvent pas être modifiées par l’outil. L’unité de distance affichée dans la boîte de dialogue de l’outil est déterminée par les unités de distance qui ont été utilisées pour entraîner le modèle.

  Remarque :

  Nous vous recommandons de définir les unités des variables avant de partager le fichier de modèle pour effectuer des prévisions avec des données différentes. L’utilisation involontaire d’unités incohérentes peut fausser les résultats de l’analyse, il est donc important de documenter les unités associées à chaque variable. Par exemple, si vous entraînez un modèle en utilisant une variable de revenu en dollars américains, mais que vous faites correspondre cette variable à un revenu exprimé en roupies indiennes lors des prévisions, les plages de valeurs et la signification des coefficients seront incohérents, ce qui se traduira par des prévisions inexactes.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Fichier de modèle en entrée.	Le fichier de modèle de statistiques spatiales	File
Variable à prévoir (Facultatif)	Le nom, la description et l’unité de la variable qui sera prévue aux nouveaux emplacements.	Value Table
Variables d’entraînement explicatives (Facultatif)	Le nom, la description et l’unité des variables explicatives qui seront utilisées pour entraîner le modèle en entrée.	Value Table
Entités de distance d’entraînement explicatives (Facultatif)	Le nom, la description et l’unité des entités de distance d’entraînement explicatives qui seront utilisées pour entraîner le modèle en entrée.	Value Table
Rasters d’entraînement explicatifs (Facultatif)	Le nom, la description et l’unité des rasters d’entraînement explicatifs qui seront utilisés pour entraîner le modèle en entrée.	Value Table

Sortie obtenue

Étiquette	Explication	Type de données
Fichier de modèle mis à jour	Le fichier de modèle de statistiques spatiales mis à jour avec les descriptions et unités de variables.	File

Python

arcpy.stats.SetSSMFileProperties(input_model, {variable_predict}, {explanatory_variables}, {distance_features}, {explanatory_rasters})

Nom	Explication	Type de données
input_model	Le fichier de modèle de statistiques spatiales	File
variable_predict [[var1, desc1, unit1], [var2, desc2, unit2],...] (Facultatif)	Le nom, la description et l’unité de la variable qui sera prévue aux nouveaux emplacements.	Value Table
explanatory_variables [[var1, desc1, unit1], [var2, desc2, unit2],...] (Facultatif)	Le nom, la description et l’unité des variables explicatives qui seront utilisées pour entraîner le modèle en entrée.	Value Table
distance_features [[var1, desc1, unit1], [var2, desc2, unit2],...] (Facultatif)	Le nom, la description et l’unité des entités de distance d’entraînement explicatives qui seront utilisées pour entraîner le modèle en entrée.	Value Table
explanatory_rasters [[var1, desc1, unit1], [var2, desc2, unit2],...] (Facultatif)	Le nom, la description et l’unité des rasters d’entraînement explicatifs qui seront utilisés pour entraîner le modèle en entrée.	Value Table

Sortie obtenue

Nom	Explication	Type de données
updated_model_file	Le fichier de modèle de statistiques spatiales mis à jour avec les descriptions et unités de variables.	File

Exemple de code

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

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

arcpy.stats.SetSSMFileProperties ("C:/MyData/input_modelfile.ssm", 
      [["CORN", "Presence of Corn Prediction", "No Units"]], 
      [["RASTER1", "Rainfall", "millimeter"], ["RASTER2", "Temperature", "Celsius"], 
       ["RASTER3", "Crop Type", "No units']])

Exemple 2 d’utilisation de l’outil SetSSMFileProperties (script autonome)

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

# Set the properties of a spatial statistics model file 

# Import modules 
import arcpy 

# Set the current workspace 
arcpy.env.workspace = "C:/MyData" 

# Set Variable Description and units 
var_predict = [["FatalityPresence", "Binary value to show presence of fatality", "No Units"]]
var_exp = [["ALCOHOL_RELATED", "Number of accidents related to alcohol usage", "Count"], 
           ["SPEED", "Speed of the vehicle", "Miles per hour"]]
var_distance = [["INTERSECTION", "Distance to a road intersection", "Miles"]]

# Run tool  
arcpy.stats.SetSSMFileProperties("input_modelfile.ssm", var_predict, var_exp, 
          var_distance) 

# Print geoprocessing messages 
print(arcpy.GetMessages)

Environnements

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