Побитовый оператор Right Shift (Image Analyst)

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

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

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

Выполняет побитовую операцию "Сдвиг вправо" над двоичными значениями входного растра.

Более подробно о работе побитовых математических инструментов

Иллюстрация

Рисунок инструмента Побитовый оператор Right Shift
OutRas = BitwiseRightShift(InRas1, 1)

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

  • Для выполнения этой побитовой операции необходимо наличие двух входных файлов.

  • Порядок входных данных имеет значение для этого инструмента.

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

  • В побитовых операциях верно следующее:

    • Бинарные значения хранятся в виде поразрядного дополнения до двух.
    • Инструменты работают с 32-битовыми целыми числами.
    • Крайняя левая битовая позиция резервируется для знака значения (положительного или отрицательного). Если целое число положительное, битовая позиция равна нулю; если оно отрицательное, битовая позиция равна единице.

  • Побитовая операция сдвига вправо не выполняет свертывания бит. Крайний правый бит отбрасывается.

  • Если оба входных растра являются одноканальными или на входе имеется константа, на выходе получится одноканальный растр.

  • Если оба входных растра являются многоканальными, инструмент будет выполнять операцию над каждый каналом, а выходной растр будет многоканальным. Число каналов всех многоканальных растров должно быть одинаковым.

  • Если один из входных растров является многоканальным, а другие входные данные - константами, инструмент выполняет операцию, используя постоянное значение для каждого канала многоканального входного растра, а выходной растр будет многоканальным.

  • Если все входные данные представляют собой многомерные растровые данные с одинаковым количеством переменных, инструмент выполнит операцию для всех срезов с одинаковым значением размерности. Результатом будет многомерный растр в формате CRF. Переменные во входных данных должны иметь по крайней мере одно общее измерение и одно общее значение измерения для обработки этим инструментом, в противном случае произойдет ошибка.

    Если у всех входных данные есть одна переменная, но разные имена, снимите отметку Сопоставить многомерную переменную для среды геообработки (задайте arcpy.env.matchMultidimensionalVariable = False в Python) перед запуском инструмента.

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

  • В алгебре карт эквивалентным символом для этого оператора ">>" (ссылка).

Параметры

ПодписьОписаниеТип данных
Входной растр или постоянное значение 1

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

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

Raster Layer; Constant
Входной растр или постоянное значение 2

Входной растр, определяющий число позиций для сдвига бит.

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

Raster Layer; Constant

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

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

Выходной растр.

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

Raster

BitwiseRightShift(in_raster_or_constant1, in_raster_or_constant2)
ИмяОписаниеТип данных
in_raster_or_constant1

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

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

Raster Layer; Constant
in_raster_or_constant2

Входной растр, определяющий число позиций для сдвига бит.

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

Raster Layer; Constant

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

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

Выходной растр.

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

Raster

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
outBitwiseRShift = BitwiseRightShift("degs", "negs")
outBitwiseRShift.save("C:/iapyexamples/output/outbitrs")
BitwiseRightShift, пример 2 (автономный скрипт)

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

# Name: BitwiseRightShift_Ex_02.py
# Description: Performs a Bitwise Right Shift operation on the binary
#              values of two input rasters
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

# Set environment settings
env.workspace = "C:/iapyexamples/data"

# Set local variables
inRaster1 = "degs"
inRaster2 = "negs"

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Execute BitwiseRightShift
outBitwiseRShift = BitwiseRightShift(inRaster1, inRaster2)

# Save the output 
outBitwiseRShift.save("C:/iapyexamples/output/outbitrshift.img")

Информация о лицензиях

  • Basic: Обязательно Image Analyst или Spatial Analyst
  • Standard: Обязательно Image Analyst или Spatial Analyst
  • Advanced: Обязательно Image Analyst или Spatial Analyst

Связанные разделы