在 ModelBuilder 中使用迭代器的示例

迭代器将启用批处理，有助于针对一组输入重复一个过程或一系列过程。

For

在下图中，For 迭代器从值 500 迭代至值 2000，以 500 增量增加。For 的输出用作缓冲工具中缓冲距离的参数值，而输出名称则按照行内变量替换的形式。

While

在下图中，模型将选择与感兴趣区域共享边界的所有区块组，计算其总人口并在人口小于阈值处创建图层，例如，某企业试图达到为特定区块组周围的优惠券发放设置人口值。获取计数工具可用于检查是否存在与创建表视图工具中设置的条件相匹配的任何选择。同时确保模型运行直到行计数不为零为止。

迭代要素选择

在下图中，模型用于计算在五类一级飓风以 100 米宽席卷的行进路径上，“东海岸”有多少土地覆被图区域遭到破坏。输入要素变量是一个包括周围 100 米宽的缓冲区在内的五类大西洋飓风行进路径的要素类。输入栅格变量是土地覆被栅格。

在本例中，飓风的名称被作为执行选择的分组字段，所选要素被作为以表格显示分区统计工具的输入，以便最终生成飓风登陆期间遭受破坏的土地覆被上相关统计数据的输出表。

迭代要素选择工具有两个输出：

• 所选要素（作为输入与以表格显示分区统计工具连接）。
• 值变量，包含用作输出表变量输出名称中行内变量的要素（基于分组字段）名称。

迭代行选择

在下图中，模型可为一天中不同时段（上午、下午、傍晚和夜间）发生的盗窃案件创建标准差椭圆，用以侦查犯罪的基本模式。

输入要素类变量是一个包含犯罪案件点的要素类。其中包含字段 Crime_Peri（犯罪时段），该字段是指案件发生的时段（字符串 Morning、Afternoon、Evening 和 Night）。此字段作为执行选择的分组字段，所选行被用来创建输出标准差椭圆。

此工具有两个输出：

• 包含唯一犯罪时段的所选行的行选择变量。这些行是方向分布（标准差椭圆）工具的输入。
• 值变量，包含分组字段（Morning、Afternoon、Evening 或 Night）的值。此值被用作输出标准差椭圆变量的输出名称中的行内变量。

迭代字段

在下图中，模型使用计算字段工具将多个字段中的空值转换为零。

事件要素图层变量具有唯一的字段，该字段按日期统计事件的数量。一些具有缺失值的字段存储为空值。在这种情况下，迭代字段工具用于基于通配符和已过滤字段列表的子集过滤日期。然后每个字段将传递至按属性选择图层工具，然后所选记录将传递到计算字段工具。

此工具有两个输出：

• 值变量作为输入字段名称连接到按属性选择图层工具。计数变量保留要迭代的字段总数。

迭代字段值

在下图中，模型对每个县贫困线以下的人数使用聚类和异常值分析工具，以比较不同距离的结果。这些距离以 Distance 字段的形式记录在 输入表 变量中。

请注意，默认情况下，迭代字段值对话框中的唯一值选项被选中，以迭代表中的所有唯一值。取消选中唯一值选项将迭代字段中的所有值，如果在输入字段中存在重复值，则输出值也会出现重复。

迭代字段值有一个输出：包含字段的值的值变量，被用作聚类和异常值分析工具的距离范围或距离阈值。值变量也可使用行内变量替换来构造输出聚类要素类变量的输出文件名。

迭代多值

在下图中，模型更改了存储在不同驱动器和工作空间中的多个要素类的地图投影。投影输出要素类被写入到单个输出数据库中。

此工具有一个输出：值，它是作为输入与投影工具连接的要素类的字符串。

迭代数据集

在下面的图像中，模型将复制包含于输入数据集变量（工作空间变量）中的所有要素数据集。已将迭代限制为仅可迭代 FEATURE 数据集类型。

此工具有两个输出：

• 数据集（Land 和 Transportation）。
• 名称，用作复制工具的输出中的行内变量 %Name%。

迭代要素类

在下图中，模型将为输入要素类变量中的 Blocks 和 Parcels 要素类找到人口密度。

已通过选择面要素类型对迭代进行了限制；因此，迭代器仅能对 Blocks 和 Parcels 面要素类进行迭代。

此工具有两个输出：

• 作为输入与添加字段工具连接的输出要素类变量（Blocks 和 Parcels）。
• 名称变量（在本例中为 Blocks 和 Parcels），可能在其他工具中被用作行内变量 %Name%。

迭代文件

在下图中，输入文件夹变量具有要转换为栅格的文本文件列表。已使用通配符 f* 和文件扩展名 .txt 对迭代进行了限制，因此，它仅能迭代首字母为 f 或 F 的文本文件。

此工具有两个输出：

• 作为输入与 ASCII 转栅格工具连接的文件变量（focaldem1.txt、focaldem2.txt 或 focaldem3.txt）。
• 包含文本文件名称的名称变量（focaldem1、focaldem2 或 focaldem3）。此名称变量以行内变量 %Name% 的形式应用于下一个工具的输出中。

迭代栅格数据

在下图中，模型对格网数据集重新采样并提取一个子集以进行进一步分析。

输入栅格变量是包含格网、图像和 TIFF 的文件夹。在本例中，已使用通配符 A* 和栅格类型“格网”对迭代进行了限制，因此，其仅能迭代首字母为 a 或 A 的“格网”类型栅格。

此工具有两个输出：

• 作为输入与重采样工具连接的输出栅格变量（Aland、Aparcel 和 Aroad）。
• 名称变量，以行内变量 %Name% 的形式用于重采样和提取子集工具的输出名称中。

迭代表

在下图中，模型用于使用土地覆被类型转置每个州的土地覆被表，并汇总每类土地覆被的统计数据（例如总面积）。

输入工作空间变量是包含表的文件夹。已使用通配符 L* 和表类型 dBASE 对迭代进行了限制，因此，它仅能迭代首字母为 l 或 L 的 dBASE 表。

此工具有两个输出：

• 作为输入与数据透视表工具连接的输出表变量（Landcover_Arizona、Landcover_California 和 Landcover_Nevada）。
• 名称变量，以行内变量 %Name% 的形式用于数据透视表和汇总统计数据工具的输出名称中。

迭代工作空间

在下图中，模型使用存储在名为 Arizona 的地理数据库中的栅格创建了镶嵌，该栅格存储在文件夹中。

已使用通配符 Ar* 和文件地理数据库的工作空间类型对迭代进行了限制，因此，它仅能迭代名称首字母为 Ar 的文件地理数据库。

此工具有两个输出：

• 作为输入与工作空间转栅格数据集工具连接的输出工作空间变量，包含 Arizona.gdb。
• 名称变量，可以行内变量 %Name% 的形式用于后续工具的输出名称中。