Mit der Network Analyst-Lizenz verfügbar.
Zusammenfassung
Erstellt eine Datei mit räumlicher Gewichtungsmatrix (.swm) unter Verwendung eines Netzwerk-Datasets, wobei die räumlichen Beziehungen zwischen Features in Bezug auf die zugrunde liegende Netzwerkstruktur definiert werden.
Ältere Versionen:
Dies ist ein veraltetes Werkzeug. Es wurde ein neues Werkzeug mit Verbesserungen und neuen Funktionen erstellt. Beispielsweise werden nun Netzwerke aus Portal-Services akzeptiert. Weitere Informationen finden Sie unter dem aktualisierten Werkzeug Räumliche Gewichtungsmatrix des Netzwerks generieren.
Abbildung
Verwendung
-
Die Ausgabe dieses Werkzeugs ist eine Datei mit räumlicher Gewichtungsmatrix (.swm). Werkzeuge, die erfordern, dass Sie eine Option für die Konzeptualisierung von räumlichen Beziehungen angeben, akzeptieren Dateien mit räumlicher Gewichtungsmatrix. Wählen Sie GET_SPATIAL_WEIGHTS_FROM_FILE für den Parameter Konzeptualisierung von räumlichen Beziehungen aus, und geben Sie für den Parameter Gewichtungsmatrix-Datei den vollständigen Pfad zur Datei mit der räumlichen Gewichtungsmatrix an, die mit diesem Werkzeug erstellt wurde.
-
Dieses Werkzeug wurde ausschließlich für die Verwendung mit Punktdaten der Eingabe-Feature-Class konzipiert.
-
Mit einer räumlichen Gewichtungsmatrix können die räumlichen Beziehungen zwischen den Features in Ihrem Dataset quantifiziert werden. Zahlreiche Werkzeuge der Toolbox "Spatial Statistics" werten einzelne Features im Kontext ihrer benachbarten Features aus. Mit einer Datei mit räumlicher Gewichtungsmatrix werden diese Nachbarbeziehungen definiert. Bei diesem Werkzeug werden die Nachbarbeziehungen in den Fällen, in denen die Fahrstrecken auf ein Netzwerk beschränkt sind, auf Zeit oder Entfernung zwischen den Features basiert. Weitere Informationen zu räumlichen Gewichtungen und Dateien mit räumlicher Gewichtungsmatrix finden Sie unter "Räumliche Gewichtungen".
-
Das Feld Eindeutige ID ist mit Feature-Beziehungen verknüpft, die von der Ausführung dieses Werkzeugs abgeleitet werden. Infolgedessen müssen die Werte unter Eindeutige ID für jedes Feature eindeutig sein und in einem permanenten Feld vorgehalten werden, das bei der Feature-Class verbleibt. Falls kein Feld für eindeutige IDs vorhanden ist, können Sie dieses erstellen, indem Sie der Feature-Class-Tabelle ein neues ganzzahliges Feld hinzufügen (Feld hinzufügen). Berechnen Sie die Feldwerte so, dass sie dem Feld FID oder OBJECTID entsprechen (Feld berechnen). Da sich die Feldwerte für FID und OBJECTID ändern können, wenn Sie eine Feature-Class kopieren oder bearbeiten, können Sie diese Felder nicht direkt für den Parameter Eindeutige ID verwenden.
-
Mit dem Parameter Maximale Anzahl von Nachbarn wird die exakte Anzahl an Nachbarn angegeben, die jedem Feature zugeordnet wird. Mit dem Impedanzgrenzwert wird der Parameter der Nachbaranzahl überschrieben, sodass einige Features unter Umständen weniger Nachbarn aufweisen, wenn die angegebene Anzahl an Nachbarn nicht innerhalb der Grenzwert-Entfernung oder -Zeit gefunden werden kann.
-
Sie können mit dem Parameter Hierarchie bei Analyse verwenden räumliche Beziehungen mithilfe der Hierarchie im Netzwerk-Dataset definieren, sofern vorhanden. In der Hierarchie werden die Netzwerkkanten in Haupt-, Neben- und Ortsstraßen aufgeteilt. Bei Verwendung der Hierarchie des Netzwerks zum Erstellen räumlicher Beziehungen zwischen Features wird den Strecken auf Hauptstraßen der Vorzug vor Nebenstraßen und den Strecken auf Nebenstraßen der Vorzug vor Ortsstraßen gegeben.
Wenn Sie vordefinierte Netzwerk-Datasets von Street Map Premium for ArcGIS nutzen, die einen Reisemodus verwenden, sind einige Parameteroptionen möglicherweise vorab ausgefüllt und lassen sich nicht ändern.
-
Dieses Werkzeug berücksichtigt nicht die Umgebungseinstellung des Ausgabe-Koordinatensystems. Die gesamte Feature-Geometrie wird vor der Analyse projiziert, um dem Raumbezug zu entsprechen, der mit dem Netzwerk-Dataset verknüpft ist. Die Datei mit räumlicher Gewichtungsmatrix, die von diesem Werkzeug erstellt wird, gibt die räumlichen Beziehungen wieder, die mit dem Raumbezug des Netzwerk-Datasets definiert wurden. Es wird beim Durchführen von Analysen mit einer auf einem Netzwerk basierenden Datei mit räumlicher Gewichtungsmatrix empfohlen, dass die Eingabe-Feature-Class so projiziert wird, dass sie dem Koordinatensystem des Netzwerk-Datasets entspricht, mit dem die Netzwerk-SWM-Datei erstellt wurde.
Tipp:
Viele Organisationen verwalten ihre eigenen Straßennetz-Datasets, auf die Sie bereits zugreifen können. Alternativ beinhaltet Street Map Premium for ArcGIS vordefinierte Netzwerk-Datasets im SDC-Format, die Nordamerika, Lateinamerika, Europa, den Nahen Osten, Afrika, Japan, Australien und Neuseeland umfassen. Diese Netzwerk-Datasets können von diesem Werkzeug direkt verwendet werden.
Vorsicht:
Denken Sie beim Verwenden von Shapefiles daran, dass diese keine NULL-Werte speichern können. Werkzeuge oder andere Verfahren zur Erstellung von Shapefiles aus Nicht-Shapefile-Eingaben speichern oder interpretieren NULL-Werte möglicherweise als Wert 0. In manchen Fällen werden NULL-Werte in Shapefiles als sehr große negative Werte gespeichert. Dies kann zu unerwarteten Ergebnissen führen. Weitere Informationen finden Sie unter "Überlegungen zur Geoverarbeitung für die Shapefile-Ausgabe".
Syntax
arcpy.stats.GenerateNetworkSpatialWeights(Input_Feature_Class, Unique_ID_Field, Output_Spatial_Weights_Matrix_File, Input_Network, Impedance_Attribute, {Impedance_Cutoff}, {Maximum_Number_of_Neighbors}, {Barriers}, {U-turn_Policy}, {Restrictions}, {Use_Hierarchy_in_Analysis}, {Search_Tolerance}, {Conceptualization_of_Spatial_Relationships}, {Exponent}, {Row_Standardization}, {Travel_Mode}, {Time_of_Day})
Parameter | Erklärung | Datentyp |
Input_Feature_Class | Die Punkt-Feature-Class, für die die räumlichen Netzwerkbeziehungen zwischen Features bewertet werden. | Feature Class |
Unique_ID_Field | Ein Ganzzahlfeld, das für jedes Feature in der Eingabe-Feature-Class einen anderen Wert enthält. Falls kein Feld für eindeutige IDs vorhanden ist, können Sie dieses erstellen, indem Sie der Feature-Class-Tabelle ein ganzzahliges Feld hinzufügen. Berechnen Sie die Feldwerte so, dass sie dem Feld FID oder OBJECTID entsprechen. | Field |
Output_Spatial_Weights_Matrix_File | Die Ausgabe-Datei der räumlichen Gewichtungsmatrix (.swm). | File |
Input_Network | Das Netzwerk-Dataset, für das die räumlichen Beziehungen zwischen Features in der Eingabe-Feature-Class definiert werden. Netzwerk-Datasets stellen meist Straßennetze dar; es kann sich dabei jedoch auch um andere Transportnetze handeln. Das Netzwerk-Dataset muss mindestens über ein zeitbasiertes und ein entfernungsbasiertes Kostenattribut verfügen. | Network Dataset Layer |
Impedance_Attribute | Der Kosteneinheitentyp, der als Impedanz in der Analyse verwendet werden soll. | String |
Impedance_Cutoff (optional) | Gibt einen Grenzwert für die INVERSE- und FIXED-Konzeptualisierungen von räumlichen Beziehungen an. Geben Sie diesen Wert in den Einheiten ein, die für den Parameter Impedance_Attribute angegeben wurden. Der Wert 0 gibt an, dass kein Schwellenwert angewendet wird. Ist dieser Parameter leer, wird ein Standardschwellenwert basierend auf der Ausdehnung der Eingabe-Feature-Class und der Anzahl von Features berechnet. | Double |
Maximum_Number_of_Neighbors (optional) | Eine ganze Zahl, die die maximale Anzahl an Nachbarn angibt, die für jedes Feature gefunden werden kann. | Long |
Barriers (optional) | Der Name einer Punkt-Feature-Class mit Features, die gesperrte Kreuzungen oder Straßen, Unfallorte oder andere Orte darstellen, an denen die Fahrt entlang des Netzwerks nicht fortgesetzt werden kann. | Feature Layer |
U-turn_Policy (optional) | Gibt optionale Beschränkungen für Wenden an.
| String |
Restrictions [Restriction,...] (optional) | Eine Liste mit Beschränkungen. Aktivieren Sie alle Beschränkungen, die in Berechnungen für räumliche Beziehungen gelten sollen. | String |
Use_Hierarchy_in_Analysis (optional) | Gibt an, ob in der Analyse eine Hierarchie verwendet werden soll.
| Boolean |
Search_Tolerance (optional) | Der Suchschwellenwert, der beim Lokalisieren von Features der Input_Feature_Class im Netzwerk-Dataset verwendet wird. Dieser Parameter umfasst einen Suchwert und die Einheiten für die Toleranz. | Linear Unit |
Conceptualization_of_Spatial_Relationships (optional) | Gibt an, wie die mit jeder räumlichen Beziehung verknüpfte Gewichtung angegeben wird.
| String |
Exponent (optional) | Parameter für die Berechnung der INVERSE Conceptualization_of_Spatial_Relationships. Typische Werte sind 1 oder 2. Die Gewichtungen sinken umso schneller in Abhängigkeit von der Entfernung, je größer dieser Exponentialwert ist. | Double |
Row_Standardization (optional) | Gibt an, ob Reihen-Standardisierung angewendet wird. Eine Reihen-Standardisierung wird immer dann empfohlen, wenn die Verteilung der Features aufgrund eines Referenzpunktschemas oder eines auferlegten Aggregationsschemas möglicherweise verzerrt ist.
| Boolean |
Travel_Mode (optional) | Der Transportmodus für die Analyse. Benutzerdefiniert kann immer ausgewählt werden. Um andere Reisemodi anzuzeigen, müssen sie in dem Netzwerk-Dataset vorhanden sein, das im Parameter Netzwerk-Dataset angegeben wurde. Ein Reisemodus wird in einem Netzwerk-Dataset definiert und stellt Override-Werte für Parameter bereit, die Reisemodi wie Auto, Lkw, Fußgänger usw. modellieren. | String |
Time_of_Day (optional) | Legt fest, ob Reisezeiten Verkehrsbedingungen berücksichtigen sollen. Verkehrsbedingungen können insbesondere in städtischen Gebieten erhebliche Auswirkungen auf das innerhalb einer angegebenen Reisezeit abgedeckte Gebiet haben. Wenn weder Datum noch Zeit angegeben werden, wird die während einer angegebenen Reisezeit festgelegte Entfernung nicht vom Verkehr beeinflusst. | Date |
Codebeispiel
Das folgende Skript veranschaulicht die Verwendung des Werkzeugs GenerateNetworkSpatialWeights im Python-Fenster.
import arcpy
arcpy.env.workspace = "c:/data"
arpcy.GenerateNetworkSpatialWeights_stats("Hospital.shp", "MyID",
"network6Neighs.swm", "Streets_ND",
"MINUTES", 10, 6, "#", "ALLOW_UTURNS",
"#", "USE_HIERARCHY", "#", "INVERSE",
1, "ROW_STANDARDIZATION")
Das folgende eigenständige Python-Skript veranschaulicht, wie Sie das Werkzeug GenerateNetworkSpatialWeights verwenden.
# Create a Spatial Weights Matrix based on Network Data
# Import system modules
import arcpy
# Set the environment property to overwrite existing output
arcpy.env.overwriteOutput = True
# Check out the Erweiterung "ArcGIS Network Analyst" (required for the Generate Network Spatial Weights tool)
arcpy.CheckOutExtension("Network")
# Local variables...
workspace = r"C:\Data"
try:
# Set the current workspace (to avoid having to specify the full path to
# the feature classes each time)
arcpy.env.workspace = workspace
# Create Spatial Weights Matrix based on Network Data
# Process: Generate Network Spatial Weights...
nwm = arcpy.GenerateNetworkSpatialWeights_stats("Hospital.shp", "MyID",
"network6Neighs.swm", "Streets_ND",
"MINUTES", 10, 6, "#", "ALLOW_UTURNS",
"#", "USE_HIERARCHY", "#", "INVERSE",
1, "ROW_STANDARDIZATION")
# Create Spatial Weights Matrix based on Euclidean Distance
# Process: Generate Spatial Weights Matrix...
swm = arcpy.GenerateSpatialWeightsMatrix_stats("Hospital.shp", "MYID",
"euclidean6Neighs.swm",
"K_NEAREST_NEIGHBORS",
"#", "#", "#", 6)
# Calculate Moran's Index of Spatial Autocorrelation for
# average hospital visit times using Network Spatial Weights
# Process: Spatial Autocorrelation (Morans I)...
moransINet = arcpy.SpatialAutocorrelation_stats("Hospital.shp", "VisitTime",
"NO_REPORT", "GET_SPATIAL_WEIGHTS_FROM_FILE",
"EUCLIDEAN_DISTANCE", "NONE", "#",
"network6Neighs.swm")
# Calculate Moran's Index of Spatial Autocorrelation for
# average hospital visit times using Euclidean Spatial Weights
# Process: Spatial Autocorrelation (Morans I)...
moransIEuc = arcpy.SpatialAutocorrelation_stats("Hospital.shp", "VisitTime",
"NO_REPORT", "GET_SPATIAL_WEIGHTS_FROM_FILE",
"EUCLIDEAN_DISTANCE", "NONE", "#",
"euclidean6Neighs.swm")
except:
# If an error occurred when running the tool, print out the error message.
print arcpy.GetMessages()
Umgebungen
Lizenzinformationen
- Basic: Erfordert Network Analyst
- Standard: Erfordert Network Analyst
- Advanced: Erfordert Network Analyst