ODCostMatrixSolverProperties (arcpy.na)

Zusammenfassung

Provides access to analysis properties from an origin-destination (OD) cost matrix network analysis layer. The GetSolverProperties function is used to obtain an ODCostMatrixSolverProperties object from an OD cost matrix network analysis layer.

Diskussion

The ODCostMatrixSolverProperties object provides read and write access to all the analysis properties of an OD cost matrix network analysis layer. The object can be used to modify the desired analysis properties of the OD cost matrix layer, and the corresponding layer can be re-solved to determine the appropriate results. A new OD cost matrix layer can be created using the Make OD Cost Matrix Layer geoprocessing tool. Obtaining the ODCostMatrixSolverProperties object from a new OD cost matrix 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 on the ODCostMatrixSolverProperties 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
accumulators (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen einer Liste der Netzwerk-Kostenattribute, die als Teil der Analyse akkumuliert werden. Eine leere Liste, [], weist darauf hin, dass keine Kostenattribute akkumuliert werden.	String
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: #Don't attempt to modify the attributeParameters property in place. #This coding method won't work. solverProps.attributeParameters[('HeightRestriction', 'RestrictionUsage')] = "PROHIBITED" #Modify the attributeParameters property using a new dictionary object. #This coding method works. params = solverProps.attributeParameters params[('HeightRestriction', 'RestrictionUsage')] = "PROHIBITED" solverProps.attributeParameters = params Wenn der Netzwerkanalyse-Layer keine parametrierten Attribute aufweist, gibt diese Eigenschaft None zurück.	Dictionary
defaultCutoff (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen des Standardimpedanzwertes, an dem die Suche nach Zielen für einen angegebenen Ursprung abgebrochen wird. Durch den Wert None wird festgelegt, dass keine Grenzwerte verwendet werden sollen.	Double
defaultTargetDestinationCount (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen der Anzahl von Zielen, die für jeden Ursprung gesucht werden soll. Durch den Wert None wird festgelegt, dass alle Ziele gesucht werden sollen.	Integer
impedance (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen des als Impedanz verwendete Netzwerk-Kostenattributs. Dieses Kostenattribut wird während der Ermittlung der Routen zwischen Startpunkten (Ursprung) und Zielen minimiert.	String
outputPathShape (Lesen und schreiben)	Steuert, ob zwischen jedem Start-Ziel-Paar eine gerade Linie in der Start-Ziel-Kostenmatrix der Ausgabe generiert werden soll. Nachfolgend finden Sie eine Liste der möglichen Werte: NO_LINES —Zwischen den Start-Ziel-Paaren wird kein Shape generiert. Dies ist nützlich, wenn Sie über zahlreiche Startpunkte und Ziele verfügen und nur an der Start-Ziel-Kostenmatrixtabelle (und nicht den Ausgabe-Linien-Shapes) interessiert sind. STRAIGHT_LINES —Zwischen den einzelnen Start-Ziel-Paaren wird eine gerade Linie generiert.	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 Netzwerkanalyse-Layer referenziert wird, um das Eigenschaftenobjekt des Solvers zu erhalten. Die Eigenschaft gibt immer den Zeichenfolgenwert OD Cost Matrix Solver zurück, wenn der Zugriff über ein ODCostMatrixSolverProperties-Objekt erfolgt.	String
timeOfDay (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen des Datums und der Uhrzeit der Abfahrt von den Startpunkten. Durch den Wert None kann festgelegt werden, dass keine Datums- und Uhrzeitangaben verwendet werden sollen. Statt ein bestimmtes Datum zu verwenden, kann ein Wochentag mithilfe der folgenden Datumsangaben angegeben werden: Heute – 30.12.1899 Sonntag – 31.12.1899 Montag – 1.1.1900 Dienstag – 2.1.1900 Mittwoch – 3.1.1900 Donnerstag – 4.1.1900 Freitag – 5.1.1900 Samstag – 6.1.1900 Wenn Sie beispielsweise festlegen möchten, dass die Route von jedem Startpunkt um 8:00 Uhr am Mittwoch beginnen soll, geben Sie den folgenden Wert an: datetime.datetime(1900, 1, 3, 8,0,0).	DateTime
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: USE_HIERARCHY — Verwenden Sie das Hierarchieattribut für die Analyse. Wenn eine Hierarchie verwendet wird, werden vom Solver Kanten einer höheren Rangstufe gegenüber Kanten niedrigerer Rangstufen bevorzugt. Hierarchische Berechnungen sind schneller und können verwendet werden, um die Präferenzen eines Fahrers auf der Straße zu simulieren, der – wenn möglich – lieber auf Autobahnen statt auf Landstraßen fährt, selbst wenn die Fahrstrecke dann länger ist. Diese Option ist nur verfügbar, wenn das Netzwerk-Dataset, auf das vom ArcGIS Network Analyst-Layer verwiesen wird, über ein Hierarchieattribut verfügt. Diese Option kann auch über den Wert True festgelegt werden. NO_HIERARCHY —Verwenden Sie das Hierarchieattribut nicht für die Analyse. Wird keine Hierarchie verwendet, dann wird eine genaue Route für das Netzwerk-Dataset berechnet. Diese Option kann auch über den Wert False festgelegt werden.	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: ALLOW_UTURNS —Wenden sind an Knoten mit einer beliebigen Anzahl verbundener Kanten erlaubt. NO_UTURNS —Wenden sind an allen Knoten verboten, unabhängig von der Valenz der Knoten. Beachten Sie, dass Wenden an Netzwerkstandorten auch dann erlaubt sind, wenn diese Einstellung ausgewählt wurde. Sie können jedoch die Eigenschaft "CurbApproach" der einzelnen Netzwerkstandorte festlegen, um auch hier Wenden zu verbieten. ALLOW_DEAD_ENDS_ONLY —Wenden sind an allen Knoten verboten, außer es ist nur eine angrenzende Kante vorhanden (Sackgasse). ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —Wenden sind an Knoten verboten, an denen genau zwei angrenzende Kanten aufeinander treffen, jedoch an Kreuzungen (Knoten mit drei oder mehr angrenzenden Kanten) und in Sackgassen (Knoten mit genau einer angrenzenden Kante) erlaubt. Oftmals verfügen Netzwerke über unwesentliche Knoten in der Mitte von Straßensegmenten. Durch diese Option wird verhindert, dass Fahrzeuge an diesen Punkten wenden.	String

Codebeispiel

ODCostMatrixSolverProperties example (Python window)

The script shows how to update an OD cost matrix network analysis layer to find all destinations within a five-minute cutoff value. It assumes that an OD cost matrix layer called Store Accessibility has been created in a new map document based on the tutorial network dataset for San Francisco region.

#Get the OD cost matrix layer object from a layer named "Store Accessibility" in
#the table of contents
odLayer = arcpy.mapping.Layer("Store Accessibility")

#Get the solver properties object from the OD cost matrix layer
solverProps = arcpy.na.GetSolverProperties(odLayer)

#Update the properties for the OD cost matrix layer using the solver properties
#object
solverProps.defaultCutoff = 5
solverProps.defaultTargetDestinationCount = None