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.

Sintaxis

arcpy.mb.CalculateValue(expression, {code_block}, {data_type})
ParámetroExplicaciónTipo 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 LocatorLocalizador de direcciones
  • Address Locator StyleEstilo del Localizador de direcciones
  • Analysis Cell SizeTamaño de celda de análisis
  • Annotation LayerCapa de anotaciones
  • Any ValueCualquier valor
  • ArcMap DocumentDocumento de ArcMap
  • Areal UnitUnidad de área
  • BIM File WorkspaceEspacio de trabajo de archivo BIM
  • BooleanBooleano
  • Building Discipline LayerGenerando capa de disciplina
  • Building Discipline Scene LayerCrear capa de escena de disciplina
  • Building LayerGenerando capa
  • Building Scene LayerCrear capa de escena
  • CAD Drawing DatasetDataset de dibujo CAD
  • Calculator ExpressionExpresión de calculadora
  • Catalog RootRaíz del catálogo
  • Cell SizeTamaño de celda
  • Cell Size XYTamaño de celda XY
  • Composite LayerCapa compuesta
  • CompressionCompresión
  • Coordinate SystemSistema de coordenadas
  • Coordinate Systems FolderCarpeta de sistemas de coordenadas
  • CoverageCobertura
  • Coverage Feature ClassClase de entidad de cobertura
  • Data ElementElemento de datos
  • Data FileArchivo de datos
  • Database ConnectionsConexiones de base de datos
  • DatasetDataset
  • DateFecha
  • dBASE TableTabla de dBase
  • DecimateRemuestreo reducido
  • Diagram LayerCapa de diagrama
  • Dimension LayerCapa de dimensión
  • Disk ConnectionConexión de disco
  • DoubleDoble
  • Elevation Surface LayerCapa de superficie de elevación
  • Encrypted StringCadena de caracteres codificada
  • EnvelopeContorno
  • Evaluation ScaleEscala de evaluación
  • ExtentExtensión
  • Extract ValuesExtraer valores
  • Feature ClassClase de entidad
  • Feature DatasetDataset de entidades
  • Feature LayerCapa de entidades
  • Feature SetConjunto de entidades
  • FieldCampo
  • Field InfoInformación del campo
  • Field MappingsAsignaciones de campos
  • FileArchivo
  • FolderCarpeta
  • Formulated RasterRáster formulado
  • Fuzzy functionFunción difusa
  • GeoDataServerGeoDataServer (Servidor de datos geográficos)
  • GeodatasetGeodataset
  • Geometric NetworkRed geométrica
  • Geostatistical LayerCapa de geoestadística
  • Geostatistical Search NeighborhoodVecindad de búsqueda de estadísticas geográficas
  • Geostatistical Value TableTabla de valores geoestadística
  • GlobeServerGlobeServer
  • GPServerGPServer
  • GraphGráfico
  • Graph Data TableTabla de datos de gráfico
  • Group LayerGrupo de capas
  • Horizontal FactorFactores horizontales
  • Image ServiceServicio de imágenes
  • IndexÍndice
  • INFO ExpressionExpresión INFO
  • INFO ItemElemento INFO
  • INFO TableTabla INFO
  • Internet Tiled LayerCapa de teselas de Internet
  • KML LayerCapa KML
  • LAS DatasetDataset LAS
  • LAS Dataset LayerCapa de dataset LAS
  • LayerCapa
  • Layer FileArchivo de capas
  • LayoutDiseño
  • LineLine
  • Linear UnitUnidad lineal
  • LongLargo
  • M DomainDominio M
  • MapMapa
  • Map Server LayerCapa de servidor de mapas
  • MapServerMapServer
  • Mosaic DatasetDataset de mosaico
  • Mosaic LayerCapa de mosaico
  • NeighborhoodVecindario
  • Network Analyst Class FieldMapFieldMap de clase de Network Analyst
  • Network Analyst Hierarchy SettingsConfiguración de jerarquía de Network Analyst
  • Network Analyst LayerCapa de Network Analyst
  • Network Data SourceFuente de datos de red
  • Network DatasetDataset de red
  • Network Dataset LayerCapa de dataset de red
  • Network Travel ModeModo de viaje de red
  • Parcel FabricEstructura de parcelas
  • Parcel Fabric for ArcMapEstructura de parcela para ArcMap
  • Parcel Fabric Layer for ArcMapCapa de estructura de parcela para ArcMap
  • Parcel LayerCapa de parcela
  • PointPoint
  • PolygonPolígono
  • Projection FileArchivo de proyección
  • PyramidPirámide
  • RadiusRadio
  • Random Number GeneratorGenerador de números aleatorios
  • Raster BandBanda de ráster
  • Raster Calculator ExpressionExpresión de calculadora de ráster
  • Raster CatalogCatálogo de ráster
  • Raster Catalog LayerCapa de catálogo de ráster
  • Raster Data LayerCapa de datos de ráster
  • Raster DatasetDataset ráster
  • Raster LayerCapa ráster
  • Raster StatisticsEstadísticas de ráster
  • Raster TypeTipo de ráster
  • Record SetConjunto de registros
  • Relationship ClassClase de relación
  • RemapNueva representación cartográfica
  • ReportInforme
  • Route Measure Event PropertiesPropiedades de eventos de medida de ruta
  • Scene LayerCapa de escena
  • SemivariogramSemivariograma
  • ServerConnectionServerConnection
  • ShapefileShapefile
  • Spatial ReferenceReferencia espacial
  • SQL ExpressionExpresión SQL
  • StringCadena
  • String HiddenCadena de caracteres oculta
  • TableTabla
  • Table ViewVista de tabla
  • Terrain LayerCapa de terreno
  • Text FileArchivo de texto
  • Tile SizeTamaño de tesela
  • Time configurationConfiguración de la hora
  • Time UnitUnidad de tiempo
  • TINTIN
  • TIN LayerCapa TIN
  • ToolHerramienta
  • ToolboxCaja de herramientas
  • Topo FeaturesEntidades topo
  • TopologyTopología
  • Topology LayerCapas de topología
  • Trace NetworkRed de trazado
  • Trace Network LayerCapa de trazado de red
  • Transformation functionFunción de transformación
  • Utility NetworkRed de servicios
  • Utility Network LayerCapa de red de servicios
  • VariantVariante
  • Vector Tile LayerCapa de teselas vectoriales
  • Vertical FactorFactor vertical
  • Voxel LayerCapa vóxel
  • VPF CoverageCobertura VPF
  • VPF TableTabla VPF
  • WCS CoverageCobertura WCS
  • Weighted Overlay TableTabla de superposición ponderada
  • Weighted SumSuma ponderada
  • WMS MapMapa de WMS
  • WorkspaceEspacio de trabajo
  • XY DomainDominio XY
  • Z DomainDominio Z
String

Salida derivada

NombreExplicaciónTipo 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í