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

Сводка

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

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

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

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

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

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

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

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

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

  • Если итератор добавлен в модель, все инструменты в модели будут повторяться для каждого значения в итераторе. Если вы не хотите запускать каждый инструмент в модели для каждого значения итерации, создайте подмодель/модель в пределах модели/вложенной модели (sub-model/model within a model/nested model), которая содержит только итератор, и добавьте ее как инструмент модели в основную модель.

Синтаксис

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>.

Вариант

Environments

Этот инструмент не использует параметры среды геообработки

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

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