Berechnen (Network Analyst)

Zusammenfassung

Berechnet das Netzwerkanalyse-Layer-Problem auf der Grundlage der Netzwerkstandorte und Eigenschaften.

Verwendung

  • Falls bei der Berechnung ein Fehler auftritt, finden Sie in den Warn- und Fehlermeldungen hilfreiche Informationen zu den Ursachen des Fehlers.

  • Stellen Sie sicher, dass Sie vor dem Ausführen dieses Werkzeugs alle Parameter im Netzwerkanalyse-Layer angeben, die zur Berechnung des Problems notwendig sind.

  • Das Werkzeug verbraucht Credits, wenn der Netzwerkanalyse-Layer ArcGIS Online als Netzwerkdatenquelle referenziert. Weitere Informationen finden Sie unter Übersicht zu Credits.

Syntax

arcpy.na.Solve(in_network_analysis_layer, {ignore_invalids}, {terminate_on_solve_error}, {simplification_tolerance}, {overrides})
ParameterErklärungDatentyp
in_network_analysis_layer

Der Netzwerkanalyse-Layer, für den die Analyse erstellt wird.

Network Analyst Layer
ignore_invalids
(optional)

Gibt an, ob ungültige Eingabestandorte ignoriert werden.

  • SKIPDer Solver überspringt Netzwerkstandorte, die nicht verortet sind, und berechnet den Analyse-Layer nur aus gültigen Netzwerkstandorten. Der Berechnungsvorgang wird auch fortgesetzt, wenn sich die Standorte auf nicht passierbaren Elementen befinden oder andere Fehler aufweisen. Dies ist nützlich, wenn Sie wissen, dass die Netzwerkstandorte nicht alle korrekt sind, Sie die Berechnung jedoch mit gültigen Netzwerkstandorten ausführen möchten. Dies ist die Standardeinstellung.
  • HALTDie Berechnung wird nicht ausgeführt, wenn ungültige Standorte vorhanden sind. Sie können diese Standorte dann korrigieren und die Analyse erneut ausführen.
Boolean
terminate_on_solve_error
(optional)

Gibt an, ob die Ausführung des Werkzeugs beendet werden soll, wenn während der Berechnung ein Fehler auftritt.

  • TERMINATEDas Werkzeug wird nicht ausgeführt, wenn im Solver ein Fehler auftritt. Dies ist die Standardeinstellung. Wenn Sie diese Option verwenden, wird das Result-Objekt nicht erstellt, wenn das Werkzeug aufgrund eines Solver-Fehlers nicht ausgeführt wird. Sie sollten die Geoverarbeitungsmeldungen aus dem ArcPy-Objekt abrufen.
  • CONTINUEDas Werkzeug wird ausgeführt und die Ausführung wird fortgesetzt, selbst wenn im Solver ein Fehler auftritt. Alle vom Solver zurückgegebenen Fehlermeldungen werden in Warnmeldungen konvertiert. Wenn Sie diese Option verwenden, wird immer ein Resultobjekt erstellt und die maxSeverity-Eigenschaft des Resultobjekts wird auf 1 festgelegt, selbst wenn im Solver ein Fehler auftritt. Verwenden Sie die getOutput-Methode des Resultobjekts mit dem Indexwert 1, um zu bestimmen, ob die Berechnung erfolgreich war.
Boolean
simplification_tolerance
(optional)

Der Grad der Vereinfachung für die Ausgabegeometrie wird durch die Toleranz bestimmt. Wenn die Toleranz angegeben ist, muss die größer als null sein. Sie können eine bevorzugte Einheit auswählen. Standardmäßig werden Dezimalgrad verwendet.

Durch Angabe einer Vereinfachungstoleranz wird im Allgemeinen weniger Zeit zum Rendern von Routen oder Einzugsgebieten benötigt. Ein Nachteil ist jedoch, dass durch die Vereinfachung der Geometrie Stützpunkte entfernt werden, wodurch die räumliche Genauigkeit der Ausgabe bei größeren Maßstäben abnimmt.

Da eine Linie mit nur zwei Stützpunkten nicht weiter vereinfacht werden kann, hat dieser Parameter keine Auswirkungen auf die Darstellungszeit von Ausgaben, die aus nur einem Segment bestehen, z. B. geradlinige Routen, Linien in einer Start-Ziel-Kostenmatrix und Linien einer Location-Allocation-Analyse.

Linear Unit
overrides
(optional)

Legen Sie zusätzliche Einstellungen fest, die das Verhalten des Solvers beim Suchen von Lösungen für die Netzwerkanalyseprobleme beeinflussen können.

Der Wert dieses Parameters muss in JavaScript Object Notation (JSON) angegeben werden. Ein gültiger Wert hat beispielsweise das Format {"overrideSetting1" : "value1", "overrideSetting2" : "value2"}. Der Name der Override-Einstellung wird immer in doppelten Anführungszeichen angegeben. Die Werte können eine Zahl, ein boolescher Wert oder eine Zeichenfolge sein.

Der Standardwert für diesen Parameter ist kein Wert, was darauf hinweist, dass keine Solver-Einstellungen überschrieben werden.

Overrides sind erweiterte Einstellungen, die nur nach sorgfältiger Analyse der abgerufenen Ergebnisse vor und nach Anwendung der Einstellungen verwendet werden sollten. Eine Liste der unterstützten Override-Einstellungen und ihrer akzeptierten Werte erhalten Sie beim technischen Support von Esri.

String

Abgeleitete Ausgabe

NameErklärungDatentyp
output_layer

Der berechnete Netzwerkanalyse-Layer.

Network Analyst-Layer
solve_succeeded

Ein boolescher Wert, der angibt, ob die Berechnung erfolgreich war oder nicht.

Boolean

Codebeispiel

Berechnen – Beispiel 1 (Python-Fenster)

Ausführen des Werkzeugs unter Verwendung aller Parameter.

arcpy.na.Solve("Route", "HALT", "TERMINATE", "10 Meters")
Berechnen – Beispiel 2 (Workflow)

Mit dem folgenden eigenständigen Python-Skript wird veranschaulicht, wie das Werkzeug Solve verwendet werden kann, um eine Analyse der nächstgelegenen Einrichtung zu erstellen und die Ergebnisse in einer Layer-Datei zu speichern.

# Name: Solve_Workflow.py
# Description: Solve a closest facility analysis to find the closest warehouse
#              from the store locations and save the results to a layer file on
#              disk.
# Requirements: Network Analyst Extension

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

try:
    #Check out Network Analyst license if available. Fail if the Network Analyst license is not available.
    if arcpy.CheckExtension("network") == "Available":
        arcpy.CheckOutExtension("network")
    else:
        raise arcpy.ExecuteError("Network Analyst Extension license is not available.")
    
    #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

    #Set local variables
    input_gdb = "C:/Data/Paris.gdb"
    network = os.path.join(input_gdb, "Transportation", "ParisMultimodal_ND")
    layer_name = "ClosestWarehouse"
    travel_mode = "Driving Time"
    facilities = os.path.join(input_gdb, "Analysis", "Warehouses")
    incidents = os.path.join(input_gdb, "Analysis", "Stores")
    output_layer_file = os.path.join(output_dir, layer_name + ".lyrx")

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

    #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 the warehouses as Facilities using the default field mappings and
    #search tolerance
    arcpy.na.AddLocations(layer_object, facilities_layer_name,
                            facilities, "", "")

    #Load the stores as Incidents. Map the Name property from the NOM field
    #using field mappings
    field_mappings = arcpy.na.NAClassFieldMappings(layer_object,
                                                    incidents_layer_name)
    field_mappings["Name"].mappedFieldName = "NOM"
    arcpy.na.AddLocations(layer_object, incidents_layer_name, incidents,
                          field_mappings, "")

    #Solve the closest facility layer
    arcpy.na.Solve(layer_object)

    #Save the solved closest facility layer as a layer file on disk
    layer_object.saveACopy(output_layer_file)

    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))

Lizenzinformationen

  • Basic: Eingeschränkt
  • Standard: Eingeschränkt
  • Advanced: Eingeschränkt

Verwandte Themen