Feature-Auswahl iterieren (ModelBuilder)

Zusammenfassung

Durchläuft Features in einer Feature-Class.

Informationen zur Funktionsweise von Feature-Auswahl iterieren in ModelBuilder

Verwendung

  • Dieses Werkzeug ist nur für die Verwendung in ModelBuilder, nicht in Python-Skripten vorgesehen.

  • Komplexe Feature-Classes wie Annotation- und Dimension-Feature-Classes werden von diesem Werkzeug nicht unterstützt.

  • Für die Auswahl kann mehr als ein Gruppenfeld verwendet werden. Wenn ein oder mehrere Gruppenfelder ausgewählt werden, wird die Anzahl der Iterationen durch die Anzahl der eindeutigen Kombinationen der Gruppenfelder festgelegt. Für jede Iteration wird die Auswahl des Ausgabe-Feature-Layers durch die Anzahl der Datensätze festgelegt, die der vorgegebenen Kombination der Gruppenfelder entsprechen. Wenn mehr als ein Gruppenfeld ausgewählt wird, werden die Werte im Ausgabenamen der direkten Variablen verbunden (< Feld value1 > _ < Feld value2 >). Unten finden Sie ein Beispiel mit zwei Gruppenfeldern: Name des Hurrikans (NAME) und Kategorie des Hurrikans (Category). Der Ausgabewert ist Katrina_H5 bzw. für die weiteren Werte entsprechend.

    Feature-Auswahl iterieren
  • Wenn kein Gruppenfeld ausgewählt ist, wird der Ausgabewert nach dem Objekt-ID-Feld gruppiert. In diesem Fall wird ein Datensatz pro Auswahl ausgewählt. Wenn die Tabelle kein Objekt-ID-Feld enthält, z. B. eine Excel-Tabelle, dann wird kein Wert angegeben.

  • Das Werkzeug stellt zwei Ausgaben bereit: Ausgewählte Features und Gruppenwert des Feldes für ausgewählte Features, die in anderen Werkzeugen als direkte Variable verwendet werden können.

  • Der temporäre Feature-Layer kann mit dem Werkzeug In Layer-Datei speichern als Layer-Datei gespeichert werden oder mit dem Werkzeug Features kopieren als neue Feature-Class.

  • Wenn einem Modell ein Iterator hinzugefügt wird, durchlaufen alle Werkzeuge im Modell jeden Wert im Iterator. Wenn Sie nicht jedes Werkzeug im Modell für jeden durchlaufenen Wert ausführen möchten, erstellen Sie ein untergeordnetes Modell, Modell im Modell oder verschachteltes Modell, das nur den Iterator enthält, und fügen Sie es als Modellwerkzeug zum Hauptmodell hinzu.

Syntax

arcpy.mb.IterateFeatureSelection(in_features, {fields}, {skip_nulls})
ParameterErklärungDatentyp
in_features

Die Eingabe-Feature-Class oder Layer mit den zu durchlaufenden Features.

Feature Layer
fields
[fields,...]
(optional)

Das Eingabefeld zur Gruppierung der Features für die Auswahl. Eine beliebige Anzahl von Eingabefeldern kann definiert werden, sodass eine Auswahl aus einer einzigartigen Kombination aus Feldern getroffen werden kann. Wenn kein Feld angegeben wird, wird die Objekt-ID verwendet, um Features zu durchlaufen.

Value Table
skip_nulls
(optional)

Gibt an, ob NULL-Werte in den Gruppierungsfeldern während der Auswahl übersprungen werden.

  • Aktiviert: Überspringt während der Auswahl alle NULL-Werte in den Gruppierungsfeldern.
  • Deaktiviert: Standardeinstellung. Überspringt während der Auswahl NULL-Werte in den Gruppierungsfeldern nicht. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErklärungDatentyp
selection

Ein Feature-Layer für die Verwendung in anderen Geoverarbeitungswerkzeugen, die einen Feature-Layer in ModelBuilder akzeptieren.

Feature-Layer
value

Die von jeder Iteration zurückgegebenen Feldwerte. Wenn mehr als ein Gruppenfeld ausgewählt wird, werden die Werte verkettet (<Feldwert1>_<Feldwert2>).

Variant

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja