Trabajar con Iterar clases de entidades

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:

Parámetros de Iterar clases de entidades

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

Modelo finalizado para iterar y proyectar clases de entidad

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.

  1. Abra la página de descripción general Trabajar con Iterar clases de entidades.
  2. Haga clic en Descargar en el lado derecho de la página.
  3. Haga clic con el botón derecho en el archivo IterateFeatureClasses.zip descargado y extráigalo en una ubicación conveniente, como C:\Temp.
  4. En la carpeta extraída, IterateFeatureClasses, haga doble clic en el archivo de proyecto de 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.

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

  1. En el panel Catálogo, haga clic en la pestaña Proyecto, en caso necesario. Vaya a Carpetas > IterateFeatureClasses > MyProjectTools.
  2. Haga clic con el botón derecho en MyProjectTools y haga clic en Nuevo. Seleccione Modelo para crear y abrir un modelo.
  3. Agregue la herramienta Iterar clases de entidades.
    1. Haga clic en la pestaña ModelBuilder.
    2. En el grupo Insertar, haga clic en Iteradores Iteradores.
    3. En la lista Iteradores, haga clic en Iterar clases de entidades.

    Agregar la herramienta 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.

  4. Agregue la herramienta Proyectar.
    1. Haga clic en el modelo y escriba Proyectar para abrir el cuadro de diálogo Agregar herramientas al modelo.
    2. Busque la herramienta Proyectar.
    3. Haga doble clic en la herramienta Proyectar para agregarla al modelo.
  5. Agregue la herramienta Recopilar valor.
    1. Haga clic en la pestaña ModelBuilder.
    2. En el grupo Insertar, haga clic en el botón Utilidades Utilidades.
    3. En la lista Utilidades, haga clic en Recopilar valores para agregar la herramienta Recopilar valores al modelo.

    Agregar la herramienta Recopilar valores

Especificar los parámetros de herramientas y conectar las herramientas

Tras haber agregado herramientas al modelo, debe especificar parámetros para cada herramienta.

  1. Haga doble clic en el iterador Iterar clases de entidades a fin de abrir el cuadro de diálogo del iterador.
    1. En el parámetro Espacio de trabajo o dataset de entidades, vaya a la carpeta Carpetas > IterateFeatureClasses > Data.
    2. Active la casilla Recursivo para iterar sobre todas las clases de entidad de todas las subcarpetas.
    3. Deje vacíos el resto de parámetros y haga clic en Aceptar.

    Cuadro de diálogo de Iterar clases de entidades

    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.

  2. Haga doble clic en la herramienta Proyectar para abrir el cuadro de diálogo de la herramienta.
    1. Haga clic en la flecha desplegable del parámetro Clase de entidad o dataset de entrada y seleccione Metro_Entrances.shp.
    2. 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.
    3. Haga clic en el botón Sistema de coordenadas 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. Haga clic en Aceptar para cerrar el cuadro de diálogo.
    4. Mantenga NTF_TO_ED_1950 en el método Transformación geográfica.
    5. Haga clic en Aceptar para cerrar el cuadro de diálogo de la herramienta Proyectar cuando se hayan rellenado todos los parámetros.

    Cuadro de diálogo de la herramienta Proyectar

    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.

  3. 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.
  4. Cambie el nombre de todas las variables del modelo tal y como se muestra en el modelo finalizado en este flujo de trabajo.
  5. Para organizar los elementos del modelo, haga clic en el botón Diseño automático Diseño automático en la pestaña ModelBuilder y haga clic en el botón Ajustar a ventana 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.

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

  2. Haga clic en el botón Guardar Guardar de la pestaña ModelBuilder para guardar el modelo.
  3. Haga clic en el botón Ejecutar Ejecutar de la pestaña ModelBuilder para ejecutar el modelo.
    Salida del modelo Iterar clases de entidades

    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.

  1. 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.
  2. 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.
  3. Haga clic en Aceptar para cerrar el cuadro de diálogo de la herramienta.
  4. 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.
  5. Haga clic en Aceptar para cerrar el cuadro de diálogo.
  6. Haga clic en el botón Guardar Guardar de la pestaña ModelBuilder para guardar el modelo.
  7. Haga clic en el botón Ejecutar Ejecutar de la pestaña ModelBuilder para ejecutar el modelo.
    Salida del modelo Iterar clases de entidades con Comodín

    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.

  1. 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.
  2. 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.
  3. Haga clic en Aceptar para cerrar el cuadro de diálogo de la herramienta.
  4. 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.
  5. Haga clic en el botón Guardar Guardar de la pestaña ModelBuilder para guardar el modelo.
  6. Haga clic en el botón Ejecutar Ejecutar de la pestaña ModelBuilder para ejecutar el modelo.
    Salida del modelo Iterar clases de entidades con Comodín y Tipo de entidad

    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.

  7. Cierre el modelo y ArcGIS Pro.