Mit der Spatial Analyst-Lizenz verfügbar.
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 .asc sein.
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 Werkzeugdialogfelds in das Multiband-Raster mithilfe der Schaltfläche "Durchsuchen"
neben dem Eintrag Eingabe-Raster-Bänder. Ö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 Werkzeugdialogfelds in das Multiband-Raster mithilfe der Schaltfläche "Durchsuchen"
Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.
Syntax
ClassProbability (in_raster_bands, in_signature_file, {maximum_output_value}, {a_priori_probabilities}, {in_a_priori_file})| Parameter | Erläuterung | Datentyp |
in_raster_bands [in_raster_band,...] | Die Eingabe-Raster-Bänder. Die Raster können den Typ "Ganzzahl" oder "Gleitkomma" haben. | 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 bei Verwendung der Option FILE erforderlich. 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. Es hat den Typ "Ganzzahl". Wenn die Ausgabe ein Esri Grid ist, darf der Dateiname nicht mehr als 9 Zeichen umfassen. | Raster |
Codebeispiel
ClassProbability – Beispiel 1 (Python-Fenster)
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")
ClassProbability – Beispiel 2 (eigenständiges Skript)
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")
Umgebungen
Lizenzinformationen
- ArcGIS Desktop Basic: Erfordert Spatial Analyst
- ArcGIS Desktop Standard: Erfordert Spatial Analyst
- ArcGIS Desktop Advanced: Erfordert Spatial Analyst