描述
“收集值”工具专用于收集迭代器的输出值或将一组多值转换为单个输入。“收集值”工具的输出结果可用作如合并、追加、镶嵌和像元统计等工具的输入。
使用方法
此工具专用于模型构建器，而并不在编写 Python 脚本时使用。
在选中添加至显示选项的情况下，工具输出将会以变量名称作为图层名称被添加到 ArcMap 的显示画面中。如果您在模型中引入了迭代器，并且要使用实际的唯一输出名称（而不是变量名称）将所有迭代的输出都添加到 ArcMap 的显示画面中，请将要显示的输出连接到“收集值”工具，然后右键单击 “收集值”的输出并选中添加至显示选项。如果要从模型工具对话框运行模型，则请设置“收集值”的输出成为模型参数，因为系统只会将输出模型参数添加到显示画面。
“收集值”工具的另一个用途是从工具对话框中移除输出参数，且仍可将输出添加到显示中。例如，假设您的模型使用缓冲工具，且缓冲工具的输出是一个模型参数。通过模型工具对话框运行模型时，工具对话框将显示该参数，同时对话框的用户可以更改缓冲输出的写入位置。但如果不希望对话框的用户更改此位置呢？也就是说，希望将其写入无法更改的特定位置。您可以更改模型变量，使其不成为参数，但模型变量只在作为参数时才可添加到显示画面中。
解决方案为更改缓冲的输出，使其不成为参数，然后将输出连接到“收集值”工具。接下来将“收集值”的输出更改为模型参数。通过工具对话框运行模型时，参数不会在对话框中显示，且用户无法对其进行更改。但是，由于是输出参数，因此将添加到显示中。（此方法可行，因为从技术上，“收集值”的输出属于输入-输出派生数据，而输入-输出派生数据不会添加到对话框中。）
语法
arcpy.mb.CollectValues(in_value)
| 参数 | 说明 | 数据类型 |
in_value | 要收集的输入值。 | Multiple Value |
环境
此工具不使用任何地理处理环境。
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是