Calculadora ráster (Image Analyst)

Disponible con una licencia de Spatial Analyst.

Disponible con licencia de Image Analyst.

Resumen

Crea y ejecuta una expresión de Álgebra de mapas única válida con sintaxis de Python.

Más información sobre cómo funciona Calculadora ráster

Ilustración

Cuadro de diálogo de la herramienta Calculadora ráster
Ejemplo del cuadro de diálogo de la herramienta Calculadora ráster

Uso

    Nota:

    La herramienta Calculadora ráster se ha diseñado para el uso en la aplicación solo como un cuadro de diálogo de la herramienta GP o en ModelBuilder. No se ha diseñado para usarla en secuencias de comandos y no está disponible en el módulo Spatial Analyst de ArcPy.

  • La herramienta Calculadora ráster permite crear y ejecutar una expresión de Álgebra de mapas que generará como salida un ráster.

  • Utilice la lista Rásteres para seleccionar los datasets y las variables que se deben utilizar en la expresión. La lista Herramientas proporciona una selección de las herramientas matemáticas y condicionales utilizadas con frecuencia, lo que permite agregarlas fácilmente a la expresión. Los valores numéricos (y los símbolos de los operadores matemáticos) se pueden agregar directamente a la expresión.

  • Las rutas completas a los datos o los datos existentes en la configuración del entorno del espacio de trabajo actual especificado se pueden introducir entre comillas (""). Los números y los escalares pueden introducirse directamente en una expresión.

  • Los operadores en el cuadro de diálogo de la herramienta Calculadora ráster son:

  • Las operaciones o herramientas de geoprocesamiento diversas se pueden combinar como expresión de álgebra de mapas al utilizar una sintaxis de Python estándar.

    Precaución:

    Al escribir nombres de herramientas, compruebe la sintaxis del nombre de la herramienta. Dado que Python distingue entre mayúsculas y minúsculas, la expresión será no válida y no se podrá ejecutar si el uso de mayúsculas y minúsculas es incorrecto.

    Un ejemplo del formato general de la expresión de Álgebra de mapas al utilizar herramientas de geoprocesamiento es:

    Con(IsNull("streams"), 0, "streams")

  • La herramienta admite la sintaxis de Álgebra de mapas estándar que se utiliza en el script de Python. Las únicas diferencias son las siguientes:

    • No necesita incluir el nombre del ráster de salida ni el signo = en la expresión porque el nombre de salida se especifica en el parámetro Ráster de salida.
    • No es necesario convertir los datos de entrada como un objeto Ráster al usar operadores.

  • Puede recortar fácilmente un dataset ráster configurando el entorno de extensión y especificando el nombre del ráster de entrada en la expresión. Cuando se ejecuta la herramienta, la salida del ráster resultante se recortará según la extensión especificada.

  • Para crear un ráster con celdas de un valor constante, especifique las configuraciones de entorno de tamaño de celda y extensión apropiadas e introduzca el valor numérico en la expresión.

  • Cuando se utilizan varios operadores en una expresión, no necesariamente se ejecutan por orden de izquierda a derecha. El operador con el valor de jerarquía más alto será el que se ejecute primero. Para obtener más información, consulte la tabla de jerarquía del operador en Trabajar con operadores en Álgebra de mapas. Puede utilizar paréntesis para controlar el orden de ejecución.

  • Los operadores booleanos (~, &, ^, |) tienen un nivel más alto en la jerarquía que los operadores relacionales (<, <=, >, >=, ==, !=). Por consiguiente, los operadores booleanos se utilizan en la misma expresión que los operadores relacionales, pero los booleanos se ejecutan primero. Para cambiar el orden de la ejecución, utilice paréntesis.

  • Cuando se utilizan varios operadores booleanos y/o relacionales en una sola expresión, en algunos casos puede producirse un error de ejecución. Para evitar este posible problema, utilice paréntesis adecuados en la expresión para definir de manera explícita el orden de ejecución de los operadores. Para obtener más información, consulte la sección de reglas de sentencias complejas de Crear sentencias complejas.

  • El rendimiento de una operación se puede mejorar mediante las capacidades de evaluación diferida de Álgebra de mapas. La evaluación diferida es una técnica de optimización donde los componentes individuales de una expresión se procesan de manera inteligente para minimizar la creación de datasets intermedios en el disco.

    Sólo los operadores y las herramientas que se procesan por celda pueden aprovechar esta capacidad. Los operadores y las herramientas que admiten la evaluación diferida se incluyen en la misma herramienta calculadora ráster como un botón o en la lista de las herramientas proporcionadas.

  • La herramienta Calculadora ráster se puede utilizar en ModelBuilder, pero tenga en cuenta los siguientes puntos:

    • La sintaxis de la expresión determina cómo se especifican las variables. Si selecciona una variable de la lista de variables, se agregará automáticamente a la expresión en la ubicación actual del cursor. En la validación del modelo:
      • Los nombres de capa se escribirán entre símbolos de comillas dobles ("").

        Ejemplo: "inlayer"

      • Las variables largas, dobles o booleanas se encerrarán entre símbolos de porcentaje (%%). No deben estar entre comillas.

        Ejemplo: %scale_factor%

      • Las variables que representan las cadenas de caracteres o los nombres del dataset deben encerrarse entre comillas y símbolos de porcentaje ("%%").

        Por ejemplo, inraster, cuando se selecciona de la lista de variables, se convertirá en "%inraster%" en la expresión.

    • En ModelBuilder, los siguientes tipos de variables son entradas válidas para una expresión:
      • Cadena de caracteres
      • Booleanos
      • Numérico (doble y larga)
      • Datos (dataset ráster, capa ráster, banda de ráster, archivo de capa .lyr)
    • Por lo general, la herramienta Calculadora ráster sigue el comportamiento de conectividad estándar de modelos en ModelBuilder, con algunas excepciones que resultan de los requisitos de formular una expresión de Álgebra de mapas válida. Estas incluyen lo siguiente:
      • Las variables se conectan a la herramienta Calculadora ráster cuando se seleccionan desde la lista de variables. Todas las variables se incluyen automáticamente en la lista Variables dentro de la herramienta.
      • Cuando se utiliza un dataset o una variable en la expresión, se crea un vínculo entre la variable y la herramienta. Si quita la variable de la expresión, el vínculo asociado entre la variable y la herramienta también se quitará.
      • Si elimina la conexión a una variable, la variable no se quita de la expresión.
      • No debe cambiar el nombre de una variable que esté conectada a la herramienta, dado que el nombre de la variable no cambiará dentro de la expresión. Si lo hace, la expresión será no válida.
  • Determinados Entornos de almacenamiento de ráster pueden aplicar esta herramienta si la salida tiene un formato de ráster distinto de Cuadrícula de Esri.

    • En los entornos de Estadísticas de ráster, solo se admite la casilla de verificación Calcular estadísticas.
    • Para los entornos de Compresión, solo se admite el tipo de Compresión. Este entorno solo se aplicará cuando la salida vaya a ser de tipo entero. La compresión no se admite en los rásteres de punto flotante, de modo que este entorno solo se usará cuando la salida vaya a ser de tipo entero.
    • El entorno de Tamaño de tesela solo se admite en la salida de ráster en los siguientes formatos: TIFF, geodatabase de archivos o geodatabase corporativa.
  • Si todas las entradas son datos ráster 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. La salida será un ráster multidimensional en formato CRF. La variable de las entradas debe tener al menos una dimensión común y un valor dimensional común para que esta herramienta procese; de lo contrario, se producirá un error.

    Si todas las entradas tienen una variable pero nombres diferentes, desactive el entorno de geoprocesamiento Variable multidimensional coincidente (definido como arcpy.env.matchMultidimensionalVariable = False en Python) antes de ejecutar la herramienta.

    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.

Parámetros

EtiquetaExplicaciónTipo de datos
Expresión de álgebra de mapas

La expresión de Álgebra de mapas que desee ejecutar.

Para componer la expresión se especifican las entradas, los valores, los operadores y las herramientas que se quieran utilizar. Puede escribir la expresión directamente o utilizar los controles, que le ayudarán a crearla.

  • La lista Rásteres identifica los datasets disponibles para su uso en la expresión de Álgebra de mapas.
  • La lista de Herramientas incluye una selección de las herramientas que se utilizan con más frecuencia para que pueda elegir entre ellas.
Raster Calculator Expression
Ráster de salida

El ráster de salida que resulta de la expresión de Álgebra de mapas.

Raster Dataset

RasterCalculator(expression, output_raster)
NombreExplicaciónTipo de datos
expression
Nota:

En Python, las expresiones del Álgebra de mapas se deben crear y ejecutar con el módulo Spatial Analyst, que es una extensión del paquete del sitio ArcPy Python.

Consulte Álgebra de mapas en el Spatial Analyst para más información sobre cómo realizar su análisis en Python.

Raster Calculator Expression
output_raster
Nota:

Consulte Crear salida para obtener información sobre la salida de las expresiones de Álgebra de mapas en Python.

Raster Dataset

Información de licenciamiento

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

Temas relacionados