Klassenwahrscheinlichkeit (Spatial Analyst)

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

  • Wenn ein Multiband-Raster als eines der Eingabe-Raster-Bänder (in_raster_bands in Python) angegeben wird, werden alle Bänder verwendet.

    Wenn eine Auswahl von Bändern aus einem Multiband-Raster verarbeitet werden soll, können Sie zunächst mit dem Werkzeug Bänder zusammensetzen ein neues Raster-Dataset erstellen, das aus den betreffenden Bändern besteht, und das Ergebnis in der Liste der Eingabe-Raster-Bänder (in_raster_bands in Python) verwenden.

  • 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  .2

    Die 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 ganzzahlige Werte enthält, die im Bereich von 0 bis 100 liegen. Jeder beliebige ganzzahlige Wert 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.

  • Weitere Informationen zur Geoverarbeitung von Umgebungen mit diesem Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster-Bänder

Die Eingabe-Raster-Bänder.

Die Raster können den Typ "Integer" oder "Gleitkomma" haben.

Raster Layer
Eingabe-Signaturdatei

Eingabesignaturdatei, deren Klassensignaturen verwendet werden, um die A-Priori-Wahrscheinlichkeitsbänder zu generieren.

Die Erweiterung .gsg ist erforderlich.

File
Höchster Ausgabewert
(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-Wahrscheinlichkeits-Gewichtung
(optional)

Gibt an, wie A-Priori-Wahrscheinlichkeiten bestimmt werden.

  • GleichAlle Klassen verfügen über die gleiche A-Priori-Wahrscheinlichkeit.
  • StichprobeDie A-Priori-Wahrscheinlichkeit ist proportional zur Anzahl der Zellen in jeder Klasse im Verhältnis zur Gesamtzahl der referenzierten Zellen in allen Klassen innerhalb der Signaturdatei.
  • DateiDie A-Priori-Wahrscheinlichkeit wird jeder Klasse anhand einer ASCII-Eingabedatei mit A-Priori-Wahrscheinlichkeiten zugewiesen.
String
Eingabe-A-Priori-Wahrscheinlichkeitsdatei
(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 Datei verwendet wird.

Die Erweiterung für die A-Priori-Datei kann .txt oder .asc lauten.

File

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Multiband-Raster

Das Ausgabe-Multiband-Raster-Dataset.

Es hat den Typ "Integer".

Wenn die Ausgabe ein Esri Grid ist, darf der Dateiname nicht mehr als 9 Zeichen umfassen.

Raster

ClassProbability(in_raster_bands, in_signature_file, {maximum_output_value}, {a_priori_probabilities}, {in_a_priori_file})
NameErläuterungDatentyp
in_raster_bands
[in_raster_band,...]

Die Eingabe-Raster-Bänder.

Die Raster können den Typ "Integer" 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.

  • EQUALAlle Klassen verfügen über die gleiche A-Priori-Wahrscheinlichkeit.
  • SAMPLEDie A-Priori-Wahrscheinlichkeit ist proportional zur Anzahl der Zellen in jeder Klasse im Verhältnis zur Gesamtzahl der referenzierten Zellen in allen Klassen innerhalb der Signaturdatei.
  • FILEDie A-Priori-Wahrscheinlichkeit wird jeder Klasse anhand einer ASCII-Eingabedatei mit A-Priori-Wahrscheinlichkeiten zugewiesen.
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 Datei verwendet wird.

Die Erweiterung für die A-Priori-Datei kann .txt oder .asc lauten.

File

Rückgabewert

NameErläuterungDatentyp
out_multiband_raster

Das Ausgabe-Multiband-Raster-Dataset.

Es hat den Typ "Integer".

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 = ""

# Execute ClassProbability
outClassProbability = ClassProbability(inRaster,inSigFile,
                    maxValue, aPrioriWeight, aPrioriFile)

# Save the output 
outClassProbability.save("c:/sapyexamples/output/classprob01")

Lizenzinformationen

  • Basic: Erfordert Spatial Analyst
  • Standard: Erfordert Spatial Analyst
  • Advanced: Erfordert Spatial Analyst

Verwandte Themen