ServiceAreaSolverProperties (arcpy.na)

Zusammenfassung

Provides access to analysis properties from a service area network analysis layer. The GetSolverProperties function is used to obtain a ServiceAreaSolverProperties object from a service area network analysis layer.

Diskussion

The ServiceAreaSolverProperties object provides read and write access to all the analysis properties of a service area network analysis layer. The object can be used to modify the desired analysis properties of the service area layer, and the corresponding layer can be re-solved to determine the appropriate results. A new service area layer can be created using the Make Service Area Layer geoprocessing tool. Obtaining the ServiceAreaSolverProperties object from a new service area 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 ServiceAreaSolverProperties 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
defaultBreaks (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen des Impedanzwertes, der die Ausdehnung des zu berechnenden Einzugsgebiets angibt. Es können mehrere Polygonunterbrechungen festgelegt werden, um konzentrische Einzugsgebiete zu erstellen. Wenn Sie zum Beispiel 2-, 3- und 5-Minuten-Einzugsgebiete für dieselbe Einrichtung ermitteln möchten, geben Sie den folgenden Wert an: [2,3, 5].	Double
excludeSources (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen der Liste an Netzwerkquellen, die beim Generieren der Polygone ausgeschlossen werden sollen. Die Geometrie der durchlaufenen Elemente von den ausgeschlossenen Quellen wird aus allen Polygonen entfernt. Eine leere Liste, [], weist darauf hin, dass keine Netzwerkquellen ausgeschlossen werden.	String
impedance (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen des als Impedanz verwendete Netzwerk-Kostenattributs. Dieses Kostenattribut wird während der Ermittlung des Einzugsgebiets akkumuliert.	String
includeNetworkSourceFields (Lesen und schreiben)	Steuert, ob den Einzugsgebietslinien zusätzliche Felder aus den zugrunde liegenden Quell-Features hinzugefügt werden, die während der Analyse durchlaufen werden. Nachfolgend finden Sie eine Liste der möglichen Werte: LINES_SOURCE_FIELDS — Fügen Sie den Einzugsgebietslinien die Felder "SourceID", "SourceOID", "FromPosition" und "ToPosition" hinzu, um Informationen zu den zugrunde liegenden Quell-Features bereitzustellen, die während der Analyse durchlaufen werden. Dies kann hilfreich sein, um die Ergebnisse der Einzugsgebietslinien problemlos mit den ursprünglichen Quelldaten zusammenzuführen. Diese Option kann auch über den Wert True festgelegt werden. NO_LINES_SOURCE_FIELDS —Fügen Sie den Einzugsgebietslinien keine Quellenfelder (SourceID, SourceOID, FromPosition und ToPosition) hinzu. Diese Option kann auch über den Wert False festgelegt werden.	String
lineOverlap (Lesen und schreiben)	Steuert, ob bei der Berechnung von Einzugsgebietslinien Überschneidungslinien generiert werden. Nachfolgend finden Sie eine Liste der möglichen Werte: OVERLAP — Es wird ein separates Linien-Feature für jede Einrichtung eingeschlossen, wenn die Einrichtungen Einzugsgebietslinien haben, die lagegleich sind. Diese Option kann auch über den Wert True festgelegt werden. NON_OVERLAP — Jede Einzugsgebietslinie wird einmal eingeschlossen und ist jeweils mit der am nächsten gelegenen Einrichtung (geringster Impedanzwert) verknüpft. Diese Option kann auch über den Wert False festgelegt werden.	String
lineType (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen des Linientyps für das Einzugsgebiet, der bei der Analyse generiert werden soll. Nachfolgend finden Sie eine Liste der möglichen Werte: NO_LINES —Es werden keine Linien generiert. TRUE_LINES —Linien werden ohne Messwerte generiert. TRUE_LINES_WITH_MEASURES —Linien werden mit Messwerten generiert. Die Messwerte werden auf der Grundlage des Impedanzwertes an jedem Ende der Kante mit den interpolierten Zwischenstützpunkten generiert. Es empfiehlt sich nicht, diese Option zu verwenden, wenn eine höhere Performance gewünscht wird.	String
polygonMerge (Lesen und schreiben)	Steuert, ob Polygone zusammengeführt werden, für die ähnliche Unterbrechungswerte angegeben sind. Diese Option ist nur beim Generieren von Polygonen für mehrere Einrichtungen anwendbar. Nachfolgend finden Sie eine Liste der möglichen Werte: NO_MERGE —Erstellt für jede Einrichtung ein eigenes Polygon. Die Polygone können dabei überlappen. NO_OVERLAP —Erstellt für jede Einrichtung ein eigenes, jeweils am nächsten gelegenes Polygon. Die Polygone überlappen sich dabei nicht. MERGE — Verbindet die Polygone mehrerer Einrichtungen, die über den gleichen Unterbrechungswert verfügen.	String
polygonNesting (Lesen und schreiben)	Steuert, ob konzentrische Einzugsgebiet-Polygone als Scheiben oder als Ringe erstellt werden. Diese Option ist nur anwendbar, wenn mehrere Unterbrechungswerte für die Einrichtungen angegeben werden. Nachfolgend finden Sie eine Liste der möglichen Werte: RINGS —Die Fläche der kleineren Unterbrechungen wird nicht mit eingeschlossen. Dadurch werden Polygone erstellt, die durch aufeinander folgende Unterbrechungen verlaufen. Verwenden Sie diese Option, wenn Sie die Fläche zwischen zwei Unterbrechungen ermitteln möchten. Diese Option kann auch über den Wert True festgelegt werden. DISKS — Erstellt Polygone von der Einrichtung in Richtung der Unterbrechung. Beim Erstellen von 5- und 10-Minuten-Einzugsgebieten schließt das 10-Minuten-Einzugsgebiet-Polygon beispielsweise die Fläche des 5-Minuten-Einzugsgebiet-Polygons ein. Verwenden Sie diese Option, wenn Sie die gesamte Fläche von der Einrichtung bis zur Unterbrechung für jede einzelne Unterbrechung ermitteln möchten. Diese Option kann auch über den Wert False festgelegt werden.	String
polygonType (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen des Polygontyps, der generiert werden soll. Nachfolgend finden Sie eine Liste der möglichen Werte: SIMPLE_POLYS —Erstellt generalisierte Polygone. Diese können schnell erstellt werden und sind mit Ausnahme der Randbereiche recht genau. DETAILED_POLYS —Erstellt detaillierte Polygone. Diese stellen die Einzugsgebietslinien genau dar und können außerdem Inseln enthalten, die nicht abgedeckte Bereiche darstellen. Für diese Option wird deutlich mehr Zeit benötigt als für das Erstellen von generalisierten Polygonen. NO_POLYS —Deaktiviert die Polygonerstellung in Fällen, in denen nur Linien für das Einzugsgebiet gewünscht werden.	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 Service Area Solver zurück, wenn der Zugriff über ein ServiceAreaSolverProperties-Objekt erfolgt.	String
splitLinesAtBreaks (Lesen und schreiben)	Steuert, ob Einzugsgebietslinien geteilt werden, wenn sie einen Unterbrechungswert überschreiten. Nachfolgend finden Sie eine Liste der möglichen Werte: SPLIT —Linien zwischen zwei Unterbrechungen werden jeweils in zwei Linien geteilt, die dann in der jeweiligen Unterbrechung liegen. Dies ist nützlich, wenn Sie die Einzugsgebietslinien nach Unterbrechungen darstellen möchten. Anderenfalls verwenden Sie für eine optimale Performance die Option NO_SPLIT. NO_SPLIT —Die Linien werden an den Grenzen der Unterbrechungen nicht geteilt.	String
timeOfDay (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen der Abfahrtszeit von oder der Ankunftszeit bei den Einrichtungen. Die Interpretation dieses Wertes hängt davon ab, ob die Fahrt zu der Einrichtung hin oder von der Einrichtung weg führt. Wenn die Eigenschaft travelDirection auf TRAVEL_FROM gesetzt ist, gibt dies die Abfahrtszeit an, und wenn die Eigenschaft travelDirection auf TRAVEL_TO gesetzt ist, gibt dies die Ankunftszeit an. 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 Abfahrt von den Einrichtungen um 8:00 Uhr am Freitag erfolgen soll, geben Sie den folgenden Wert an: datetime.datetime(1900, 1, 5, 8,0,0).	DateTime
travelDirection (Lesen und schreiben)	Steuert die Richtung, in der die Impedanz während der Einzugsgebiet-Analyse akkumuliert wird. Nachfolgend finden Sie eine Liste der möglichen Werte: TRAVEL_FROM —Das Einzugsgebiet wird in der Fahrtrichtung weg von den Einrichtungen erstellt. TRAVEL_TO —Das Einzugsgebiet wird in der Fahrtrichtung hin zu den Einrichtungen erstellt.	String
trimDistance (Lesen und schreiben)	Ermöglicht das Abrufen oder Festlegen der Entfernung, in der die Einzugsgebiet-Polygone gekürzt werden. Der Eigenschaftswert umfasst einen numerischen Wert und eine Einheit für die Entfernung (durch Leerzeichen getrennt). Wenn beispielsweise für das Kürzen der Entfernung 100 Meter festgelegt werden soll, muss die Eingabe "100 Meters" lauten.	String
trimPolygons (Lesen und schreiben)	Steuert, ob die Einzugsgebiet-Polygone gekürzt werden. Nachfolgend finden Sie eine Liste der möglichen Werte: TRIM_POLYS —Kürzt die Polygone mit den Kanten an den Grenzen des Einzugsgebiets so weit, dass sie sich innerhalb der angegebenen Entfernung dieser äußeren Kanten befinden. Dies ist nützlich, wenn die Feature-Dichte im Netzwerk sehr gering ist und das Einzugsgebiet keine große Flächen ohne Features abdecken soll. Diese Option kann auch über den Wert True festgelegt werden. NO_TRIM_POLYS —Polygone werden nicht gekürzt. Diese Option kann auch über den Wert False festgelegt werden.	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

ServiceAreaSolverProperties example (Python window)

The script shows how to update a service area network analysis layer to use hierarchy and set 5, 10, and 15 minutes as the break values. It assumes that a service area layer called Store Trade Areas has been created in a new map document based on the tutorial network dataset for San Francisco region.

#Get the service area layer object from a layer named "Store Trade Areas" in
#the table of contents
saLayer = arcpy.mapping.Layer("Store Trade Areas")

#Get the solver properties object from the service area layer
solverProps = arcpy.na.GetSolverProperties(saLayer)

#Update the properties for the service area layer using the solver properties
#object
solverProps.defaultBreaks = [5, 10, 15]
solverProps.useHierarchy = "USE_HIERARCHY"