Popularität (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Zusammenfassung

Ermittelt den Wert in einer Argumentliste auf Zellenbasis, der einen bestimmten Verbreitungsgrad aufweist. Der jeweilige Verbreitungsgrad (die Anzahl von Vorkommen jedes Wertes) wird durch das erste Argument angegeben.

Abbildung

Beispiel für Eingabe- und Ausgabewerte des Werkzeugs "Popularität"
OutRas = Popularity(ValRas, [InRas1, InRas2, InRas3])

Verwendung

  • Das Werkzeug wertet die Anzahl der Vorkommen der Eingabe-Raster-Werte für jede Position aus und ordnet sie auf einem Ordinalmaßstab – also der verbreitetste, der am zweithäufigsten verbreitete usw. Der Wert des angegebenen n-häufigst verbreiteten Wertes laut Definition durch den Popularitäts-Raster-Wert wird zurückgegeben.

  • Die Reihenfolge in der Liste der Eingabe-Raster ist nicht von Bedeutung. Das Raster, das die Popularitätsposition definiert, muss jedoch vorausgehen.

  • In der Liste der Eingabe-Raster kann eine beliebige Anzahl von Rastern angegeben werden.

  • Wenn alle Eingabewerte für eine Zellenposition identisch sind (unabhängig von der angegebenen Popularität/Verbreitung), ist der Ausgabewert mit der Eingabe für diese Zellenposition identisch.

  • Wenn eine Zellenposition für eines der Eingabe-Raster den Wert "NoData" enthält, wird dieser Position auch in der Ausgabe der Wert "NoData" zugewiesen.

  • Wenn kein Einzelwert als n-verbreitetster ermittelt werden konnte, wird der Position im Ausgabe-Raster "NoData" zugewiesen. Diese Situation tritt auf, wenn alle Eingabe-Raster-Werte an einer Position unterschiedlich sind, oder wenn zwei oder mehr Eingabe-Raster-Werte die gleiche Anzahl an Vorkommen aufweisen und diese Anzahl die n-verbreitetste ist. Die Ausgabe eines der Eingabe-Raster-Werte, z. B. des ersten, der im Scanvorgang gefunden wurde, wäre irreführend. Sie würden nicht wissen, ob der Wert wirklich der n-verbreitetste Wert ist.

  • Wenn der Popularitätswert größer als die Anzahl der Eingabe-Raster ist, wird jeder Zellenposition in der Ausgabe der Wert "NoData" zugewiesen.

  • Wenn 0 als Popularitätswert angegeben wird, ist der Ausgabewert "NoData".

  • Der Verbreitungsgrad 1 ist der Mehrheitswert, ähnlich der Option "Majority" des Werkzeugs Zellenstatistiken.

  • Wenn es sich bei einem der Eingabe-Raster um ein Gleitkomma-Raster handelt, enthält auch die Ausgabe Gleitkommawerte. Andernfalls enthält sie Ganzzahlwerte.

  • Wenn der Parameter Als Multiband verarbeiten deaktiviert ist (für process_as_multiband wurde in Python SINGLE_BAND festgelegt), wird nur das erste Band von Eingabe-Popularitäts-Raster oder konstanter Wert eines Multibands (in_popularity_raster_or_constant in Python) verwendet. Jedes Band aus Eingabe-Raster eines Multibands (in_rasters in Python) wird gesondert als Einzelband-Raster verarbeitet.

  • Wenn der Parameter Als Multiband verarbeiten aktiviert ist (für process_as_multiband wurde in Python MULTI_BAND festgelegt), wird jede Multiband-Raster-Eingabe als Multiband-Raster verarbeitet.

    Die Anzahl an Bändern in der Ausgabe hängt vom Parameter Eingabe-Popularitäts-Raster oder konstanter Wert ab. Wenn das Popularitäts-Raster ein Einzelband ist, entspricht die Anzahl an Bändern im Ausgabe-Raster der maximalen Anzahl an Bändern aller Multiband-Raster aus den Eingabe-Rastern. Wenn das Popularitäts-Raster ein Multiband ist, verfügt das Ausgabe-Raster über dieselbe Anzahl an Bändern wie das Popularitäts-Raster.

    Wenn es sich bei einem Eingabe-Raster um ein Raster mit einer geringeren Anzahl an Bändern als beim Ausgabe-Raster handelt, werden die fehlenden Bänder als ein Band mit NoData-Werten interpretiert. Wenn der Zellenwert des Popularitäts-Rasters den Wert Eins aus dem fehlenden Band auswählt, erhält das Ausgabe-Raster den Wert "NoData". Handelt es sich bei einem Eingabe-Raster um einen konstanten Wert, wird dieser als Multiband-Raster interpretiert, in dem die Zellenwerte aller Bänder mit dem konstanten Wert übereinstimmen und über dieselbe Anzahl an Bändern wie das Ausgabe-Raster verfügen.

  • Wenn alle Eingaben multidimensionale Raster-Daten mit derselben Anzahl an Variablen sind, führt das Werkzeug den Vorgang für alle Ausschnitte mit demselben Dimensionswert durch. Die Ausgabe ist ein multidimensionales Raster im CRF-Format. Die Variablen in den Eingaben müssen mindestens eine gemeinsame Dimension und einen gemeinsamen Dimensionswert enthalten, damit dieses Werkzeug erfolgreich ausgeführt werden kann. Andernfalls tritt ein Fehler auf.

    Wenn alle Eingaben eine Variable, aber unterschiedliche Namen aufweisen, deaktivieren Sie vor dem Ausführen der Operation die Einstellung Multidimensionale Variable abgleichen für die Geoverarbeitungsumgebung (durch Festlegen von arcpy.env.matchMultidimensionalVariable = False in Python).

    Wenn mindestens eine der Eingaben ein multidimensionales Raster und die anderen Eingaben Konstanten sind, führt das Werkzeug den Vorgang für alle Ausschnitte sämtlicher Variablen mit dem konstanten Wert durch, und die Ausgabe ist ein multidimensionales Raster.

  • Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Popularitäts-Raster oder konstanter Wert

Das Eingabe-Raster, das die Popularitätsposition definiert, die zurückgegeben werden soll.

Eine Zahl kann als Eingabe verwendet werden, Sie müssen jedoch zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant
Eingabe-Raster

Die Liste der Eingabe-Raster, die verwendet werden, um die Popularität der Werte für jede Zellenposition auszuwerten.

Raster Layer
Als Multiband verarbeiten
(optional)

Legt fest, wie die Bänder von Eingabemultiband-Rastern verarbeitet werden.

  • Deaktiviert: Jedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung.
  • Aktiviert: Jede Multiband-Raster-Eingabe wird als Multiband verarbeitet. Der Vorgang wird für jedes Band aus einer Eingabe mit der entsprechenden Bandnummer aus den anderen Eingaben durchgeführt.
Boolean

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster.

Jede Zelle im Ausgabe-Raster stellt den Wert an der gleichen Position der Eingabe-Raster dar, der dem Eingabepopularitätswert entspricht.

Raster

Popularity(in_popularity_raster_or_constant, in_rasters, {process_as_multiband})
NameErläuterungDatentyp
in_popularity_raster_or_constant

Das Eingabe-Raster, das die Popularitätsposition definiert, die zurückgegeben werden soll.

Eine Zahl kann als Eingabe verwendet werden, Sie müssen jedoch zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant
in_rasters
[in_raster,...]

Die Liste der Eingabe-Raster, die verwendet werden, um die Popularität der Werte für jede Zellenposition auszuwerten.

Raster Layer
process_as_multiband
(optional)

Legt fest, wie die Bänder von Eingabemultiband-Rastern verarbeitet werden.

  • SINGLE_BANDJedes Band aus einer Multiband-Raster-Eingabe wird gesondert als Einzelband-Raster verarbeitet. Dies ist die Standardeinstellung.
  • MULTI_BANDJede Multiband-Raster-Eingabe wird als Multiband verarbeitet. Der Vorgang wird für jedes Band aus einer Eingabe mit der entsprechenden Bandnummer aus den anderen Eingaben durchgeführt.
Boolean

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster.

Jede Zelle im Ausgabe-Raster stellt den Wert an der gleichen Position der Eingabe-Raster dar, der dem Eingabepopularitätswert entspricht.

Raster

Codebeispiel

Popularity – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird eine Popularitätsoperation für mehrere Eingabe-Raster ausgeführt und das Ergebnis als IMG-Raster ausgegeben.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPopularity = Popularity("cost", ["degs", "negs", "fourgrd"])
outPopularity.save("C:/sapyexamples/output/outpop.img")
Popularity – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird eine Popularitätsoperation für mehrere Eingabe-Raster ausgeführt und das Ergebnis als Grid-Raster ausgegeben.

# Name: Popularity_Ex_02.py
# Description: Determines the value in an argument list that is
#              at a certain level of popularity 
# 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
inPopularityRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Execute Popularity
outPopularity = Popularity(inPopularityRaster, [inRaster01, inRaster02, inRaster03])

# Save the output 
outPopularity.save("C:/sapyexamples/output/outpop")

Verwandte Themen