Skip to main content

Auf NULL setzen (Spatial Analyst Tools)

Zusammenfassung

Legt identifizierte Zellenpositionen basierend auf einem angegebenen Kriterium auf "NoData" fest. "NoData" wird zurückgegeben, wenn eine Bedingungsauswertung "true" (wahr) ergibt, und ein durch ein anderes Raster angegebener Wert wird zurückgegeben, wenn die Bedingungsauswertung "false" (falsch) ergibt.

Weitere Informationen zum Festlegen von Zellenwerten auf "NoData" mit dem Werkzeug "Auf NULL setzen"

Abbildung

Abbildung: "Auf NULL setzen"

OutRas = SetNull(InRas1, InRas2, "Value = 4")

Verwendung

  • Wenn die Auswertung für die Where-Klausel den Wert "true" (wahr) ergibt, wird der Zellenposition im Ausgabe-Raster der Wert "NoData" zugewiesen. Wenn die Auswertung den Wert "false" (falsch) ergibt, wird das Ausgabe-Raster durch das Eingabe-Raster mit der Bedingung "false" oder einen konstanten Wert definiert.

  • Wenn keine Where-Klausel angegeben wird, hat das Ausgabe-Raster überall dort den Wert "NoData", wo das Bedingungs-Raster nicht 0 ist.

  • Das Eingabe-Bedingungs-Raster beeinflusst nicht, ob der Ausgabedatentyp eine ganze Zahl oder ein Gleitkommawert ist. Wenn das Eingabe-Raster mit der Bedingung "false" (bzw. der konstante Wert) Gleitkommawerte enthält, handelt es sich beim Ausgabe-Raster ebenfalls um Gleitkommazahlen. Wenn es ausschließlich ganzzahlige Werte enthält, wird ein ganzzahliges Raster ausgegeben.

  • Wenn das Eingabe-Bedingungs-Raster (in_conditional_raster in Python) ein Einzelband-Raster ist und Eingabe-Raster oder Eingabe-Wert, wenn Bedingung FALSCH (in_false_raster_or_constant in Python) ein konstanter Wert ist, ist die Ausgabe ein Einzelband-Raster.

  • Wenn beide Eingaben Multiband-Raster sind, ist auch die Ausgabe ein Multiband-Raster. Das Ausgabe-Raster ist ebenfalls ein Multiband-Raster, wenn "Eingabe-Raster wenn Bedingung FALSCH" ein konstanter Wert ist. Die Anzahl an Bändern in jeder Multiband-Eingabe muss identisch sein.

  • Das Werkzeug führt den Vorgang für jedes Band aus dem Bedingungs-Raster mit dem entsprechenden Band aus der anderen Eingabe durch. Wenn die Eingabe-Bedingung ein Multiband-Raster ist und "Eingabe-Raster, wenn Bedingung FALSCH" ein konstanter Wert ist, führt das Werkzeug den Vorgang für jedes Band in der Multiband-Eingabe mit dem konstanten Wert durch.

  • Der Ausdruck verwendet eine SQL-Abfrage. Weitere Informationen zum Erstellen von Abfragen finden Sie in den folgenden Themen:

  • Um in Python eine {where_clause} (WHERE-Klausel) zu verwenden, setzen Sie sie in Anführungszeichen. Beispiel: "Value > 5000".

    Weitere Informationen zum Festlegen einer Abfrage in Python finden Sie in der Hilfe.

  • Die maximale Länge des logischen Ausdrucks ist 4.096 Zeichen.

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

Parameter

Beschriftung Erläuterung Datentyp

Eingabe-Bedingungs-Raster

Das Eingabe-Raster, das das Ergebnis der gewünschten Bedingung als wahr (true) oder falsch (false) darstellt.

Das Raster kann ein Ganzzahl- oder Gleitkomma-Raster sein.

Raster Layer

Eingabe-Raster oder Eingabe-Wert, wenn Bedingung FALSCH

Die Eingabe, deren Werte als Ausgabezellenwerte verwendet werden, wenn die Bedingung falsch (false) ist.

Das Raster kann ein Integer- oder Gleitkomma-Raster oder ein konstanter Wert sein.

Raster Layer; Constant

Ausdruck

(Optional)

Ein logischer Ausdruck, der bestimmt, welche der Eingabezellen wahr (true) oder falsch (false) sind.

Die Where-Klausel entspricht der allgemeinen Form eines SQL-Ausdrucks. Er kann direkt eingegeben werden, z. B. VALUE > 100, indem Sie auf die Schaltfläche SQL-Bearbeitungsmodus klicken. Im Modus "Klausel bearbeiten" können Sie mit dem Erstellen des Ausdrucks beginnen, indem Sie auf die Schaltfläche Modus "Klausel hinzufügen" klicken.

SQL Expression

Rückgabewert

Beschriftung Erläuterung Datentyp

Ausgabe-Raster

Das Ausgabe-Raster.

Wenn die Bedingungsauswertung "true" (wahr) ergibt, wird "NoData" zurückgegeben. Bei "false" (falsch) wird der Wert des zweiten Eingabe-Rasters zurückgegeben.

Raster

Umgebungen

Auto-Commit, Zellengröße, Projektionsmethode für Zellengröße, Komprimierung, Aktueller Workspace, Ausdehnung, Geographische Transformationen, Maske, Ausgabe-CONFIG-Schlüsselwort, Ausgabe-Koordinatensystem, Scratch-Workspace, Fang-Raster, Kachelgröße

Lizenzierungsinformationen

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