Calculadora ráster (Análisis espacial)
Resumen
Construye y ejecuta una expresión simple de álgebra de mapas utilizando la sintaxis de Python en una interfaz símil calculadora.
Ilustración
 |
Raster Calculator tool dialog box example |
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:
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:Cuando escriba los nombres de la herramienta, asegúrese de que revisa 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 la secuencia de comandos de Python. Las únicas diferencias son las siguientes:
- No necesita colocar el nombre del ráster de salida o 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 la 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 encerrarán entre símbolos de comilla doble ("").
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 encerrarán entre símbolos de comilla doble ("").
- En ModelBuilder, los siguientes tipos de variables son entradas válidas para una expresión:
- Cadena de caracteres
- 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 volver a nombrar una variable que está conectada a la herramienta, dado que la variable no se volverá a nombrar 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:
Nota:La herramienta Calculadora ráster está diseñada para utilizarse en la aplicación ArcGIS Desktop sólo como un cuadro de diálogo de la herramienta GP o en ModelBuilder. No está diseñada para utilizarse en secuencias de comando y no está disponible en el módulo ArcPy Spatial Analyst.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
expression | Nota: En Python, las expresiones del álgebra de mapa 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 mapa en el Spatial Analyst para más información sobre cómo realizar su análisis en Python. | String |
output_raster | Nota: Ver Crear la salida de la álgebra de mapa para obtener información sobre la salida de producción de las expresiones de Álgebra de mapa en Python. | Raster Dataset |