ClosestFacilitySolverProperties (arcpy.na)

Zusammenfassung

Provides access to analysis properties from a closest facility network analysis layer. The GetSolverProperties function is used to obtain a ClosestFacilitySolverProperties object from a closest facility network analysis layer.

Diskussion

The ClosestFacilitySolverProperties object provides read and write access to all the analysis properties of a closest facility network analysis layer. The object can be used to modify the desired analysis properties of the closest facility layer, and the corresponding layer can be re-solved to determine the appropriate results. A new closest facility layer can be created using the Make Closest Facility Layer geoprocessing tool. Obtaining the ClosestFacilitySolverProperties object from a new closest facility 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 ClosestFacilitySolverProperties 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, bei dem der Solver die Suche nach Einrichtungen für ein gegebenes Ereignis beendet. Durch den Wert None wird festgelegt, dass keine Grenzwerte verwendet werden sollen.	Double
defaultTargetFacilityCount (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen der Anzahl der nächstgelegenen Einrichtungen, die pro Ereignis 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 nächstgelegenen Einrichtung und der optimalen Route zur nächstgelegenen Einrichtung minimiert.	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: TRUE_LINES_WITH_MEASURES —Die Ausgaberouten weisen die exakte Form der zugrunde liegenden Netzwerkquellen auf. Die Ausgabe umfasst zudem Routenmesswerte für die lineare Referenzierung. Die Messwerte nehmen ab dem ersten Halt zu und zeichnen die kumulierte Impedanz zum Erreichen einer definierten Position auf. TRUE_LINES_WITHOUT_MEASURES —Die Ausgaberouten weisen die exakte Form der zugrunde liegenden Netzwerkquellen auf. STRAIGHT_LINES —Das Ausgaberouten-Shape ist eine einzelne gerade Linie zwischen jedem einzelnen Ereignis-Einrichtungs-Paar. NO_LINES —Für die Ausgaberouten wird kein Shape erstellt.	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 Closest Facility Solver zurück, wenn der Zugriff über ein ClosestFacilitySolverProperties-Objekt erfolgt.	String
timeOfDay (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen der Uhrzeit und des Datums für den Beginn oder das Ende der Routen. Die Interpretation dieses Wertes hängt davon ab, ob die Eigenschaft timeOfDayUsage auf START_TIME oder END_TIME festgelegt ist. 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 um 8:00 Uhr am Montag beginnen oder enden soll, geben Sie den folgenden Wert an: datetime.datetime(1900, 1, 1, 8,0,0).	DateTime
timeOfDayUsage (Lesen und schreiben)	Steuert, ob der Wert der Eigenschaft timeOfDay die Ankunfts- oder Abfahrtszeiten für die Routen darstellt. Nachfolgend finden Sie eine Liste der möglichen Werte: END_TIME —Die Ankunftszeit für die Routen bei den Einrichtungen oder den Ereignissen entspricht Ihrer Einstellung unter der Eigenschaft timeOfDay. Diese Option empfiehlt sich, wenn die Ankunftszeit wichtiger ist, und Sie wissen möchten, wann von einem Ort abgefahren werden muss, um zu einem bestimmten Zeitpunkt am Ziel einzutreffen. START_TIME —Die Abfahrtszeit für die Routen bei den Einrichtungen oder den Ereignissen entspricht Ihrer Einstellung unter der Eigenschaft timeOfDay. Diese Option ist sinnvoll, um die optimalen Routen für eine bestimmte Abfahrtszeit zu ermitteln. NOT_USED —Für die Routen wird keine Abfahrts- oder Ankunftszeit verwendet. Diese Option ist sinnvoll, wenn für die Eigenschaft timeOfDay der Wert None festgelegt wurde.	String
travelDirection (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen der Fahrtrichtung zwischen Einrichtungen und Ereignissen während der Analyse. Nachfolgend finden Sie eine Liste der möglichen Werte: TRAVEL_FROM —Die Fahrtrichtung erfolgt von den Einrichtungen zu den Ereignissen. TRAVEL_TO —Die Fahrtrichtung erfolgt von den Ereignissen zu den Einrichtungen.	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: 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

ClosestFacilitySolverProperties example (Python window)

The script shows how to update a closest facility network analysis layer to find three facilities without using a cutoff value. It assumes that a closest facility layer called Closest Hospitals has been created in a new map document based on the tutorial network dataset for San Francisco region.

#Get the closest facility layer object from a layer named "Closest Hospitals" in
#the table of contents
cfLayer = arcpy.mapping.Layer("Closest Hospitals")

#Get the closest facility solver properties object from the closest facility layer
solverProps = arcpy.na.GetSolverProperties(cfLayer)

#Update the properties for the closest facility layer using the closest facility
#solver properties object
solverProps.defaultCutoff = None
solverProps.defaultTargetFacilityCount = 3