Passierte Quell-Features kopieren (Network Analyst Tools)

Zusammenfassung

Erstellt zwei Feature-Classes und eine Tabelle, die Informationen zu Kanten, Knoten und Kantenübergängen enthalten, die beim Berechnen eines Netzwerkanalyse-Layers durchlaufen werden.

Weitere Informationen über die Ausgabe des Werkzeugs "Passierte Quell-Features kopieren"

Verwendung

Das Werkzeug berechnet den Eingabe-Netzwerkanalyse-Layer, wenn dieser noch nicht berechnet wurde. Der Analyse-Layer wird erneut berechnet, wenn die Eingaben seit der letzten Berechnung geändert wurden.
Passierte Quell-Features können für die folgenden Netzwerkanalyse-Layer generiert werden:
- Route
- Nächstgelegene Einrichtung
- Vehicle Routing Problem
- Last-Mile-Delivery
- Einzugsgebiets-Layer, die auf Netzwerk-Datasets in einer File-Geodatabase verweisen
Passierte Quell-Features können für die folgenden Layer nicht generiert werden:
- Start-Ziel-Kostenmatrix
- Location-Allocation
- Waste Collection
- Einzugsgebiets-Layer, die auf Netzwerk-Datasets in einer Mobile-Geodatabase verweisen
Abgesehen von Punkten, die durchlaufene Netzwerkknoten darstellen, enthält die Ausgabe-Junctions-Feature-Class auch Punkte, die Folgendes darstellen:
- Durchlaufene Punkt-Barrieren
- Anfangs- und Endpunkte durchlaufener Linien- und Polygon-Barrieren
- Durchlaufene Stopps in einer Routenanalyse
- Durchlaufene Einrichtungen und das Ende von Pausen in einer Einzugsgebiet-Analyse
- Durchlaufene Einrichtungen und Ereignisse in einer Analyse der nächstgelegenen Einrichtung
- Durchlaufene Aufträge, Depots und Pausen in einer Vehicle Routing Problem-Analyse
- Durchlaufene Aufträge und Depots in einer Last-Mile-Delivery-Analyse
Das Koordinatensystem für die Ausgabe-Feature-Classes kann durch Angabe der Umgebung Ausgabe-Koordinatensystem oder eines Feature-Datasets in einer Geodatabase als Wert für den Parameter Ausgabeverzeichnis gesteuert werden. Wenn die Umgebung "Ausgabe-Koordinatensystem" nicht angegeben wurde oder wenn der Parameter Ausgabeverzeichnis kein Feature-Dataset ist, haben die Ausgabe-Feature-Classes das gleiche Koordinatensystem wie der Eingabe-Netzwerkanalyse-Layer.
Das Werkzeug schlägt bei Last-Mile-Delivery-Analyse-Layern fehl, die keine Wegbeschreibungen ausgeben und keine Routen-Shapes verwenden, da das Routenergebnis nicht erzeugt wird.

Beschriftung	Erläuterung	Datentyp
Eingabe-Netzwerkanalyse-Layer	Der Netzwerkanalyse-Layer, aus dem passierte Quell-Features kopiert werden. Wenn der Netzwerkanalyse-Layer kein gültiges Ergebnis aufweist, wird der Layer berechnet, um ein solches zu erzeugen.	Network Analyst Layer
Ausgabeverzeichnis	Der Workspace, in dem die Ausgabetabelle und die zwei Feature-Classes gespeichert werden.	Workspace; Feature Dataset
Edge-Feature-Class-Name	Der Name der Feature-Class, die Informationen über die durchlaufenen Kanten-Quell-Features enthält. Wenn der berechnete Netzwerkanalyse-Layer keine Kanten-Features durchläuft, wird eine leere Feature-Class erstellt.	String
Junction-Feature-Class-Name	Der Name der Feature-Class, die Informationen über die passierten Knoten-Quell-Features enthält, einschließlich Systemknoten und relevanten Punkten aus dem Eingabe-Netzwerkanalyse-Layer. Wenn der berechnete Netzwerkanalyse-Layer keine Knoten durchläuft, wird eine leere Feature-Class erstellt.	String
Name der Kantenübergangstabelle	Der Name der Tabelle, die Informationen über die durchlaufenen globalen Kantenübergänge und Kantenübergangs-Features enthält, durch die Kosten für die zugrunde liegenden Kanten skaliert werden. Wenn der berechnete Netzwerkanalyse-Layer keine Kantenübergänge durchläuft, wird eine leere Tabelle erstellt. Da eingeschränkte Kantenübergange niemals durchlaufen werden, sind sie nie in der Ausgabe enthalten.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Kanten-Features	Eine Feature-Class mit den Netzwerk-Dataset-Kanten, die in der Netzwerkanalyse passiert wurden.	Feature Class
Knoten-Features	Eine Feature-Class mit den Netzwerk-Dataset-Knoten, die in der Netzwerkanalyse passiert wurden.	Feature Class
Kantenübergangstabelle	Eine Tabelle mit den Netzwerk-Dataset-Kantenübergängen, die in der Netzwerkanalyse passiert wurden.	Table
Geänderter Eingabe-Netzwerkanalyse-Layer	Der berechnete Netzwerkanalyse-Layer.	Network Analyst Layer

arcpy.na.CopyTraversedSourceFeatures(input_network_analysis_layer, output_location, edge_feature_class_name, junction_feature_class_name, turn_table_name)

Name	Erläuterung	Datentyp
input_network_analysis_layer	Der Netzwerkanalyse-Layer, aus dem passierte Quell-Features kopiert werden. Wenn der Netzwerkanalyse-Layer kein gültiges Ergebnis aufweist, wird der Layer berechnet, um ein solches zu erzeugen.	Network Analyst Layer
output_location	Der Workspace, in dem die Ausgabetabelle und die zwei Feature-Classes gespeichert werden.	Workspace; Feature Dataset
edge_feature_class_name	Der Name der Feature-Class, die Informationen über die durchlaufenen Kanten-Quell-Features enthält. Wenn der berechnete Netzwerkanalyse-Layer keine Kanten-Features durchläuft, wird eine leere Feature-Class erstellt.	String
junction_feature_class_name	Der Name der Feature-Class, die Informationen über die passierten Knoten-Quell-Features enthält, einschließlich Systemknoten und relevanten Punkten aus dem Eingabe-Netzwerkanalyse-Layer. Wenn der berechnete Netzwerkanalyse-Layer keine Knoten durchläuft, wird eine leere Feature-Class erstellt.	String
turn_table_name	Der Name der Tabelle, die Informationen über die durchlaufenen globalen Kantenübergänge und Kantenübergangs-Features enthält, durch die Kosten für die zugrunde liegenden Kanten skaliert werden. Wenn der berechnete Netzwerkanalyse-Layer keine Kantenübergänge durchläuft, wird eine leere Tabelle erstellt. Da eingeschränkte Kantenübergange niemals durchlaufen werden, sind sie nie in der Ausgabe enthalten.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
edge_features	Eine Feature-Class mit den Netzwerk-Dataset-Kanten, die in der Netzwerkanalyse passiert wurden.	Feature Class
junction_features	Eine Feature-Class mit den Netzwerk-Dataset-Knoten, die in der Netzwerkanalyse passiert wurden.	Feature Class
turn_table	Eine Tabelle mit den Netzwerk-Dataset-Kantenübergängen, die in der Netzwerkanalyse passiert wurden.	Table
modified_input_network_analysis_layer	Der berechnete Netzwerkanalyse-Layer.	Network Analyst Layer

Codebeispiel

CopyTraversedSourceFeatures: Beispiel 1 (-Fenster)

Das folgende Python-Skript veranschaulicht, wie Sie mit der Funktion CopyTraversedSourceFeatures die durchlaufenen Kanten, Knoten und Kantenübergänge aus einem Routen-Netzwerkanalyse-Layer in Feature-Classes und eine Tabelle in einem speicherresidenten Workspace schreiben.

arcpy.na.CopyTraversedSourceFeatures("Route", "C:/Data/Output.gdb",
                                     "TraversedEdges",
                                     "TraversedJunctions",
                                     "TraversedTurns")

CopyTraversedSourceFeatures: Beispiel 2 (Workflow)

Das folgende eigenständige Python-Skript veranschaulicht, wie Sie mit CopyTraversedSourceFeatures identische Straßen in den Routen von den Zählbezirksschwerpunkten zu den nächsten Feuerwachen suchen können. Anhand dieser Ergebnisse können Sie die Straßen ermitteln, die bei Notfällen am häufigsten genutzt werden.

# Name: CopyTraversedSourceFeatures_ex02.py
# Description: The scenario shows how to find the streets that are common to the
#              routes between the closest fire station and the census tract
#              centroids. These streets can be used to identify critical points
#              in case of an emergency.
# Requirements: Network Analyst extension

# Import system modules
import os
import arcpy
from arcpy import env

try:
    # Set environment settings
    output_dir = "C:/Data"
    # The NA layer's data will be saved to the workspace specified here
    env.workspace = os.path.join(output_dir, "Output.gdb")
    env.overwriteOutput = True
    env.qualifiedFieldNames = False

    # Set local variables
    input_gdb = "C:/Data/SanFrancisco.gdb"
    output_gdb = "C:/Data/Output.gdb"
    network = os.path.join(input_gdb, "Transportation", "Streets_ND")
    layer_name = "EmergencyRoutes"
    travel_mode = "Driving Time"
    facilities = os.path.join(input_gdb, "Analysis", "FireStations")
    incidents = os.path.join(input_gdb, "Analysis", "TractCentroids")
    edge_frequency = os.path.join(output_gdb, "EdgeFrequency")
    critical_streets = os.path.join(output_gdb, "CriticalStreets")

    # Create a new closest facility analysis layer.
    result_object = arcpy.na.MakeClosestFacilityAnalysisLayer(
        network, layer_name, travel_mode, "FROM_FACILITIES"
    )

    # Get the layer object from the result object. The closest facility layer can
    # now be referenced using the layer object.
    layer_object = result_object.getOutput(0)

    # Get the names of all the sublayers within the closest facility layer.
    sublayer_names = arcpy.na.GetNAClassNames(layer_object)
    # Stores the layer names that we will use later
    facilities_layer_name = sublayer_names["Facilities"]
    incidents_layer_name = sublayer_names["Incidents"]

    # Load fire station features as facilities
    arcpy.na.AddLocations(layer_object, facilities_layer_name, facilities)

    # Load tract centroids as incidents. Map the ID field from Tract
    # Centroids as the name for incidents using field mappings
    field_mappings = arcpy.na.NAClassFieldMappings(
        layer_object, incidents_layer_name
    )
    field_mappings['Name'].mappedFieldName = "ID"
    arcpy.na.AddLocations(
        layer_object, incidents_layer_name, incidents, field_mappings
    )

    # Solve the closest facility layer and copy the travered source features to
    # the output geodatabase. Use default names for the output feature
    # classes and table. Retrieve the first output, which is the traversed edges.
    traversed_edges = arcpy.na.CopyTraversedSourceFeatures(
        layer_object, output_gdb
    ).getOutput(0)

    # Some streets might be traversed by more than one route. Streets traversed
    # by many routes are the most critical emergency routes. Count the number of
    # routes using each street.
    arcpy.analysis.Frequency(
        traversed_edges, edge_frequency, ["SourceOID", "SourceName"]
    )

    # The resulting edge features from CopyTraversedSourceFeatures may include
    # clipped versions of the original street features because the Closest
    # Facility route only traveled across part of the street feature. Select
    # the complete street features from the original street feature class and
    # copy them to output.
    # Get the full path to the network dataset's streets feature class by
    # describing the network dataset.
    network_desc = arcpy.Describe(network)
    edge_sources = network_desc.edgeSources
    for es in edge_sources:
        if es.name.lower() == "streets":
            streets_source = os.path.join(os.path.dirname(network), es.name)
            break

    # Select the relevant streets based on overlap with the results from
    # CopyTraversedSourceFeatures
    streets_layer = arcpy.management.MakeFeatureLayer(
        streets_source, "StreetsLayer"
    )
    arcpy.management.SelectLayerByLocation(
        streets_layer, "SHARE_A_LINE_SEGMENT_WITH", traversed_edges
    )

    # Add the frequency information to the output feature class using JoinField
    arcpy.management.JoinField(
        streets_layer, "ObjectID", edge_frequency, "SourceOID", "FREQUENCY"
    )

    # Save the selected features to disk
    arcpy.management.CopyFeatures(streets_layer, critical_streets)

    # Delete the Frequency field from the street feature class
    arcpy.management.DeleteField(streets_layer, "FREQUENCY")

    print("Script completed successfully")

except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    print("An error occurred on line %i" % tb.tb_lineno)
    print(str(e))

Umgebungen

Aktueller Workspace, Ausgabe-Koordinatensystem

Lizenzierungsinformationen

Basic: Benötigt Network Analyst
Standard: Benötigt Network Analyst
Advanced: Benötigt Network Analyst

Passierte Quell-Features kopieren (Network Analyst Tools)

Zusammenfassung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen