Décrire le fichier de modèle de statistiques spatiales (Statistiques spatiales)

Synthèse

Décrit le contenu et les diagnostics d’un fichier de modèle de statistiques spatiales.

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

Utilisation

• Cet outil génère principalement des messages de géotraitement en sortie qui décrivent les caractéristiques et le contenu du fichier de modèle en entrée. Pour accéder aux messages, survolez la barre de progression avec votre souris et cliquez sur le 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 via l’historique de géotraitement.

  Les messages comprennent les informations et tables suivantes :

  • L’outil et la méthode utilisés pour créer le fichier de modèle de statistiques spatiales.
  • La table Paramètres du modèle décrit la variable à prévoir et les variables explicatives utilisées pour créer le modèle. Cette table contient également les unités de chaque variable, ce qui vous permet de vérifier qu’elles correspondent aux variables de prévision lorsque le modèle est utilisé pour faire des prévisions. Vous pouvez définir la description et les unités des variables à l’aide de l’outil Définir les propriétés du fichier de modèle de statistiques spatiales.
  • 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.

  Remarque :

  Si aucune donnée de validation n’a été retenue au cours du processus d’entraînement du modèle, certains diagnostics ne figurent pas dans les messages. Utilisez de tels modèles avec prudence pour vos prévisions.

  Dans le cas d’un processus de classification et régression basées sur une forêt, les erreurs hors section (OOB) ne figurent pas dans les messages du fait qu’elles ne sont pas enregistrées dans le fichier de modèle. Dans le cas d’une prévision de présence uniquement, le nombre total de points de présence et d’arrière-plan utilisés pour entraîner le modèle ainsi que les résultats de la validation croisée n’apparaissent pas en raison du caractère sensible ou confidentiel possible de ces informations.

  Attention :

  Certains diagnostics de modèle (comme la matrice de confusion) et le contenu du fichier de modèle pourraient être utilisés pour obtenir par rétro-ingénierie les données en entrée utilisées pour créer le fichier. Soyez prudent lorsque vous partagez des fichiers de modèle dont les données d’entraînement sont confidentielles ou sensibles.

• 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 applications possibles de cet outil sont les suivantes :

  • Se faire une idée des variables stockées dans le fichier de modèle en examinant leur description et leurs unités. Ensuite, utiliser l’outil Prévoir à l’aide d’un fichier de modèle de statistiques spatiales pour les prévisions.
  • Consulter les diagnostics de modèle pour évaluer la qualité du modèle.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Fichier de modèle en entrée.	Fichier de modèle de statistiques spatiales à décrire.	File

Sortie obtenue

Étiquette	Explication	Type de données
Variables d’entraînement explicatives	Liste des variables d’entraînement explicatives utilisées pour entraîner le fichier de modèle.	String
Entités de distance d’entraînement explicatives	Liste des entités de distance d’entraînement explicatives utilisées pour entraîner le fichier de modèle.	String
Rasters d’entraînement explicatifs	Liste des rasters d’entraînement explicatifs utilisés pour entraîner le fichier de modèle.	String

Python

arcpy.stats.DescribeSSMFile(input_model)

Nom	Explication	Type de données
input_model	Fichier de modèle de statistiques spatiales à décrire.	File

Sortie obtenue

Nom	Explication	Type de données
explanatory_variables	Liste des variables d’entraînement explicatives utilisées pour entraîner le fichier de modèle.	String
explanatory_distance_features	Liste des entités de distance d’entraînement explicatives utilisées pour entraîner le fichier de modèle.	String
explanatory_rasters	Liste des rasters d’entraînement explicatifs utilisés pour entraîner le fichier de modèle.	String

Exemple de code

Exemple 1 d’utilisation de la fonction DescribeSSMFile (fenêtre Python)

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

import arcpy
arcpy.stats.DescribeSSMFile("C:/MyData/input_modelfile.ssm")

Exemple 2 d’utilisation de la fonction DescribeSSMFile (script autonome)

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

# Print the properties of a spatial statistics model file
# Import modules
import arcpy

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

# Run tool 
arcpy.stats.DescribeSSMFile("input_modelfile.ssm")

# Print geoprocessing messages
print(arcpy.GetMessages())

Environnements

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