Ejemplos del uso de iteradores en ModelBuilder

Los iteradores permiten el procesamiento por lotes y ayudan a repetir un proceso o conjunto de procesos en un conjunto de entradas.

Para

La herramienta Para se itera en un valor inicial y final mediante un valor determinado.

En la siguiente imagen, el iterador Para itera desde un valor de 500 a un valor de 2000, aumentando en incrementos de 500. La salida de Para se utiliza como el parámetro Distancia de zona de influencia en la herramienta Zona de influencia y en el nombre de salida como sustitución de variables en línea.

Uso de Para en ModelBuilder

Mientras

La herramienta Mientras itera hasta que una condición pasa a ser verdadera o hasta que una condición pasa a ser falsa.

En la imagen siguiente, el modelo selecciona todos los grupos de bloques que comparten un límite con un área de interés, calcula su población total y crea una capa en la que la población es menor que el valor umbral, por ejemplo, un negocio que intenta alcanzar un valor de población establecido para ofertas de cupones alrededor de un grupo de bloques determinado. La herramienta Obtener conteo se activa para visualizar si existen selecciones que coinciden con los criterios establecidos en la herramienta Crear vista de tabla. La herramienta Mientras garantiza que el modelo se ejecute hasta que el recuento de filas sea diferente de cero.

Uso de Mientras en ModelBuilder

Iterar selección de entidades

La herramienta Iterar selección de entidades itera entidades en una clase de entidad.

En la imagen siguiente, el modelo calcula qué porción del área de mapa de la cobertura de suelo de la costa este resultó destruida por una franja de 100 metros de cinco huracanes de categoría 1. La variable Entidad de entrada es una clase de entidad de cinco rutas de huracanes del Atlántico con una zona de influencia de 100 metros alrededor de ella. La variable Ráster de entrada es un ráster de cobertura de suelo.

Cómo utilizar Iterar selección de entidades

En este ejemplo, el nombre del huracán se ha utilizado como un campo de grupo para realizar la selección, y la entidad seleccionada se utiliza como entrada para la herramienta Estadísticas zonales como tabla para generar una tabla de salida con estadísticas en la cobertura de suelo destruida durante la recalada de los huracanes.

La herramienta Iterar selección de entidades tiene dos salidas:

  • Entidad seleccionada (conectada como entrada a la herramienta Estadísticas zonales como tabla).
  • La variable Valor, que contiene el nombre de la entidad (basado en el campo de grupo), que se utiliza como una variable en línea en el nombre de salida de la variable Tabla de salida.

Iterar selección de filas

La herramienta Iterar selección de filas itera las filas de una tabla.

En la imagen siguiente, el modelo crea una elipse de desviación para hurtos durante distintos momentos del día (mañana, tarde, anochecer y noche) con el fin de detectar un patrón de delito subyacente.

Cómo utilizar Iterar selección de filas

La variable Clase de entidad de entrada es una clase de entidad que contiene puntos de incidentes de vandalismo. Contiene el campo Crime_Peri (período de delitos), que es el momento del día en el que ocurrió el incidente (las cadenas de caracteres Mañana, Tarde, Anochecer y Noche). Este campo se utiliza como el campo de grupo para realizar la selección, y las filas seleccionadas se utilizan para crear la elipse de desviación estándar de salida.

La herramienta tiene dos salidas:

  • La variable Selección de fila, que contiene las filas seleccionadas para un único período de delitos. Estas filas son la entrada para la herramienta Distribución direccional (Elipse de desviación estándar).
  • La variable Valor, que contiene el valor del campo de grupo (Mañana, Tarde, Anochecer o Noche). Este valor se utiliza como una variable en línea en el nombre de salida de la variable Elipse de desviación estándar de salida.

Iterar campos

La herramienta Iterar campos itera los campos de una tabla.

En la siguiente imagen, el modelo utiliza la herramienta Calcular campo para convertir los valores nulos de varios campos en ceros.

Cómo utilizar Iterar campos

La variable de la capa de entidades Incidentes tiene campos exclusivos con recuento del número de incidentes por fecha. Algunos de los campos tienen valores ausentes almacenados como nulos. En este caso, la herramienta Iterar campos se utiliza para filtrar los días en función de un comodín y un subconjunto de la lista de campos filtrados. A continuación, cada campo se pasa a la expresión de la herramienta Seleccionar capa por atributo y los registros seleccionados se pasan a la herramienta Calcular campo.

La herramienta tiene dos salidas:

  • Variable Valor conectada como el nombre de campo de entrada a la herramienta Seleccionar capa por atributo.
  • La variable Recuento mantiene un recuento total del número de campos sobre los que se iterará.

Iterar valores de campo

La herramienta Iterar valores de campo itera cada valor de un campo.

En la siguiente imagen, el modelo utiliza la herramienta Análisis de clúster y de valor atípico para el número de personas por debajo del umbral de la pobreza en cada país para comparar los resultados a diferentes distancias. Estas distancias se registran como el Campo de Distance en la variable Tabla de entrada.

Cómo utilizar Iterar valores de campo

Tenga en cuenta que en el cuadro de diálogo Iterar valores de campo, la opción Valores únicos está activada de forma predeterminada para iterar sobre cada valor único en una tabla. Si desactiva la opción Valores únicos, iterará para cada valor en el campo y el valor de salida se repetirá si hay valores duplicados en el campo de entrada.

Iterar valores de campo tiene una salida: la variable Valor que contiene el valor del campo, que se utiliza como el parámetro Banda de distancia o distancia de umbral de la herramienta Análisis de clúster y de valor atípico. La variable Valor también se utiliza para construir el nombre del archivo de salida de la variable Clase de entidad clúster de salida con el uso de la sustitución de la variable en línea.

Iterar multivalor

La herramienta Iterar multivalor itera sobre una lista de valores.

En la siguiente imagen, el modelo cambia la proyección del mapa de varias clases de entidad que están almacenadas en diferentes controladores y espacios de trabajo. Las clases de entidad de salida proyectadas se escriben en una base de datos de salida simple.

Cómo utilizar Iterar valor múltiple

La herramienta tiene una salida: el valor, que es una cadena de clases de entidad conectada a la herramienta Proyectar como entrada.

Iterar datasets

La herramienta Iterar clases de entidades itera los datasets de un espacio de trabajo o dataset de entidades.

En la siguiente imagen, el modelo copia todos los datasets de entidades incluidos en la variable Dataset de entrada, una variable del espacio de trabajo. La iteración ha sido restringida para que solo itere en el tipo de dataset de entidades.

Cómo utilizar Iterar datasets

La herramienta tiene dos salidas:

  • Dataset (suelo y transporte).
  • Nombre, que se utiliza como la variable en línea %Name% en la salida de la herramienta Copiar.

Iterar clases de entidades

La herramienta Iterar clases de entidades se itera sobre clases de entidad en un espacio de trabajo o dataset de entidades.

En la siguiente imagen, el modelo busca la densidad de población para las clases de entidad Blocks y Parcels en la variable Clases de entidad de entrada.

Cómo utilizar Iterar clases de entidades

La iteración ha sido restringida al elegir el tipo de entidad poligonal; por lo tanto, el iterador solo itera en las clases de entidad poligonales Blocks y Parcels.

La herramienta tiene dos salidas:

  • Variable Clase de entidad de salida (Bloques y Parcelas) conectada a la herramienta Agregar campo como entrada.
  • Variable Nombre (Bloques y Parcelas en este ejemplo), que se podría utilizar como la variable en línea %Name% en otras herramientas.

Iterar archivos

La herramienta Iterar archivos itera los archivos de una carpeta.

En la imagen siguiente, la variable Carpeta de entrada dispone de una lista de archivos de texto que se convertirán en ráster. La iteración se ha restringido con un comodín f* y la extensión de archivo .txt para que solo itere sobre archivos que comiencen con la letra f o F y de tipo texto.

Cómo utilizar Iterar archivos

La herramienta tiene dos salidas:

  • La variable Archivo (focaldem1.txt, focaldem2.txt o focaldem3.txt) conectada como entrada a la herramienta De ASCII a ráster.
  • La variable Nombre que contiene el nombre del archivo de texto (focaldem1, focaldem2 o focaldem3). Esta variable Nombre se utiliza en la salida de la próxima herramienta como una variable en línea %Name%.

Iterar capas

La herramienta Iterar capas itera las capas de un mapa.

En la imagen siguiente, la variable Mapa de entrada muestra una lista de capas que se proyectarán. La iteración está restringida a iterar solo las capas de entidades de puntos del mapa. La salida de la herramienta Iterar capas se prueba contra un sistema de coordenadas definido utilizando la herramienta Si el sistema de coordenadas es. Si el sistema de coordenadas de una capa no coincide con el sistema de coordenadas definido, el valor de la variable de salida False cambia a True y se ejecuta la herramienta Proyecto conectado para proyectar la capa entrante en un sistema de coordenadas especificado.

Cómo utilizar Iterar capas

Iterar tiempo

La herramienta Iterar tiempo itera a lo largo del tiempo en un campo de fecha.

En el siguiente ejemplo, la tabla de entrada presenta datos de precipitación entre 1981 y 2020 excluyendo los días secos. La herramienta Iterar tiempo divide los datos de entrada en periodos temporales de un mes mediante el campo Date. A partir de las filas seleccionadas para cada mes, la precipitación media y el recuento de días de lluvia se calculan con la herramienta Resumen de estadísticas. La herramienta Calcular campo se utiliza para agregar el valor de Hora de inicio con formato de cada iteración en la tabla resumida utilizando la sustitución de variables en línea. La tabla de resumen de cada mes se incorpora para generar una única tabla con la herramienta Incorporar.

Cómo utilizar Iterar tiempo

En el siguiente ejemplo, la tabla de entrada presenta datos de tornados, con su magnitud, de 2000 a 2018. El modelo resume la frecuencia de los tornados por magnitud en los meses de mayo y junio para un subconjunto de datos entre los años 2008 y 2018. La herramienta Iterar tiempo divide los datos de entrada en periodos temporales anuales mediante el campo Date. La herramienta limita el rango de datos en función de los valores definidos en los parámetros Hora de inicio de la iteración, Hora de finalización de la iteración y Definición de tiempo. Los tornados se resumen con la herramienta Resumen de estadísticas, y la herramienta Calcular campo agrega el año a la salida. Por último, los resultados anuales se incorporan en una única tabla.

Usar el parámetro Iterar tiempo con definición de tiempo

Iterar rásteres

La herramienta Iterar rásteres itera los rásteres de un espacio de trabajo.

En la siguiente imagen, el modelo remuestrea los datasets de cuadrícula y extrae un subconjunto para realizar un análisis posterior.

Cómo utilizar Iterar rásteres

La variable Rásteres de entrada es una carpeta que contiene cuadrículas, imágenes y archivos .tiff. En este caso, la iteración ha sido restringida con un comodín A* y un tipo de ráster de cuadrícula para que solo itere sobre rásteres que comiencen con la letra a o A y solamente en las cuadrículas.

La herramienta tiene dos salidas:

  • La variable Ráster de salida (Aland, Aparcel y Aroad) conectada como entrada a la herramienta Remuestrear.
  • La variable Nombre, que se utiliza en el nombre de salida de las herramientas Remuestrear y Extraer subconjunto como la variable en línea %Name%.

Iterar tablas

La herramienta Iterar tablas itera las tablas de un espacio de trabajo.

Iterar tablas (tablas del dBASE)

En la imagen siguiente, el modelo transpone tablas de cobertura de suelo de cada estado con un tipo de cobertura de suelo y resume las estadísticas, como la suma del área, para cada clase de cobertura de suelo.

Cómo utilizar Iterar tablas

La variable Espacio de trabajo de entrada es una carpeta que contiene las tablas. La iteración ha sido restringida con el comodín L* y el tipo de tabla dBASE para que itere solo en tablas dBASE que comiencen con la letra l o L.

La herramienta tiene dos salidas:

  • La variable Tabla de salida (Landcover_Arizona, Landcover_California y Landcover_Nevada) conectada a la herramienta Tabla pivote como entrada.
  • La variable Nombre, que se utiliza como una variable en línea %Name% en los nombres de salida de las herramientas Tabla pivote y Resumen de estadísticas.

Iterar tablas (tablas de Excel)

En la imagen que aparece a continuación, el modelo se itera por todas las hojas de una tabla de Excel y las exporta a una geodatabase. La tabla de Excel de entrada funciona como un espacio de trabajo para el iterador. La herramienta crea una ruta de salida a hojas individuales en el espacio de trabajo de Excel y también devuelve el nombre de la hoja que se utiliza como variable en línea para el nombre de salida de la herramienta Exportar tabla.

Usar Iterar tablas con entrada de

Iterar tablas (tablas CSV)

En el ejemplo siguiente, la herramienta Iterar tablas se itera por una carpeta que contiene archivos .csv. La herramienta crea una ruta de salida a archivos .csv individuales y también devuelve el nombre del archivo .csv que puede utilizarse como variable en línea para el nombre de salida de la herramienta De tabla XY a punto. La herramienta De tabla XY a punto toma las coordenadas XY de cada archivo .csv y crea una clase de entidad correspondiente.

Usar Iterar tablas con entradas csv

Iterar espacios de trabajo

La herramienta Iterar espacios de trabajo itera los espacios de trabajo de una carpeta.

En la imagen siguiente, el modelo crea un mosaico con rásteres almacenados en una geodatabase denominada Arizona, que se almacena dentro de una carpeta.

Cómo utilizar Iterar espacios de trabajo

La iteración ha sido restringida con el comodín Ar* y un espacio de trabajo de tipo geodatabase de archivos para que solo itere en geodatabases de archivos con nombres que comiencen con las letras Ar.

La herramienta tiene dos salidas: