Lookup (Spatial Analyst)

Zusammenfassung

Erstellt ein Raster durch die Suche nach Werten in einem anderen Feld in der Tabelle des Eingabe-Rasters.

Abbildung

Abbildung: Lookup
OutRas = Lookup(InRas1, "Category")

Verwendung

  • Es werden numerische Felder (Ganzzahl oder Gleitkomma) und Zeichenfolgenfelder unterstützt. Wenn das Feld eine Ganzzahl oder eine Zeichenfolge aufweist, ist die Ausgabe ein Ganzzahl-Raster. Andernfalls ist das Ausgabe-Raster ein Gleitkomma-Raster.

  • Wenn das Lookup-Feld eine Ganzzahl aufweist, werden die Werte dieses Feldes als "Value" in die Attributtabelle des Ausgabe-Rasters geschrieben. Die anderen Felder in der Attributtabelle des Eingabe-Rasters werden nicht in die Attributtabelle des Ausgabe-Rasters übertragen.

    Beispiel: Eine Attributtabelle des Eingabe-Rasters mit einem Zahlenfeld Attr1

        Value   Count   Attr1
        1       294     1
        2       345     8
        3       654     3

    Ausgabe-Attributtabelle der Funktion Lookup für das Feld Attr1

        Value   Count
        1       294
        3       654
        8       345
  • Wenn das Lookup-Feld ein Zeichenfolgenfeld ist, wird das Lookup-Feld in der Attributtabelle des Ausgabe-Rasters angezeigt, und das Wertefeld entspricht dem numerischen Typ des Eingabe-Rasters. Die anderen Felder in der Attributtabelle des Eingabe-Rasters werden nicht in die Attributtabelle des Ausgabe-Rasters übertragen.

    Beispiel: Die Attributtabelle eines Eingabe-Rasters mit einem Zeichenfolgenfeld Text1

        Value   Count   Attr1   Text1
        1        294    1       A
        2       6218    8       B
        3         28    3
        4       3603    9       3

    Die Attributtabelle des Ausgabe-Rasters nach Ausführung der Funktion Lookup für das Feld Text1 sieht folgendermaßen aus:

        Value   Count   Text1
        1        294    A
        2       6218    B
        3         28    
        4       3603    3

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster

Das Eingabe-Raster mit dem Feld, aus dem ein neues Raster erstellt werden soll.

Raster Layer
Lookup-Feld

Das Feld mit den gewünschten Werten für das neue Raster.

Es kann ein numerisches oder ein Zeichenfolgenfeld sein.

Field

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster, dessen Werte durch das angegebene Feld des Eingabe-Rasters bestimmt werden.

Raster

Lookup(in_raster, lookup_field)
NameErläuterungDatentyp
in_raster

Das Eingabe-Raster mit dem Feld, aus dem ein neues Raster erstellt werden soll.

Raster Layer
lookup_field

Das Feld mit den gewünschten Werten für das neue Raster.

Es kann ein numerisches oder ein Zeichenfolgenfeld sein.

Field

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster, dessen Werte durch das angegebene Feld des Eingabe-Rasters bestimmt werden.

Raster

Codebeispiel

Lookup – Beispiel 1 (Python-Fenster)

In diesem Beispiel wird ein neues Raster erstellt, das durch das angegebene Feld des Eingabe-Rasters festgelegt wird.

import arcpy
from arcpy import env  
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRaster = Lookup("mycity","land_code")
outRaster.save("C:/sapyexamples/output/mylandcode.img")
Lookup – Beispiel 2 (eigenständiges Skript)

In diesem Beispiel wird ein neues Raster erstellt, das durch das angegebene Feld des Eingabe-Rasters festgelegt wird.

# Name: lookup_example02.py
# Description: Creates a new raster by looking up values found in another 
#              field in the table of the input raster.
# 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 = "mycity"
lookupField = "land_code"

# Execute Lookup
outRaster = Lookup(inRaster, lookupField)

# Save the output 
outRaster.save("C:/sapyexamples/output/mylandcode")