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})| Parameter | Erklärung | 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.
| 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
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")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)Umgebungen
Lizenzinformationen
- Basic: Ja
- Standard: Ja
- Advanced: Ja