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.

  

  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.

  

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

  

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

  

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

  

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

  

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

  

• 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

arcpy.mb.CalculateValue(expression, {code_block}, {data_type})

Parámetro	Explicación	Tipo de datos
expression	Expresión de Python que se evaluará.	SQL Expression
code_block (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
data_type (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. Address Locator —Localizador de direcciones Address Locator Style —Estilo del Localizador de direcciones Analysis Cell Size —Tamaño de celda de análisis Annotation Layer —Capa de anotaciones Any Value —Cualquier valor ArcMap Document —Documento de ArcMap Areal Unit —Unidad de área BIM File Workspace —Espacio de trabajo de archivo BIM Boolean —Booleano Building Discipline Layer —Generando capa de disciplina Building Discipline Scene Layer —Crear capa de escena de disciplina Building Layer —Generando capa Building Scene Layer —Crear capa de escena CAD Drawing Dataset —Dataset de dibujo CAD Calculator Expression —Expresión de calculadora Catalog Root —Raíz del catálogo Cell Size —Tamaño de celda Cell Size XY —Tamaño de celda XY Composite Layer —Capa compuesta Compression —Compresión Coordinate System —Sistema de coordenadas Coordinate Systems Folder —Carpeta de sistemas de coordenadas Coverage —Cobertura Coverage Feature Class —Clase de entidad de cobertura Data Element —Elemento de datos Data File —Archivo de datos Database Connections —Conexiones de base de datos Dataset —Dataset Date —Fecha dBASE Table —Tabla de dBase Decimate —Remuestreo reducido Diagram Layer —Capa de diagrama Dimension Layer —Capa de dimensión Disk Connection —Conexión de disco Double —Doble Elevation Surface Layer —Capa de superficie de elevación Encrypted String —Cadena de caracteres codificada Envelope —Contorno Evaluation Scale —Escala de evaluación Extent —Extensión Extract Values —Extraer valores Feature Class —Clase de entidad Feature Dataset —Dataset de entidades Feature Layer —Capa de entidades Feature Set —Conjunto de entidades Field —Campo Field Info —Información del campo Field Mappings —Asignaciones de campos File —Archivo Folder —Carpeta Formulated Raster —Ráster formulado Fuzzy function —Función difusa GeoDataServer —GeoDataServer (Servidor de datos geográficos) Geodataset —Geodataset Geometric Network —Red geométrica Geostatistical Layer —Capa de geoestadística Geostatistical Search Neighborhood —Vecindad de búsqueda de estadísticas geográficas Geostatistical Value Table —Tabla de valores geoestadística GlobeServer —GlobeServer GPServer —GPServer Graph —Gráfico Graph Data Table —Tabla de datos de gráfico Group Layer —Grupo de capas Horizontal Factor —Factores horizontales Image Service —Servicio de imágenes Index —Índice INFO Expression —Expresión INFO INFO Item —Elemento INFO INFO Table —Tabla INFO Internet Tiled Layer —Capa de teselas de Internet KML Layer —Capa KML LAS Dataset —Dataset LAS LAS Dataset Layer —Capa de dataset LAS Layer —Capa Layer File —Archivo de capas Layout —Diseño Line —Line Linear Unit —Unidad lineal Long —Largo M Domain —Dominio M Map —Mapa Map Server Layer —Capa de servidor de mapas MapServer —MapServer Mosaic Dataset —Dataset de mosaico Mosaic Layer —Capa de mosaico Neighborhood —Vecindario Network Analyst Class FieldMap —FieldMap de clase de Network Analyst Network Analyst Hierarchy Settings —Configuración de jerarquía de Network Analyst Network Analyst Layer —Capa de Network Analyst Network Data Source —Fuente de datos de red Network Dataset —Dataset de red Network Dataset Layer —Capa de dataset de red Network Travel Mode —Modo de viaje de red Parcel Fabric —Estructura de parcelas Parcel Fabric for ArcMap —Estructura de parcela para ArcMap Parcel Fabric Layer for ArcMap —Capa de estructura de parcela para ArcMap Parcel Layer —Capa de parcela Point —Point Polygon —Polígono Projection File —Archivo de proyección Pyramid —Pirámide Radius —Radio Random Number Generator —Generador de números aleatorios Raster Band —Banda de ráster Raster Calculator Expression —Expresión de calculadora de ráster Raster Catalog —Catálogo de ráster Raster Catalog Layer —Capa de catálogo de ráster Raster Data Layer —Capa de datos de ráster Raster Dataset —Dataset ráster Raster Layer —Capa ráster Raster Statistics —Estadísticas de ráster Raster Type —Tipo de ráster Record Set —Conjunto de registros Relationship Class —Clase de relación Remap —Nueva representación cartográfica Report —Informe Route Measure Event Properties —Propiedades de eventos de medida de ruta Scene Layer —Capa de escena Semivariogram —Semivariograma ServerConnection —ServerConnection Shapefile —Shapefile Spatial Reference —Referencia espacial SQL Expression —Expresión SQL String —Cadena String Hidden —Cadena de caracteres oculta Table —Tabla Table View —Vista de tabla Terrain Layer —Capa de terreno Text File —Archivo de texto Tile Size —Tamaño de tesela Time configuration —Configuración de la hora Time Unit —Unidad de tiempo TIN —TIN TIN Layer —Capa TIN Tool —Herramienta Toolbox —Caja de herramientas Topo Features —Entidades topo Topology —Topología Topology Layer —Capas de topología Trace Network —Red de trazado Trace Network Layer —Capa de trazado de red Transformation function —Función de transformación Utility Network —Red de servicios Utility Network Layer —Capa de red de servicios Variant —Variante Vector Tile Layer —Capa de teselas vectoriales Vertical Factor —Factor vertical Voxel Layer —Capa vóxel VPF Coverage —Cobertura VPF VPF Table —Tabla VPF WCS Coverage —Cobertura WCS Weighted Overlay Table —Tabla de superposición ponderada Weighted Sum —Suma ponderada WMS Map —Mapa de WMS Workspace —Espacio de trabajo XY Domain —Dominio XY Z Domain —Dominio Z	String

Salida derivada

Nombre	Explicación	Tipo de datos
value	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í