Сводка
Выполняет итерации над объектами в классе пространственных объектов.
Использование
Этот инструмент предназначен для использования в ModelBuilder, а не в скриптах Python.
Итерировать выборку объектов (Iterate Feature Selection) вызывает Создать векторный слой (Make Feature Layer), чтобы сделать новую выборку и создать два набора выходных данных: Выбранные объекты (Selected Features) и Значение (Value). Выходные Выбранные объекты (Selected Features) - это векторный слой, который можно использовать в других инструментах геообработки, которые принимают векторный слой, в ModelBuilder.
Сложные классы объектов, таких как аннотации и размеры, не поддерживаются этим инструментом.
Для выборки можно использовать более одной группы по полю. Если выбраны одна или несколько группировок по полям, число итераций определяется числом уникальных комбинаций групп по полям. Для каждой итерации выборка выходного векторного слоя определяется числом записей, который совпадают с данной комбинацией группировки по полям. Если выбрано более одной группы по полю, тогда значения соединяются в виде <field value1>_<field value2> в выходном имени встроенной переменной. Посмотрите пример ниже, где два поля группировки: имя урагана и категория урагана. Выходное Значение (Value) 'Katrina_H5' и так же для других значений.
Если группировка по полю не выбрана, выходное значение - это группировка по полю ObjectID, и выборка - это одна запись на одну выборку. Если таблица не имеет поля ObjectID (OID), например таблица Excel, тогда значение пустое.
У инструмента два элемента выходных данных: Выходные выбранные объекты (Output Selected Features) и Значение (Group Value) поля для выбранных объектов, которое можно использовать каквстроенную переменную %Value% в других инструментах.
Временный векторный слой может быть сохранен как файл слоя с помощью инструмента Сохранить в файл слоя (Save To Layer File) или как новый класс пространственных объектов с помощью инструмента Копировать объекты (Copy Features).
Если итератор добавлен в модель, все инструменты в модели будут повторяться для каждого значения в итераторе. Если вы не хотите запускать каждый инструмент в модели для каждого значения итерации, создайте подмодель/модель в пределах модели/вложенной модели (sub-model/model within a model/nested model), которая содержит только итератор, и добавьте ее как инструмент модели в основную модель.
Синтаксис
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: Да