Bitwise Left Shift (Spatial Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Ejecuta una operación del método Bitwise Left Shift sobre los valores binarios de dos rásteres de entrada.

Más información acerca de cómo funcionan las herramientas de Matemática a nivel de bits

Ilustración

Ilustración de Bitwise Left Shift
OutRas = BitwiseLeftShift(InRas1, 1)

Uso

  • Se necesitan dos entradas para que ocurra esta operación bit a bit.

  • El orden de entradas es importante para esta herramienta.

  • Si una entrada es de punto flotante, los valores se convierten a valores enteros mediante el truncamiento antes de que ocurra la operación bit a bit.

  • En las operaciones bit a bit, se cumplen las siguientes afirmaciones:

    • Los valores binarios se almacenan en complementos de dos.
    • Las herramientas funcionan con enteros de 32 bits.
    • La posición de bit situado más a la izquierda se reserva para el signo (positivo o negativo) del valor. Si el entero es positivo, la posición del bit es 0; si es negativo, la posición del bit es 1.

  • La operación del método Bitwise Left Shift no ajusta los bits. El bit que está más a la izquierda se quita.

  • Si ambas entradas son rásteres de banda única o una de las entradas es una constante, la salida será un ráster de banda única.

  • Si ambas entradas son rásteres multibanda, la herramienta realizará la operación en cada banda desde una entrada y la salida será un ráster multibanda. El número de bandas en cada entrada multibanda debe ser el mismo.

  • Si una de las entradas es un ráster multibanda y la otra entrada es una constante, la herramienta realizará la operación con el valor constante de cada banda de la entrada multibanda, y la salida será un ráster multibanda.

  • En ArcPy, si ambas entradas son rásteres multidimensionales con el mismo número de variables, la herramienta realizará la operación para todas las porciones con el mismo valor de dimensión y la salida será un ráster multidimensional. Las variables en las entradas deben tener las mismas dimensiones o dimensión común, pero no dimensiones inusuales.

    Si ambas entradas tienen una variable pero nombres diferentes, establezca el entorno de geoprocesamiento matchMultidimensionalVariable en False para realizar la operación.

    En ArcPy, si una de las entradas es un ráster multidimensional y la otra entrada es una constante, la herramienta realizará la operación en todas las porciones de todas las variables respecto al valor constante y la salida será un ráster multidimensional.

  • En Álgebra de mapas, el símbolo del operador equivalente para esta herramienta es "<<" (vínculo).

  • Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Ráster de entrada o valor constante 1

La entrada en la cual se realiza el cambio.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant
Ráster de entrada o valor constante 2

La entrada que define la cantidad de posiciones para cambiar los bits.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant

Valor de retorno

EtiquetaExplicaciónTipo de datos
Ráster de salida

El ráster de salida.

Los valores de celda son el resultado de una operación de método Bitwise Left Shift en las entradas.

Raster

BitwiseLeftShift(in_raster_or_constant1, in_raster_or_constant2)
NombreExplicaciónTipo de datos
in_raster_or_constant1

La entrada en la cual se realiza el cambio.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant
in_raster_or_constant2

La entrada que define la cantidad de posiciones para cambiar los bits.

Se puede utilizar un número como entrada para este parámetro, siempre que se especifique un ráster para el otro parámetro. Para especificar un número para ambas entradas, previamente se deben establecer en el entorno el tamaño de la celda y la extensión.

Raster Layer; Constant

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de salida.

Los valores de celda son el resultado de una operación de método Bitwise Left Shift en las entradas.

Raster

Muestra de código

Ejemplo 1 de BitwiseLeftShift (ventana de Python)

Este ejemplo desplaza a la izquierda los valores de la primera entrada por el número de bits definidos por la segunda entrada y genera el resultado como un ráster TIFF.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outBitwiseLS = BitwiseLeftShift("degs", "negs")
outBitwiseLS.save("C:/sapyexamples/output/outbitls.tif")
Ejemplo 2 de BitwiseLeftShift (script independiente)

Este ejemplo desplaza a la izquierda los valores de la primera entrada por el número de bits definidos por la segunda entrada.

# Name: BitwiseLeftShift_Ex_02.py
# Description: Performs a Bitwise Left Shift operation on the binary
#              values of two input rasters
# 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
inRaster1 = "degs"
inRaster2 = "negs"

# Execute BitwiseLeftShift
outBitwiseLShift = BitwiseLeftShift(inRaster1, inRaster2)

# Save the output 
outBitwiseLShift.save("C:/sapyexamples/output/outlshift")

Información de licenciamiento

  • Basic: Requiere Spatial Analyst o Image Analyst
  • Standard: Requiere Spatial Analyst o Image Analyst
  • Advanced: Requiere Spatial Analyst o Image Analyst

Temas relacionados