Beschriftung | Erläuterung | Datentyp |
Eingabe-Feature-Class | Die Feature-Class, für die die räumlichen Beziehungen zwischen Features bewertet werden. | Feature Class |
Eindeutiges ID-Feld | 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 |
Ausgabe-Datei der räumlichen Gewichtungsmatrix | Der vollständige Pfad für die Ausgabe-Datei mit der räumlichen Gewichtungsmatrix (.swm). | File |
Konzeptualisierung von räumlichen Beziehungen | Gibt an, wie räumliche Beziehungen zwischen Features konzeptualisiert werden.
| String |
Entfernungsmethode (optional) | Gibt an, wie Entfernungen von den einzelnen Features zu benachbarten Features berechnet werden.
| String |
Exponent (optional) | Der Wert für die Berechnung der inversen Entfernung. Ein typischer Wert ist 1 oder 2. | Double |
Entfernungsschwellenwert (optional) | Der Entfernungsgrenzwert für die Optionen Inverse Entfernung und Feste Entfernung des Parameters Konzeptualisierung von räumlichen Beziehungen. Dieser Wert sollte in den Einheiten des Ausgabe-Koordinatensystems der Umgebung eingegeben werden. Damit wird die Größe des Raumfensters für die Option Raum-Zeit-Fenster festgelegt. Ist dieser Parameter leer, wird ein Standardschwellenwert basierend auf der Ausdehnung der Ausgabe-Feature-Class und der Anzahl von Features berechnet. Bei der Konzeptualisierung von räumlichen Beziehungen mit inverser Entfernung gibt der Wert Null an, dass kein Entfernungsschwellenwert angewendet wird und alle Features Nachbarn jedes anderen Features sind. | Double |
Anzahl der Nachbarn (optional) | Eine Ganzzahl, die die minimale oder genaue Anzahl an Nachbarn angibt. Wenn für den Parameter Konzeptualisierung von räumlichen Beziehungen die Option Nächste Nachbarn (K) festgelegt ist, hat jedes Feature exakt diese angegebene Anzahl von Nachbarn. Bei der Option Inverse Entfernung oder Feste Entfernung hat jedes Feature mindestens diese Anzahl von Nachbarn (der Entfernungsgrenzwert wird zum Erreichen dieser Nachbaranzahl bei Bedarf vorübergehend erweitert). Bei Auswahl der Option Nur benachbarte Kanten oder Benachbarte Kanten und Ecken wird jedem Polygon diese minimale Anzahl von Nachbarn zugewiesen. Für Polygone mit einer geringeren Anzahl von zusammenhängenden Nachbarn basieren zusätzliche Nachbarn auf der Nachbarschaft von Feature-Schwerpunkten. | Long |
Reihen-Standardisierung (optional) | Gibt an, ob räumliche Gewichtungen nach Zeile standardisiert werden. Eine Reihen-Standardisierung wird immer dann empfohlen, wenn die Verteilung der Features aufgrund eines Referenzpunktschemas oder eines auferlegten Aggregationsschemas möglicherweise verzerrt ist.
| Boolean |
Eingabetabelle (optional) | Eine Tabelle mit numerischen Gewichtungen, die Beziehungen zwischen allen Features in der Eingabe-Feature-Class herstellt. Erforderliche Felder für die Tabelle sind der Parameterwert Eindeutiges ID-Feld, NID (Nachbar-ID) und WEIGHT. | Table |
Datums-/Uhrzeitfeld (optional) | Ein Datumsfeld mit einem Zeitstempel für jedes Feature. | Field |
Intervalltyp von Datum/Uhrzeit (optional) | Gibt die zum Messen der Zeit verwendeten Einheiten an.
| String |
Intervallwert von Datum/Uhrzeit (optional) | Eine ganze Zahl, die die Anzahl an Zeiteinheiten wiedergibt, die das Zeitfenster bilden. Wenn Sie z. B. Stunden für den Parameter Intervalltyp von Datum/Uhrzeit auswählen und für den Parameter Intervallwert von Datum/Uhrzeit den Wert 3 angeben, beträgt das Zeitfenster 3 Stunden; Features, die sich innerhalb des Raum- und Zeitfensters befinden, sind Nachbarn. Wenn Sie z. B. HOURS für den Parameter Date_Time_Interval_Type auswählen und für den Parameter Date_Time_Interval_Value den Wert 3 angeben, beträgt das Zeitfenster 3 Stunden. Features, die sich innerhalb des angegebenen Raum- und Zeitfensters befinden, sind Nachbarn. | Long |
Z-Werte verwenden | Gibt an, ob Z-Koordinaten in der Konstruktion der räumlichen Gewichtungsmatrix verwendet werden, wenn die Eingabe-Features Z-aktiviert sind.
| Boolean |
Zusammenfassung
Hiermit wird eine Datei (.swm) mit einer räumlichen Gewichtungsmatrix generiert, die die räumlichen Beziehungen zwischen Features in einem Dataset wiedergibt.
Weitere Informationen zur Funktionsweise von Räumliche Gewichtungsmatrix erstellen
Abbildung
Verwendung
Die Ausgabe dieses Werkzeugs ist eine Datei mit räumlicher Gewichtungsmatrix (.swm). In Werkzeugen, in denen ein Wert für den Parameter Konzeptualisierung von räumlichen Beziehungen angegeben werden muss, wie z. B. im Werkzeug Hot-Spot-Analyse, ist eine Datei mit räumlicher Gewichtungsmatrix zulässig. Wählen Sie im Parameter Konzeptualisierung von räumlichen Beziehungen die Option Räumliche Gewichtungen aus Datei abrufen aus, und geben Sie den vollständigen Pfad zu der erstellten Datei mit räumlicher Gewichtungsmatrix an. Zu diesem Zweck verwenden Sie für den Parameter Gewichtungsmatrix-Datei dieses Werkzeug.
Dieses Werkzeug gibt auch die Merkmale der erstellten Datei mit räumlicher Gewichtungsmatrix wieder: Anzahl der Features, Konnektivität sowie minimale, maximale und durchschnittliche Anzahl an Nachbarn. Diese Zusammenfassung wird während der Ausführung des Werkzeugs als Meldungen unten im Bereich Geoverarbeitung geschrieben. Um auf die Meldungen zuzugreifen, zeigen Sie mit der Maus auf die Fortschrittsleiste, klicken Sie auf die Pop-out-Schaltfläche, oder erweitern Sie den Abschnitt "Meldungen" im Bereich Geoverarbeitung. Sie können auch auf die Meldungen für ein zuvor ausgeführtes Werkzeug über den Geoverarbeitungsverlauf zugreifen. Diese Zusammenfassung gibt an, ob alle Features mindestens einen Nachbarn aufweisen. Im Allgemeinen sind besonders bei großen Datasets eine Mindestzahl von acht Nachbarn und ein niedriger Wert für die Feature-Konnektivität am besten.
Wählen Sie bei Raum-Zeit-Analysen für den Parameter Konzeptualisierung von räumlichen Beziehungen die Option Raum-Zeit-Fenster aus. Raum definieren Sie über den Entfernungsschwellenwert, Zeit über einen Wert für Datums-/Uhrzeitfeld und einen Datums-/Uhrzeittyp (wie Stunden oder Tage) und einen Intervallwert von Datum/Uhrzeit. Der Wert des Parameters Intervallwert von Datum/Uhrzeit ist eine ganze Zahl. Wenn Sie z. B. 1000 Fuß eingeben, Stunden auswählen und als Wert Intervallwert von Datum/Uhrzeit 3 angeben, werden Features, die sich in einer Entfernung von 1.000 Fuß und drei Stunden voneinander befinden, als Nachbarn betrachtet.
Die Datei mit räumlicher Gewichtungsmatrix (.swm) dient dazu, die Konzeptualisierung der Beziehungen zwischen einer Gruppe von Features zu erstellen, zu speichern, für die Wiederverwendung bereitzustellen und freizugeben. Zur Verbesserung der Performance wird die Datei in einem binären Dateiformat erstellt. Feature-Beziehungen werden als dünnbesetzte Matrix gespeichert, sodass nur Nicht-Null-Beziehungen in die .swm-Datei geschrieben werden. Im Allgemeinen funktionieren die Werkzeuge immer noch einwandfrei, selbst wenn die .swm-Datei mehr als 15 Millionen Nicht-Null-Beziehungen enthält. Tritt jedoch ein Speicherfehler bei Verwendung der .swm-Datei auf, sollten Sie die Definition Ihrer Feature-Beziehungen überprüfen. Empfehlenswert ist eine Matrix mit einer räumlichen Gewichtung, bei der jedes Feature mindestens 1 Nachbarn hat, die meisten Features 8 Nachbarn haben und kein Feature mehr als 1.000 Nachbarn hat.
Lagegleiche Punkte werden nicht zur Berechnung des standardmäßigen Parameterwertes für Entfernungsschwellenwert verwendet.
Bei der Verwendung von Daten mit Koordinaten, die einen Z-Wert enthalten, ist der Parameterwert Entfernungsschwellenwert eine 3D-Entfernung.
Bei der Verwendung von Daten mit Koordinaten, die einen Z-Wert enthalten, werden vom Parameter Konzeptualisierung von räumlichen Beziehungen nur folgende Optionen unterstützt: Inverse Entfernung, Feste Entfernung, Nächste Nachbarn (K) und Raum-Zeit-Fenster.
Wenn der Parameterwert Eingabe-Feature-Class Z-aktiviert ist, müssen die linearen Einheiten des vertikalen Koordinatensystems (VKS) mit den linearen Einheiten des horizontalen Koordinatensystems übereinstimmen. Wenn der Parameterwert für Eingabe-Feature-Class nicht über ein VKS verfügt, wird angenommen, dass die vertikale lineare Einheit mit der horizontalen linearen Einheit identisch ist.
Wenn der Parameterwert für Eingabe-Feature-Class nicht projiziert wurde (d. h., wenn Koordinaten in Grad, Minuten und Sekunden angegeben werden) oder wenn als Ausgabe-Koordinatensystem ein geographisches Koordinatensystem festgelegt wurde, werden Entfernungen mit Sehnenmesswerten berechnet. Sehnenentfernungsmesswerte werden verwendet, weil sie schnell berechnet werden können und ausgezeichnete Schätzungen von echten geodätischen Entfernungen zulassen, zumindest für Punkte innerhalb von 30 Grad voneinander. Sehnenentfernungen basieren auf einem abgeplatteten Sphäroid. Im Fall von zwei beliebigen Punkten auf der Erdoberfläche ist die Sehnenentfernung zwischen diesen die Länge einer Linie, die durch die dreidimensionale Erde führt, um diese beiden Punkte zu verbinden. Sehnenentfernungen werden in Metern angegeben.
Vorsicht:
Achten Sie darauf, Ihre Daten zu projizieren, wenn sich der Untersuchungsbereich über 30 Grad hinaus erstreckt. Sehnenentfernungen erlauben keine sichere Schätzung von geodätischen Entfernungen über 30 Grad hinaus.
Wenn in der Analyse "Sehnenentfernungen" verwendet werden, sollte der Parameterwert für Entfernungsband (falls angegeben) in Metern angegeben werden.
-
Für Linien- und Polygon-Features werden bei Entfernungsberechnungen Feature-Schwerpunkte verwendet. Für Multipoints, Polylinien oder Polygone mit mehreren Teilen wird der Schwerpunkt mithilfe des gewichteten arithmetischen Mittelpunkts aller Feature-Teile berechnet. Die Gewichtung für Punkt-Features ist 1, für Linien-Features "Länge" und für Polygon-Features "Fläche".
Der Parameterwert für Eindeutiges ID-Feld ist mit Feature-Beziehungen verknüpft, die von der Ausführung dieses Werkzeugs abgeleitet werden. Infolgedessen müssen die Werte für Eindeutiges ID-Feld für jedes Feature eindeutig sein, und sie sollten in einem permanenten Feld enthalten sein, 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 Eindeutiges ID-Feld verwenden.
Bei INVERSE- und FIXED-Konzeptualisierungen von räumlichen Beziehungen kann der Parameter Anzahl der Nachbarn den Parameter für den Entfernungsschwellenwert überschreiben. Wenn Sie beispielsweise einen Entfernungsschwellenwert von 10 Meilen und für den Parameter Anzahl der Nachbarn den Wert 3 angeben, erhalten alle Features mindestens 3 Nachbarn, selbst wenn der Entfernungsschwellenwert erhöht werden muss, um sie zu finden. Der Entfernungsschwellenwert wird nur in Fällen erhöht, in denen die minimale Anzahl an Nachbarn nicht erreicht wird.
Mit der Option In Tabelle konvertieren für den Parameter Konzeptualisierung von räumlichen Beziehungen kann eine ASCII-Datei mit räumlicher Gewichtungsmatrix in eine SWM-formatierte Datei mit räumlicher Gewichtungsmatrix konvertiert werden. Fügen Sie als Erstes die ASCII-Gewichtungen in eine formatierte Tabelle ein (z. B. eine Excel-Tabelle).
Vorsicht:
Wenn Ihre Tabelle Gewichtungen für das Eigenpotenzial enthält, werden sie in der .swm-Ausgabedatei ausgelassen, und nur die standardmäßigen Eigenpotenzialwerte werden in Analysen verwendet. Der standardmäßige Eigenpotenzialwert für die Hot-Spot-Analyse ist 1, aber dieser Wert kann überschrieben werden, indem ein Wert im Eigenpotenzialfeld angegeben wird. Bei allen anderen Werkzeugen ist der standardmäßige Eigenpotenzialwert 0.
Aktivieren Sie für Polygon-Features den Parameter Reihen-Standardisierung. Die Reihen-Standardisierung verringert die Verzerrung, wenn die Anzahl der Nachbarn der einzelnen Features eine Funktion des Aggregationsschemas oder Sampling-Prozesses ist, und die tatsächliche räumliche Verteilung der analysierten Variable nicht widergespiegelt wird.
-
Das Hilfethema Modellierungen räumlicher Beziehungen enthält weitere Informationen zu den Parametern dieses Werkzeugs.
Die Werkzeuge, die eine Datei mit räumlicher Gewichtungsmatrix verwenden können, projizieren die Feature-Geometrie vor der Analyse in das Ausgabekoordinatensystem, und alle mathematischen Berechnungen basieren auf dem Ausgabekoordinatensystem. Wenn die Einstellung des Ausgabekoordinatensystems nicht mit dem Raumbezug der Eingabe-Feature-Class übereinstimmt, sollten Sie daher bei allen Analysen, in denen die Datei mit räumlicher Gewichtungsmatrix verwendet wird, entweder sicherstellen, dass das Ausgabekoordinatensystem mit den Einstellungen übereinstimmt, die beim Erstellen der Datei mit räumlicher Gewichtungsmatrix verwendet wurden, oder die Eingabe-Feature-Class projizieren, sodass sie dem mit der Datei mit räumlicher Gewichtungsmatrix verknüpften Raumbezug entspricht.
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.
Parameter
arcpy.stats.GenerateSpatialWeightsMatrix(Input_Feature_Class, Unique_ID_Field, Output_Spatial_Weights_Matrix_File, Conceptualization_of_Spatial_Relationships, {Distance_Method}, {Exponent}, {Threshold_Distance}, {Number_of_Neighbors}, {Row_Standardization}, {Input_Table}, {Date_Time_Field}, {Date_Time_Interval_Type}, {Date_Time_Interval_Value}, Use_Z_values)
Name | Erläuterung | Datentyp |
Input_Feature_Class | Die Feature-Class, für die die räumlichen Beziehungen 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 | Der vollständige Pfad für die Ausgabe-Datei mit der räumlichen Gewichtungsmatrix (.swm). | File |
Conceptualization_of_Spatial_Relationships | Gibt an, wie räumliche Beziehungen zwischen Features konzeptualisiert werden.
| String |
Distance_Method (optional) | Gibt an, wie Entfernungen von den einzelnen Features zu benachbarten Features berechnet werden.
| String |
Exponent (optional) | Der Wert für die Berechnung der inversen Entfernung. Ein typischer Wert ist 1 oder 2. | Double |
Threshold_Distance (optional) | Der Entfernungsgrenzwert für die Optionen INVERSE_DISTANCE und FIXED_DISTANCE des Parameters Conceptualization_of_Spatial_Relationships. Dieser Wert sollte in den Einheiten des Ausgabe-Koordinatensystems der Umgebung eingegeben werden. Damit wird die Größe des Raumfensters für die Option SPACE_TIME_WINDOW festgelegt. Ist dieser Parameter leer, wird ein Standardschwellenwert basierend auf der Ausdehnung der Ausgabe-Feature-Class und der Anzahl von Features berechnet. Bei der Konzeptualisierung von räumlichen Beziehungen mit inverser Entfernung gibt der Wert Null an, dass kein Entfernungsschwellenwert angewendet wird und alle Features Nachbarn jedes anderen Features sind. | Double |
Number_of_Neighbors (optional) | Eine Ganzzahl, die die minimale oder genaue Anzahl an Nachbarn angibt. Wenn der Parameter Conceptualization_of_Spatial_Relationships auf K_NEAREST_NEIGHBORS festgelegt ist, hat jedes Feature exakt diese angegebene Anzahl von Nachbarn. Bei der Option INVERSE_DISTANCE oder FIXED_DISTANCE hat jedes Feature mindestens diese Anzahl von Nachbarn (die Schwellenwert-Entfernung wird zum Erreichen dieser Nachbarzahl bei Bedarf vorübergehend erweitert). Bei Auswahl der Option CONTIGUITY_EDGES_ONLY oder CONTIGUITY_EDGES_CORNERS wird jedem Polygon diese minimale Anzahl von Nachbarn zugewiesen. Für Polygone mit einer geringeren Anzahl von zusammenhängenden Nachbarn basieren zusätzliche Nachbarn auf der Nachbarschaft von Feature-Schwerpunkten. | Long |
Row_Standardization (optional) | Gibt an, ob räumliche Gewichtungen nach Zeile standardisiert werden. Eine Reihen-Standardisierung wird immer dann empfohlen, wenn die Verteilung der Features aufgrund eines Referenzpunktschemas oder eines auferlegten Aggregationsschemas möglicherweise verzerrt ist.
| Boolean |
Input_Table (optional) | Eine Tabelle mit numerischen Gewichtungen, die Beziehungen zwischen allen Features in der Eingabe-Feature-Class herstellt. Erforderliche Felder für die Tabelle sind der Parameterwert Eindeutiges ID-Feld, NID (Nachbar-ID) und WEIGHT. | Table |
Date_Time_Field (optional) | Ein Datumsfeld mit einem Zeitstempel für jedes Feature. | Field |
Date_Time_Interval_Type (optional) | Gibt die zum Messen der Zeit verwendeten Einheiten an.
| String |
Date_Time_Interval_Value (optional) | Eine ganze Zahl, die die Anzahl an Zeiteinheiten wiedergibt, die das Zeitfenster bilden. | Long |
Use_Z_values | Gibt an, ob Z-Koordinaten in der Konstruktion der räumlichen Gewichtungsmatrix verwendet werden, wenn die Eingabe-Features Z-aktiviert sind.
| Boolean |
Codebeispiel
Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion GenerateSpatialWeightsMatrix verwenden.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.GenerateSpatialWeightsMatrix_stats("911Count.shp", "MYID",
"euclidean6Neighs.swm",
"K_NEAREST_NEIGHBORS", "#", "#", "#",
6, "NO_STANDARDIZATION")
Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie Sie die Funktion GenerateSpatialWeightsMatrix verwenden.
# Analyze the spatial distribution of 911 calls in a metropolitan area
# using the Hot-Spot Analysis Tool (Local Gi*)
# Import system modules
import arcpy
# Set property to overwrite existing output, by default
arcpy.env.overwriteOutput = True
# Local variables...
workspace = "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
# Copy the input feature class and integrate the points to snap
# together at 500 feet
# Process: Copy Features and Integrate
cf = arcpy.CopyFeatures_management("911Calls.shp", "911Copied.shp",
"#", 0, 0, 0)
integrate = arcpy.Integrate_management("911Copied.shp #", "500 Feet")
# Use Collect Events to count the number of calls at each location
# Process: Collect Events
ce = arcpy.CollectEvents_stats("911Copied.shp", "911Count.shp", "Count", "#")
# Add a unique ID field to the count feature class
# Process: Add Field and Calculate Field
af = arcpy.AddField_management("911Count.shp", "MyID", "LONG", "#", "#", "#", "#",
"NON_NULLABLE", "NON_REQUIRED", "#",
"911Count.shp")
cf = arcpy.CalculateField_management("911Count.shp", "MyID", "[FID]", "VB")
# Create Spatial Weights Matrix for Calculations
# Process: Generate Spatial Weights Matrix...
swm = arcpy.GenerateSpatialWeightsMatrix_stats("911Count.shp", "MYID",
"euclidean6Neighs.swm",
"K_NEAREST_NEIGHBORS",
"#", "#", "#", 6,
"NO_STANDARDIZATION")
# Hot Spot Analysis of 911 Calls
# Process: Hot Spot Analysis (Getis-Ord Gi*)
hs = arcpy.HotSpots_stats("911Count.shp", "ICOUNT", "911HotSpots.shp",
"GET_SPATIAL_WEIGHTS_FROM_FILE",
"EUCLIDEAN_DISTANCE", "NONE",
"#", "#", "euclidean6Neighs.swm")
except arcpy.ExecuteError:
# If an error occurred when running the tool, print the error message.
print(arcpy.GetMessages())
Umgebungen
Sonderfälle
- Ausgabe-Koordinatensystem
Die Feature-Geometrie wird vor der Analyse in das Ausgabe-Koordinatensystem projiziert, damit die für den Parameter Entfernungsschwellenwert eingegebenen Werte zu jenen passen, die im Ausgabe-Koordinatensystem angegeben sind. Alle mathematischen Berechnungen basieren auf dem Raumbezug des Ausgabe-Koordinatensystems. Wenn das Ausgabe-Koordinatensystem auf Grad, Minuten und Sekunden basiert, werden geodätische Entfernungen mithilfe von Sehnenentfernungen in Metern geschätzt.