Zusammenfassung
Exportiert Teilnetze aus einem Versorgungsnetz in eine JSON-Datei. Mit diesem Werkzeug können Sie zudem eine Zeile in der Tabelle der Teilnetze löschen, sofern das Is deleted-Attribut auf "true" festgelegt ist. Damit wird angegeben, dass der Teilnetz-Controller aus dem Teilnetz entfernt wurde.
Verwendung
Die Teilnetze müssen bereinigt werden. Führen Sie zunächst das Werkzeug Teilnetz aktualisieren aus.
Die Parameter in der Kategorie Trace Parameters können nur über Python ausgeführt werden.
- Die folgenden Anforderungen müssen erfüllt werden, wenn mit einer Enterprise-Geodatabase gearbeitet wird:
- Der Parameter Eingabe-Versorgungsnetz muss aus einem Utility Network-Service stammen.
Wenn der Parameter Export als bestätigt festlegen aktiviert ist, muss Folgendes zutreffen:
Die Netzwerk-Topologie muss aktiviert sein.
- Für Enterprise-Geodatabases gelten folgende zusätzliche Anforderungen:
- Dieses Werkzeug muss bei bestehender Verbindung zur Standardversion ausgeführt werden.
- Bei dem verbundenen ArcGIS Enterprise-Portal-Konto muss es sich um den Besitzer des Portal-Versorgungsnetzes handeln.
In ArcGIS Pro 2.3 wurden die folgenden Parameter hinzugefügt: Geometrie einbeziehen, Ergebnistypen, Ergebnis-Netzwerkattribute und Ergebnisfelder. Wenn diese Parameter verwendet werden, kann das Format der JSON-Ausgabedatei variieren. Für diese Parameter wird ArcGIS Enterprise 10.7 oder höher benötigt, wenn sie in einer Enterprise-Geodatabase verwendet werden. Weitere Informationen zur Antwortsyntax der Ausgabe-JSON.
Syntax
ExportSubnetwork(in_utility_network, domain_network, tier, subnetwork_name, export_acknowledged, out_json_file, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {include_geometry}, {result_types}, {result_network_attributes}, {result_fields})
Parameter | Erklärung | Datentyp |
in_utility_network | Das Versorgungsnetz, das das zu exportierende Teilnetz enthält. | Utility Network; Utility Network Layer |
domain_network | Die Netzart, in der das Teilnetz enthalten ist. | String |
tier | Die Ebene, in der das Teilnetz enthalten ist. | String |
subnetwork_name | Der Name des zu exportierenden Teilnetzes. Wählen Sie eine bestimmte Quelle zum Exportieren der entsprechenden Teilnetzinformationen aus. | String |
export_acknowledged | Gibt an, ob das Attribut LASTACKEXPORTSUBNETWORK für den entsprechenden Controller in der Tabelle der Teilnetze und das Feature in der SubnetLine-Feature-Class aktualisiert werden.
| Boolean |
out_json_file | Name und Speicherort der zu generierenden JSON-Datei. | File |
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-Werte für die Bedingungsbarriere lauten wie folgt:
Die type-Optionen für die Bedingungsbarriere lauten wie folgt:
Die Combine Using-Werte lauten wie folgt:
Hinweis:Dieser Parameter ist nur über Python verfügbar. Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken | 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:
Mögliche Werte der function-Optionen für die Funktionsbarriere:
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 "Mittelwert" ist es 25, mit "Anzahl" ist es 2, und mit "Subtrahieren" ist es -10. Die operator-Wertoptionen für die Funktionsbarriere lauten wie folgt:
Hinweis:Dieser Parameter ist nur über Python verfügbar. | Value Table |
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.
Hinweis:Dieser Parameter ist nur über Python verfügbar. | Boolean |
traversability_scope (optional) | Gibt den Typ der Durchlassfähigkeit an, 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 zu stoppen, wenn DEVICESTATUS auf Open festgelegt wurde und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, würde die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da DEVICESTATUS nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.
Hinweis:Dieser Parameter ist nur über Python verfügbar. | 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 werden soll. 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:
Mögliche Werte von function für die Weitergabemodule:
Die operator-Werte für das Weitergabemodul lauten wie folgt:
Hinweis:Dieser Parameter ist nur über Python verfügbar. | Value Table |
include_geometry (optional) | Gibt an, ob die Geometrie in die Ergebnisse aufgenommen werden soll.
Hinweis:Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 10.7 oder höher. | Boolean |
result_types [result_types,...] (optional) | Gibt den Typ der zu exportierenden Ergebnisse an.
Hinweis:Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 10.7 oder höher.
| String |
result_network_attributes [result_network_attributes,...] (optional) | Die Netzwerkattribute, die in die Ergebnisse aufgenommen werden. Hinweis:Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 10.7 oder höher. | String |
result_fields [[Feature Class, Field Name],...] (optional) | Felder aus einer Feature-Class, die als Ergebnisse zurückgegeben werden sollen. Die Werte des Feldes werden in den Ergebnissen für die Features im Teilnetz zurückgegeben. Hinweis:Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 10.7 oder höher. | Value Table |
Abgeleitete Ausgabe
Name | Erklärung | Datentyp |
out_utility_network | Das aktualisierte Versorgungsnetz. | Versorgungsnetz |
Codebeispiel
Mit diesem Beispielskript werden die entsprechenden Teilnetzinformationen für die Quelle "RMT002" in eine JSON-Datei exportiert.
import arcpy
arcpy.ExportSubnetwork_un("Utility Network", "ElectricDistribution",
"Medium Voltage", "RMT002", "ACKNOWLEDGE",
"C:\\Temp\\RMT002clean.json")
Umgebungen
Lizenzinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja