Сводка
Находит совпадения между двумя классами пространственных объектов на основе близости, временного экстента или и того, и другого.
Использование
Выходные классы объектов будут содержать все объекты входных классов объектов, которые соответствуют критерию. Один объект любого входного класса может соответствовать нескольким другим объектам. В этом случае объект копируется в выходные данные столько раз, сколько необходимо для сохранения уникальных совпадений объектов.
Если ни для одного из входных объектов не будет найдено совпадений, на выходе будут созданы пустые классы объектов.
Входные объекты и поля переносятся в выходные классы объектов.
Если для параметра Выходные типы совпадения задано Пространство и время либо Только время, во входных классах объектов должно быть обязательно поле даты.
К выходным объектам будут добавлены следующие поля:
- MATCHID - значение идентификатора, которое определяет взаимосвязь выходных классов объектов. Это поле может использоваться для создания отношения «один к одному» между выходными классами объектов.
- MATCHTYPE - назначаемое каждому объекту значение, описывающее тип критерия соответствия между входными объектами.
- B - оба входных объекта находятся в непосредственной близости друг от друга в пределах одного и того же периода времени: например, звонок по Телефону 2 произошел в пределах 1000 футов и 30 минут относительно звонка по Телефону 1. Это тип соответствия Пространство и время.
- S - оба входных объекта находятся в непосредственной близости друг от друга, например, звонок на Телефоне 2 произошел в пределах 1000 футов от Телефона 1, но не в пределах 30-минутного временного интервала. Это тип соответствия Только пространство.
- T - оба входных объекта находятся в пределах одного периода времени: например, звонок по Телефону 2 произошел в пределах 30 минут относительно звонка по Телефону 1, но не в пределах 1000 футов. Это тип соответствия Только время.
Синтаксис
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 | Объяснение | Тип данных |
in_primary_features | Входной класс основных объектов. | Feature Layer |
in_comparison_features | Входной класс объектов сравнения. | Feature Layer |
out_primary_feature_class | Выходной класс пространственных объектов, содержащий объекты из класса основных входных объектов, в котором встречаются выходные типы соответствия. | Feature Class |
out_comparison_feature_class | Выходной класс объектов, содержащий объекты из класса входных объектов сравнения, в котором встречаются выходные типы соответствия. | Feature Class |
match_types [match_types,...] | Задает типы соответствия для сопоставления.
| String |
search_radius (Дополнительный) | Радиус поиска между входными классами объектов. | Linear Unit |
temporal_search_radius (Дополнительный) | Временной интервал, используемый для поиска во входных классах пространственных объектов. | Time Unit |
primary_start_date_field (Дополнительный) | Поле начальных даты и времени входных основных объектов. | Field |
comparison_start_date_field (Дополнительный) | Поле начальной даты входных объектов сравнения. | Field |
primary_end_date_field (Дополнительный) | Поле конечных даты и времени входных основных объектов. Если значение задано, временной диапазон, заданный начальной и конечной датой и радиусом временного поиска, будет использоваться для поиска объектов сравнения. Радиус временного поиска может быть установлен на 0, чтобы сравнивать только время, заданное временным диапазоном объекта. | Field |
comparison_end_date_field (Дополнительный) | Поле начальных даты и времени входных объектов сравнения. Если значение задано, временной диапазон, заданный начальной и конечной датой и радиусом временного поиска, будет использоваться для оценки отношений с основными объектами. Радиус временного поиска может быть установлен на 0, чтобы сравнивать только время, заданное временным диапазоном объекта. | Field |
Пример кода
Пример скрипта для использования функции FindSpaceTimeMatches в режиме прямого запуска.
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 в автономном скрипте.
# 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)Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да