收集值 (模型构建器)

摘要

“收集值”工具专用于收集迭代器的输出值或将一组多值转换为单个输入。“收集值”工具的输出结果可用作如合并、追加、镶嵌和像元统计等工具的输入。

了解“收集值”在模型构建器中的工作原理

用法

• 此工具专用于模型构建器，不能用于 Python 脚本编辑。

注:

除“收集值”和“合并分支”外，所有 ArcGIS 工具在添加到模型后均为空（无颜色）。与其他系统工具不同，“收集值”则始终处于准备运行状态（彩色）。这是因为收集值的输入属于多值数据类型，而一个空的多值数据仍将被视为有效输入。

• 在选中添加至显示选项的情况下，工具输出将会以变量名称作为图层名称被添加到 ArcMap 的显示画面中。如果您在模型中引入了迭代器，并且要使用实际的唯一输出名称（而不是变量名称）将所有迭代的输出都添加到 ArcMap 的显示画面中，请将要显示的输出连接到“收集值”工具，然后右键单击 “收集值”的输出并选中添加至显示选项。如果要从模型工具对话框运行模型，则请设置“收集值”的输出成为模型参数，因为系统只会将输出模型参数添加到显示画面。

• “收集值”工具的另一个用途是从工具对话框中移除输出参数，且仍可将输出添加到显示中。例如，假设您的模型使用缓冲工具，且缓冲工具的输出是一个模型参数。通过模型工具对话框运行模型时，工具对话框将显示该参数，同时对话框的用户可以更改缓冲输出的写入位置。但如果不希望对话框的用户更改此位置呢？也就是说，希望将其写入无法更改的特定位置。您可以更改模型变量，使其不成为参数，但模型变量只在作为参数时才可添加到显示画面中。

  解决方案为更改缓冲的输出，使其不成为参数，然后将输出连接到“收集值”工具。接下来将“收集值”的输出更改为模型参数。通过工具对话框运行模型时，参数不会在对话框中显示，且用户无法对其进行更改。但是，由于是输出参数，因此将添加到显示中。（此方法可行，因为从技术上，“收集值”的输出属于输入-输出派生数据，而输入-输出派生数据不会添加到对话框中。）

语法

CollectValues_mb (in_value)

参数	说明	数据类型
in_value	要收集的输入值。	Multiple Value

环境

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

许可信息

ArcGIS for Desktop Basic: 是

ArcGIS for Desktop Standard: 是

ArcGIS for Desktop Advanced: 是