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.
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. Es muss überprüft werden, ob die Netzwerk-Topologie für die zu verfolgende Fläche die aktuellsten Änderungen oder Aktualisierungen darstellt.
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.
Syntax
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})
Parameter | Erklärung | 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.
| String |
starting_points | Ein Feature-Layer, der mithilfe des Werkzeugs 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 dem Werkzeug 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.
| 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.
| 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, überprüfen Sie die Netzwerk-Topologie.
| Boolean |
ignore_barriers_at_starting_points (optional) | Gibt an, ob Barrieren in der Verfolgungskonfiguration für Startpunkte ignoriert werden.
| 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.
| 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:
Folgende Operator-Komponenten stehen zur Verfügung:
Folgende Type-Komponenten stehen zur Verfügung:
Folgende Combine Using-Komponenten stehen zur Verfügung:
| 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:
Folgende Function-Komponenten stehen zur Verfügung:
Folgende Operator-Komponenten stehen zur Verfügung:
Folgende Use Local Values-Komponenten stehen zur Verfügung:
| Value Table |
traversability_scope (optional) | Gibt den Typ der Durchlassfähigkeit an, der umgesetzt werden soll. Der Umfang der Durchlassfähigkeit bestimmt, ob die Durchlassfähigkeit an Knoten, an Kanten oder an Knoten und an Kanten umgesetzt 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. Anders gesagt wird mit diesem Parameter für die Verfolgung angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.
| String |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (optional) | Wendet eine Berechnungsfunktion auf Verfolgungsergebnisse an. Folgende Funktionskomponenten stehen zur Verfügung:
Folgende Function-Komponentenoptionen stehen zur Verfügung:
Es liegt beispielsweise ein Startpunkt-Feature mit dem Wert 20 vor. Das nächste Feature hat den Wert 30. Wenn Sie die Funktion MIN verwenden, ist das Ergebnis 20. MAX ist 30, ADD ist 50, AVERAGE ist 25, COUNT ist 2 und SUBTRACT ist -10. Folgende Filter Operator-Komponentenoptionen stehen zur Verfügung:
Folgende Filter Type-Komponentenoptionen stehen zur Verfügung:
| 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:
Folgende Operator-Komponentenoptionen stehen zur Verfügung:
Folgende Type-Komponentenoptionen stehen zur Verfügung:
Folgende Combine Using-Komponentenoptionen stehen zur Verfügung:
| Value Table |
result_types [result_types,...] (optional) | Gibt den Typ der Ergebnisse an, die von der Verfolgung zurückgegeben werden.
| String |
selection_type | Gibt an, wie die Auswahl angewendet wird, und welche Aktion ausgeführt wird, wenn bereits eine Auswahl vorhanden ist.
| 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".
| 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 Verfolgungskonfiguration verwendet wird.
Hinweis:Für diesen Parameter wird Trace Network Version 2 oder höher benötigt. | Boolean |
trace_config_name (optional) | Gibt den Namen der Verfolgungskonfiguration an, die zum Definieren der Verfolgungseigenschaften verwendet wird. Dieser Parameter wird nur aktiviert, wenn der Parameter use_trace_config auf USE_TRACE_CONFIGURATION gesetzt ist Hinweis:Für diesen Parameter wird Trace Network Version 2 oder höher benötigt. | String |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
updated_trace_network | Das aktualisierte Verfolgungsnetz | Beliebiger Wert |
Codebeispiel
Führen Sie mit der Funktion Trace eine Verfolgung flussabwärts in einem Verfolgungsnetz namens HydroNetwork durch.
import arcpy
arcpy.Trace_tn(r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork",
"DOWNSTREAM", r"C:\MyProject\NHD.gdb\TN_Temp_Starting_Points")
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja