描述
迭代要素类中的要素。
使用方法
此工具专用于模型构建器,而并不在编写 Python 脚本时使用。
迭代要素选择可调用创建要素图层以创建一个新的选择和两项输出:所选要素和值。输出所选要素为要素图层,可在其他地理处理工具中使用,而这些工具可在“模型构建器”中接受要素图层。
此工具不支持复杂要素类(如注记和尺寸)。
多个按字段划分的组可用于选择。可选择一个或多个按字段划分的组,迭代次数由按字段划分的组的唯一组合数确定。对于每次迭代,输出要素图层的选择由与按字段划分的组的给定组合相匹配的记录数来确定。如果选择了多个按字段划分的组,则会在输出行内变量名称中将这些字段值串连为 <字段值1>_<字段值2>。请参阅下例,包含两个分组字段:使用飓风的名称和类别。输出值为“Katrina_H5”,而其他值则依此类推。
如果未选择任何按字段划分的组,则输出值为按 ObjetctID 字段划分的组,且一次只能选择一个记录。如果表没有对象 ID (OID) 字段(例如 Excel 表),则输出值为空。
此工具有两个输出:输出所选要素及所选要素的字段的分组值,它们可在其他工具中用作行内变量 %Value%。
可使用保存至图层文件工具将临时要素图层保存为图层文件或使用复制要素工具将此图层保存为新的要素类。
如果模型中已添加一个迭代器,模型中的所有工具都会对此迭代器中的每个值进行迭代。如果您不想对每个被迭代的值运行模型中的每个工具,请创建一个只包含迭代器的子模型/嵌套模型内的子模型/镶嵌模型,并将其作为模型工具添加到主模型中。
语法
arcpy.mb.IterateFeatureSelection(in_features, {fields}, {skip_nulls})
参数 | 说明 | 数据类型 |
in_features | 包含要迭代的要素的输入要素类或图层。 | Feature Layer |
fields [[Field, Null Value],...] (可选) | 用于对可供选择的要素进行分组的一个或多个输入字段。可定义多个输入字段,以根据字段的唯一组合进行选择。如果未指定任何字段,则使用 OID 迭代要素。 为字段定义空值。默认情况下,除非进行指定或者选中跳过所有空值的选项,否则所选内容将包含空值。对于字符串,默认值为 "";对于数字,默认值为“0”。 | Value Table |
skip_nulls (可选) | 确定是否在选择过程中跳过一个或多个分组字段中的空值。
| Boolean |
环境
此工具不使用任何地理处理环境。
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是