Klassenwahrscheinlichkeit (Spatial Analyst)
Zusammenfassung
Erstellt ein Multiband-Raster von Wahrscheinlichkeitsbändern, wobei ein Band für jede Klasse erstellt wird, die in der Eingabe-Signaturdatei dargestellt ist.
Weitere Informationen zur Funktionsweise von "Klassenwahrscheinlichkeit"
Verwendung
-
Alle mit den Werkzeugen Signaturen erstellen, Signaturen bearbeiten oder Iso-Cluster erstellten Signaturdateien sind gültige Eingaben für die Eingabe-Signaturdatei. Diese haben die Erweiterung .gsg.
-
Dieses Werkzeug nutzt zur Schätzung der Klassenwahrscheinlichkeiten Bayes-Statistiken. Bei Bayes-Statistiken dienen die Vorinformationen zu den Daten als Ausgangspunkt, die nach Erfassung der Daten aktualisiert werden. Die Vorinformationen zu den Datenwerten werden mit A-Priori-Wahrscheinlichkeiten quantifiziert, die dann mithilfe der Wahrscheinlichkeitsfunktion angepasst werden, um nachfolgende Wahrscheinlichkeiten (die aktualisierten Informationen) zu erhalten Die Wahrscheinlichkeitsfunktion wird von den Datenwerten für jede Klasse bzw. jedes Cluster definiert.
Die Eingabe-A-Priori-Wahrscheinlichkeitsdatei muss eine ASCII-Datei sein, die aus zwei Spalten besteht. Die Werte in der linken Spalte stellen Klassen-IDs dar. Die Werte in der rechten Spalte stellen die A-Priori-Wahrscheinlichkeiten für die jeweiligen Klassen dar. Gültige Werte für Klassen-A-Priori-Wahrscheinlichkeiten müssen größer oder gleich 0 sein. Wenn 0 als Wahrscheinlichkeit angegeben wird, wird kein zugeordnetes Wahrscheinlichkeitsband für die Klasse im Ausgabe-Multiband-Raster erstellt. Die Summe der angegebenen A-Priori-Wahrscheinlichkeiten muss kleiner oder gleich 1 sein. Hier ein Beispiel, in dem das Format der Datei dargestellt wird:
1 .3 2 .1 4 .0 5 .15 7 .05 8 .2Die in der Datei weggelassenen Klassen erhalten die durchschnittliche A-Priori-Wahrscheinlichkeit des verbleibenden Teiles des Wertes 1. Im obigen Beispiel werden alle Klassen von 1 bis 8 in der Signaturdatei dargestellt. Die A-Priori-Wahrscheinlichkeiten der Klassen 3 und 6 fehlen in der Eingabe-A-Priori-Wahrscheinlichkeitsdatei. Da die Summe aller Wahrscheinlichkeiten, die in der oben erwähnten Datei angegeben wurden, gleich 0,8 ist, wird der verbleibende Teil der Wahrscheinlichkeit (0,2) durch die Anzahl der nicht angegebenen Klassen (2) dividiert. Daher wird den Klassen 3 und 6 jeweils eine Wahrscheinlichkeit von 0,1 zugewiesen.
Die Erweiterung für die Eingabe-A-Priori-Wahrscheinlichkeitsdatei kann .txt oder .ascsein.
-
Der als maximaler Ausgabewert eingegebene Wert legt den oberen Bereich der Werte in den Ausgabewahrscheinlichkeitsbändern fest. Der Standardwert 100 erstellt ein Multiband-Raster mit jedem Band, das Ganzzahlwerte enthält, die im Bereich von 0 bis 100 liegen. Jeder beliebige Ganzzahlwert größer 0 ist als maximaler Ausgabewert gültig. Nur der Wert 1 als Argument für den maximalen Ausgabewert führt zu Bändern mit Gleitkommawerten.
-
Wenn die Eingabe ein Layer ist, der aus einem Multiband-Raster mit mehr als drei Bändern erstellt wurde, berücksichtigt der Vorgang alle mit dem Quellen-Dataset verknüpften Bänder und nicht nur die drei vom Layer geladenen (symbolisierten) Bänder.
Sie haben verschiedene Möglichkeiten, eine Teilmenge von Bändern eines Multiband-Rasters als Eingabe für das Werkzeug festzulegen.
- Wechseln Sie bei Verwendung des Werkzeugdialogfeldes in das Multiband-Raster, indem Sie die Schaltfläche "Durchsuchen"
neben dem Eintrag Eingabe-Raster-Bänder verwenden. Öffnen Sie das Raster, und wählen Sie die gewünschten Bänder aus. - Wenn es sich bei dem Multiband-Raster um einen Layer im Inhaltsverzeichnis handelt, können Sie mit dem Werkzeug Raster-Layer erstellen einen neuen Multiband-Layer erstellen, der nur die gewünschten Bänder enthält.
- Sie können auch mithilfe der Option Bänder zusammensetzen ein neues Dataset erstellen, das nur die gewünschten Bänder enthält, und dieses als Eingabe für das Werkzeug verwenden.
- In Python können die gewünschten Bänder direkt als Liste im Werkzeugparameter festgelegt werden.
- Wechseln Sie bei Verwendung des Werkzeugdialogfeldes in das Multiband-Raster, indem Sie die Schaltfläche "Durchsuchen"
Syntax
| Parameter | Erläuterung | Datentyp |
in_raster_bands [in_raster_band,...] |
Die Eingabe-Raster-Bänder. Rasterbänder können Ganzzahl- oder Gleitkommawerte sein. | Raster Layer |
in_signature_file |
Eingabesignaturdatei, deren Klassensignaturen verwendet werden, um die A-Priori-Wahrscheinlichkeitsbänder zu generieren. Die Erweiterung .gsg ist erforderlich. | File |
maximum_output_value (optional) |
Faktor zum Skalieren des Wertebereichs in den Ausgabewahrscheinlichkeitsbändern. Standardmäßig können die Werte im Bereich von 0 bis 100 liegen. | Long |
a_priori_probabilities (optional) | Gibt an, wie A-Priori-Wahrscheinlichkeiten bestimmt werden.
| String |
in_a_priori_file (optional) | Eine Textdatei, die A-Priori-Wahrscheinlichkeiten für die Eingabe-Signaturklassen enthält. Eine Eingabe für die A-Priori-Wahrscheinlichkeitsdatei ist nur erforderlich, wenn die Option "FILE" verwendet wird. Die Erweiterung für die A-Priori-Datei kann .txt oder .asc lauten. | File |
Rückgabewert
| Name | Erläuterung | Datentyp |
| out_multiband_raster |
Das Ausgabe-Multiband-Raster-Dataset. Wenn die Ausgabe ein Esri Grid ist, darf der Dateiname nicht mehr als 9 Zeichen umfassen. | Raster |
Codebeispiel
In diesem Beispiel wird ein Multiband-Raster von Wahrscheinlichkeitsbändern für jede Klasse in einer Signaturdatei erstellt.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outClassProbability = ClassProbability("redlands","C:/sapyexamples/data/wedit5.gsg",
100,"EQUAL","")
outClassProbability.save("c:/sapyexamples/output/classprob")
In diesem Beispiel wird ein Multiband-Raster von Wahrscheinlichkeitsbändern für jede Klasse in einer Signaturdatei erstellt.
# Name: ClassProbability_Ex_02.py
# Description: Creates probability layers for each class in a signature file.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "redl123"
inSigFile = "c:/sapyexamples/data/wedit5.gsg"
maxValue = 100
aPrioriWeight = "EQUAL"
aPrioriFile = ""
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ClassProbability
outClassProbability = ClassProbability(inRaster,inSigFile,
maxValue, aPrioriWeight, aPrioriFile)
# Save the output
outClassProbability.save("c:/sapyexamples/output/classprob01")