Zusammenfassung
Fügt eine Schemaregel für die automatische Verfolgung in einem Versorgungs- oder Verfolgungsnetz beim Erstellen von Schemas basierend auf einer vorhandenen Vorlage hinzu. Mit den bei der Verfolgung berücksichtigten Netzwerk-Features und Netzwerkobjekten wird der Schemainhalt erstellt.
Weitere Informationen zur Verwendung der Verfolgungsregel zum Erstellen von Schemas
Vorsicht:
Dieses Werkzeug ist ein Konfigurations- und Verwaltungswerkzeug.
Hinweis:
Dieses Werkzeug hat Auswirkungen auf die Konsistenz aller vorhandenen Schemas, die auf der Eingabeschemavorlage basieren. Alle vorhandenen Schemas werden inkonsistent und werden beim Öffnen mit dem Konsistenzwarnsymbol 
angezeigt, bis sie aktualisiert werden.
Verwendung
Bei Verwendung eines Utility Network- oder Trace Network-Service wird dieses Werkzeug nicht unterstützt. Sie müssen entweder ein Versorgungs- oder Verfolgungsnetz in einer File-Geodatabase oder eine Datenbankverbindung zu einem Versorgungs- oder Verfolgungsnetz in einer Enterprise-Geodatabase verwenden. Für die Verwendung einer Enterprise-Geodatabase gelten folgende Voraussetzungen:
- Der Parameterwert Eingabe-Netzwerk muss aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes oder als Besitzers des Datenbank-Verfolgungsnetzes hergestellt wurde.
- Bei dem verbundenen ArcGIS Enterprise-Portal-Konto muss es sich um den Besitzer des Portal-Versorgungsnetzes oder den Besitzer des Portal-Verfolgungsnetzes handeln.
- Dieses Werkzeug muss mit der Default-Version verbunden sein, von der vorausgesetzt wird, dass sie öffentlich und nicht geschützt ist.
Die Verfolgungsregel dient zur Ausführung einer Verfolgung in Versorgungs- und Verfolgungsnetzelementen, die aktuell in einem Schema dargestellt werden.
Je nach angegebenem Verfolgungstyp muss das Schema Startpunkte aufweisen, damit die Verfolgungsregel ausgeführt werden kann:
- Für die Verfolgungstypen "Verbunden", "Teilnetz", "Flussaufwärts" und "Flussabwärts" werden alle Versorgungsnetz- oder Verfolgungsnetz-Elemente, die zum Zeitpunkt des Starts der Verfolgungsregel im Schema dargestellt werden, als Startpunkte für die Verfolgung betrachtet, es sei denn, es wird eine Regel zum Festlegen von Startpunkten für die Schemavorlage konfiguriert, um bestimmte Startpunkte vorab eindeutig zu identifizieren.
- Für den Verfolgungstyp "Kürzeste Verbindung" müssen Regeln zum Festlegen von Startpunkten für die Schemavorlage konfiguriert werden, um für die kürzeste Route die beiden Startpunkte unter allen derzeit im Schema dargestellten Verfolgungsnetz-Elementen zu ermitteln.
Wenn Sie eine Vorlage basierend auf der Verfolgungsregel konfigurieren, wird die Verfolgung bei jeder Aktualisierung des Schemas im Versorgungs- oder Verfolgungsnetz systematisch erneut ausgeführt. Dies bedeutet, dass jedes auf dieser Vorlage basierende Schema nach einer Aktualisierung stets das aktuelle Netzverfolgungsergebnis widerspiegelt.
Syntax
arcpy.nd.AddTraceRule(in_utility_network, template_name, is_active, trace_type, {domain_network}, {tier}, {target_tier}, {include_structures}, {include_barriers}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {propagators}, {description}, {allow_indeterminate_flow}, {path_direction}, {path_network_weight_name})| Parameter | Erklärung | Datentyp |
in_utility_network | Das Versorgungs- oder Verfolgungsnetz, das die zu ändernden Schemavorlagendefinitionen referenziert. | Utility Network; Trace Network |
template_name | Der Name der zu ändernden Schemavorlage. | String |
is_active | Gibt an, ob die Regel aktiviert ist, wenn Schemas basierend auf der angegebenen Vorlage erstellt und aktualisiert werden.
| Boolean |
trace_type | Gibt den Verfolgungstyp an, den die Regel zum Erstellen des Schemainhalts durchführt.
| String |
domain_network (optional) | Der Name der Netzart, in der die Verfolgung eines Versorgungsnetzes ausgeführt wird. Dieser Parameter ist erforderlich, wenn die Verfolgungstypen für Teilnetze, flussaufwärts und flussabwärts ausgeführt werden. | String |
tier (optional) | Der Name der Ebene, auf der die Verfolgung eines Versorgungsnetzes gestartet wird. Dieser Parameter ist beim Ausführen der Verbindungsverfolgung optional; er ist erforderlich, wenn die Verfolgungstypen für Teilnetze, flussaufwärts und flussabwärts ausgeführt werden. | String |
target_tier (optional) | Der Name der Zielebene, in deren Richtung die Eingabeebene eines Versorgungsnetzes fließt. Wenn dieser Parameter in Verfolgungen vom Typ "Flussaufwärts" und "Flussabwärts" fehlt, enden diese Verfolgungen an der Grenze des Start-Teilnetzes. Dieser Parameter kann verwendet werden, um die Verfolgungen darüber hinaus fortzusetzen, also in der Hierarchie weiter nach oben oder weiter nach unten. | String |
include_structures (optional) | Gibt an, ob Struktur-Features und Objekte in die Verfolgungsergebnisse einbezogen werden.
| Boolean |
include_barriers (optional) | Gibt an, ob die Barrieren-Features für die Durchlassfähigkeit in die Verfolgungsergebnisse einbezogen werden. Barrieren für die Durchlassfähigkeit sind optional, auch wenn sie in der Teilnetzdefinition voreingestellt wurden. Dieser Parameter gilt nicht für Bauteil-Features mit Anschlusspunkten.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (optional) | Legt für Features eine Bedingungsbarriere für Durchlässigkeit basierend auf einem Vergleich mit einem Netzwerkattribut fest, oder führt eine Überprüfung der Kategoriezeichenfolge durch. Eine Bedingungsbarriere verwendet ein Netzwerkattribut, einen Operator und einen Typ sowie einen Attributwert. Halten Sie eine Verfolgung beispielsweise an, wenn das Attribut Device Status dem spezifischen Wert Open 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:
Die operator-Optionen für die Bedingungsbarrieren sind folgende:
Weitere Informationen zu Bitwise-Operatoren Die Type-Optionen für die Bedingungsbarrieren sind folgende:
Die Combine Using-Optionen für die Bedingungsbarrieren sind folgende:
| 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:
Die function-Wertoptionen für die Funktionsbarriere lauten wie folgt:
Die operator-Wertoptionen für die Funktionsbarriere lauten wie folgt:
Weitere Informationen zu Bitwise-Operatoren Die Use Local Values-Optionen für die Funktionsbarriere lauten wie folgt:
| Value Table |
traversability_scope (optional) | Der Typ der Durchlassfähigkeit, der umgesetzt werden soll. Der Umfang der Durchlassfähigkeit regelt, ob die Durchlassfähigkeit an Knoten, an Kanten oder an Knoten und an Kanten umgesetzt wird. Beispiel: Wenn eine Bedingungsbarriere definiert wurde, um die Verfolgung anzuhalten, aber der Bauteilstatus dem Wert "Offen" entspricht und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, wird die Verfolgung auch dann nicht angehalten, wenn ein offenes Bauteil vorhanden ist, da "Bauteilstatus" nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.
| String |
filter_barriers [[Name, Operator, Type, Value, Combine Using],...] (optional) | Gibt an, wann eine Verfolgung aufgrund eines bestimmten Kategorie- oder Netzwerkattributs beendet wird. Beispiel: Eine Verfolgung bei Features beenden, die ein Attribut für den Lebenszyklusstatus aufweisen, das einem bestimmten Wert entspricht. Dieser Parameter wird verwendet, um ein abschließendes Feature basierend auf dem im System definierten Wert eines Netzwerkattributs festzulegen. Bei Verwendung mehrerer Attribute können Sie mit der Option Combine Using eine And- oder eine Or-Bedingung definieren. Die Komponenten der Filterbarrieren sind folgende:
Die operator-Optionen für die Filterbarrieren sind folgende:
Weitere Informationen zu Bitwise-Operatoren Die Type-Optionen für die Filterbarrieren sind folgende:
Die Combine Using-Optionen für die Filterbarrieren sind folgende:
| Value Table |
filter_function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (optional) | Diese filtern die Ergebnisse der Verfolgung entsprechend einer bestimmten Kategorie. Die Komponenten der Filterfunktionsbarrieren sind folgende:
Die function-Optionen für die Filterfunktionsbarrieren sind folgende:
Die operator-Optionen für die Filterfunktionsbarrieren sind folgende:
Weitere Informationen zu Bitwise-Operatoren Die Use Local Values-Optionen für die Filterfunktionsbarrieren sind folgende:
| Value Table |
filter_scope (optional) | Gibt an, ob der Filter für eine bestimmte Kategorie bei Knoten oder Kanten oder bei Knoten und Kanten angewendet wird. Beispiel: Wenn eine Filterbarriere definiert wurde, um die Verfolgung zu stoppen, wenn der Bauteilstatus dem Wert "Offen" entspricht und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, wird die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da der Bauteilstatus nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.
| String |
filter_bitset_network_attribute_name (optional) | Der Name des Netzwerkattributs, das zum Filtern nach Bitset verwendet wird. Dieser Parameter kann nur für Verfolgungen vom Typ "Flussaufwärts", "Flussabwärts" oder "Schleifen" verwendet werden. Mit diesem Parameter kann während der Verfolgung eine spezielle Logik hinzugefügt werden, sodass mit der Verfolgung Szenarien realitätsgetreuer abgebildet werden. Bei einer Verfolgung vom Typ "Schleifen" kann das Netzwerkattribut "Phasenstrom" beispielsweise ermitteln, ob es sich bei einer Schleife um eine echte elektrische Schleife handelt (d. h. in der gesamten Schleife führt Phase A Strom), und nur diese als Verfolgungsergebnis zurückgeben. Ein Beispiel für eine Verfolgung vom Typ "Flussaufwärts" ist die Verfolgung eines Stromverteilungsnetzes durch Festlegen des Netzwerkattributs "Phasenstrom", wobei in den Verfolgungsergebnissen nicht alle Pfade, sondern nur im Netzwerkattribut angegebene gültige Pfade enthalten sind. | String |
filter_nearest (optional) | Gibt an, ob der Algorithmus "Nächster Nachbar (K)" verwendet werden soll, um eine Reihe von Features eines bestimmten Typs innerhalb einer angegebenen Entfernung zurückzugeben. Wenn dieser Parameter verwendet wird, können Sie Anzahl und Kosten sowie eine Sammlung von Kategorien und/oder einen Asset-Typ festlegen.
| Boolean |
nearest_count (optional) | Die Anzahl der zurückzugebenden Features, wenn filter_nearest den Wert FILTER_BY_NEAREST hat. | Long |
nearest_cost_network_attribute (optional) | Das numerische Netzwerkattribut, das zum Berechnen von Nähe, Kosten oder Entfernung verwendet werden soll, wenn filter_nearest den Wert FILTER_BY_NEAREST hat, zum Beispiel Shape-Länge. | String |
nearest_categories [nearest_categories,...] (optional) | Die Kategorien, die zurückgegeben werden sollen, wenn filter_nearest den Wert FILTER_BY_NEAREST hat, zum Beispiel Schutz. | String |
nearest_assets [nearest_assets,...] (optional) | Die Asset-Gruppen und Asset-Typen, die zurückgegeben werden sollen, wenn filter_nearest den Wert FILTER_BY_NEAREST hat, zum Beispiel ElectricDistributionDevice/Transformer/Step Down. | String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (optional) | Legt fest, welche Netzwerkattribute weitergegeben werden sollen und wie diese Weitergabe während einer Verfolgung durchgeführt wird. Weitergegebene Klassenattribute geben die Schlüsselwerte für Teilnetz-Controller an, die auf die restlichen Features im Teilnetz verteilt werden. In einem Stromversorgungsmodell können Sie beispielsweise die Phasenwerte weitergeben. Folgende Komponenten stehen bei den Weitergabemodulen zur Verfügung:
Die function-Optionen für die Weitergabemodule lauten wie folgt:
Die operator-Optionen für die Weitergabemodule lauten wie folgt:
Weitere Informationen zu Bitwise-Operatoren Hinweis:Dieser Parameter ist nur über Python verfügbar. | Value Table |
description (optional) | Die Beschreibung der Regel. | String |
allow_indeterminate_flow (optional) | Gibt an, ob Verfolgungsnetz-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 |
path_direction (optional) | Gibt die Richtung eines Verfolgungsnetzes an. Die Kosten, die beim Passieren des Pfades entstehen, werden anhand des Wertes path_network_attribute_name ermittelt. Dieser Parameter wird nur bei der Ausführung einer Verfolgung vom Typ PATH berücksichtigt.
| String |
path_network_weight_name (optional) | Das Netzwerkattribut, das zum Berechnen des Pfades eines Verfolgungsnetzes 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 |
Abgeleitete Ausgabe
| Name | Erklärung | Datentyp |
| out_utility_network | Das aktualisierte Versorgungs- oder Verfolgungsnetz. | Versorgungsnetz, Verfolgungsnetz |
| out_template_name | Der Name der Schemavorlage | Zeichenfolge |
Codebeispiel
Mit diesem Beispielskript wird der für ein angegebenes Netzwerk bestehenden Vorlage "MyTemplate1" eine Verfolgungsregel hinzugefügt, um in der Domäne "ElectricDistribution" Schemas aus einer Verfolgung in Teilnetzen innerhalb der Ebene "Mittlere Spannung" zu erstellen.
import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddTraceRule_nd(input_Network, input_DiagramTemplate, "ACTIVE",
"SUBNETWORK", "ElectricDistribution", "Medium Voltage",
"Low Voltage Mesh")Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja