Zusammenfassung
Iteriert Layer in einer Karte.
Informationen zur Funktionsweise von "Layer iterieren" in ModelBuilder
Verwendung
Dieses Werkzeug ist nur für die Verwendung in ModelBuilder, nicht in Python-Skripten vorgesehen.
Wenn der Parameter Layer-Typ auf Tabellenansicht festgelegt wird, werden nur Standalone-Tabellen iteriert. Um mit Feature- oder Raster-Tabellen zu arbeiten, legen Sie den Parameter Layer-Typ jeweils auf Feature-Layer oder Raster-Layer fest.
Für jede Iteration gibt das Werkzeug die folgenden Ausgaben zurück:
- Ausgabe-Layer: Der Layer der Karte basierend auf den Parameterfiltern, die festgelegt wurden. Dieser Layer schließt alle Auswahlen oder Verbindungen ein, die bereits für den Layer festgelegt wurden.
- Name: Der Name des Layers. Der Name kann in der direkten Variablenersetzung verwendet werden.
- Ausgabe-Layer-Typ: Typ des Layers. Dieser Wert entspricht den Layer-Typen, die mit dem Parameter Layer-Typ festgelegt wurden. Die Ausgabewerte sind Konstanten und werden nicht lokalisiert. Wenn mehrere Layer-Typen verwendet werden, kann der Typ für Verzweigungen in Modellen verwendet werden, wie nachfolgend gezeigt:
- Workspace-Typ oder Formattyp: Workspace-Typ des Layers. Dieser Wert wird nur für Feature-Layer, Raster-Layer und Tabellenansichten zurückgegeben. Die Ausgabewerte sind Konstanten und werden nicht lokalisiert. Bei Raster-Layern, die im ordnerbasierten Workspace gespeichert werden, wird das Dateiformat zurückgegeben, z. B. TIFF, und dieser Wert kann für die Verzweigung eines Modells oder als Diagnose für die Auswertung des Layer-Typs, der iteriert wurde, verwendet werden.
Das Werkzeug gibt Layer zurück, die dem Typ entsprechen, der mit dem Parameter Layer Typ festgelegt wurden, und den Filtern, die mit den Parametern Sichtbarkeit und Status festgelegt wurden. Beispiel: Wenn der Parameter Layer-Typ auf Feature-Layer und Raster-Layer, der Parameter Sichtbarkeit auf Nicht sichtbar und der Parameter Status auf Gültig festgelegt wird, gibt das Werkzeug Feature- und Raster-Layer zurück, die nicht sichtbar und gültig sind.
Wenn der Parameter Layer-Typ nicht festgelegt wurde oder wenn es keine Layer gibt, die den Parameterkriterien entsprechen, wird der Wert von Ausgabe-Layer auf OUTPUT_LAYER gesetzt, der Wert von Name und die Ausgaben von Ausgabe-Layer-Typ werden auf FEATURE_LAYER und die Ausgabe von Workspace-Typ oder Formattyp wird auf WORKSPACE gesetzt.
Der Parameter Layer-Typ kann auf mehrere Typen festgelegt werden, beispielsweise auf Feature-Layer, Raster-Layer und Tabellenansicht. Das Werkzeug kann jedoch mit Downstream-Werkzeugen wie Features kopieren, Raster kopieren oder Zeilen kopieren verbunden werden, die mit einigen Layer-Typen inkompatibel sein können. Um die Verwendung von mehreren Layer-Typen in diesem Szenario zu ermöglichen, muss der Parameter Layer-Typ auf einen einzigen bestimmten Layer-Typ festgelegt werden. Verbinden Sie dann die Ausgabe mit dem entsprechenden Werkzeug, das mit diesem bestimmten Datentyp funktioniert. Nachdem alle Downstream-Verbindungen erstellt wurden, können Sie den Parameter Layer-Typ auf alle drei Layer-Typen festlegen. Dieser Workflow ist notwendig, da die anfängliche Standardeinstellung für dieses Werkzeugs auf einen Feature-Layer-Typ festgelegt wird, der nicht mit den Werkzeugen kompatibel ist, die Raster als Eingabe verwenden. Nachdem alle Layer-Typen zum Modell hinzugefügt wurden, befinden sich die Werkzeuge nach der Validierung im gültigen Status.
Syntax
arcpy.mb.IterateLayers(input_map, {wildcard}, {layer_type}, workspace_type, {feature_type}, {raster_format_type}, {layer_visibility}, {layer_state}, {recursive})
Parameter | Erklärung | Datentyp |
input_map | Die Eingabekarte mit den zu iterierenden Layern. | Map |
wildcard (optional) | Eine Kombination von * und Zeichen, die die Ergebnisse einschränken. Das Sternchen entspricht ALL. Wenn kein Platzhalter angegeben wird, werden alle Eingaben zurückgegeben. Dies kann z. B. verwendet werden, um die Iteration auf Eingabenamen einzuschränken, die mit einem bestimmten Zeichen oder Wort beginnen (z. B. A* oder Ari* oder Land* usw.). | String |
layer_type [layer_type,...] (optional) | Gibt den Layer-Typ an, der zum Filtern der Layer verwendet wird. Wenn kein Layer-Typ angegeben wird, werden alle unterstützten Layer-Typen durchlaufen. Es können jeweils mehrere Layer-Typen zum Filtern der Layer verwendet werden.
| String |
workspace_type [workspace_type,...] | Gibt den Workspace-Typ an, der zum Filtern der Layer verwendet wird. Wenn kein Workspace-Typ angegeben wurde, werden alle Layer der unterstützten Workspace-Typen durchlaufen. Der Parameter Workspace-Typ wird nur aktiviert, wenn der Parameter Layer-Typ auf Feature-Layer, Raster-Layer oder Tabellenansicht festgelegt wird.
| String |
feature_type [feature_type,...] (optional) | Gibt den Feature-Typ an, der zum Filtern der Layer verwendet wird. Wenn kein Feature-Typ angegeben wird, werden alle unterstützten Feature-Typen durchlaufen.
| String |
raster_format_type [raster_format_type,...] (optional) | Der Rasterformattyp wird verwendet, um die Raster-Layer zu filtern, wenn der Parameter Workspace-Typ auf Raster gesetzt wird. Wenn kein Raster-Typ angegeben wurde, werden alle Layer der unterstützten Raster-Typen durchlaufen. | String |
layer_visibility (optional) | Gibt an, ob die Layer-Sichtbarkeit für das Filtern der Layer verwendet wird. Wird die Sichtbarkeit nicht angegeben, werden alle Layer iteriert.
| String |
layer_state (optional) | Gibt den Layer-Status an, der zum Filtern der Layer verwendet wird. Layer mit ungültigen Quellpfad-Layern werden zurückgegeben, wenn der Parameter auf "ungültig" gesetzt wird. Wird ein Layer-Status nicht angegeben, werden alle Layer iteriert.
| String |
recursive (optional) | Gibt an, ob der Iterator geschachtelte Gruppen-Layer iteriert.
| Boolean |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
output_layer | Der Layer der Karte basierend auf den Parameterfiltern, die festgelegt wurden. Dieser Layer schließt alle Auswahlen oder Verbindungen ein, die bereits für den Layer festgelegt wurden. | Beliebiger Wert |
output_name | Der Name des Layers. | Zeichenfolge |
output_layer_type | Der Typ des Layers. | Zeichenfolge |
output_workspace_type | Der Workspace-Typ des Layers. | Zeichenfolge |
Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja