计算值 (ModelBuilder)

描述

基于指定的 Python 表达式返回值。

使用方法

• 此工具专用于 ModelBuilder ，而并不在编写 Python 脚本时使用。

• 在 ModelBuilder 中使用数据类型参数可将计算值工具的输出与其他工具相连接。例如，如果使用计算值工具计算距离并将其用作 缓冲区工具的缓冲距离参数的输入，则请指定数据类型参数的线性单位。

• 虽然此工具可以使用在 ModelBuilder 中创建的变量，但是表达式参数中需要使用的变量无法连接到计算值工具。要在表达式中使用它们，请将变量名称用百分号 (%) 括起。例如，如果要将名称为“Input”的变量除以 100，表达式将为 %Input%/100。

  请注意：在上面的表达式中，如果 Input = 123，此表达式将返回 1。要获得保留小数位的值，请将各值的小数位添加到此表达式中。例如：%Input%/100.00 将返回 1.23。下图显示的是另一个在表达式中使用变量的示例。

  

  警告：

  在表达式中，字符串类型的行内变量应使用引号括起 ("%字符串变量%")。数值类型的行内变量（双精度型、长整型）不需要使用引号括起 (%双精度型%)。

• 只能使用标准 Python 格式创建表达式。不支持其他脚本语言。

• 计算值工具可对简单的数学表达式进行求值。例如：

  • 3+5
  • 9*8
  • 4+(9/3)

• 计算值工具允许使用 Python 数学模块执行更为复杂的数学运算。通过在所需函数前添加 math 可访问相应数学模块。例如：

  • math.sqrt(25)
  • math.cos(0.5)

• 数学模块还支持常量。例如：

  • math.pi

• random 模块支持生成随机数。使用 random 模块的示例如下：

  • 在 0 到 10 之间取一个随机整数：random.randint(0, 10)
  • 计算从平均值为 10 且标准差为 3 的正态分布中获取的随机值：random.normalvariate(10, 3)

  旧版本：

  自 ArcGIS Pro 2.0 起不再支持 arcgis.rand()。应使用利用 Python random 模块的类似函数。要成功使用 random 模块，请将其作为导入添加到代码块参数中。

• 通常，将在表达式参数中输入表达式。诸如多行计算或逻辑运算 (if, then) 等更为复杂的表达式需要使用代码块参数。代码块参数不能单独使用；此参数必须与表达式参数结合使用。

• 可从表达式中引用代码块参数中定义的变量。

  

• 函数可在代码块参数中定义，并可从表达式中调用。在以下示例中，函数将基于随机输入值返回风向字符串。在 Python 中，各函数可通过 def 关键字定义，关键字后为函数的名称以及函数的输入参数。在本示例中，函数为 getWind 并包含一个参数 wind。使用 return 关键字会将值从函数中返回。

  

• 您可通过表达式参数传递变量，还可将 if-else 逻辑用于代码块中的行内变量，如下所示。代码块将检查 Input Cell Size 变量是否为空，然后根据条件返回值。

  

• Python 方法可直接在工具的“表达式”参数中使用。例如，如果输入值带有小数（输入表的字段值即为这种情况），并且您想通过行内变量替换在其他工具的输出名称中使用此值，则可在计算值工具表达式中使用 Python 方法替换来替换此小数。

  

• 可以调用 Python 模块，还可以在代码块参数中合并或堆叠 Python 方法（例如 replace）。在以下示例中，time 模块将被导入到代码块中，此代码块将返回当前日期和时间，如 Fri Mar 19 2010 09:42:39。此返回值在创建文件夹工具中用作名称，用来命名文件夹。由于文件夹的名称不能包含空格或标点符号，因此 Python 中的 replace 方法的使用方式为，为每个需要替换的元素堆叠此方法。在本示例中，得到的文件夹名称为 FriMar192010094239。

  

• 如果在计算模型中的一个值时需要通过诸如缓冲区（需要缓冲距离值和线性单位）等工具使用该计算值，您需要：

  • 将代码块中的线性单位与距离值一同返回，
  • 如下图所示更改返回值的数据类型，
  • 然后将数据类型参数设置为线性单位，这样，表达式的结果将被转换为线性单位值。

  

• 在任何接受栅格或常数值的 Spatial Analyst 工具中，可以直接使用计算值工具的输出结果，例如，加、大于和小于（这些工具位于 Spatial Analyst 工具箱/数学工具集中）。要使用计算值的输出结果，请将输出数据类型更改为“格式化的栅格”。此输出数据类型格式是像元值由公式或常量表示的栅格表面。

  

• 在 Python 中，部分语法将适当缩进。缩进程度（两个空格或四个空格）可任意设置，但在整个代码块中缩进程度必须保持一致。

• 无法从代码块访问模型变量。此类变量必须从表达式传递到代码块。此操作可通过在代码块中创建定义并在表达式框中引用所创建的定义来实现。

注：

编写 Python 脚本时，请使用标准 Python 语句，而不是计算值工具。

语法

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

参数	说明	数据类型
expression	要进行求值的 Python 表达式。	SQL Expression
code_block （可选）	Python 代码块。可以在表达式参数中引用代码块中的代码。	String
data_type （可选）	指定从 Python 表达式返回的输出的数据类型。应在 ModelBuilder 中使用此参数，以便将计算值工具与其他工具相连接。 Address Locator —地址定位器 Address Locator Style —地址定位器样式 Analysis Cell Size —分析像元大小 Annotation Layer —注记图层 Any Value —任意值 ArcMap Document —ArcMap 文档 Areal Unit —面积单位 BIM File Workspace —BIM 文件工作空间 Boolean —布尔型 Building Discipline Layer —建筑领域图层 Building Discipline Scene Layer —构建领域场景图层 Building Layer —建筑图层 Building Scene Layer —构建场景图层 CAD Drawing Dataset —CAD 工程图数据集 Calculator Expression —计算器表达式 Catalog Root —目录根 Cell Size —像元大小 Cell Size XY —像元大小 XY Composite Layer —复合图层 Compression —压缩 Coordinate System —坐标系 Coordinate Systems Folder —坐标系文件夹 Coverage —覆盖范围 Coverage Feature Class —Coverage 要素类 Data Element —数据元素 Data File —数据文件 Database Connections —数据库连接 Dataset —数据集 Date —日期 dBASE Table —dBASE 表 Decimate —抽取 Diagram Layer —逻辑示意图图层 Dimension Layer —尺寸图层 Disk Connection —磁盘连接 Double —双精度型 Elevation Surface Layer —高程表面图层 Encrypted String —加密字符串 Envelope —包络 Evaluation Scale —评估等级 Extent —范围 Extract Values —提取值 Feature Class —要素类 Feature Dataset —要素数据集 Feature Layer —要素图层 Feature Set —要素集 Field —字段 Field Info —字段信息 Field Mappings —字段映射 File —文件 Folder —文件夹 Formulated Raster —格式化栅格 Fuzzy function —模糊函数 GeoDataServer —GeoDataServer Geodataset —地理数据集 Geometric Network —几何网络 Geostatistical Layer —地统计图层 Geostatistical Search Neighborhood —地统计搜索邻域 Geostatistical Value Table —地统计值表 GlobeServer —GlobeServer GPServer —GPServer Graph —图形 Graph Data Table —图表数据表 Group Layer —图层组 Horizontal Factor —水平系数 Image Service —影像服务 Index —索引 INFO Expression —INFO 表达式 INFO Item —INFO 项目 INFO Table —INFO 表 Internet Tiled Layer —Internet 切片图层 KML Layer —KML 图层 LAS Dataset —LAS 数据集 LAS Dataset Layer —LAS 数据集图层 Layer —图层 Layer File —图层文件 Layout —布局 Line —线 Linear Unit —线性单位 Long —长整型 M Domain —M 值域 Map —地图 Map Server Layer —地图服务器图层 MapServer —MapServer Mosaic Dataset —镶嵌数据集 Mosaic Layer —镶嵌图层 Neighborhood —邻域 Network Analyst Class FieldMap —Network Analyst 类 FieldMap Network Analyst Hierarchy Settings —Network Analyst 等级设置 Network Analyst Layer —网络分析图层 Network Data Source —网络数据源 Network Dataset —网络数据集 Network Dataset Layer —网络数据集图层 Network Travel Mode —网络出行模式 Parcel Fabric —宗地结构 Parcel Fabric for ArcMap —ArcMap 宗地结构 Parcel Fabric Layer for ArcMap —ArcMap 宗地结构图层 Parcel Layer —宗地图层 Point —点 Polygon —面 Projection File —投影文件 Pyramid —金字塔 Radius —半径 Random Number Generator —随机数生成器 Raster Band —栅格波段 Raster Calculator Expression —栅格计算器表达式 Raster Catalog —栅格目录 Raster Catalog Layer —栅格目录图层 Raster Data Layer —栅格数据图层 Raster Dataset —栅格数据集 Raster Layer —栅格图层 Raster Statistics —栅格统计 Raster Type —栅格类型 Record Set —记录集 Relationship Class —关系类 Remap —重映射 Report —报告 Route Measure Event Properties —路线测量事件属性 Scene Layer —场景图层 Semivariogram —半变异函数 ServerConnection —ServerConnection Shapefile —Shapefile Spatial Reference —空间参考 SQL Expression —SQL 表达式 String —字符串 String Hidden —隐藏字符串 Table —表 Table View —表视图 Terrain Layer —地形图层 Text File —文本文件 Tile Size —分块大小 Time configuration —时间配置 Time Unit —时间单位 TIN —TIN TIN Layer —TIN 图层 Tool —工具 Toolbox —工具箱 Topo Features —拓扑要素 Topology —拓扑 Topology Layer —拓扑图层 Trace Network —追踪网络 Trace Network Layer —追踪网络图层 Transformation function —变换函数 Utility Network —公共设施网络 Utility Network Layer —公共设施网络图层 Variant —变量 Vector Tile Layer —矢量切片图层 Vertical Factor —垂直系数 Voxel Layer —体素图层 VPF Coverage —VPF Coverage VPF Table —VPF 表 WCS Coverage —WCS Coverage Weighted Overlay Table —加权叠加表 Weighted Sum —加权总和 WMS Map —WMS 地图 Workspace —工作空间 XY Domain —XY 值域 Z Domain —Z 值域	String

派生输出

名称	说明	数据类型
value	计算值。	数据元素；图层；表视图

环境

此工具不使用任何地理处理环境。

许可信息

• Basic: 是
• Standard: 是
• Advanced: 是