Итерировать выборку объектов (ModelBuilder)

Сводка

Выполняет итерации над объектами в классе пространственных объектов.

Более подробно о том, как работает Итерировать выборку объектов в ModelBuilder

Использование

  • Этот инструмент предназначен для использования в ModelBuilder, а не в скриптах Python.

  • Классы сложных объектов, таких как аннотации и размеры, не поддерживаются этим инструментом.

  • Для выборки можно использовать более одной группы по полю. Если выбраны одна или несколько группировок по полям, число итераций определяется числом уникальных комбинаций групп по полям. Для каждой итерации выборка выходного векторного слоя определяется числом записей, который совпадают с данной комбинацией группировки по полям. Если выбрано более одной группы по полю, тогда значения соединяются в виде <field value1>_<field value2> в выходном имени встроенной переменной. Посмотрите пример ниже, где два поля группировки: имя урагана (NAME) и категория урагана (Category). Выходное Значение Katrina_H5 и так же для других значений.

    Итерировать выборку объектов
  • Если группировка по полю не выбрана, выходным значением будет группировка по полю Object ID, и выборка – одна запись на одну выборку. Если таблица не имеет поля Object ID, например таблица Excel, тогда значение пустое.

  • У инструмента два элемента выходных данных: Выбранные объекты и групповое Значение поля для выбранных объектов, которое можно использовать каквстроенную переменную в других инструментах.

  • Временный векторный слой может быть сохранен как файл слоя с помощью инструмента Сохранить в файл слоя или как новый класс пространственных объектов с помощью инструмента Копировать объекты.

  • Если в модель добавлен итератор, все инструменты модели будут повторяться для каждого значения в итераторе. Если вы не собираетесь запускать каждый инструмент модели для всех итерируемых значений, создайте подмодель, модель внутри модели или вложенную модель, содержащую только один итератор, и добавьте его в качестве инструмента модели в основную модель.

Синтаксис

arcpy.mb.IterateFeatureSelection(in_features, {fields}, {skip_nulls})
ParameterОбъяснениеТип данных
in_features

Входной класс пространственных объектов или слой, содержащий объекты для итерации.

Feature Layer
fields
[fields,...]
(Дополнительный)

Входное поле или поля, используемые для группировки объектов для выборки. Может быть задано любое число входных полей, в результате выборка на основе уникальной комбинации полей. Если поле не задано, то используется Object ID для итерации по объектам.

Value Table
skip_nulls
(Дополнительный)

Определяет, будут ли пропущены пустые значения в полях группировки при выборке.

  • Включено – пропускать все пустые значения в полях группировки при выборке.
  • Выключено — по умолчанию. Включить все пустые значения в полях группировки при выборке. Это значение по умолчанию.
Boolean

Производные выходные данные

NameОбъяснениеТип данных
selection

Векторный слой, который можно использовать в других инструментах геообработки, которые принимают векторный слой, в ModelBuilder.

Векторный слой
value

Значение поля возвращается в каждой итерации. Если выбрано более одной группы по полю, тогда значения соединяются в виде <field value1>_<field value2>.

Вариант

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да