Calcular valor (ModelBuilder)
Resumen
La herramienta Calcular valor devuelve un valor a partir de una expresión de Python especificada.
Uso
-
La herramienta esta pensada para utilizarse solo en ModelBuilder y no en secuencias de comandos de Python.
-
El parámetro Tipo de datos se utiliza en ModelBuilder para ayudar a conectar la salida de la herramienta Calcular valor con otras herramientas. Por ejemplo, si utiliza la herramienta Calcular valor para calcular una distancia que se utilizará como entrada del parámetro Distancia de zona de influencia de la herramienta Zona de influencia, especifique una unidad lineal para el parámetro Tipo de datos.
-
Con la herramienta Calcular valor se pueden utilizar las variables creadas con ModelBuilder, pero no se pueden conectar las variables que se desean utilizar en el parámetro de expresión. Para utilizar estas variables dentro de la expresión, encierre los nombres de las variables entre signos de porcentaje (%). Por ejemplo, si desea dividir una variable denominada "Entrada" por 100, la expresión sería %Entrada%/100.
Nota: en la expresión anterior, si Entrada es igual a 123, la expresión devolverá 1. Para obtener posiciones decimales, agregue decimales a los valores de la expresión. Por ejemplo: %Entrada%/100,00 devolverá 1,23. En la ilustración siguiente se muestra otro ejemplo del uso de variables en la expresión.
Precaución:En una expresión, la variable en línea de tipo cadena de caracteres debe estar entre comillas ("%variable tipo cadena de caracteres%"). Las variables en línea de tipo numérico (dobles, largas) no requieren comillas (%doble%).
-
Las expresiones SOLO se pueden crear en formato Python estándar. Los demás lenguajes de secuencias de comandos no son compatibles.
-
La herramienta Calcular valor puede evaluar expresiones matemáticas simples. Por ejemplo:
- 3+5
- 9*8
- 4+(9/3)
-
La herramienta Calcular valor permite el uso de módulo de matemática de Python para realizar operaciones matemáticas más complejas. Para acceder a este módulo, se debe anteponer "math" a la función deseada. Por ejemplo:
- math.sqrt(25)
- math.cos(0,5)
-
El módulo de matemática también admite constantes. Por ejemplo:
- math.pi
-
La función arcgis.rand() está admitida. Esta función se creó para las herramientas de ArcGIS y no debe confundirse con la función Rand() de Python. A continuación se presentan ejemplos del uso de la función arcgis.rand():
- Calcular un valor aleatorio derivado de una distribución uniforme de números enteros entre 0 y 10: arcgis.rand("Integer 0 10")
- Calcular un valor aleatorio derivado de una distribución normal con un valor medio de 10 y una desviación estándar de 3: arcgis.rand("Normal 10 3")
Precaución:La expresión arcgis.rand se debe introducir con caracteres en minúscula.
-
Por lo general, introducirá las expresiones en el parámetro Expresión. Las expresiones más complejas, como cálculos u operaciones lógicas de varias líneas (if, then), requieren el uso del parámetro Código bloque. Este parámetro no se puede utilizar por separado, solo junto con el parámetro Expresión.
Se puede hacer referencia a las variables definidas en el parámetro Código bloque a partir de la expresión.
Las variables se pueden definir en el parámetro Código bloque e invocar a partir de la expresión. En el ejemplo siguiente, la función devuelve una cadena de dirección del viento basada en un valor de entrada aleatorio. En Python, las funciones se definen con la palabra clave def seguida del nombre y los parámetros de entrada de la función. En este caso, la función es getWind y tiene un parámetro: wind. Los valores se devuelven de una función con la palabra clave return .
Puede introducir una variable en el parámetro Expresión y utilizar la lógica if-else con las variables en línea que se encuentran en el bloque de código, tal como se muestra a continuación. El bloque de código verifica la variable Input Cell Size para comprobar que no este vacía y, a continuación, devuelve un valor basado en la condición.
Los métodos de Python se pueden utilizar directamente en el parámetro Expresión de la herramienta. Por ejemplo, si tiene un valor de entrada con un decimal (en este caso, el valor de campo de la tabla de entrada) y desea utilizar el valor en el nombre de entrada de otra herramienta por medio de la sustitución de variables en línea, el decimal se puede reemplazar mediante el método de Python reemplazar en la expresión de la herramienta Calcular valor.
En el parámetro de bloque de código se pueden utilizar los módulos de Python y combinar o apilar métodos de Python, tales como replace. En el ejemplo siguiente se importa el módulo time al bloque de código, el cual devuelve la fecha y hora actuales, por ejemplo, Fri Mar 19 2010 09:42:39. Este valor devuelto se utiliza como un nombre en la herramienta Crear carpeta para denominar la carpeta. Ya que el nombre de la carpeta no puede contener espacios ni marcas de puntuación, el método replace se utiliza en Python apilando el método de cada elemento que requiere un reemplazo. El nombre que se obtiene para esta carpeta en el presente ejemplo es FriMar192010094239.
Si calcula un valor en el modelo para utilizar con herramientas como Zona de influencia, que requieren un valor de distancia de zona de influencia y una unidad lineal, deberá:
- devolver la unidad lineal del bloque de código, junto con el valor de distancia,
- cambiar el tipo de datos de los valores devueltos, tal como se muestra más adelante y, por último,
- establecer el parámetro de tipo de datos como unidad lineal, para que el resultado de la expresión se convierta en un valor de unidad lineal.
-
En Python, parte de la sintaxis es el uso correcto de la sangría. El grado de sangría (dos espacios o cuatro espacios) no es importante, siempre y cuando sea consistente en todo el bloque de código.
-
No se puede acceder a las variables de modelo desde el bloque de código. Estas variables se deben introducir en el bloque de código desde la expresión. Esto se puede realizar creando una definición en el parámetro Código bloque y haciendo referencia a esta en el cuadro Expresión.
Nota:Cuando escriba secuencias de comandos de Python, en lugar de la herramienta Calcular valor, utilice declaraciones de Python estándar.
Sintaxis
| Parámetro | Explicación | Tipo de datos |
expression |
Expresión de Python que se evaluará. | SQL expression |
code_block (Opcional) |
Código de Python adicional. En el parámetro Expresión se puede hacer referencia al código que se encuentra en el bloque de código. | String |
data_type (Opcional) |
Tipo de datos de la salida devuelta a partir de la expresión de Python. Este parámetro se debe utilizar en ModelBuilder para ayudar a conectar la herramienta Calcular valor con las demás herramientas. | String |