Справочная перекодировка (Spatial Analyst)

Доступно с лицензией Spatial Analyst.

Доступно с лицензией 3D Analyst.

Краткая информация

Создает растр при помощи перекодировки на основе значений другого поля в таблице входного растра.

Иллюстрация

Иллюстрация инструмента Справочная перекодировка
OutRas = Lookup(InRas1, "Category")

Использование

  • Поддерживаются как числовые (целочисленные и с плавающей точкой), так и строковые поля. Если поле целочисленное или текстовое, выходной растр будет целочисленным; в противном случае выходной растр будет растром с плавающей точкой.

  • Если поле перекодировки является целочисленным, значения этого поля будут записаны в таблицу атрибутов выходного растра как значение (в поле Value). Остальные поля таблицы атрибутов входного растра не будут перенесены в таблицу атрибутов выходного растра.

    В качестве примера приведена таблица атрибутов входного растра с числовым полем Attr1

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

    Таблица атрибутов, полученная после применения инструмента Справочная перекодировка к полю Attr1

        Value   Count
        1       294
        3       654
        8       345
  • Если поле перекодировки является строковым, оно будет включено в таблицу атрибутов выходного растра, при этом поле значения будет в числовом формате, совпадающим с полем значений входного растра. Никакие другие поля таблицы атрибутов входного растра не будут перенесены в таблицу атрибутов выходного растра.

    В качестве примера приведена таблица атрибутов входного растра со строковым полем Text1

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

    Таблица атрибутов выходного растра, полученного в результате применения инструмента Справочная перекодировка для поля Text1, будет следующей

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

Параметры

ПодписьОписаниеТип данных
Входной растр

Входной растр, содержащий поле, на основании значений которого будет создан новый растр.

Raster Layer
Справочное поле

Поле, содержащее желаемые значения для нового растра.

Может быть числовым или строковым.

Field

Возвращаемое значение

ПодписьОписаниеТип данных
Выходной растр

Выходной растр, значения которого определены по заданному полю входного растра.

Raster

Lookup(in_raster, lookup_field)
ИмяОписаниеТип данных
in_raster

Входной растр, содержащий поле, на основании значений которого будет создан новый растр.

Raster Layer
lookup_field

Поле, содержащее желаемые значения для нового растра.

Может быть числовым или строковым.

Field

Возвращаемое значение

ИмяОписаниеТип данных
out_raster

Выходной растр, значения которого определены по заданному полю входного растра.

Raster

Пример кода

Lookup, пример 1 (окно Python)

В этом примере создается новый растр, определенный по заданному полю входного растра.

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, пример 2 (автономный скрипт)

В этом примере создается новый растр, определенный по заданному полю входного растра.

# 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")