迭代要素选择 (ModelBuilder)

使用方法

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

  • 此工具不支持复杂要素类(如注记和尺寸)。

  • 多个按字段划分的组可用于选择。可选择一个或多个按字段划分的组,迭代次数由按字段划分的组的唯一组合数确定。对于每次迭代,输出要素图层的选择由与按字段划分的组的给定组合相匹配的记录数来确定。如果选择了多个按字段划分的组,会在输出行内变量名称中将这些字段值串连为 <字段值1>_<字段值2>。请参阅以下包含两个分组字段的示例:使用了飓风的名称(名称)和飓风的类别(类别)。输出值为 Katrina_H5,其他值则依此类推。

    迭代要素选择
  • 如果未选择按字段划分的组,则输出值将按“对象 ID”字段进行分组,且一次只能选择一个记录。如果表没有“对象 ID”字段(例如 Excel 表),则输出值为空。

  • 该工具包含两种输出:所选要素及所选要素字段的分组,它们可在其他工具中用作行内变量

  • 可使用保存至图层文件工具将临时要素图层保存为图层文件或使用复制要素工具将此图层保存为新要素类。

  • 如果模型中添加了一个迭代器,那么模型中的所有工具会对迭代器中的每个值进行迭代。如果不想针对每个迭代值运行模型中的所有工具,创建仅包含迭代器的子模型、模型中的模型或嵌套模型,然后将其作为模型工具添加到主要模型中。

语法

arcpy.mb.IterateFeatureSelection(in_features, {fields}, {skip_nulls})
参数说明数据类型
in_features

包含要迭代的要素的输入要素类或图层。

Feature Layer
fields
[fields,...]
(可选)

用于对可供选择的要素进行分组的一个或多个输入字段。可定义多个输入字段,以根据字段的唯一组合进行选择。如果未指定字段,则使用“对象 ID”迭代要素。

Value Table
skip_nulls
(可选)

指定是否在选择过程中跳过一个或多个分组字段中的空值。

  • 选中 - 选择过程中跳过分组字段中的所有空值。
  • 未选中 - 设置为默认值。选择过程中包含分组字段中的所有空值。这是默认设置。
Boolean

派生输出

名称说明数据类型
selection

要素图层可在其他地理处理工具中使用,而这些工具可在 ModelBuilder 中接受要素图层。

要素图层
value

每次迭代返回的字段值。如果选择了多个按字段划分的组,会将这些字段值串连为 <字段值1>_<字段值2>。

变量

许可信息

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