Iterar selección de entidades (ModelBuilder)

Uso

  • La herramienta está pensada para utilizarse en ModelBuilder y no en scripts de Python.

  • Esta herramienta no admite clases de entidad complejas, como, por ejemplo, anotación y dimensiones.

  • Se puede utilizar más de un grupo por campo para la selección. Si se selecciona uno o más grupos por campos, el número de combinaciones únicas de cada grupo por campos determina el número de iteraciones. Para cada iteración, el número de registros que coinciden con la combinación determinada del grupo por campo determina la selección de la capa de entidades de salida. Si se selecciona más de un grupo por campo, los valores se concatenan <field value1>_<field value2> en el nombre de la variable en línea de salida. Consulte el siguiente ejemplo, en el que se utilizan dos campos de grupo: el nombre del huracán (NAME) y su categoría (Category). El valor de salida es Katrina_H5 y así sucesivamente para los demás valores.

    Iterar selección de entidades
  • Si no se selecciona ningún grupo por campo, el valor de salida se agrupará por el campo ObjectID, y la selección será un registro por selección. Si la tabla no contiene ningún campo ObjectID, por ejemplo, una tabla Excel, el valor está en blanco.

  • La herramienta tiene dos salidas: las Entidades seleccionadas y Valor de grupo del campo para las entidades seleccionadas, que se puede utilizar como variable en línea en otras herramientas.

  • La capa de entidades temporal se puede guardar como archivo de capa utilizando la herramienta Guardar en archivo de capa o se puede guardar como una nueva clase de entidad utilizando la herramienta Copiar entidades.

  • Si se agrega un iterador a un modelo, todas las herramientas del modelo se repetirán para cada valor en el iterador. Si no desea ejecutar cada herramienta en el modelo para cada valor iterado, cree un submodelo, modelo dentro de un modelo o modelo anidado que contenga solo el iterador y agréguelo al modelo principal como una herramienta de modelo.

Sintaxis

arcpy.mb.IterateFeatureSelection(in_features, {fields}, {skip_nulls})
ParámetroExplicaciónTipo de datos
in_features

La clase o capa de entidades de entrada que contiene las entidades que se desea iterar.

Feature Layer
fields
[fields,...]
(Opcional)

El campo o campos de entrada utilizados para agrupar las entidades para la selección. Se puede definir cualquier número de campos de entrada, y su resultado será una selección basada en una combinación única de los campos. Si no se especifica ningún campo, se utiliza ObjectID para iterar las entidades.

Value Table
skip_nulls
(Opcional)

Especifica si los valores nulos del campo o los campos de agrupación se omiten durante la selección.

  • Activado: omite todos los valores nulos en los campos de agrupación durante la selección.
  • Desactivado: establecer como valor predeterminado. Incluye todos los valores nulos en los campos de agrupamiento durante la selección. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
selection

Una capa de entidades que se puede utilizar en otras herramientas de geoprocesamiento que acepten una capa de entidades en ModelBuilder.

Capa de entidades
value

El valor de campo que devuelve cada iteración. Si se elige más de un grupo por campo, los valores se concatenan <field value1>_<field value2>.

Variante

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí