VehicleRoutingProblemSolverProperties (arcpy.na)
Zusammenfassung
Provides access to analysis properties from a vehicle routing problem Network Analyst layer. The GetSolverProperties function is used to obtain a VehicleRoutingProblemSolverProperties object from a vehicle routing problem Network Analyst layer.
Diskussion
The VehicleRoutingProblemSolverProperties object provides read and write access to all the analysis properties of a vehicle routing problem Network Analyst layer. The object can be used to modify the desired analysis properties of the vehicle routing problem layer, and the corresponding layer can be re-solved to determine the appropriate results. A new vehicle routing problem layer can be created using the Make Vehicle Routing Problem Layer geoprocessing tool. Obtaining the VehicleRoutingProblemSolverProperties object from a new vehicle routing problem layer allows you to reuse the existing layer for subsequent analyses rather than create a new layer for each analysis, which can be slow.
After modifying the properties of the VehicleRoutingProblemSolverProperties object, the corresponding layer can be immediately used with other functions and geoprocessing tools. There is no refresh or update of the layer required to honor the changes modified through the object.
Eigenschaften
Eigenschaft | Erläuterung | Datentyp |
attributeParameters (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen der parametrierten Attribute, die für die Analyse verwendet werden sollen. Die Eigenschaft gibt ein Python-Wörterbuch zurück. Der Wörterbuchschlüssel ist ein Tupel mit zwei Werten, der aus dem Attributnamen und dem Parameternamen besteht. Der Wert der einzelnen Elemente im Wörterbuch ist der Parameterwert. Mithilfe der parametrierten Netzwerkattribute können dynamische Aspekte eines Attributwertes modelliert werden. So kann beispielsweise ein Tunnel mit einer Höhenbeschränkung von 12 Fuß mit einem Parameter modelliert werden. In diesem Fall sollte die Höhe des Fahrzeugs (in Fuß) als angegebener Parameterwert verwendet werden. Wenn das Fahrzeug höher als 12 Fuß ist, wird diese Einschränkung als "Wahr" bewertet und das Passieren des Tunnels somit untersagt. Entsprechend kann eine Brücke einen Parameter zur Angabe einer Gewichtsbeschränkung aufweisen. Das Ändern der festgelegten Eigenschaft " attributeParameters" würde keine aktualisierten Werte zurückgeben. Sie sollten daher immer ein neues Wörterbuchobjekt verwenden, um die Werte für die Eigenschaft festzulegen. Die zwei folgenden Codeblöcke veranschaulichen den Unterschied zwischen diesen beiden Ansätzen:
| Dictionary |
capacityCount (Lesen und schreiben) |
Ermöglicht das Abrufen oder Festlegen der Anzahl an Abmessungen für die zulässige Höchstlast, mit denen die jeweiligen Höchstlasten der Fahrzeuge beschrieben werden. | Integer |
defaultDate (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen des impliziten Datums für Zeitfeldwerte, für die kein Datum für die Uhrzeit angegeben wurde. Wenn ein Zeitfeld für ein Auftragsobjekt, z. B. "TimeWindowStart1", einen reinen Uhrzeitwert enthält, wird als Datum der Eigenschaftswert defaultDate verwendet. Wenn ein Auftrag beispielsweise den Wert "TimeWindowStart1" von 9:00 Uhr aufweist und defaultDate auf datetime.date(2012, 3, 6) gesetzt ist, wird als vollständiger Zeitwert für das Feld der Wert "9:00 Uhr, 6. März 2012" verwendet. Das Standarddatum wirkt sich nicht auf Feldwerte aus, die bereits ein Datum aufweisen. Mithilfe der folgenden Datumsangaben kann auch ein Wochentag als Standarddatum angegeben werden:
Wenn Sie beispielsweise angeben möchten, dass das implizite Datum für Zeitfeldwerte "Dienstag" sein soll, müssen Sie den folgenden Eigenschaftswert angeben: 1/2/1900. | DateTime |
distanceAttribute (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen des Entfernungskostenattributs, mit dem die Länge entlang der Netzwerkelemente definiert wird. | String |
distanceFieldUnits (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen der Entfernungseinheiten, die von den Entfernungsfeldern in den Sublayern und Tabellen des Analyse-Layers verwendet werden (Netzwerkanalyseklassen). Die Einheit muss nicht mit der Einheit des Netzwerkkostenattributs übereinstimmen, das als Eigenschaftswert timeAttribute angegeben wird. Nachfolgend finden Sie eine Liste der möglichen Werte:
| String |
excessTransitTimeImportance (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen der Bedeutung für die Reduzierung von Fahrzeitüberschreitungen. Die Fahrzeitüberschreitung entspricht der Zeit, um die die direkte Fahrzeit zwischen den Auftragspaaren überschritten wird. Die Fahrzeitüberschreitung ergibt sich aus Unterbrechungen oder Fahrten zu anderen Aufträgen oder Depots, die zwischen den Auftragspaaren stattgefunden haben. Nachfolgend finden Sie eine Liste der möglichen Werte:
| String |
outputPathShape (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen des Shape-Typs für die Routen-Features, die vom Solver ausgegeben werden. Nachfolgend finden Sie eine Liste der möglichen Werte:
| String |
restrictions (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen einer Liste der Restriktionsattribute, die für die Analyse angewendet werden. Eine leere Liste, [], weist darauf hin, dass keine Restriktionsattribute für die Analyse verwendet werden. | String |
solverName (Schreibgeschützt) |
Gibt den Namen des Solvers zurück, der vom Network Analyst-Layer referenziert wird, um das Eigenschaftenobjekt des Solvers zu erhalten. Die Eigenschaft gibt immer den Zeichenfolgenwert Vehicle Routing Problem Solver zurück, wenn der Zugriff über ein VehicleRoutingProblemSolverProperties-Objekt erfolgt. | String |
timeAttribute (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen des zeitbasierten Netzwerkkostenattributs, mit dem die Routenzeit entlang der Netzwerkelemente definiert wird. Dieses Kostenattribut wird vom Solver während der Ermittlung der Lösung minimiert. | String |
timeFieldUnits (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen der Zeiteinheit, die von den Zeitdatenfeldern in den Sublayern und Tabellen des Analyse-Layers verwendet wird (Netzwerkanalyseklassen). Die Einheit muss nicht mit der Einheit des Netzwerkkostenattributs übereinstimmen, das als Eigenschaftswert timeAttribute angegeben wird. Nachfolgend finden Sie eine Liste der möglichen Werte:
| String |
timeWindowViolationImportance (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen der Bedeutung für die Einhaltung von Zeitfenstern, ohne Zeitfensterverletzungen zu verursachen. Eine Zeitfensterverletzung tritt auf, wenn eine Route nach dem Schließen eines Zeitfensters einen Auftrag, ein Depot oder eine Unterbrechung erreicht. Als Verletzung ist das Intervall zwischen dem Ende des Zeitfensters und der Ankunftszeit einer Route definiert. Nachfolgend finden Sie eine Liste der möglichen Werte:
| String |
useHierarchy (Lesen und schreiben) | Steuert die Verwendung des Hierarchieattributs während der Durchführung der Analyse. Nachfolgend finden Sie eine Liste der möglichen Werte:
| String |
uTurns (Lesen und schreiben) | Ermöglicht das Abrufen oder Festlegen der Richtlinie, die angibt, wie der Solver Wenden an Knoten, die beim Durchlaufen des Netzwerks zwischen Stopps auftreten können, verarbeitet. Nachfolgend finden Sie eine Liste der möglichen Werte:
| String |
Codebeispiel
The script shows how to update the Distance Attribute, Default Date, U-Turns at Junctions, and Output Shape Type properties for an existing vehicle routing problem layer in the ArcMap table of contents. It assumes that a vehicle routing problem layer called Store Delivery Routes has been created in a new map document based on the tutorial network dataset of the San Francisco region.
#Get the vehicle routing problem layer object from a layer named
#"Store Delivery Routes" in the table of contents
vrpLayer = arcpy.mapping.Layer("Store Delivery Routes")
#Get the solver properties object from the vehicle routing problem layer
solverProps = arcpy.na.GetSolverProperties(vrpLayer)
#Update the properties for the vehicle routing problem layer using the
#solver properties object
solverProps.distanceAttribute = "Meters"
#Set the default date to be Monday
solverProps.defaultDate = datetime.date(1900,1,1)
solverProps.uTurns = "NO_UTURNS"
solverProps.outputPathShape = "STRAIGHT_LINES"