Disponible con una licencia de Spatial Analyst.
Resumen
Construye y ejecuta una expresión simple de Álgebra de mapas utilizando la sintaxis de Python en una interfaz similar a una calculadora.
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 Capas y variables para seleccionar los datasets y las variables a utilizar en la expresión. Los valores numéricos y los operadores matemáticos se pueden agregar a la expresión haciendo clic en los botones respectivos en el cuadro de diálogo de la herramienta. Se proporciona una lista de herramientas matemáticas y condicionales utilizadas comúnmente, lo que permite agregarlas fácilmente 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:
/
(División)
==
(Igual a)
!=
&
*
>
>=
|
-
<
<=
^
+
(Adición)
~
Operadores de Álgebra de mapas 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.
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 debe 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 en orden de izquierda a derecha. El operador con el valor de jerarquía más alta se ejecutará primero. Para obtener más información sobre la jerarquía del operador, consulte la tabla jerarquía del operador. Puede utilizar paréntesis para controlar el orden de ejecución.
Los operadores booleanos (~, &, ^, |) tienen un nivel de jerarquía mayor que los operadores relacionales (<, <=, >, >=, ==, !=). Por lo tanto, cuando los operadores booleanos se utilizan en la misma expresión como los operadores relacionales, los operadores booleanos se ejecutan primero. Para cambiar el orden de la ejecución, utilice paréntesis.
Cuando varios operadores relacionales o booleanos se utilizan consecutivamente en una expresión simple, en algunos casos no se podrá ejecutar. Para evitar este posible problema, utilice los paréntesis apropiados en la expresión, de manera que el orden de ejecución de los operadores esté explícitamente definido. 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 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.
- Los nombres de capa se escribirán entre símbolos de comillas dobles ("").
- En ModelBuilder, los siguientes tipos de variables son entradas válidas para una expresión:
- Cadena
- Booleano
- 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.
- 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:
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.
Sintaxis
RasterCalculator(expression, output_raster)
Parámetro | Explicación | Tipo de datos |
expression | Raster Calculator Expression | |
output_raster | Raster Dataset |
Entornos
Información de licenciamiento
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst