Skip to main content

Итерировать выборку объектов (Инструменты модели)

Краткая информация

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

[Более подробно о том, как в ModelBuilder работает инструмент Итерировать выборку объектов(examples-of-using-iterators-in-modelbuilder.md#0EF)

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

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

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

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

    Параметры инструмента Итерировать выборку объектов

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

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

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

  • Если в модель добавлен итератор, все инструменты модели будут повторяться для каждого значения в итераторе. Если вы не хотите запускать каждый инструмент в модели для каждого значения итерации, создайте подмодель, модель в пределах модели или вложенную модель(../../help/analysis/geoprocessing/modelbuilder/add-a-submodel-to-a-model.md), которая содержит только итератор, и добавьте ее как инструмент модели в основную модель.

Параметры

Подпись Объяснение Тип данных

Входные объекты

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

Feature Layer

Группировать по полям

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

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

Столбцы таблицы значений:

  • Field–The fields that will be used to group the features for selection.

  • Null Value–The value from the field that will be substituted for a null value.

Value Table

Пропустить нулевые значения

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

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

  • Checked—Значения null в полях группировки будут пропущены при выборке.

  • Unchecked—Значения null в полях группировки не будут пропущены при выборке. Используется по умолчанию.

Boolean

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

Подпись Объяснение Тип данных

Выбранные объекты

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

Feature Layer

Значение

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

Variant

Параметры среды

Текущая рабочая область

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

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