Найти совпадения пространство-время (Анализ преступности и безопасность)

Краткая информация

Находит совпадения между двумя классами пространственных объектов на основе близости, временного экстента или и того, и другого.

Использование

  • Выходные классы объектов будут содержать все объекты входных классов объектов, которые соответствуют критерию. Один объект любого входного класса может соответствовать нескольким другим объектам. В этом случае объект копируется в выходные данные столько раз, сколько необходимо для сохранения уникальных совпадений объектов.

  • Если ни для одного из входных объектов не будет найдено совпадений, на выходе будут созданы пустые классы объектов.

  • Входные объекты и поля переносятся в выходные классы объектов.

  • Если для параметра Выходные типы совпадения задано Пространство и время либо Только время, во входных классах объектов должно быть обязательно поле даты.

  • К выходным объектам будут добавлены следующие поля:

    • MATCHID - значение идентификатора, которое определяет взаимосвязь выходных классов объектов. Это поле может использоваться для создания отношения «один к одному» между выходными классами объектов.
    • MATCHTYPE - назначаемое каждому объекту значение, описывающее тип критерия соответствия между входными объектами.
      • B - оба входных объекта находятся в непосредственной близости друг от друга в пределах одного и того же периода времени: например, звонок по Телефону 2 произошел в пределах 1000 футов и 30 минут относительно звонка по Телефону 1. Это тип соответствия Пространство и время.
      • S - оба входных объекта находятся в непосредственной близости друг от друга, например, звонок на Телефоне 2 произошел в пределах 1000 футов от Телефона 1, но не в пределах 30-минутного временного интервала. Это тип соответствия Только пространство.
      • T - оба входных объекта находятся в пределах одного периода времени: например, звонок по Телефону 2 произошел в пределах 30 минут относительно звонка по Телефону 1, но не в пределах 1000 футов. Это тип соответствия Только время.

Параметры

ПодписьОписаниеТип данных
Входные основные объекты

Входной класс основных объектов.

Feature Layer
Входные объекты сравнения

Входной класс объектов сравнения.

Feature Layer
Выходные сопоставленные основные объекты

Выходной класс пространственных объектов, содержащий объекты из класса основных входных объектов, в котором встречаются выходные типы соответствия.

Feature Class
Выходные сопоставленные объекты сравнения

Выходной класс объектов, содержащий объекты из класса входных объектов сравнения, в котором встречаются выходные типы соответствия.

Feature Class
Выходные типы соответствия

Задает типы соответствия для сопоставления.

  • Пространство и времяБудут выполняться сопоставления, основанные как на временном периоде, так и радиусе пространственного поиска, определенной во временном и радиусе пространственного поиска: например, 25 метров и 10 минут.
  • Только пространствоБудут выполняться сопоставления, основанные только на близости, заданной в радиусе пространственного поиска: например, 25 метров.
  • Только времяБудут выполняться сопоставления, основанные только на временном периоде, заданной в радиусе временного поиска: например, 10 минут.
String
Радиус поиска
(Дополнительный)

Радиус поиска между входными классами объектов.

Linear Unit
Радиус временного поиска
(Дополнительный)

Временной интервал, используемый для поиска во входных классах пространственных объектов.

Time Unit
Поле начальной даты основных объектов
(Дополнительный)

Поле начальных даты и времени входных основных объектов.

Field
Поле начальной даты объектов сравнения
(Дополнительный)

Поле начальной даты входных объектов сравнения.

Field
Поле конечной даты основных объектов
(Дополнительный)

Поле конечных даты и времени входных основных объектов. Если значение задано, временной диапазон, заданный начальной и конечной датой и радиусом временного поиска, будет использоваться для поиска объектов сравнения. Радиус временного поиска может быть установлен на 0, чтобы сравнивать только время, заданное временным диапазоном объекта.

Field
Поле конечной даты объектов сравнения
(Дополнительный)

Поле начальных даты и времени входных объектов сравнения. Если значение задано, временной диапазон, заданный начальной и конечной датой и радиусом временного поиска, будет использоваться для оценки отношений с основными объектами. Радиус временного поиска может быть установлен на 0, чтобы сравнивать только время, заданное временным диапазоном объекта.

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})
ИмяОписаниеТип данных
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,...]

Задает типы соответствия для сопоставления.

  • SPACE_AND_TIMEБудут выполняться сопоставления, основанные как на временном периоде, так и радиусе пространственного поиска, определенной во временном и радиусе пространственного поиска: например, 25 метров и 10 минут.
  • SPACE_ONLYБудут выполняться сопоставления, основанные только на близости, заданной в радиусе пространственного поиска: например, 25 метров.
  • TIME_ONLYБудут выполняться сопоставления, основанные только на временном периоде, заданной в радиусе временного поиска: например, 10 минут.
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, пример 1 (окно Python)

Пример скрипта для использования функции 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, пример 2 (автономный скрипт)

В следующем скрипте показано, как использовать функцию 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)

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы