Eigenschaften der Modelldatei für räumliche Statistiken festlegen (Spatial Statistics)

Zusammenfassung

Fügt den Variablen, die in einer Modelldatei für räumliche Statistiken gespeichert sind, Beschreibungen und Einheiten hinzu.

Weitere Informationen zu Modelldateien für räumliche Statistiken

Verwendung

• Das Werkzeug hat folgende potenzielle Anwendungsbereiche:

  • Festlegen von Variablenbeschreibungen als Hintergrund und Informationen für die Variablen, die in der Modelldatei gespeichert sind.
  • Hinzufügen von Einheiten zu den Variablen, damit sie abgeglichen werden können, wenn die Modelldatei im Werkzeug Mit Modelldatei für räumliche Statistiken vorhersagen verwendet wird, um Vorhersagen zu treffen.

• Die Ausgaben dieses Werkzeugs sind Ausgabe-Meldungen der Geoverarbeitung, in denen die Merkmale und Inhalte der Eingabe-Modelldatei beschrieben werden. Sie können auf diese Meldungen zugreifen, indem Sie mit der Maus auf die Fortschrittsleiste zeigen, auf die Pop-out-Schaltfläche klicken oder den Abschnitt "Meldungen" im Bereich Geoverarbeitung erweitern. Sie können auch auf die Meldungen für ein zuvor ausgeführtes Werkzeug über den Geoverarbeitungsverlauf zugreifen.

  Die Meldungen enthalten die folgenden Informationen und Tabellen:

  • Das Werkzeug und die Methode, die zum Erstellen der Modelldatei für räumliche Statistiken verwendet wurden.
  • Die Tabelle Modellparameter enthält die Beschreibungen der vorherzusagenden Variable und der erklärenden Variablen, die zum Erstellen des Modells verwendet wurden. Diese Tabelle enthält auch Einheiten für jede Variable, damit sichergestellt werden kann, dass sie auf die Vorhersagevariablen abgestimmt sind, wenn das Modell verwendet wird, um Vorhersagen zu treffen.
  • Die Meldungen und Modelldiagnosen des Werkzeugs, das zum Erstellen der Modelldatei verwendet wurde. Die Erläuterungen der Meldungen und Diagnosen finden Sie in der Dokumentation für das zugehörige Werkzeug.

• Die Modelldatei können Sie mit dem Parameter Trainierte Ausgabe-Modelldatei in den Werkzeugen Generalisierte lineare Regression, Forest-basierte und geboostete Klassifizierung und Regression und Auf Vorhandensein beschränkte Vorhersage erstellen.

  Für Modelle, die durch das Werkzeug Generalisierte lineare Regression erstellt wurden, wird in den Meldungen der verwendete Modelltyp (Kontinuierlich, Binär oder Anzahl) angezeigt. Beim Werkzeug Forest-basierte und geboostete Klassifizierung und Regression wird in den Meldungen angezeigt, ob ein Forest-basiertes oder ein abgestuft geboostetes Modell für Regression oder Klassifizierung verwendet wurde. Beim Werkzeug Auf Vorhandensein beschränkte Vorhersage wird in den Meldungen angezeigt, ob Hintergrundpunkte verwendet wurden.

• Die Einheiten für erklärende Trainings-Entfernungs-Features können vom Werkzeug nicht bearbeitet werden. Die Entfernungseinheit, die im Werkzeugdialogfeld angezeigt wird, wird durch die Entfernungseinheiten bestimmt, die zum Trainieren des Modells verwendet wurden.

  Hinweis:

  Es wird empfohlen, dass Sie die Einheiten für Variablen festlegen, bevor die Modelldatei für Vorhersagen mit anderen Daten freigegeben wird. Da versehentliche Konflikte zwischen Einheiten zu falschen Analyseergebnissen führen können, ist es wichtig, die Einheiten für jede Variable zu dokumentieren. Wenn Sie zum Beispiel beim Trainieren eines Modells Einkommensdaten in US-Dollar verwenden, beim Treffen von Vorhersagen aber Einkommensdaten in Indischen Rupien verwenden, dann erhalten Sie falsche Vorhersagen, da die Wertebereiche und die Bedeutung der Koeffizienten inkonsistent sind.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Modelldatei	Die Modelldatei für räumliche Statistiken.	File
Vorherzusagende Variable (optional)	Name, Beschreibung und Einheit der Variable, die an neuen Positionen vorhergesagt werden soll.	Value Table
Erklärende Trainingsvariablen (optional)	Name, Beschreibung und Einheit der erklärenden Variablen, die zum Trainieren des Eingabemodells verwendet werden sollen.	Value Table
Erklärende Trainings-Entfernungs-Features (optional)	Name, Beschreibung und Einheit der erklärenden Trainings-Entfernungs-Features, die zum Trainieren des Eingabemodells verwendet werden sollen.	Value Table
Erklärende Trainings-Raster (optional)	Name, Beschreibung und Einheit der erklärenden Trainings-Raster, die zum Trainieren des Eingabemodells verwendet werden sollen.	Value Table

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Modelldatei	Die Modelldatei für räumliche Statistiken nach ihrer Aktualisierung mit Variablenbeschreibungen und -einheiten.	File

Python

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

Name	Erläuterung	Datentyp
input_model	Die Modelldatei für räumliche Statistiken.	File
variable_predict [[var1, desc1, unit1], [var2, desc2, unit2],...] (optional)	Name, Beschreibung und Einheit der Variable, die an neuen Positionen vorhergesagt werden soll.	Value Table
explanatory_variables [[var1, desc1, unit1], [var2, desc2, unit2],...] (optional)	Name, Beschreibung und Einheit der erklärenden Variablen, die zum Trainieren des Eingabemodells verwendet werden sollen.	Value Table
distance_features [[var1, desc1, unit1], [var2, desc2, unit2],...] (optional)	Name, Beschreibung und Einheit der erklärenden Trainings-Entfernungs-Features, die zum Trainieren des Eingabemodells verwendet werden sollen.	Value Table
explanatory_rasters [[var1, desc1, unit1], [var2, desc2, unit2],...] (optional)	Name, Beschreibung und Einheit der erklärenden Trainings-Raster, die zum Trainieren des Eingabemodells verwendet werden sollen.	Value Table

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_model_file	Die Modelldatei für räumliche Statistiken nach ihrer Aktualisierung mit Variablenbeschreibungen und -einheiten.	File

Codebeispiel

SetSSMFileProperties: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion SetSSMFileProperties verwenden.

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']])

SetSSMFileProperties: Beispiel 2 (eigenständiges Skript)

Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie Sie die Funktion SetSSMFileProperties verwenden.

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

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.