Resumen
La herramienta Iterar clases de entidades se itera sobre clases de entidad en un espacio de trabajo o dataset de entidades. Cada iterador tiene un conjunto de parámetros que pueden diferir de los otros iteradores, pero la estructura general de todas las herramientas de iterador es muy similar. La herramienta Iterar clases de entidades se describe a continuación:
- Clases de entidad de entrada (entrada): un espacio de trabajo o dataset de entidades que almacena las clases de entidad a iterar.
- Comodín (entrada opcional): una combinación de asteriscos y caracteres utilizados para limitar los resultados. El asterisco equivale a todo. Si no se especifica ningún comodín, se devolverán todas las entradas.
- Tipo de entidad (entrada opcional): el tipo de entidad que se va a utilizar como filtro. Sólo se generarán las entidades del tipo especificado. Si no se especifica un tipo de entidad se devolverán todos los tipos de entidades.
- Recursivo (entrada opcional): especifica si el iterador se iterará por todas las subcarpetas en el espacio de trabajo principal.
- Clase de entidad (salida): la ruta completa a la clase de entidad.
- Nombre (salida): el nombre de la clase de entidad.
En este flujo de trabajo, creará un modelo (como se muestra a continuación) para iterar y proyectar cada clase de entidad en el espacio de trabajo del modelo de entrada y utilizará el parámetro Nombre de salida como la variable en línea en el nombre de la Clase de entidad de salida de la herramienta Proyectar. El flujo de trabajo le guiará por cada opción de los parámetros del iterador para resaltar su funcionalidad.
Requisitos previos
Si no tiene experiencia en ModelBuilder, repase los siguientes temas:
Abrir el proyecto
Descargue el proyecto que se utilizará en este flujo de trabajo. El proyecto incluye datos de entrada, geodatabases de salida y un modelo completado.
- Abra la página de descripción general Trabajar con Iterar clases de entidades.
- Haga clic en Descargar en el lado derecho de la página.
- Haga clic con el botón derecho en el archivo IterateFeatureClasses.zip descargado y extráigalo en una ubicación conveniente, como C:\Temp.
- En la carpeta extraída, IterateFeatureClasses, haga doble clic en el archivo de proyecto ArcGIS Pro, IterateFeatureClasses.aprx.
El proyecto se abre en un mapa vacío y se utilizará para ver los resultados del modelo que va a crear.
- Explore los datos en el panel Catálogo y haga clic en la pestaña Proyecto, en caso necesario. Vaya a Carpetas > IterateFeatureClasses.
La carpeta Data contiene subcarpetas, cada una de ellas contiene clases de entidad que se iterarán y proyectarán en el modelo. Las salidas de este flujo de trabajo se guardarán en las geodatabases Scratch*.
Agregar herramientas
Creará un modelo en la caja de herramientas MyProjectTools. Para agregar herramientas al modelo, siga estos pasos:
- En el panel Catálogo, haga clic en la pestaña Proyecto, en caso necesario. Vaya a Carpetas > IterateFeatureClasses > MyProjectTools.
- Haga clic con el botón derecho en MyProjectTools y haga clic en Nuevo. Seleccione Modelo para crear y abrir un modelo.
- Agregue la herramienta Iterar clases de entidades.
- En la cinta, haga clic en la pestaña ModelBuilder.
- En el grupo Insertar, haga clic en Iteradores .
- En la lista Iteradores, haga clic en Iterar clases de entidades.
El iterador Iterar clases de entidades se agrega al modelo. El iterador no está disponible al no haberse proporcionado todavía valores para el parámetro.
- Agregue la herramienta Proyectar.
- Haga clic en el modelo y escriba Proyectar para abrir el cuadro de diálogo Agregar herramientas al modelo.
- Busque la herramienta Proyectar.
- Haga doble clic en la herramienta Proyectar para agregarla al modelo.
- Agregue la herramienta Recopilar valor.
- Haga clic en la pestaña ModelBuilder.
- En el grupo Insertar, haga clic en el botón Utilidades .
- En la lista Utilidades, haga clic en Recopilar valores para agregar la herramienta Recopilar valores al modelo.
Especificar los parámetros de herramientas y conectar las herramientas
Tras haber agregado herramientas al modelo, debe especificar parámetros para cada herramienta.
- Haga doble clic en el iterador Iterar clases de entidades a fin de abrir el cuadro de diálogo del iterador.
- En el parámetro Espacio de trabajo o dataset de entidades, vaya a la carpeta Carpetas > IterateFeatureClasses > Data.
- Active la casilla Recursivo para iterar sobre todas las clases de entidad de todas las subcarpetas.
- Deje vacíos el resto de parámetros y haga clic en Aceptar.
Se agrega el espacio de trabajo como variable de entrada del modelo (óvalo azul oscuro) y cambia el color del iterador, lo que indica que se han suministrado los parámetros requeridos y ya se puede ejecutar.
- Haga doble clic en la herramienta Proyectar para abrir el cuadro de diálogo de la herramienta.
- Haga clic en la flecha desplegable del parámetro Clase de entidad o dataset de entrada y seleccione Metro_Entrances.shp.
- En el parámetro Clase de entidad o dataset de salida, vaya a la geodatabase <Your Project Location>\IterateFeatureClasses\ScratchAllFC.gdb y escriba %Name%_Project.
- Haga clic en el botón Sistema de coordenadas en el parámetro Sistema de coordenadas de salida para abrir el cuadro de diálogo Sistema de coordenadas. Seleccione Sistema de coordenadas proyectadas > Continental > Europa > Proyección Cónica de áreas equivalentes de Albers de Europa. Haz clic en Aceptar para cerrar el cuadro de diálogo.
- Mantenga NTF_TO_ED_1950 en el método Transformación geográfica.
- Haga clic en Aceptar para cerrar el cuadro de diálogo de la herramienta Proyectar cuando se hayan rellenado todos los parámetros.
Precaución:
Si sus clases de entidad de entrada tienen otros sistemas de coordenadas, es posible que la transformación geográfica agregada no se aplique en todos y que los datos se proyecten de forma incorrecta. Debe tener en cuenta los sistemas de coordenadas de sus entradas y el método de transformación geográfica que se aplica a ellos. Utilice el parámetro Comodín del iterador para proyectar de forma selectiva las clases de entidad en tales casos. Obtendrá más información sobre el uso del comodín en la sección Uso del parámetro opcional Comodín.
- Desplace el cursor sobre la variable de salida de la herramienta Proyectar. Haga clic y arrastre para dibujar una línea de conexión con el elemento de herramienta Recopilar valores. Suelte el ratón y haga clic en Valor de entrada en el menú emergente. La herramienta Recopilar valores es una herramienta de respaldo que se utiliza para recopilar los valores de salida de cada iteración en una única salida de varios valores.
- Cambie el nombre de todas las variables del modelo tal y como se muestra en el modelo finalizado en este flujo de trabajo.
- Para organizar los elementos del modelo, haga clic en el botón Diseño automático en la pestaña ModelBuilder y haga clic en el botón Ajustar a ventana para maximizar el diseño según el tamaño de la ventana de su modelo.
Ejecutar el modelo
Validará y ejecutará el modelo. Examinará las salidas de ScratchAllFC.gdb y confirmará que todas las clases de entidad de la carpeta Data se hayan iterado y proyectado.
- Haga clic con el botón derecho en la salida de la herramienta Recopilar valores y, a continuación, haga clic en Agregar a visualización.
Las salidas se agregan al mapa después de ejecutar el modelo.
- Haga clic en el botón Guardar de la pestaña ModelBuilder para guardar el modelo.
- Haga clic en el botón Ejecutar de la pestaña ModelBuilder para ejecutar el modelo.
El modelo se itera sobre todas las clases de entidad de la carpeta Data, las proyecta y crea la salida en la geodatabase ScratchAllFC.gdb.
Utilizar el parámetro opcional Comodín
Estos pasos amplían el flujo de trabajo para obtener más información sobre el uso del parámetro opcional Comodín del iterador.
- Tras terminar con las secciones anteriores y crear las clases de entidades proyectadas de salida, haga doble clic en la herramienta Iterar clases de entidades y ábrala.
- Escriba Metro* en el parámetro Comodín. Deje activado el parámetro Recursivo. Así, garantiza que el modelo se itere sobre todas las subcarpetas, pero que solo proyecte las clases de entidad cuyo nombre comience por Metro. En el tiempo de ejecución, * se sustituirá por el resto del nombre de la clase de entidad que comience por Metro.
- Haga clic en Aceptar para cerrar el cuadro de diálogo de la herramienta.
- Abra el cuadro de diálogo de la herramienta Proyectar y cambie la opción Clase de entidad o dataset de salida por <Your Project Location>\IterateFeatureClasses\ScratchWildCard.gdb\%Name%_Project.
- Haz clic en Aceptar para cerrar el cuadro de diálogo.
- Haga clic en el botón Guardar de la pestaña ModelBuilder para guardar el modelo.
- Haga clic en el botón Ejecutar de la pestaña ModelBuilder para ejecutar el modelo.
El modelo se itera sobre todas las clases de entidad cuyo nombre comience por Metro, las proyecta y crea la salida en la geodatabase ScratchWildCard.gdb.
Utilizar los parámetros opcionales Comodín y Tipo de entidad
Estos pasos amplían más el flujo de trabajo para obtener más información sobre el uso del parámetro opcional Tipo de entidad del iterador.
- Tras terminar con la sección Uso del parámetro opcional Comodín y crear las clases de entidad proyectadas de salida, haga doble clic en la herramienta Iterar clases de entidades y ábrala.
- Haga clic en la flecha desplegable del parámetro Tipo de entidad y seleccione la opción Línea. Así, garantiza que el modelo se itere sobre todas las clases de entidad de Línea cuyo nombre comience por Metro.
- Haga clic en Aceptar para cerrar el cuadro de diálogo de la herramienta.
- Abra el cuadro de diálogo de la herramienta Proyectar y cambie la opción Clase de entidad o dataset de salida por <Your Project Location>\IterateFeatureClasses\ScratchOnlyLine.gdb\%Name%_Project.
- Haga clic en el botón Guardar de la pestaña ModelBuilder para guardar el modelo.
- Haga clic en el botón Ejecutar de la pestaña ModelBuilder para ejecutar el modelo.
El modelo se itera sobre todas las clases de entidad de línea cuyo nombre comience por Metro, las proyecta y crea la salida en la geodatabase ScratchOnlyLine.gdb.
- Cierre el modelo y ArcGIS Pro.