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

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 Suchkriterien entsprechen. Ein einzelnes Feature aus beiden Eingabe-Feature-Classes kann mit mehreren anderen Features übereinstimmen. In diesem Fall wird das Feature so oft wie erforderlich in die Ausgabe kopiert, um Übereinstimmungen eindeutiger Features beizubehalten.

  • Wenn in keinem der Eingabe-Features Übereinstimmungen gefunden werden, werden leere Ausgabe-Feature-Classes erstellt.

  • Die Eingabe-Features und Eingabefelder werden in den Ausgabe-Feature-Classes übernommen.

  • Wenn Raum und Zeit oder Nur Zeit für den Parameter Ausgabe-Übereinstimmungstypen angegeben wird, müssen die Eingabe-Feature-Classes ein Datumsfeld enthalten.

  • Die folgenden Felder werden zur Ausgabe hinzugefügt:

    • MATCHID: Die Kennung, mit der die Beziehung der Ausgabe-Feature-Classes definiert wird. Mit diesem Feld kann eine Eins-zu-Eins-Beziehung zwischen Ausgabe-Feature-Classes erstellt werden.
    • MATCHTYPE: Ein jedem Feature zugewiesener Wert, der den Typ der Übereinstimmungskriterien zwischen den Eingabe-Features beschreibt.
      • B: Beide Eingabe-Features befinden sich während desselben Zeitraums in Nachbarschaft zueinander. Beispiel: Auf Telefon 2 erfolgte ein Anruf in einer Entfernung von 1.000 Fuß von Telefon 1 und in einem zeitlichen Abstand von 30 Minuten von einem Anruf auf Telefon 1. Dies ist der Übereinstimmungstyp Raum und Zeit.
      • S: Beide Eingabe-Features befinden sich in Nachbarschaft zueinander. Beispiel: Auf Telefon 2 erfolgte ein Anruf in einer Entfernung von 1.000 Fuß von Telefon 1, jedoch nicht in einem zeitlichen Abstand von 30 Minuten von einem Anruf auf Telefon 1. Dies ist der Übereinstimmungstyp Nur Raum.
      • T: Beide Eingabe-Features liegen im gleichen Zeitraum. Beispiel: Auf Telefon 2 erfolgte ein Anruf in einem zeitlichen Abstand von 30 Minuten von einem Anruf auf Telefon 1, jedoch nicht in einer Entfernung von 1.000 Fuß von Telefon 1. Dies ist der Übereinstimmungstyp Nur Zeit.

Syntax

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})
ParameterErklärungDatentyp
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_TIMEDie Ü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_ONLYDie Übereinstimmungen werden nur auf Grundlage der im räumlichen Suchradius definierten Entfernung verglichen, z. B. 25 Meter.
  • TIME_ONLYDie Ü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"
# Execute 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)

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen