Räumliche und zeitliche Übereinstimmungen suchen (Crime Analysis and Safety Tools)

Zusammenfassung

Bestimmt Übereinstimmungen zwischen zwei Feature-Classes auf Grundlage von Entfernung, Zeitraum oder anhand beider dieser Faktoren.

Verwendung

Die Ausgabe-Feature-Classes enthalten alle Features von Eingabe-Feature-Classes, die den Kriterien entsprechen. Ein einzelnes Feature aus einer der beiden Eingabe-Feature-Classes kann mit mehr als einem anderen Feature übereinstimmen. In diesem Fall wird das Feature so oft wie nötig in die Ausgabe kopiert, um eindeutige Feature-Übereinstimmungen aufrechtzuerhalten.
Wenn in keiner der Eingabe-Features Übereinstimmungen gefunden werden, werden leere Ausgabe-Feature-Classes erstellt.
Die Eingabe-Features und -felder werden in die Feature-Classes der Ausgabe übernommen.
Wenn für den Parameter Ausgabe-Übereinstimmungstypen die Option Raum und Zeit oder Nur Zeit ausgewählt ist, müssen die Eingabe-Feature-Classes ein Datumsfeld enthalten.
Die folgenden Felder werden zur Ausgabe hinzugefügt:
- MATCHID—Der ID-Wert, der die Beziehung zwischen den Ausgabe-Feature-Classes definiert. Dieses Feld kann verwendet werden, um eine Eins-zu-Eins-Beziehung zwischen den Ausgabe-Feature-Classes herzustellen.
- MATCHTYPE—Ein Wert, der jedem Feature zugewiesen wird und die Art der Übereinstimmungskriterien zwischen den Eingabe-Features beschreibt.
  - B—Beide Features liegen im selben Zeitrahmen in unmittelbarer Nähe zueinander; beispielsweise erfolgte ein Anruf auf Telefon 2 innerhalb eines Umkreises von 1000 Fuß und innerhalb von 30 Minuten nach einem Anruf auf Telefon 1. Das ist ein Raum und Zeit-Übereinstimmungstyp.
  - S—Beide Features liegen in unmittelbarer Nähe zueinander; beispielsweise erfolgte ein Anruf auf Telefon 2 innerhalb eines Umkreises von 1000 Fuß zu Telefon 1, jedoch nicht innerhalb des 30-minütigen Zeitrahmens. Das ist ein Nur Raum-Übereinstimmungstyp.
  - T—Beide Eingabe-Features liegen innerhalb des Zeitrahmens; beispielsweise erfolgte ein Anruf auf Telefon 2 innerhalb von 30 Minuten nach einem Anruf auf Telefon 1, jedoch nicht innerhalb einer Entfernung von 1000 Fuß. Das ist ein Nur Zeit-Übereinstimmungstyp.

Beschriftung	Erläuterung	Datentyp
Eingabe-Primär-Features	Die primäre Eingabe-Feature-Class.	Feature Layer
Eingabe-Vergleichs-Features	Die Eingabe-Vergleichs-Feature-Class.	Feature Layer
Übereinstimmende Ausgabe-Primär-Features	Die Ausgabe-Feature-Class, die Features aus den primären Eingabe-Features enthält, in denen Ausgabe-Übereinstimmungstypen erfolgt sind.	Feature Class
Übereinstimmende Ausgabe-Vergleichs-Features	Die Ausgabe-Feature-Class, die Features aus Eingabe-Vergleichs-Features enthält, in denen Ausgabe-Übereinstimmungstypen erfolgt sind.	Feature Class
Ausgabe-Übereinstimmungstypen	Gibt die zu vergleichenden Typen von Übereinstimmungen an. Raum und Zeit—Die Übereinstimmungen werden auf Grundlage des Zeitraums und der Entfernung verglichen, die im zeitlichen und räumlichen Suchradius definiert sind, z. B. 25 Meter und 10 Minuten. Nur Raum—Die Übereinstimmungen werden nur auf Grundlage der im räumlichen Suchradius definierten Entfernung verglichen, z. B. 25 Meter. Nur Zeit—Die Übereinstimmungen werden nur auf Grundlage des im zeitlichen Suchradius definierten Zeitraums verglichen, z. B. 10 Minuten.	String
Suchradius (Optional)	Der Radius für die Suche zwischen Eingabe-Feature-Classes.	Linear Unit
Zeitlicher Suchradius (Optional)	Der Zeitraum für die Suche zwischen Eingabe-Feature-Classes.	Time Unit
Startdatumsfeld für primäre Features (Optional)	Das Feld für Startdatum und -uhrzeit der primären Eingabe-Features.	Field
Startdatumsfeld für Vergleichs-Features (Optional)	Das Feld für Startdatum und -uhrzeit der Eingabe-Vergleichs-Features.	Field
Enddatumsfeld für primäre Features (Optional)	Das Feld für Enddatum und -uhrzeit der primären Eingabe-Features. Wenn angegeben, wird der durch Start- und Enddatum definierte Zeitraum und der zeitliche Suchradius zur Suche von Vergleichs-Features verwendet. Der zeitliche Suchradius kann auf 0 gesetzt werden, um nur die durch den Zeitraum des Features definierte Zeit zu vergleichen.	Field
Enddatumsfeld für Vergleichs-Features (Optional)	Das Feld für Enddatum und -uhrzeit der Eingabe-Vergleichs-Features. Wenn angegeben, wird der durch Start- und Enddatum definierte Zeitraum und der zeitliche Suchradius zur Auswertung der Beziehung zu den Primär-Features verwendet. Der zeitliche Suchradius kann auf 0 gesetzt werden, um nur die durch den Zeitraum des Features definierte Zeit zu vergleichen.	Field

arcpy.ca.FindSpaceTimeMatches(in_primary_features, in_comparison_features, out_primary_feature_class, out_comparison_feature_class, match_types, {search_radius}, {temporal_search_radius}, {primary_start_date_field}, {comparison_start_date_field}, {primary_end_date_field}, {comparison_end_date_field})

Name	Erläuterung	Datentyp
in_primary_features	Die primäre Eingabe-Feature-Class.	Feature Layer
in_comparison_features	Die Eingabe-Vergleichs-Feature-Class.	Feature Layer
out_primary_feature_class	Die Ausgabe-Feature-Class, die Features aus den primären Eingabe-Features enthält, in denen Ausgabe-Übereinstimmungstypen erfolgt sind.	Feature Class
out_comparison_feature_class	Die Ausgabe-Feature-Class, die Features aus Eingabe-Vergleichs-Features enthält, in denen Ausgabe-Übereinstimmungstypen erfolgt sind.	Feature Class
match_types [match_types,...]	Gibt die zu vergleichenden Typen von Übereinstimmungen an. `SPACE_AND_TIME`—Die Übereinstimmungen werden auf Grundlage des Zeitraums und der Entfernung verglichen, die im zeitlichen und räumlichen Suchradius definiert sind, z. B. 25 Meter und 10 Minuten. `SPACE_ONLY`—Die Übereinstimmungen werden nur auf Grundlage der im räumlichen Suchradius definierten Entfernung verglichen, z. B. 25 Meter. `TIME_ONLY`—Die Übereinstimmungen werden nur auf Grundlage des im zeitlichen Suchradius definierten Zeitraums verglichen, z. B. 10 Minuten.	String
search_radius (Optional)	Der Radius für die Suche zwischen Eingabe-Feature-Classes.	Linear Unit
temporal_search_radius (Optional)	Der Zeitraum für die Suche zwischen Eingabe-Feature-Classes.	Time Unit
primary_start_date_field (Optional)	Das Feld für Startdatum und -uhrzeit der primären Eingabe-Features.	Field
comparison_start_date_field (Optional)	Das Feld für Startdatum und -uhrzeit der Eingabe-Vergleichs-Features.	Field
primary_end_date_field (Optional)	Das Feld für Enddatum und -uhrzeit der primären Eingabe-Features. Wenn angegeben, wird der durch Start- und Enddatum definierte Zeitraum und der zeitliche Suchradius zur Suche von Vergleichs-Features verwendet. Der zeitliche Suchradius kann auf 0 gesetzt werden, um nur die durch den Zeitraum des Features definierte Zeit zu vergleichen.	Field
comparison_end_date_field (Optional)	Das Feld für Enddatum und -uhrzeit der Eingabe-Vergleichs-Features. Wenn angegeben, wird der durch Start- und Enddatum definierte Zeitraum und der zeitliche Suchradius zur Auswertung der Beziehung zu den Primär-Features verwendet. Der zeitliche Suchradius kann auf 0 gesetzt werden, um nur die durch den Zeitraum des Features definierte Zeit zu vergleichen.	Field

Codebeispiel

FindSpaceTimeMatches: Beispiel 1 (Python-Fenster)

Das folgende Skript veranschaulicht, wie die Funktion FindSpaceTimeMatches im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.env.workspace = r"C:/data/city_pd.gdb"
arcpy.ca.FindSpaceTimeMatches("CDR_Phone_1_Sites",
                            "CDR_Phone_2_Sites",
                            "CDR_Phone_1_Sites_Matches",
                            "CDR_Phone_2_Sites_Matches",
                            "SPACE_AND_TIME",
                            "1000 Meters",
                            "30 Minutes",
                            "starttime",
                            "starttime",
                            "endtime",
                            "endtime")

FindSpaceTimeMatches: Beispiel 2 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie die Funktion FindSpaceTimeMatches in einem eigenständigen Skript verwendet wird.

# Description: Use the FindSpaceTimeMatches function to create two feature
#              classes with matches based on proximity, time extent, or both
#              proximity and time extent.

# Import required modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:\data\city_pd.gdb"

# Set local variables
in_primary_features = "CDR_Phone_1_Sites"
in_comparison_features = "CDR_Phone_2_Sites"
out_primary_feature_class = "CDR_Phone_1_Sites_Matches"
out_comparison_feature_class = "CDR_Phone_2_Sites_Matches"
match_types = ["SPACE_AND_TIME","SPACE_ONLY","TIME_ONLY"]
search_radius = "1000 Meters"
temporal_search_radius = "30 Minutes"
primary_start_date_field = "starttime"
comparison_start_date_field = "starttime"
primary_end_date_field = "endtime"
comparison_end_date_field = "endtime"

# Run the FindSpaceTimeMatches tool
arcpy.ca.FindSpaceTimeMatches(in_primary_features,
                              in_comparison_features,
                              out_primary_feature_class,
                              out_comparison_feature_class,
                              match_types,
                              search_radius,
                              temporal_search_radius,
                              primary_start_date_field ,
                              comparison_start_date_field,
                              primary_end_date_field,
                              comparison_end_date_field)

Umgebungen

Aktueller Workspace, Scratch-Workspace, Ausgabe-Koordinatensystem, Geographische Transformationen, Ausdehnung, XY-Auflösung, XY-Toleranz, Ausgabe hat M-Werte, M-Auflösung, M-Toleranz, Ausgabe hat Z-Werte, Standard-Ausgabe-Z-Werte, Z-Auflösung, Z-Toleranz, Vollständig qualifizierte Feldnamen beibehalten, Ausgabe-CONFIG-Schlüsselwort, Anlagen beibehalten, Auto-Commit, Ausgabe-XY-Domäne, Ausgabe-M-Domäne, Ausgabe-Z-Domäne

Lizenzierungsinformationen