Verfolgen (Trace Network)

Zusammenfassung

Gibt ausgewählte Features in einem Verfolgungsnetz basierend auf Konnektivität oder Durchlassfähigkeit aus den angegebenen Startpunkten zurück.

Mit den Verfolgungsfunktionen im Verfolgungsnetz können Sie Pfade in Ihrem Netzwerk analysieren. Durchlassfähigkeit bezieht sich auf Pfade, die durch verbundene Features entstehen, die bestimmte Konfigurationsanforderungen erfüllen.

Standardmäßig werden Verfolgungsergebnisse als Auswahl zurückgegeben und enthalten das vollständige Linien-Feature. Um partielle Feature-Ergebnisse zurückzugeben, legen Sie den Parameter Ergebnistypen auf Aggregierte Geometrie fest. Wenn ein Startpunkt oder eine Barriere auf einem Knoten mit mittiger Konnektivität platziert wird, geben Verfolgungsergebnisse Teilelemente des Kanten-Features zurück. Wenn eine Barriere an einer Kante platziert wird, können Verfolgungsergebnisse am nächstgelegenen Knoten mit mittiger Konnektivität enden. Der aus einer Verfolgung resultierende Auswahlsatz bzw. die resultierende Ausgabe-Feature-Class kann an eine andere Karte oder an eine Schemaansicht weitergegeben oder als Eingabe für ein anderes Werkzeug bzw. eine andere Verfolgung verwendet werden.

Weitere Informationen zum Verfolgen eines Verfolgungsnetzes

Verwendung

• Die Netzwerk-Topologie muss aktiviert sein.

• Bei Verwendung einer Enterprise-Geodatabase muss ein Eingabe-Verfolgungsnetz von einem Feature-Service stammen. Ein Verfolgungsnetz von einer Datenbankverbindung wird nicht unterstützt.

• Da das Werkzeug Verfolgen auf der Netzwerk-Topologie basiert, sind die Verfolgungsergebnisse nicht unbedingt genau, wenn in der Verfolgungsausdehnung Dirty Areas vorkommen. Die Netzwerk-Topologie für die zu verfolgende Fläche muss validiert werden, damit die aktuellen Änderungen oder Aktualisierungen am Netzwerk darstellt werden.

• Bei Verwendung von Netzwerkattributen, die einem Datumsfeld für Bedingungsbarrieren, Funktionsbarrieren, Funktionen und Ausgabebedingungen zugewiesen sind, muss der Datumswert das Format yyyy-mm-dd hh:mm:ss aufweisen, z. B. 2020-10-12 18:45:31.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Verfolgungsnetz	Das Verfolgungsnetz, in dem die Verfolgung ausgeführt wird. Bei Verwendung einer Enterprise-Geodatabase muss ein Eingabe-Verfolgungsnetz von einem Feature-Service stammen. Ein Verfolgungsnetz von einer Datenbankverbindung wird nicht unterstützt.	Trace Network; Trace Network Layer
Verfolgungstyp	Gibt den Typ der auszuführenden Verfolgung an. Verbunden: Eine Verbindungsverfolgung, die an mindestens einem Startpunkt beginnt und sich entlang der verbundenen Features nach außen erstreckt, wird verwendet. Flussaufwärts: Eine Verfolgung flussaufwärts, bei der Features ermittelt werden, die sich flussaufwärts von einer Position im Netzwerk befinden, wird verwendet. Für diesen Verfolgungstyp muss die Fließrichtung festgelegt sein. Flussabwärts: Eine Verfolgung flussabwärts, bei der Features ermittelt werden, die sich flussabwärts von einer Position im Netzwerk befinden, wird verwendet. Für diesen Verfolgungstyp muss die Fließrichtung festgelegt sein. Kürzeste Verbindung: Eine Verfolgung der kürzesten Verbindung, die unabhängig von der Fließrichtung die kürzeste Verbindung zwischen zwei Startpunkten im Netzwerk findet, wird verwendet. Die Kosten, die beim Passieren des Pfades entstehen, werden anhand des Netzwerkattributs für den Parameter Name des "Kürzester Pfad"-Netzwerkattributs ermittelt. Verbunden—Eine Verbindungsverfolgung, die an mindestens einem Startpunkt beginnt und sich entlang der verbundenen Features nach außen erstreckt, wird verwendet. Flussaufwärts—Eine Verfolgung flussaufwärts, bei der Features ermittelt werden, die sich flussaufwärts von einer Position im Netzwerk befinden, wird verwendet. Für diesen Verfolgungstyp muss die Fließrichtung festgelegt sein. Flussabwärts—Eine Verfolgung flussabwärts, bei der Features ermittelt werden, die sich flussabwärts von einer Position im Netzwerk befinden, wird verwendet. Für diesen Verfolgungstyp muss die Fließrichtung festgelegt sein. Kürzeste Verbindung—Eine Verfolgung der kürzesten Verbindung, die unabhängig von der Fließrichtung die kürzeste Verbindung zwischen zwei Startpunkten im Netzwerk findet, wird verwendet. Die Kosten, die beim Passieren des Pfades entstehen, werden anhand des Netzwerkattributs ermittelt, das für den Parameter shortest_path_network_attribute_name festgelegt wurde.	String
Startpunkte	Ein Feature-Layer, der mithilfe der Registerkarte Startpunkte im Bereich Verfolgungspositionen erstellt wurde, oder eine Tabelle oder Feature-Class, die mindestens einen Datensatz enthält, der die Startpunkte der Verfolgung darstellt. Die Feature-Class "TN_Temp_Starting_Points" wird standardmäßig verwendet und in der Standard-Geodatabase des Projekts generiert, wenn Sie die Startpunkte mit dem Werkzeug Startpunkte im Bereich Verfolgungspositionen erstellen.	Feature Layer; Table View
Barrieren (optional)	Eine Tabelle oder Feature-Class mit einem oder mehreren Features, die die Barrieren darstellen, die verhindern, dass die Verfolgung über diesen Punkt hinaus ausgeführt wird. Die Feature-Class "TN_Temp_Barriers" wird standardmäßig verwendet und in der Standard-Geodatabase des Projekts generiert, wenn Sie die Barrieren mit der Registerkarte Barrieren im Bereich Verfolgungspositionen erstellen.	Feature Layer; Table View
Pfadrichtung (optional)	Gibt die Richtung des Verfolgungspfades an. Die Kosten, die beim Passieren des Pfades entstehen, werden mit dem Parameterwert Name des Netzwerkattributs für "Kürzester Pfad" ermittelt. Dieser Parameter wird nur bei der Ausführung einer Verfolgung vom Typ Kürzester Pfad berücksichtigt. Keine Richtung—Der Pfad zwischen den beiden Startpunkten wird unabhängig von der Fließrichtung verwendet. Dies ist die Standardeinstellung. Pfad flussaufwärts—Der Pfad flussaufwärts zwischen den beiden Startpunkten wird verwendet. Pfad flussabwärts—Der Pfad flussabwärts zwischen den beiden Startpunkten wird verwendet.	String
Name des Netzwerkattributs für "Kürzester Pfad" (optional)	Der Name des Netzwerkattributs, das zum Berechnen des Pfades verwendet wird. Bei der Ausführung einer Verfolgung vom Typ "Kürzester Pfad" wird der kürzeste Pfad mithilfe eines numerischen Netzwerkattributs wie etwa Shape-Länge berechnet. Es können sowohl kosten- als auch entfernungsbasierte Pfade ermittelt werden. Dieser Parameter ist für die Ausführung einer Verfolgung vom Typ "Kürzester Pfad" erforderlich.	String
Barrieren-Features einbeziehen (optional)	Gibt an, ob die Barrieren-Features für die Durchlassfähigkeit in die Verfolgungsergebnisse einbezogen werden. Aktiviert: Barrieren-Features für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung. Deaktiviert: Barrieren-Features für die Durchlassfähigkeit werden nicht in die Verfolgungsergebnisse einbezogen.	Boolean
Konsistenz überprüfen (optional)	Gibt an, ob ein Fehler ausgegeben wird, wenn in den durchlaufenen Features Dirty Areas gefunden werden. Dies ist die einzige Möglichkeit sicherzustellen, dass eine Verfolgung Features mit einem konsistenten Status im Netzwerk weitergibt. Um Dirty Areas zu entfernen, validieren Sie die Netzwerk-Topologie. Aktiviert: Bei der Verfolgung wird ein Fehler ausgegeben, wenn in den durchlaufenen Features Dirty Areas gefunden werden. Dies ist die Standardeinstellung. Deaktiviert: Die Verfolgungsergebnisse werden ausgegeben, auch wenn in den durchlaufenen Features Dirty Areas gefunden werden.	Boolean
Barrieren bei Startpunkten ignorieren (optional)	Gibt an, ob Barrieren in der Verfolgungskonfiguration für Startpunkte ignoriert werden. Aktiviert: Barrieren bei Startpunkten werden in der Verfolgung ignoriert. Deaktiviert: Barrieren bei Startpunkten werden in der Verfolgung nicht ignoriert. Dies ist die Standardeinstellung.	Boolean
Unbestimmbare Fließrichtung zulassen (optional)	Gibt an, ob Features mit einer unbestimmbaren oder nicht initialisierten Fließrichtung verfolgt werden. Dieser Parameter wird nur bei der Ausführung einer Verfolgung flussaufwärts oder flussabwärts berücksichtigt. Aktiviert: Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen werden verfolgt. Deaktiviert: Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen werden nicht verfolgt. Dies ist die Standardeinstellung.	Boolean
Bedingungsbarrieren (optional)	Legt für Features basierend auf einem Vergleich mit einem Netzwerkattribut eine Bedingungsbarriere für Durchlässigkeit fest. Eine Bedingungsbarriere verwendet ein Netzwerkattribut, einen Operator und einen Typ sowie einen Attributwert. Halten Sie eine Verfolgung beispielsweise an, wenn das Attribut Code dem spezifischen Wert ArtificialPath entspricht. Wenn ein Feature diese Bedingung erfüllt, wird die Verfolgung angehalten. Bei Verwendung mehrerer Attribute können Sie mit dem Parameter Kombination verwenden eine And- oder eine Or-Bedingung definieren. Die Komponenten der Bedingungsbarrieren sind folgende: Name: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest. Operator: Wählen Sie aus verschiedenen Operatoren aus. Typ: Wählen Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der in der Komponente Name angegeben ist, aus. Wert: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt. Kombination verwenden: Legen Sie diesen Wert fest, wenn Sie mehrere Attribute hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden. Folgende Komponenten für Operator stehen zur Verfügung: Ist gleich: Das Attribut ist gleich dem Wert. Ist ungleich: Das Attribut ist nicht gleich dem Wert. Ist größer als: Das Attribut ist größer als der Wert. Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert. Ist kleiner als: Das Attribut ist kleiner als der Wert. Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert. Folgende Komponenten für Typ stehen zur Verfügung: Bestimmter Wert: Nach einem bestimmten Wert filtern. Netzwerkattribut: Nach einem Netzwerkattribut filtern. Folgenden Komponenten für Kombination verwenden stehen zur Verfügung: Und: Die Bedingungsbarrieren kombinieren. Oder: Verwenden, Sie "Oder", wenn eine der Bedingungsbarrieren erfüllt ist. Ist gleich—Das Attribut ist gleich dem Wert. Ist ungleich—Das Attribut ist nicht gleich dem Wert. Ist größer als—Das Attribut ist größer als der Wert. Ist größer als oder gleich—Das Attribut ist größer als oder gleich dem Wert. Ist kleiner als—Das Attribut ist kleiner als der Wert. Ist kleiner als oder gleich—Das Attribut ist kleiner als oder gleich dem Wert. Bestimmter Wert—Nach einem bestimmten Wert filtern. Netzwerkattribut—Nach einem Netzwerkattribut filtern. Und—Die Bedingungsbarrieren kombinieren. Oder—Verwenden, wenn eine der Bedingungsbarrieren erfüllt ist.	Value Table
Funktionsbarrieren (optional)	Legt für Features eine Durchlässigkeitsbarriere basierend auf einer Funktion fest. Funktionsbarrieren können beispielsweise verwendet werden, um die Entfernung der Verfolgung vom Startpunkt einzuschränken oder einen Maximalwert zum Anhalten einer Verfolgung festzulegen. Die Länge der jeweils zurückgelegten Linie wird beispielsweise der bisher zurückgelegten Gesamtentfernung hinzugefügt. Wenn die zurückgelegte Gesamtlänge den angegebenen Wert erreicht hat, wird die Verfolgung angehalten. Die Komponenten der Funktionsbarrieren sind folgende: Funktion: Wählen Sie aus verschiedenen Berechnungsfunktionen aus. Attribut: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest. Operator: Wählen Sie aus verschiedenen Operatoren aus. Wert: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der zur Beendigung führt, wenn er ermittelt wird. Lokale Werte verwenden: Berechnet Werte in jeder Richtung im Gegensatz zu einem globalen Gesamtwert. Beispiel sei eine Funktionsbarriere, die die Summe von "Shape-Länge" berechnet, wobei die Verfolgung beendet wird, wenn der Wert größer als oder gleich 4 ist. Wenn Sie im globalen Fall zwei Kanten mit dem Wert 2 durchlaufen haben, wird die Verfolgung beendet, da Sie bereits die Shape-Länge 4 erreicht haben. Wenn lokale Werte verwendet werden, dann läuft die Verfolgung weiter, da sich die lokalen Werte auf jedem Pfad ändern. Folgende Komponenten des Typs Funktion stehen zur Verfügung: Minimum: Das Minimum der Eingabewerte. Maximum: Das Maximum der Eingabewerte. Addieren: Die Summe der Eingabewerte. Durchschnitt: Der Durchschnitt der Eingabewerte. Anzahl: Die Anzahl der Features Subtrahieren: Die Differenz zwischen den Eingabewerten. Es liegt beispielsweise ein Startpunkt-Feature mit dem Wert 20 vor. Das nächste Feature hat den Wert 30. Mit der Funktion "Minimum" ist das Ergebnis 20, mit "Maximum" ist es 30, mit "Addieren" ist es 50, mit "Durchschnitt " ist es 25, mit "Anzahl" ist es 2, und mit "Subtrahieren" ist es -10. Folgende Komponenten für Operator stehen zur Verfügung: Ist gleich: Das Attribut ist gleich dem Wert. Ist ungleich: Das Attribut ist nicht gleich dem Wert. Ist größer als: Das Attribut ist größer als der Wert. Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert. Ist kleiner als: Das Attribut ist kleiner als der Wert. Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert. Folgende Komponenten für Lokale Werte verwenden stehen zur Verfügung: Aktiviert: Lokale Werte werden verwendet. Deaktiviert: Globale Werte werden verwendet. Dies ist die Standardeinstellung. Durchschnitt—Der Durchschnitt der Eingabewerte. Anzahl—Die Anzahl der Features. Maximum—Das Maximum der Eingabewerte. Minimum—Das Minimum der Eingabewerte. Hinzufügen—Die Werte addieren. Subtrahieren—Die Werte subtrahieren. Ist gleich—Das Attribut ist gleich dem Wert. Ist ungleich—Das Attribut ist nicht gleich dem Wert. Ist größer als—Das Attribut ist größer als der Wert. Ist größer als oder gleich—Das Attribut ist größer als oder gleich dem Wert. Ist kleiner als—Das Attribut ist kleiner als der Wert. Ist kleiner als oder gleich—Das Attribut ist kleiner als oder gleich dem Wert.	Value Table
Durchlassfähigkeit anwenden auf (optional)	Gibt den Typ der Durchlassfähigkeit an, der angewendet wird. Der Umfang der Durchlassfähigkeit bestimmt, ob die Durchlassfähigkeit auf Knoten, auf Kanten oder auf Knoten und auf Kanten angewendet wird. Wenn beispielsweise in einem Wanderwegenetz als Bedingungsbarriere definiert ist, dass eine Verfolgung beendet wird, wenn ein Attribut für den Oberflächentyp den Wert "Kies" enthält, und der Umfang der Durchlassfähigkeit nur für Knoten festgelegt ist, endet die Verfolgung bei einem Kanten-Feature mit diesem Wert im Feld für den Oberflächentyp nicht, da das Attribut für den Oberflächentyp nur für Kanten gilt. Knoten und Kanten—Die Durchlassfähigkeit wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung. Nur Knoten—Die Durchlassfähigkeit wird nur auf Knoten angewendet. Nur Kanten—Die Durchlassfähigkeit wird nur auf Kanten angewendet.	String
Funktionen (optional)	Die Berechnungsfunktionen, die auf die Verfolgungsergebnisse angewendet werden. Folgende Funktionskomponenten stehen zur Verfügung: Funktion: Wählen Sie aus verschiedenen Berechnungsfunktionen aus. Attribut: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest. Name: Legen Sie die Filterung der Funktionsergebnisse nach Attributname fest. Operator: Wählen Sie aus verschiedenen Operatoren aus. Typ: Wählen Sie aus verschiedenen Filtertypen aus. Filterwert: Geben Sie einen Wert für das Eingabefilterattribut an. Folgende Komponentenoptionen für Funktion stehen zur Verfügung: Minimum: Das Minimum der Eingabewerte. Maximum: Das Maximum der Eingabewerte. Addieren: Die Summe der Eingabewerte. Durchschnitt: Der Durchschnitt der Eingabewerte. Anzahl: Die Anzahl der Features Subtrahieren: Die Differenz zwischen den Eingabewerten. Es liegt beispielsweise ein Startpunkt-Feature mit dem Wert 20 vor. Das nächste Feature hat den Wert 30. Wenn Sie die Funktion Minimum verwenden, ist das Ergebnis 20. Maximum ist 30, Addieren ist 50, Durchschnitt ist 25, Anzahl ist 2 und Subtrahieren ist -10. Folgende Komponentenoptionen für Filteroperator stehen zur Verfügung: Ist gleich: Das Attribut ist gleich dem Wert. Ist ungleich: Das Attribut ist nicht gleich dem Wert. Ist größer als: Das Attribut ist größer als der Wert. Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert. Ist kleiner als: Das Attribut ist kleiner als der Wert. Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert. Folgende Komponentenoptionen für Filtertyp stehen zur Verfügung: Bestimmter Wert: Nach einem bestimmten Wert filtern. Netzwerkattribut: Nach einem Netzwerkattribut filtern. Durchschnitt—Der Durchschnitt der Eingabewerte. Anzahl—Die Anzahl der Features. Maximum—Das Maximum der Eingabewerte. Minimum—Das Minimum der Eingabewerte. Hinzufügen—Die Summe der Werte. Subtrahieren—Die Differenz der Werte. Ist gleich—Das Attribut ist gleich dem Wert. Ist ungleich—Das Attribut ist nicht gleich dem Wert. Ist größer als—Das Attribut ist größer als der Wert. Ist größer als oder gleich—Das Attribut ist größer als oder gleich dem Wert. Ist kleiner als—Das Attribut ist kleiner als der Wert. Ist kleiner als oder gleich—Das Attribut ist kleiner als oder gleich dem Wert.	Value Table
Ausgabebedingungen (optional)	Die Typen der Features, die basierend auf einem Netzwerkattribut zurückgegeben werden sollen. Bei einer Verfolgung, die beispielsweise zum Herausfiltern aller Features außer Abzweigungs-Features konfiguriert wurde, sind in den Ergebnissen keine verfolgten Features enthalten, denen nicht das Attribut "Abzweigung" zugewiesen wurde. Verfolgte Features, denen die Ablaufventil-Kategorie zugewiesen wurde, werden im Ergebnisauswahlsatz zurückgegeben. Die Komponenten der Ausgabebedingungen sind folgende: Name: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest. Operator: Wählen Sie aus verschiedenen Operatoren aus. Typ: Wählen Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der in der Komponente Name angegeben ist, aus. Wert: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt. Kombination verwenden: Legen Sie diesen Wert fest, wenn Sie mehrere Attribute hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden. Folgende Komponentenoptionen für Operator stehen zur Verfügung: Ist gleich: Das Attribut ist gleich dem Wert. Ist ungleich: Das Attribut ist nicht gleich dem Wert. Ist größer als: Das Attribut ist größer als der Wert. Ist größer als oder gleich: Das Attribut ist größer als oder gleich dem Wert. Ist kleiner als: Das Attribut ist kleiner als der Wert. Ist kleiner als oder gleich: Das Attribut ist kleiner als oder gleich dem Wert. Folgende Komponentenoptionen für Typ stehen zur Verfügung: Bestimmter Wert: Nach einem bestimmten Wert filtern. Netzwerkattribut: Nach einem Netzwerkattribut filtern. Ist gleich—Das Attribut ist gleich dem Wert. Ist ungleich—Das Attribut ist nicht gleich dem Wert. Ist größer als—Das Attribut ist größer als der Wert. Ist größer als oder gleich—Das Attribut ist größer als oder gleich dem Wert. Ist kleiner als—Das Attribut ist kleiner als der Wert. Ist kleiner als oder gleich—Das Attribut ist kleiner als oder gleich dem Wert.	Value Table
Ergebnistypen (optional)	Gibt den Typ der Ergebnisse an, die von der Verfolgung zurückgegeben werden. Auswahl—Die Verfolgungsergebnisse werden als Auswahlsatz der entsprechenden Netzwerk-Features zurückgegeben. Dies ist die Standardeinstellung. Aggregierte Geometrie—Die Verfolgungsergebnisse werden nach Geometrietyp aggregiert und in Feature-Classes gespeichert, die in Layern auf der aktiven Karte angezeigt werden. Netzwerk-Layer—Die Verfolgungsergebnisse werden Feature-Layern als Auswahlsatz in einem Gruppen-Layer hinzugefügt. Konnektivität—Die Verfolgungsergebnisse werden als Konnektivitätsdiagramm in einer angegebenen .json-Datei zurückgegeben. Mit dieser Option wird der Parameter Ausgabe-JSON aktiviert. Elemente—Die Verfolgungsergebnisse werden als Feature-basierte Informationen in der angegebenen .json-Ausgabedatei zurückgegeben. Mit dieser Option wird der Parameter Ausgabe-JSON aktiviert.	String
Auswahltyp	Gibt an, wie die Auswahl angewendet wird, und welche Aktion ausgeführt wird, wenn eine aktuelle Auswahl vorhanden ist. Neue Auswahl—Die getätigte Auswahl ersetzt die aktuelle Auswahl. Dies ist die Standardeinstellung. Zur aktuellen Auswahl hinzufügen—Die getätigte Auswahl wird der aktuellen Auswahl hinzugefügt (wenn eine vorhanden ist). Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option "Neue Auswahl". Aus aktueller Auswahl entfernen—Die getätigte Auswahl wird aus der aktuellen Auswahl entfernt. Wenn keine Auswahl vorhanden ist, ist diese Option irrelevant. Teilmenge aus der aktuellen Auswahl auswählen—Die getätigte Auswahl wird mit der aktuellen Auswahl kombiniert. Nur Datensätze, die in beiden Auswahlen vorhanden sind, werden ausgewählt. Aktuelle Auswahl umkehren—Die getätigte Auswahl wird umgekehrt. Bisher ausgewählte Ergebnisse werden aus der aktuellen Auswahl entfernt und bisher nicht ausgewählte Ergebnisse werden der aktuellen Auswahl hinzugefügt. Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option "Neue Auswahl".	String
Alle vorherigen Verfolgungsergebnisse löschen (optional)	Gibt an, ob Inhalte aus den Feature-Classes, die zum Speichern der aggregierten Geometrie ausgewählt wurden, gekürzt oder an diese angehängt werden. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie". Aktiviert: Die Feature-Classes, in denen die aggregierte Verfolgungsgeometrie gespeichert wird, werden gekürzt. Nur die Ausgabegeometrie der aktuellen Verfolgungsoperation wird eingefügt. Dies ist die Standardeinstellung. Deaktiviert: Die Ausgabegeometrie der aktuellen Verfolgungsoperation wird an die Feature-Classes angefügt, in denen die aggregierte Geometrie gespeichert wird.	Boolean
Name der Verfolgung (optional)	Der Name der Verfolgungsoperation. Dieser Wert wird im Feld TRACENAME der Ausgabe-Feature-Class gespeichert, um die Identifizierung der Verfolgungsergebnisse zu unterstützen. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".	String
Aggregierte Punkte (optional)	Eine Ausgabe-Multipoint-Feature-Class, die die aggregierte Ergebnisgeometrie enthält. Standardmäßig wird der Parameter von einer vom System generierten Feature-Class namens "Trace_Results_Aggregated_Points" gefüllt, die in der Standard-Geodatabase des Projekts gespeichert wird. Diese Feature-Class wird automatisch erstellt, wenn sie nicht vorhanden ist. Eine vorhandene Feature-Class kann auch zum Speichern der aggregierten Geometrie verwendet werden. Wenn nicht die Standard-Feature-Class verwendet wird, muss es eine Multipoint-Feature-Class sein, die ein Zeichenfolgenfeld namens TRACENAME enthält. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".	Feature Class
Aggregierte Linien (optional)	Eine Ausgabe-Polyline-Feature-Class, die die aggregierte Ergebnisgeometrie enthält. Standardmäßig wird der Parameter von einer vom System generierten Feature-Class namens "Trace_Results_Aggregated_Lines" gefüllt, die in der Standard-Geodatabase des Projekts gespeichert wird. Diese Feature-Class wird automatisch erstellt, wenn sie nicht vorhanden ist. Eine vorhandene Feature-Class kann auch zum Speichern der aggregierten Geometrie verwendet werden. Wenn nicht die Standard-Feature-Class verwendet wird, muss es eine Polyline-Feature-Class sein, die ein Zeichenfolgenfeld namens TRACENAME enthält. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".	Feature Class
Ausgabe-Gruppenlayer-Name (optional)	Der Name des Ausgabe-Gruppen-Layers, in dem Feature-Layer mit Auswahlsätzen aus Features, die durch die Verfolgung zurückgegeben wurden, enthalten sind. Dieser Layer ermöglicht den Zugriff zum Arbeiten mit der Ausgabe einer Verfolgung in ModelBuilder und Python. Dieser Parameter gilt nur für den Ergebnistyp "Netzwerk-Layer".	Group Layer
Verfolgungskonfiguration verwenden (optional)	Gibt an, ob zum Füllen der Parameter des Werkzeugs Verfolgen eine vorhandene benannte Verfolgungskonfiguration verwendet wird. Aktiviert: Eine vorhandene benannte Verfolgungskonfiguration wird zum Definieren der Verfolgungseigenschaften verwendet. Mit Ausnahme von Name der Verfolgungskonfiguration, Startpunkte und Barrieren werden alle Parameter ignoriert. Deaktiviert: Es wird keine vorhandene benannte Verfolgungskonfiguration zum Definieren der Verfolgungseigenschaften verwendet. Dies ist die Standardeinstellung. Hinweis: Für diesen Parameter wird Trace Network Version 2 oder höher benötigt.	Boolean
Name der Verfolgungskonfiguration (optional)	Der Name der Verfolgungskonfiguration, die zum Definieren der Verfolgungseigenschaften verwendet wird. Dieser Parameter ist nur aktiv, wenn der Parameter Verfolgungskonfiguration verwenden aktiviert wurde. Hinweis: Für diesen Parameter wird Trace Network Version 2 oder höher benötigt.	String
Ausgabe-JSON (optional)	Der Name und der Speicherort der .json-Datei, die generiert wird.	File

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisiertes Verfolgungsnetz	Das aktualisierte Verfolgungsnetz	Any Value

Python

arcpy.tn.Trace(in_trace_network, trace_type, starting_points, {barriers}, {path_direction}, {shortest_path_network_attribute_name}, {include_barriers}, {validate_consistency}, {ignore_barriers_at_starting_points}, {allow_indeterminate_flow}, {condition_barriers}, {function_barriers}, {traversability_scope}, {functions}, {output_conditions}, {result_types}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {out_network_layer}, {use_trace_config}, {trace_config_name}, {out_json_file})

Name	Erläuterung	Datentyp
in_trace_network	Das Verfolgungsnetz, in dem die Verfolgung ausgeführt wird. Bei Verwendung einer Enterprise-Geodatabase muss ein Eingabe-Verfolgungsnetz von einem Feature-Service stammen. Ein Verfolgungsnetz von einer Datenbankverbindung wird nicht unterstützt.	Trace Network; Trace Network Layer
trace_type	Gibt den Typ der auszuführenden Verfolgung an. CONNECTED—Eine Verbindungsverfolgung, die an mindestens einem Startpunkt beginnt und sich entlang der verbundenen Features nach außen erstreckt, wird verwendet. UPSTREAM—Eine Verfolgung flussaufwärts, bei der Features ermittelt werden, die sich flussaufwärts von einer Position im Netzwerk befinden, wird verwendet. Für diesen Verfolgungstyp muss die Fließrichtung festgelegt sein. DOWNSTREAM—Eine Verfolgung flussabwärts, bei der Features ermittelt werden, die sich flussabwärts von einer Position im Netzwerk befinden, wird verwendet. Für diesen Verfolgungstyp muss die Fließrichtung festgelegt sein. SHORTEST_PATH—Eine Verfolgung der kürzesten Verbindung, die unabhängig von der Fließrichtung die kürzeste Verbindung zwischen zwei Startpunkten im Netzwerk findet, wird verwendet. Die Kosten, die beim Passieren des Pfades entstehen, werden anhand des Netzwerkattributs ermittelt, das für den Parameter shortest_path_network_attribute_name festgelegt wurde.	String
starting_points	Ein Feature-Layer, der mithilfe der Registerkarte Startpunkte im Bereich Verfolgungspositionen erstellt wurde, oder eine Tabelle oder Feature-Class, die mindestens einen Datensatz enthält, der die Startpunkte der Verfolgung darstellt. Die Feature-Class "TN_Temp_Starting_Points" wird standardmäßig verwendet und in der Standard-Geodatabase des Projekts generiert, wenn Sie die Startpunkte mit dem Werkzeug Startpunkte im Bereich Verfolgungspositionen erstellen.	Feature Layer; Table View
barriers (optional)	Eine Tabelle oder Feature-Class mit einem oder mehreren Features, die die Barrieren darstellen, die verhindern, dass die Verfolgung über diesen Punkt hinaus ausgeführt wird. Die Feature-Class "TN_Temp_Barriers" wird standardmäßig verwendet und in der Standard-Geodatabase des Projekts generiert, wenn Sie die Barrieren mit der Registerkarte Barrieren im Bereich Verfolgungspositionen erstellen.	Feature Layer; Table View
path_direction (optional)	Gibt die Richtung des Verfolgungspfades an. Die Kosten, die beim Passieren des Pfades entstehen, werden mit dem Parameterwert shortest_path_network_attribute_name ermittelt. Dieser Parameter wird nur bei der Ausführung einer Verfolgung vom Typ SHORTEST_PATH berücksichtigt. NO_DIRECTION—Der Pfad zwischen den beiden Startpunkten wird unabhängig von der Fließrichtung verwendet. Dies ist die Standardeinstellung. PATH_UPSTREAM—Der Pfad flussaufwärts zwischen den beiden Startpunkten wird verwendet. PATH_DOWNSTREAM—Der Pfad flussabwärts zwischen den beiden Startpunkten wird verwendet.	String
shortest_path_network_attribute_name (optional)	Der Name des Netzwerkattributs, das zum Berechnen des Pfades verwendet wird. Bei der Ausführung einer Verfolgung vom Typ "Kürzester Pfad" wird der kürzeste Pfad mithilfe eines numerischen Netzwerkattributs wie etwa Shape-Länge berechnet. Es können sowohl kosten- als auch entfernungsbasierte Pfade ermittelt werden. Dieser Parameter ist für die Ausführung einer Verfolgung vom Typ "Kürzester Pfad" erforderlich.	String
include_barriers (optional)	Gibt an, ob die Barrieren-Features für die Durchlassfähigkeit in die Verfolgungsergebnisse einbezogen werden. INCLUDE_BARRIERS—Barrieren-Features für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung. EXCLUDE_BARRIERS—Barrieren-Features für die Durchlassfähigkeit werden nicht in die Verfolgungsergebnisse einbezogen.	Boolean
validate_consistency (optional)	Gibt an, ob ein Fehler ausgegeben wird, wenn in den durchlaufenen Features Dirty Areas gefunden werden. Dies ist die einzige Möglichkeit sicherzustellen, dass eine Verfolgung Features mit einem konsistenten Status im Netzwerk weitergibt. Um Dirty Areas zu entfernen, validieren Sie die Netzwerk-Topologie. VALIDATE_CONSISTENCY—Bei der Verfolgung wird ein Fehler ausgegeben, wenn in den durchlaufenen Features Dirty Areas gefunden werden. Dies ist die Standardeinstellung. DO_NOT_VALIDATE_CONSISTENCY—Die Verfolgungsergebnisse werden ausgegeben, auch wenn in den durchlaufenen Features Dirty Areas gefunden werden.	Boolean
ignore_barriers_at_starting_points (optional)	Gibt an, ob Barrieren in der Verfolgungskonfiguration für Startpunkte ignoriert werden. IGNORE_BARRIERS_AT_STARTING_POINTS—Barrieren bei Startpunkten werden in der Verfolgung ignoriert. DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS—Barrieren bei Startpunkten werden in der Verfolgung nicht ignoriert. Dies ist die Standardeinstellung.	Boolean
allow_indeterminate_flow (optional)	Gibt an, ob Features mit einer unbestimmbaren oder nicht initialisierten Fließrichtung verfolgt werden. Dieser Parameter wird nur bei der Ausführung einer Verfolgung flussaufwärts oder flussabwärts berücksichtigt. TRACE_INDETERMINATE_FLOW—Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen werden verfolgt. IGNORE_INDETERMINATE_FLOW—Features mit unbestimmbaren oder nicht initialisierten Fließrichtungen werden nicht verfolgt. Dies ist die Standardeinstellung.	Boolean
condition_barriers [Name, Operator, Type, Value, Combine Using,...] (optional)	Legt für Features basierend auf einem Vergleich mit einem Netzwerkattribut eine Bedingungsbarriere für Durchlässigkeit fest. Eine Bedingungsbarriere verwendet ein Netzwerkattribut, einen Operator und einen Typ sowie einen Attributwert. Halten Sie eine Verfolgung beispielsweise an, wenn das Attribut Code dem spezifischen Wert ArtificialPath entspricht. Wenn ein Feature diese Bedingung erfüllt, wird die Verfolgung angehalten. Bei Verwendung mehrerer Attribute können Sie mit der Komponente Combine Using eine And- oder eine Or-Bedingung definieren. Die Komponenten der Bedingungsbarrieren sind folgende: Name: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest. Operator: Hier können Sie unter mehreren Operatoren wählen. Type: Hier können Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der in der Komponente Name angegeben ist, wählen. Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt. Combine Using: Legen Sie diesen Wert fest, wenn Sie mehrere Attribute hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden. Folgende Operator-Komponenten stehen zur Verfügung: IS_EQUAL_TO—Das Attribut ist gleich dem Wert. DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert. IS_GREATER_THAN—Das Attribut ist größer als der Wert. IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert. IS_LESS_THAN—Das Attribut ist kleiner als der Wert. IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert. Folgende Type-Komponenten stehen zur Verfügung: SPECIFIC_VALUE—Nach einem bestimmten Wert filtern. NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern. Folgende Combine Using-Komponenten stehen zur Verfügung: AND—Die Bedingungsbarrieren kombinieren. OR—Verwenden, wenn eine der Bedingungsbarrieren erfüllt ist.	Value Table
function_barriers [Function, Attribute, Operator, Value, Use Local Values,...] (optional)	Legt für Features eine Durchlässigkeitsbarriere basierend auf einer Funktion fest. Funktionsbarrieren können beispielsweise verwendet werden, um die Entfernung der Verfolgung vom Startpunkt einzuschränken oder einen Maximalwert zum Anhalten einer Verfolgung festzulegen. Die Länge der jeweils zurückgelegten Linie wird beispielsweise der bisher zurückgelegten Gesamtentfernung hinzugefügt. Wenn die zurückgelegte Gesamtlänge den angegebenen Wert erreicht hat, wird die Verfolgung angehalten. Die Komponenten der Funktionsbarrieren sind folgende: Function: Wählen Sie aus verschiedenen Berechnungsfunktionen aus. Attribute: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest. Operator: Wählen Sie aus verschiedenen Operatoren aus. Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der zur Beendigung führt, wenn er ermittelt wird. Use Local Values: Berechnet Werte in jeder Richtung im Gegensatz zu einem globalen Gesamtwert. Beispiel sei eine Funktionsbarriere, die die Summe von "Shape-Länge" berechnet, wobei die Verfolgung beendet wird, wenn der Wert größer als oder gleich 4 ist. Wenn Sie im globalen Fall zwei Kanten mit dem Wert 2 durchlaufen haben, wird die Verfolgung beendet, da Sie bereits die Shape-Länge 4 erreicht haben. Wenn lokale Werte verwendet werden, dann läuft die Verfolgung weiter, da sich die lokalen Werte auf jedem Pfad ändern. Folgende Function-Komponenten stehen zur Verfügung: AVERAGE—Der Durchschnitt der Eingabewerte. COUNT—Die Anzahl der Features. MAX—Das Maximum der Eingabewerte. MIN—Das Minimum der Eingabewerte. ADD—Die Werte addieren. SUBTRACT—Die Werte subtrahieren. Folgende Operator-Komponenten stehen zur Verfügung: IS_EQUAL_TO—Das Attribut ist gleich dem Wert. DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert. IS_GREATER_THAN—Das Attribut ist größer als der Wert. IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert. IS_LESS_THAN—Das Attribut ist kleiner als der Wert. IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert. Folgende Use Local Values-Komponenten stehen zur Verfügung: TRUE—Lokale Werte verwenden. FALSE—Globale Werte verwenden. Dies ist die Standardeinstellung.	Value Table
traversability_scope (optional)	Gibt den Typ der Durchlassfähigkeit an, der angewendet wird. Der Umfang der Durchlassfähigkeit bestimmt, ob die Durchlassfähigkeit auf Knoten, auf Kanten oder auf Knoten und auf Kanten angewendet wird. Wenn beispielsweise in einem Wanderwegenetz als Bedingungsbarriere definiert ist, dass die Verfolgung beendet wird, wenn der Pfadtyp "Kies" und der Umfang der Durchlassfähigkeit nur für Knoten festgelegt ist, endet die Verfolgung bei einem Kiespfad nicht, da der Pfadtyp nur für Kanten gilt. BOTH_JUNCTIONS_AND_EDGES—Die Durchlassfähigkeit wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung. JUNCTIONS_ONLY—Die Durchlassfähigkeit wird nur auf Knoten angewendet. EDGES_ONLY—Die Durchlassfähigkeit wird nur auf Kanten angewendet.	String
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (optional)	Die Berechnungsfunktionen, die auf die Verfolgungsergebnisse angewendet werden. Folgende Funktionskomponenten stehen zur Verfügung: Function: Wählen Sie aus verschiedenen Berechnungsfunktionen aus. Attribute: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest. Filter Name: Legen Sie die Filterung der Funktionsergebnisse nach Attributname fest. Filter Operator: Hier können Sie unter mehreren Operatoren wählen. Filter Type: Wählen Sie aus verschiedenen Filtertypen aus. Filter Value: Geben Sie einen Wert für das Eingabefilterattribut an. Folgende Function-Komponentenoptionen stehen zur Verfügung: AVERAGE—Der Durchschnitt der Eingabewerte. COUNT—Die Anzahl der Features. MAX—Das Maximum der Eingabewerte. MIN—Das Minimum der Eingabewerte. ADD—Die Summe der Werte. SUBTRACT—Die Differenz der Werte. Es liegt beispielsweise ein Startpunkt-Feature mit dem Wert 20 vor. Das nächste Feature hat den Wert 30. Bei Verwendung der Funktion MIN ist das Ergebnis 20, bei MAX 30, bei ADD 50, bei AVERAGE 25, bei COUNT 2 und bei SUBTRACT -10. Folgende Filter Operator-Komponentenoptionen stehen zur Verfügung: IS_EQUAL_TO—Das Attribut ist gleich dem Wert. DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert. IS_GREATER_THAN—Das Attribut ist größer als der Wert. IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert. IS_LESS_THAN—Das Attribut ist kleiner als der Wert. IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert. Folgende Filter Type-Komponentenoptionen stehen zur Verfügung: SPECIFIC_VALUE—Nach einem bestimmten Wert filtern. NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern.	Value Table
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (optional)	Die Typen der Features, die basierend auf einem Netzwerkattribut zurückgegeben werden sollen. Bei einer Verfolgung, die beispielsweise zum Herausfiltern aller Features außer Abzweigungs-Features konfiguriert wurde, sind in den Ergebnissen keine verfolgten Features enthalten, denen nicht das Attribut "Abzweigung" zugewiesen wurde. Verfolgte Features, denen die Ablaufventil-Kategorie zugewiesen wurde, werden im Ergebnisauswahlsatz zurückgegeben. Bei Verwendung mehrerer Attribute können Sie mit der Option Combine Using eine And- oder eine Or-Bedingung definieren. Die Komponenten der Ausgabebedingungen sind folgende: Name: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest. Operator: Wählen Sie aus verschiedenen Operatoren aus. Type: Hier können Sie einen bestimmten Wert oder ein bestimmtes Netzwerkattribut des Wertes, der in der Komponente Name angegeben ist, wählen. Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt. Combine Using: Legen Sie diesen Wert fest, wenn Sie mehrere Attribute hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden. Folgende Operator-Komponentenoptionen stehen zur Verfügung: IS_EQUAL_TO—Das Attribut ist gleich dem Wert. DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert. IS_GREATER_THAN—Das Attribut ist größer als der Wert. IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert. IS_LESS_THAN—Das Attribut ist kleiner als der Wert. IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert. Folgende Type-Komponentenoptionen stehen zur Verfügung: SPECIFIC_VALUE—Nach einem bestimmten Wert filtern. NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern. Folgende Combine Using-Komponentenoptionen stehen zur Verfügung: AND—Kombiniert die Bedingungen. OR—Wird verwendet, wenn eine der Bedingungen erfüllt ist.	Value Table
result_types [result_types,...] (optional)	Gibt den Typ der Ergebnisse an, die von der Verfolgung zurückgegeben werden. SELECTION—Die Verfolgungsergebnisse werden als Auswahlsatz der entsprechenden Netzwerk-Features zurückgegeben. Dies ist die Standardeinstellung. AGGREGATED_GEOMETRY—Die Verfolgungsergebnisse werden nach Geometrietyp aggregiert und in Feature-Classes gespeichert, die in Layern auf der aktiven Karte angezeigt werden. NETWORK_LAYERS—Die Verfolgungsergebnisse werden Feature-Layern als Auswahlsatz in einem Gruppen-Layer hinzugefügt. CONNECTIVITY—Die Verfolgungsergebnisse werden als Konnektivitätsdiagramm in einer angegebenen .json-Datei zurückgegeben. Mit dieser Option wird der Parameter out_json_file aktiviert. ELEMENTS—Die Verfolgungsergebnisse werden als Feature-Elemente in der angegebenen .json-Ausgabedatei zurückgegeben. Mit dieser Option wird der Parameter out_json_file aktiviert.	String
selection_type	Gibt an, wie die Auswahl angewendet wird, und welche Aktion ausgeführt wird, wenn eine aktuelle Auswahl vorhanden ist. NEW_SELECTION—Die getätigte Auswahl ersetzt die aktuelle Auswahl. Dies ist die Standardeinstellung. ADD_TO_SELECTION—Die getätigte Auswahl wird der aktuellen Auswahl hinzugefügt (wenn eine vorhanden ist). Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option "Neue Auswahl". REMOVE_FROM_SELECTION—Die getätigte Auswahl wird aus der aktuellen Auswahl entfernt. Wenn keine Auswahl vorhanden ist, ist diese Option irrelevant. SUBSET_SELECTION—Die getätigte Auswahl wird mit der aktuellen Auswahl kombiniert. Nur Datensätze, die in beiden Auswahlen vorhanden sind, werden ausgewählt. SWITCH_SELECTION—Die getätigte Auswahl wird umgekehrt. Bisher ausgewählte Ergebnisse werden aus der aktuellen Auswahl entfernt und bisher nicht ausgewählte Ergebnisse werden der aktuellen Auswahl hinzugefügt. Wenn keine Auswahl vorhanden ist, entspricht diese Option der Option "Neue Auswahl".	String
clear_all_previous_trace_results (optional)	Gibt an, ob Inhalte aus den Feature-Classes, die zum Speichern der aggregierten Geometrie ausgewählt wurden, gekürzt oder an diese angehängt werden. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie". CLEAR_ALL_PREVIOUS_TRACE_RESULTS—Die Feature-Classes, in denen die aggregierte Verfolgungsgeometrie gespeichert wird, werden gekürzt. Nur die Ausgabegeometrie der aktuellen Verfolgungsoperation wird eingefügt. Dies ist die Standardeinstellung. DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTS—Die Ausgabegeometrie der aktuellen Verfolgungsoperation wird an die Feature-Classes angefügt, in denen die aggregierte Geometrie gespeichert wird.	Boolean
trace_name (optional)	Der Name der Verfolgungsoperation. Dieser Wert wird im Feld TRACENAME der Ausgabe-Feature-Class gespeichert, um die Identifizierung der Verfolgungsergebnisse zu unterstützen. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".	String
aggregated_points (optional)	Eine Ausgabe-Multipoint-Feature-Class, die die aggregierte Ergebnisgeometrie enthält. Standardmäßig wird der Parameter von einer vom System generierten Feature-Class namens "Trace_Results_Aggregated_Points" gefüllt, die in der Standard-Geodatabase des Projekts gespeichert wird. Diese Feature-Class wird automatisch erstellt, wenn sie nicht vorhanden ist. Eine vorhandene Feature-Class kann auch zum Speichern der aggregierten Geometrie verwendet werden. Wenn nicht die Standard-Feature-Class verwendet wird, muss es eine Multipoint-Feature-Class sein, die ein Zeichenfolgenfeld namens TRACENAME enthält. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".	Feature Class
aggregated_lines (optional)	Eine Ausgabe-Polyline-Feature-Class, die die aggregierte Ergebnisgeometrie enthält. Standardmäßig wird der Parameter von einer vom System generierten Feature-Class namens "Trace_Results_Aggregated_Lines" gefüllt, die in der Standard-Geodatabase des Projekts gespeichert wird. Diese Feature-Class wird automatisch erstellt, wenn sie nicht vorhanden ist. Eine vorhandene Feature-Class kann auch zum Speichern der aggregierten Geometrie verwendet werden. Wenn nicht die Standard-Feature-Class verwendet wird, muss es eine Polyline-Feature-Class sein, die ein Zeichenfolgenfeld namens TRACENAME enthält. Dieser Parameter gilt nur für den Ergebnistyp "Aggregierte Geometrie".	Feature Class
out_network_layer (optional)	Der Name des Ausgabe-Gruppen-Layers, in dem Feature-Layer mit Auswahlsätzen aus Features, die durch die Verfolgung zurückgegeben wurden, enthalten sind. Dieser Layer ermöglicht den Zugriff zum Arbeiten mit der Ausgabe einer Verfolgung in ModelBuilder und Python. Dieser Parameter gilt nur für den Ergebnistyp "Netzwerk-Layer".	Group Layer
use_trace_config (optional)	Gibt an, ob zum Füllen der Parameter des Werkzeugs Verfolgen eine vorhandene benannte Verfolgungskonfiguration verwendet wird. USE_TRACE_CONFIGURATION—Eine vorhandene benannte Verfolgungskonfiguration wird zum Definieren der Verfolgungseigenschaften verwendet. Mit Ausnahme von trace_config_name, starting_points und barriers werden alle Parameter ignoriert. DO_NOT_USE_TRACE_CONFIGURATION—Es wird keine vorhandene benannte Verfolgungskonfiguration zum Definieren der Verfolgungseigenschaften verwendet. Dies ist die Standardeinstellung. Hinweis: Für diesen Parameter wird Trace Network Version 2 oder höher benötigt.	Boolean
trace_config_name (optional)	Der Name der Verfolgungskonfiguration, die zum Definieren der Verfolgungseigenschaften verwendet wird. Dieser Parameter wird nur aktiviert, wenn der Parameter use_trace_config auf USE_TRACE_CONFIGURATION festgelegt ist. Hinweis: Für diesen Parameter wird Trace Network Version 2 oder höher benötigt.	String
out_json_file (optional)	Der Name und der Speicherort der .json-Datei, die generiert wird.	File

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_trace_network	Das aktualisierte Verfolgungsnetz	Any Value

Codebeispiel

Trace: Beispiel (Fenster Python)

Führen Sie eine Verfolgung flussabwärts in einem Verfolgungsnetz namens "HydroNetwork" durch, sodass Features innerhalb von 500 Metern vom Startpunkt zurückgegeben werden. Das Ergebnis ist ein Gruppen-Layer mit einer Auswahl unter Verwendung des Ergebnistyps "Netzwerk-Layer".

import arcpy

tn = r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork"
trace = arcpy.tn.Trace(
    tn, "DOWNSTREAM", r"C:\Projects\Default.gdb\TN_Temp_Starting_Points", 
    r"C:\Projects\Default.gdb\TN_Temp_Barriers", "NO_DIRECTION", "", 
    "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", 
    "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", "IGNORE_INDETERMINATE_FLOW", 
    None, "ADD 'Shape length' IS_EQUAL_TO 500 true", "BOTH_JUNCTIONS_AND_EDGES", 
    None, None, "NETWORK_LAYERS", "NEW_SELECTION", 
    "CLEAR_ALL_PREVIOUS_TRACE_RESULTS", "", "", "", "MyTraceResult"
)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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