描述
基于指定的 Python 表达式返回值。
使用
此工具专用于模型构建器，而并不在编写 Python 脚本时使用。
在“模型构建器”中使用数据类型参数可将计算值工具的输出与其他工具相连接。例如，如果使用计算值工具计算距离并将其用作 缓冲区工具的缓冲距离参数的输入，则请指定数据类型参数的线性单位。
虽然此工具可以使用在“模型构建器”中创建的变量，但是表达式参数中需要使用的变量无法连接到计算值工具。要在表达式中使用它们，请将变量名称用百分号 (%) 括起。例如，如果要将名称为 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
支持 arcgis.rand() 函数。已为 ArcGIS 工具创建 arcgis.rand() 函数，不应将此函数与 Python Rand() 函数相混淆。使用 arcgis.rand() 的示例如下所示：
- 计算从 0 与 10 之间均匀分布的整数中获取的随机值：arcgis.rand("Integer 0 10")
- 计算从平均值为 10 且标准差为 3 的正态分布中获取的随机值：arcgis.rand("Normal 10 3")
通常，将在表达式参数中输入表达式。诸如多行计算或逻辑运算 (if, then) 等更为复杂的表达式需要使用代码块参数。代码块参数不能单独使用；此参数必须与表达式参数结合使用。
可从表达式中引用代码块参数中定义的变量。
函数可在代码块参数中定义，并可从表达式中调用。在以下示例中，函数将基于随机输入值返回风向字符串。在 Python 中，各函数可通过 def 关键字定义，关键字后为函数的名称以及函数的输入参数。在本示例中，函数为 getWind 并包含一个参数 wind。使用 return 关键字会将值从函数中返回。
您可通过表达式参数传递变量，还可将 if-else 逻辑用于代码块中的行内变量，如下所示。代码块将检查 Input Cell Size 变量是否为空，然后根据条件返回值。
Python 方法可直接在工具的表达式参数中使用。例如，如果输入值带有小数（输入表的字段值即为这种情况），并且您想通过行内变量替换在其他工具的输出名称中使用此值，则可在计算值工具表达式中使用 Python 方法 replace 替换此小数。
可以调用 Python 模块，还可以在代码块参数中合并或堆叠 Python 方法（例如 replace）。在以下示例中，time 模块将被导入到代码块中，此代码块将返回当前日期和时间，如 Fri Mar 19 2010 09:42:39。此返回值在创建文件夹工具中用作名称来命名文件夹。由于文件夹的名称不能包含空格或标点符号，因此 Python 中的 replace 方法的使用方式为，为每个需要替换的元素堆叠此方法。在本示例中，得到的文件夹名称为 FriMar192010094239。
如果要在此模型中计算某个值，并希望将计算所得的值用于需要缓冲距离值和线性单位的工具（例如缓冲区），您需要执行以下操作：
- 将代码块中的线性单位与距离值一同返回，
- 如下图所示更改返回值的数据类型，
- 然后将数据类型参数设置为线性单位，这样，表达式的结果将被转换为线性单位值。
在任何接受栅格或常数值的 Spatial Analyst 工具中，可以直接使用计算值工具的输出结果，例如，加、大于和小于（这些工具位于 Spatial Analyst 工具箱/数学工具集中）。要使用计算值的输出结果，请将输出数据类型更改为“格式化的栅格”。此输出数据类型格式是像元值由公式或常量表示的栅格表面。
在 Python 中，部分语法将适当缩进。缩进程度（两个空格或四个空格）可任意设置，但在整个代码块中缩进程度必须保持一致。
无法从代码块访问模型变量。此类变量必须从表达式传递到代码块。此操作可通过在代码块参数中创建定义并在表达式参数中引用所创建的定义来实现。
不应在表达式参数中使用类型为列表的模型变量。考虑到列表变量在“模型构建器”中的工作方式，计算值将使用列表变量中的第一个值执行一次，列表变量中的其他值不会传递给计算值。
语法
CalculateValue(expression, {code_block}, {data_type})| 参数 | 说明 | 数据类型 |
expression | 要进行求值的 Python 表达式。 | SQL Expression |
code_block （可选） | 附加 Python 代码。可以在表达式参数中引用代码块中的代码。 | String |
data_type （可选） | 从 Python 表达式返回的输出的数据类型。应在“模型构建器”中使用此参数，以便将计算值工具与其他工具相连接。 | String |
派生输出
| 名称 | 说明 | 数据类型 |
| value |
环境
此工具不使用任何地理处理环境。
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是