| Etiqueta | Explicación | Tipo de datos |
Expresión de álgebra de mapas | La expresión de álgebra de mapas que se ejecutará. Cree la expresión especificando las entradas, valores, operadores y herramientas que se quieran utilizar. Puede escribir la expresión directamente o utilizar los controles para crearla.
| Raster Calculator Expression |
Ráster de salida | El ráster de salida que resulta de la expresión de álgebra de mapas. | Raster Dataset |
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.
Ilustración
Uso
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 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 compatibles se enumeran en la siguiente tabla:
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, asegúrese de que la sintaxis del nombre de la herramienta es correcta. 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 igual (=) 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 Raster al usar operadores.
Puede recortar 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 hay 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. Utilice 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 ejecución de los operadores, utilice paréntesis.
Cuando se utilizan varios operadores booleanos o relacionales de forma consecutiva en una sola expresión, en algunos casos puede producirse un error de ejecución de la expresión. Para evitarlo, 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 Reglas de declaraciones 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 en la que 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 detalles:
La sintaxis de la expresión determina cómo se especificarán 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. Tras la validación del modelo, ocurre lo siguiente:
- 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 se encerrarán entre comillas y símbolos de porcentaje ("%%").
Por ejemplo, inraster se verá como "%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 en 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 cambie 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 cambia el nombre de una variable, la expresión no será válida.
- Los nombres de capa se escribirán entre símbolos de comillas dobles ("").
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.
Nota:
La herramienta Calculadora ráster solo está disponible para su uso en la aplicación a través del panel Geoprocesamiento o en ModelBuilder. No se ha diseñado para usarla en secuencias de comandos y no está disponible en el móduloImage Analyst de ArcPy.
Parámetros
RasterCalculator(expression, output_raster)
| Nombre | Explicación | Tipo de datos |
expression | Nota:En Python, cree y ejecute expresiones de álgebra de mapas utilizando el módulo Image Analyst, que es una extensión del paquete del sitio Python de ArcPy. Consulte Álgebra de mapas para aprender a realizar un análisis en Python. | Raster Calculator Expression |
output_raster | Nota:Consulte Crear salida para obtener información sobre la producción de salida a partir de expresiones de álgebra de mapas en Python. | Raster Dataset |
Entornos
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