Calcular valor (ModelBuilder)

Resumen

Devuelve un valor basado en una expresión especificada de Python.

Uso

  • La herramienta está pensada para utilizarse en ModelBuilder y no en scripts 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 "Input" por 100, la expresión sería %Input%/100.

    Nota: en la expresión anterior, si Input = 123, la expresión devolverá 1. Para obtener posiciones decimales, agregue decimales a los valores en la expresión. Por ejemplo: %Input%/100,00 devolverá 1,23. En la ilustración siguiente se muestra otro ejemplo del uso de variables en la expresión.

    Utilizar variable de modelo en la herramienta Calcular valor
    Precaución:

    En una expresión, la variable en línea de tipo cadena de caracteres debe estar entre comillas ("%string variable%"). Las variables en línea de tipo numérico (double, long) no requieren comillas (%double%).

  • 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 del módulo de matemática de Python para realizar operaciones matemáticas más complejas. Para acceder al módulo de matemática, 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
  • El módulo random se admite para generar números aleatorios. A continuación se presentan ejemplos de uso del módulo random:

    • Calcular un entero aleatorio entre 0 y 10: random.randint(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: random.normalvariate(10, 3)

    Heredado:

    arcgis.rand() ya no se admite desde ArcGIS Pro 2.0. En su lugar, se deben usar otras funciones similares del módulo random de Python. Para usar correctamente el módulo random, agréguelo como importación en el parámetro Bloque de código.

  • 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. El parámetro Bloque de código 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 Bloque de código a partir de la expresión.

    Utilizar los parámetros Expresión y Bloque de código

  • Las variables se pueden definir en el parámetro Bloque de código 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 de la función 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.

    Definir funciones en el parámetro Bloque de código
  • 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.

    Ejemplo de If-Else

  • 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 salida de otra herramienta por medio de la sustitución de variables en línea, el decimal se puede reemplazar usando el método replace de Python en la expresión de la herramienta Calcular valor.

    Ejemplo del método replace de Python

  • 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, el módulo time se importa en el bloque de código, que devuelve la fecha y la 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. Como 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 la carpeta en este ejemplo es FriMar192010094239.

    Ejemplo del módulo de hora de Python

  • Si calcula un valor en el modelo y desea utilizarlo 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.
    Utilizar la salida de la herramienta Calcular valor como distancia de zona de influencia

  • Puede usar la salida de la herramienta Calcular valor directamente en cualquier herramienta de Spatial Analyst que acepte un ráster o un valor constante como Suma, Mayor que y Menor que (estas herramientas se encuentran en la caja de herramientas Spatial Analyst/conjunto de herramientas Matemática). Para usar la salida de Calcular valor, cambie el tipo de datos de salida a Ráster formulado. Este formato de tipo de datos de salida es una superficie de ráster cuyas celdas están representadas por una fórmula o una constante.

    Tipo de datos Ráster formulado

  • 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.

Parámetros

EtiquetaExplicaciónTipo de datos
Expresión

Expresión de Python que se evaluará.

SQL Expression
Bloque de código
(Opcional)

Un bloque de código de Python. Se puede hacer referencia al código que se encuentra en el bloque de código en el parámetro Expresión.

String
Tipo de datos
(Opcional)

Especifica el 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 otras herramientas.

  • Localizador de direcciones —Localizador de direcciones
  • Estilo del Localizador de direcciones —Estilo del Localizador de direcciones
  • Tamaño de celda de análisis —Tamaño de celda de análisis
  • Capa de anotaciones —Capa de anotaciones
  • Cualquier valor —Cualquier valor
  • Documento de ArcMap —Documento de ArcMap
  • Unidad de área —Unidad de área
  • Espacio de trabajo de archivo BIM —Espacio de trabajo de archivo BIM
  • Booleanos —Booleanos
  • Generando capa de disciplina —Generando capa de disciplina
  • Crear capa de escena de disciplina —Crear capa de escena de disciplina
  • Generando capa —Generando capa
  • Crear capa de escena —Crear capa de escena
  • Dataset de dibujo CAD —Dataset de dibujo CAD
  • Expresión de calculadora —Expresión de calculadora
  • Raíz del catálogo —Raíz del catálogo
  • Tamaño de celda —Tamaño de celda
  • Tamaño de celda XY —Tamaño de celda XY
  • Capa compuesta —Capa compuesta
  • Compresión —Compresión
  • Sistema de coordenadas —Sistema de coordenadas
  • Carpeta de sistemas de coordenadas —Carpeta de sistemas de coordenadas
  • Cobertura —Cobertura
  • Clase de entidad de cobertura —Clase de entidad de cobertura
  • Elemento de datos —Elemento de datos
  • Archivo de datos —Archivo de datos
  • Conexiones de base de datos —Conexiones de base de datos
  • Dataset —Dataset
  • Fecha —Fecha
  • Tabla de dBase —Tabla de dBase
  • Remuestreo reducido —Remuestreo reducido
  • Capa de diagrama —Capa de diagrama
  • Capa de dimensión —Capa de dimensión
  • Conexión de disco —Conexión de disco
  • Doble —Doble
  • Capa de superficie de elevación —Capa de superficie de elevación
  • Cadena de caracteres codificada —Cadena de caracteres codificada
  • Contorno —Contorno
  • Escala de evaluación —Escala de evaluación
  • Extensión —Extensión
  • Extraer valores —Extraer valores
  • Clase de entidad —Clase de entidad
  • Dataset de entidades —Dataset de entidades
  • Capa de entidades —Capa de entidades
  • Conjunto de entidades —Conjunto de entidades
  • Campo —Campo
  • Información del campo —Información del campo
  • Asignaciones de campos —Asignaciones de campos
  • Archivo —Archivo
  • Carpeta —Carpeta
  • Ráster formulado —Ráster formulado
  • Función difusa —Función difusa
  • GeoDataServer (Servidor de datos geográficos) —GeoDataServer (Servidor de datos geográficos)
  • Geodataset —Geodataset
  • Red geométrica —Red geométrica
  • Capa de geoestadística —Capa de geoestadística
  • Vecindad de búsqueda de estadísticas geográficas —Vecindad de búsqueda de estadísticas geográficas
  • Tabla de valores geoestadística —Tabla de valores geoestadística
  • GlobeServer —GlobeServer
  • GPServer —GPServer
  • Gráfico —Gráfico
  • Tabla de datos de gráfico —Tabla de datos de gráfico
  • Grupo de capas —Grupo de capas
  • Factores horizontales —Factores horizontales
  • Servicio de imágenes —Servicio de imágenes
  • Índice —Índice
  • Expresión INFO —Expresión INFO
  • Elemento INFO —Elemento INFO
  • Tabla INFO —Tabla INFO
  • Capa teselada de Internet —Capa teselada de Internet
  • Capa KML —Capa KML
  • Dataset LAS —Dataset LAS
  • Capa de dataset LAS —Capa de dataset LAS
  • Capa —Capa
  • Archivo de capas —Archivo de capas
  • Diseño —Diseño
  • Línea —Línea
  • Unidad lineal —Unidad lineal
  • Largo —Largo
  • Dominio M —Dominio M
  • Mapa —Mapa
  • Servidor de mapa —Servidor de mapa
  • Capa de servidor de mapas —Capa de servidor de mapas
  • Dataset de mosaico —Dataset de mosaico
  • Capa de mosaico —Capa de mosaico
  • Vecindario —Vecindario
  • FieldMap de clase de Network Analyst —FieldMap de clase de Network Analyst
  • Configuración de jerarquía de Network Analyst —Configuración de jerarquía de Network Analyst
  • Capa de Network Analyst —Capa de Network Analyst
  • Fuente de datos de red —Fuente de datos de red
  • Dataset de red —Dataset de red
  • Capa de dataset de red —Capa de dataset de red
  • Modo de viaje de red —Modo de viaje de red
  • Estructura de parcelas —Estructura de parcelas
  • Estructura de parcela para ArcMap —Estructura de parcela para ArcMap
  • Capa de estructura de parcela para ArcMap —Capa de estructura de parcela para ArcMap
  • Capa de parcela —Capa de parcela
  • Punto —Punto
  • Polígono —Polígono
  • Archivo de proyección —Archivo de proyección
  • Pirámide —Pirámide
  • Radio —Radio
  • Generador de números aleatorios —Generador de números aleatorios
  • Banda de ráster —Banda de ráster
  • Expresión de calculadora de ráster —Expresión de calculadora de ráster
  • Catálogo de ráster —Catálogo de ráster
  • Capa de catálogo de ráster —Capa de catálogo de ráster
  • Capa de datos de ráster —Capa de datos de ráster
  • Dataset ráster —Dataset ráster
  • Capa ráster —Capa ráster
  • Estadísticas de ráster —Estadísticas de ráster
  • Tipo de ráster —Tipo de ráster
  • Conjunto de registros —Conjunto de registros
  • Clase de relación —Clase de relación
  • Nueva representación cartográfica —Nueva representación cartográfica
  • Informe —Informe
  • Propiedades de eventos de medición de ruta —Propiedades de eventos de medición de ruta
  • Capa de escena —Capa de escena
  • Semivariograma —Semivariograma
  • ServerConnection —ServerConnection
  • Shapefile —Shapefile
  • Referencia espacial —Referencia espacial
  • Expresión SQL —Expresión SQL
  • Cadena —Cadena
  • Cadena de caracteres oculta —Cadena de caracteres oculta
  • Tabla —Tabla
  • Vista de tabla —Vista de tabla
  • Capa de terreno —Capa de terreno
  • Archivo de texto —Archivo de texto
  • Tamaño de tesela —Tamaño de tesela
  • Configuración de la hora —Configuración de la hora
  • Unidad de tiempo —Unidad de tiempo
  • TIN —TIN
  • Capa TIN —Capa TIN
  • Herramienta —Herramienta
  • Caja de herramientas —Caja de herramientas
  • Entidades topo —Entidades topo
  • Topología —Topología
  • Capas de topología —Capas de topología
  • Red de trazado —Red de trazado
  • Capa de trazado de red —Capa de trazado de red
  • Función de transformación —Función de transformación
  • Red de servicios —Red de servicios
  • Capa de red de servicios —Capa de red de servicios
  • Variante —Variante
  • Capa de teselas vectoriales —Capa de teselas vectoriales
  • Factor vertical —Factor vertical
  • Capa vóxel —Capa vóxel
  • Cobertura VPF —Cobertura VPF
  • Tabla VPF —Tabla VPF
  • Cobertura WCS —Cobertura WCS
  • Tabla Superposición ponderada —Tabla Superposición ponderada
  • Suma ponderada —Suma ponderada
  • Mapa de WMS —Mapa de WMS
  • Capa WMTS —Capa WMTS
  • Espacio de trabajo —Espacio de trabajo
  • Dominio XY —Dominio XY
  • Dominio Z —Dominio Z
String

Salida derivada

EtiquetaExplicaciónTipo de datos
Valor

El valor calculado.

Elemento de datos; Capa; Vista de tabla

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí