Iterar capas (ModelBuilder)

Resumen

Itera las capas de un mapa.

Más información sobre cómo funciona Iterar capas en ModelBuilder

Uso

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

• Cuando el parámetro Tipo de capa se establece en Vista de tabla, solo se iteran las tablas independientes. Para trabajar con tablas de entidades o ráster, establezca el parámetro Tipo de capa en Capa de entidades o Capa ráster, respectivamente.

• Para cada iteración, la herramienta devuelve las siguientes salidas:

  • Capa de salida: la capa del mapa basada en los filtros de parámetros que se han definido. Esta capa incluirá las selecciones o uniones ya establecidas en la capa.
  • Nombre: el nombre de la capa. El nombre se puede utilizar en la sustitución de variables en línea.
  • Tipo de capa de salida: el tipo de capa. Este valor coincide con los tipos de capa establecidos con el parámetro Tipo de capa. Los valores de salida son constantes y no están localizados. Si se utilizan dos o más tipos de capas, el tipo se puede utilizar para ramificar un modelo como se muestra a continuación:

    

  • Tipo de formato o espacio de trabajo: el tipo de espacio de trabajo de la capa. Este valor solo se devuelve para capas de entidades, capas ráster y vistas de tabla. Los valores de salida son constantes y no están localizados. En el caso de las capas ráster que se almacenan en el espacio de trabajo basado en carpetas, se obtiene el formato de archivo (por ejemplo, TIFF) y este valor se puede utilizar para ramificar un modelo o como diagnóstico para evaluar el tipo de capa que se iteró.

    

• La herramienta devuelve capas que coinciden con el tipo definido en el parámetro Tipo de capa y los filtros establecidos con los parámetros Visibilidad y Estado. Por ejemplo, si el parámetro Tipo de capa está establecido en Capa de entidades y Capa ráster, el parámetro Visibilidad en No visible y el parámetro Estado en Válido, la herramienta devolverá capas de entidades y ráster que ni visibles ni válidas.

• Si no se establece el parámetro Tipo de capa o no hay capas que coincidan con los criterios del parámetro, el valor de Capa de salida se establece en OUTPUT_LAYER, el valor de Nombre y las salidas de Tipo de capa de salida se establecen en FEATURE_LAYER y la salida de Tipo de formato o espacio de trabajo se establece en WORKSPACE.

• El parámetro Tipo de capa se puede establecer en varios tipos, por ejemplo, Capa de entidades, Capa ráster y Vista de tabla. Sin embargo, la herramienta se puede conectar a herramientas aguas abajo como Copiar entidades, Copiar ráster o Copiar filas que pueden ser incompatibles con algunos de los tipos de capas. Para admitir varios tipos de capas en este escenario, el parámetro Tipo de capa se debe establecer en un único tipo de capa específico. A continuación, conecte la salida a la herramienta correspondiente que funcione con ese tipo de datos específico. Una vez realizadas todas las conexiones aguas abajo, puede establecer el parámetro Tipo de capa en los tres tipos de capas. Este flujo de trabajo es necesario porque el valor predeterminado inicial de la herramienta se establece en un tipo de capa de entidades que no es compatible con las herramientas que toman el ráster como entrada. Una vez agregado el modelo a todos los tipos de capas, la validación deja las herramientas en su estado válido.

Sintaxis

arcpy.mb.IterateLayers(input_map, {wildcard}, {layer_type}, workspace_type, {feature_type}, {raster_format_type}, {layer_visibility}, {layer_state}, {recursive})

Parámetro	Explicación	Tipo de datos
input_map	El mapa de entrada con las capas que se van a iterar.	Map
wildcard (Opcional)	Una combinación de * y caracteres que ayudan a limitar los resultados. El asterisco equivale a decir ALL. Si no se especifica ningún comodín, se devolverán todas las entradas. Por ejemplo, se puede utilizar para restringir la iteración de los nombres de entrada que empiezan por un carácter o una palabra determinados (por ejemplo, A* o Ari* o Land*, etc.).	String
layer_type [layer_type,...] (Opcional)	Especifica el tipo de capa utilizado para filtrar las capas. Si no se especifica ningún tipo de capa, se iterarán todos los tipos de capa admitidos. Se puede utilizar más de un tipo de capa para filtrar las capas. AnnotationLayer —Se iterarán las capas de anotaciones. BuildingLayer —Se iterarán las capas de edificios. BuildingSceneLayer — Se iterarán las capas de escena de edificios. DimensionLayer —Se iterarán las capas de dimensión. FeatureLayer —Se iterarán las capas de entidades. GALayer —Se iterarán las capas de estadísticas geográficas. GroupLayer —Se iterarán las capas de grupo. KMLLayer —Se iterarán las capas KML. LASDatasetLayer —Se iterarán las capas de dataset LAS. MosaicLayer —Se iterarán las capas de mosaico. NALayer —Se iterarán las capas de Network Analyst. NetworkDatasetLayer —Se iterarán las capas de dataset de red. ParcelLayer —Se iterarán las capas de parcela. RasterLayer —Se iterarán las capas ráster. SceneServiceLayer —Se iterarán las capas de servicios de escena. TableView —Se iterarán las vistas de tabla. TerrainLayer —Se iterarán las capas de terreno. TinLayer —Se iterarán las capas de TIN. TopologyLayer —Se iterarán las capas de topología. TraceNetworkLayer —Se iterarán las capas de red de trazado. UtilityNetworkLayer —Se iterarán las capas de red de servicos. VoxelLayer —Se iterarán las capas vóxel.	String
workspace_type [workspace_type,...]	Especifica el tipo de espacio de trabajo utilizado para filtrar las capas. Si no se especifica ningún tipo de espacio de trabajo, se iterarán todas las capas de los tipos de espacio de trabajo admitidos. El parámetro Tipo de espacio de trabajo solo está habilitado cuando el parámetro Tipo de capa se establece en Capa de entidades, Capa ráster o Vista de tabla. BIG_DATA_CONNECTION —Se iterarán las capas de un espacio de trabajo de conexión de big data. BIM_FILE —Se iterarán las capas de un espacio de trabajo de archivo BIM. CAD —Se iterarán las capas de un espacio de trabajo de CAD. DELIMITED_TEXT_FILE —Se iterarán las capas de un espacio de trabajo de archivo de texto delimitado. ENTERPRISE_GEODATABASE —Se iterarán las capas de un espacio de trabajo de geodatabase corporativa. FEATURE_SERVICE —Se iterarán las capas de un espacio de trabajo de servicio de entidades. FILE_GEODATABASE —Se iterarán las capas de un espacio de trabajo de geodatabase de archivos. IN_MEMORY_DATABASE —Se iterarán las capas de un espacio de trabajo de base de datos en memoria. MICROSOFT_EXCEL —Se iterarán las capas de un espacio de trabajo de Microsoft Excel. NETCDF —Se iterarán las capas de un espacio de trabajo de NetCDF. OLEDB —Se iterarán las capas de un espacio de trabajo de OLE DB. RASTER —Se iterarán las capas de un espacio de trabajo de ráster. SHAPEFILE —Se iterarán las capas de un espacio de trabajo de shapefile. SQLITE —Se iterarán las capas de un espacio de trabajo de SQLite. SQL_QUERY_LAYER —Se iterarán las capas de un espacio de trabajo de capa de consulta SQL. STREAM_SERVICE —Se iterarán las capas de un espacio de trabajo de servicio de transmisión. WEB_FEATURE_SERVICE —Se iterarán las capas de un espacio de trabajo de servicio de entidades web.	String
feature_type [feature_type,...] (Opcional)	Especifica el tipo de entidad utilizado para filtrar las capas. Si no se especifica ningún tipo de entidad, se iterarán todos los tipos de entidad admitidos. ANNOTATION —Se iterarán las clases de entidad de anotación. DIMENSION —Se iterarán las clases de entidad de dimensión. SIMPLE_EDGE —Se iterarán las clases de entidad de eje simple. COMPLEX_EDGE —Se iterarán las clases de entidad de eje complejo. SIMPLE_JUNCTION —Se iterarán las clases de entidad de cruce simple. COMPLEX_JUNCTION —Se iterarán las clases de entidad de cruce complejo. LINE —Se iterarán las clases de entidad de línea. POINT —Se iterarán las clases de entidad de punto. POLYGON —Se iterarán las clases de entidad poligonal. MULTIPATCH —Se iterarán las clases de entidad multiparche.	String
raster_format_type [raster_format_type,...] (Opcional)	El tipo de formato ráster utilizado para filtrar las capas ráster cuando el parámetro Tipo de espacio de trabajo se establece en Ráster. Si no se especifica ningún tipo de ráster, se iterarán todas las capas de los tipos de ráster admitidos.	String
layer_visibility (Opcional)	Especifica si se utiliza la visibilidad de la capa para filtrar las capas. Si no se especifica ninguna visibilidad de capa, se iterarán todas las capas. VISIBLE —Se utilizará la visibilidad de la capa para filtrar las capas y se iterarán las capas visibles. NOT_VISIBLE —No se utilizará la visibilidad de la capa para filtrar las capas y se iterarán las capas no visibles.	String
layer_state (Opcional)	Especifica el estado de la capa que se utilizará para filtrar las capas. Se obtienen capas con capas de ruta dañadas si el parámetro está establecido en no válido. Si no se especifica ningún estado de capa, se iterarán todas las capas. VALID —Se iterarán las capas válidas. INVALID —Se iterarán las capas no válidas.	String
recursive (Opcional)	Especifica si el iterador iterará las capas de grupo anidadas. Activado: se iterarán las capas de grupo anidadas. Desactivado: no se iterarán las capas de grupo anidadas.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
output_layer	La capa del mapa basada en los filtros de parámetros que se han definido. Esta capa incluirá las selecciones o uniones ya establecidas en la capa.	Cualquier valor
output_name	El nombre de la capa.	Cadena
output_layer_type	El tipo de capa.	Cadena
output_workspace_type	El tipo de espacio de trabajo de la capa.	Cadena

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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