Сводка
Извлекает уникальные идентификаторы, которые перемещаются в пространстве и времени с заданными пользователем интервалами в наборе данных точек трека.
Использование
Инструмент определяет уникальные идентификаторы входных объектов, которые перемещаются в течение заданного времени, и расстояние между объектами. Для входных объектов должно быть включено время.
Чтобы узнать о том, как включается время для набора данных, см. раздел Настройка свойств времени для данных.
При выборе поля, которое будет использоваться в качестве уникального идентификатора, укажите поле, содержащее числа или текст. Это позволит более эффективно группировать объекты и получить оптимальный результат.
При задании небольших пространственных и временных интервалов обработка будет выполняться быстрее. Например, при задании разницы во времени в 10 минут и пространственной разницы, равной 100 метрам, обработка будет выполнена значительно быстрее, в случае задания разницы во времени 1 час и пространственной разницы, равной 1 километру.
Выходные объекты соответствуют местоположениям объектов-попутчиков. К выходным объектам будут добавлены - в дополнение к другим описательным полям - еще два поля, которые содержат информацию о разнице во временном и пространственном положении между путешественником и его возможным попутчиком.
Выходные объекты будут включать следующие поля:
- traveler_id - уникальный идентификатор объекта-путешественника. Это идентификатор объекта, с которым перемещается объект-попутчик, называемый исходным объектом.
- cotraveler_id - уникальный идентификатор объекта-попутчика. Это идентификатор попутчика объекта-путешественника, называемый целевым объектом.
- X – координата х объекта-путешественника. Координаты должны быть в проекции Входных данных.
- Y – координата у объекта-путешественника. Координаты должны быть в проекции Входных данных.
- X_cotraveler – координата х объекта-попутчика. Координаты должны быть в проекции Входных данных.
- Y_cotraveler – координата у объекта-путешественника. Координаты должны быть в проекции Входных данных.
- traveler_time - дата и время для объекта-путешественника.
- cotraveler_time - дата и время для объекта-попутчика.
- distance_difference - расстояние между объектом во Входных объектах и предполагаемым попутчиком. Расстояние должно быть задано в линейных единицах Входных объектов.
- time_difference - разница во времени между Входным объектом и предполагаемым попутчиком. Разница во времени выражается в секундах и может быть как положительной, так и отрицательной. Положительные значения указывают на то, что путешественник опережает попутчика. Отрицательные значения - на то, что попутчик опережает путешественника.
- cotraveling_pair_id – уникальный идентификатор, создаваемый для каждой пары объектов-попутчиков. Объекты-попутчики (A, B) будут обладать одинаковым cotraveling_pair_id как для (A, B), так и для (B, A).
Существует необязательная сводная таблица, которую можно создать на основе выходных объектов. Сводная таблица будет включать следующие поля:
- unique_pair_id – уникальный идентификатор, создаваемый для каждой пары объектов-попутчиков. Объекты-попутчики (A, B) будут обладать одинаковым unique_pair_id как для (A, B), так и для (B, A).
- traveler_id - уникальный идентификатор объекта-путешественника. Это идентификатор объекта, с которым перемещается объект-попутчик, называемый исходным объектом.
- cotraveler_id - уникальный идентификатор объекта-попутчика. Это идентификатор попутчика объекта-путешественника, называемый целевым объектом.
- time_diff_max – максимальное разделение во времени между путешественником и попутчиком.
- time_diff_min – минимальное разделение во времени между путешественником и попутчиком.
- time_diff_mean – среднее разделение во времени между путешественником и попутчиком.
- time_diff_std – стандартное отклонение разделения во времени между путешественником и попутчиком.
- dist_diff_max – максимальное разделение по расстоянию между путешественником и попутчиком.
- dist_diff_min – минимальное разделение по расстоянию между путешественником и попутчиком.
- dist_diff_mean – среднее разделение по расстоянию между путешественником и попутчиком.
- dist_diff_std – стандартное отклонение разделения по расстоянию между путешественником и попутчиком.
- unique_pair_id_count – общее количество объектов, определенных как попутчики по отношению к unique_pair_id.
Синтаксис
arcpy.intelligence.FindCotravelers(input_features, out_featureclass, id_field, {search_distance}, {time_difference}, {input_type}, {secondary_features}, {secondary_id_field}, {create_summary_table}, {out_summary_table})
Parameter | Объяснение | Тип данных |
input_features | Объекты со включенным временем, соответствующие объекту с известным идентификатором, для которого будет выполняться поиск попутчиков. Уникальные идентификаторы, временные метки и местоположения будут перенесены в выходной слой и помогут вычислить разницу во временном и пространственном положении объектов. | Feature Layer |
out_featureclass | Выходной класс пространственных объектов, который будет точки сегмента трека, идентифицированные в качестве попутчиков для источников. Этот класс объектов будет содержать источник, который связан с соответствующей точкой сегмента трека. Разделение по времени и дистанции будет рассчитано для каждого трека точечного объекта. | Feature Class |
id_field | Поле Входных объектов для получения уникальных идентификаторов точек трека. Это поле будет скопировано в выходной класс объектов. | Field |
search_distance (Дополнительный) | Максимальное расстояние между объектами, при котором они будут считаться попутчиками. Значение по умолчанию – 100 футов. | Linear Unit |
time_difference (Дополнительный) | Максимальная разница во времени между объектами, при котором они будут считаться попутчиками. Значением по умолчанию является 10 секунд. | Time Unit |
input_type (Дополнительный) | Определяет, будут ли попутчики идентифицироваться в одном классе объектов или в двух.
| String |
secondary_features (Дополнительный) | Второй класс объектов для определения попутчиков. Потенциальные попутчики будут вычислены при помощи следующего:
| Feature Layer |
secondary_id_field (Дополнительный) | Поле Вторичные объекты (Secondary Features), которое будет использовано для получения уникальных идентификаторов для треков точек. Это поле будет скопировано в выходной класс объектов. | Field |
create_summary_table (Дополнительный) | Указывает, следует ли создавать сводную таблицу вывода.
| Boolean |
out_summary_table (Дополнительный) | Выходная таблица, которая будет хранить итоговую информацию. Эта опция доступна только при параметре Создать суммарную таблицу установленном на True. | Table |
Пример кода
В следующем скрипте Python показано, как используется функция FindCotravelers в автономном скрипте:без выходной суммарной таблицы и с одним входным классом объектов.
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
output_point_features = "Cotravelers"
id_field = "device_id"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field)
В следующем скрипте Python показано, как используется функция FindCotravelers в автономном скрипте:с выходной суммарной таблицы и с двумя входными классами объектов.
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
unknown_features = "Unknown_Tracks"
output_point_features = "Cotravelers"
id_field_name = "device_id"
unknown_id_field = "MMSI"
search_distance = "75 Feet"
time_difference = "5 Seconds"
summary_table = "CREATE_SUMMARY_TABLE"
summary_table_name = "Tracks_Summary_Table"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field_name,
search_distance,
time_difference,
"TWO_FEATURECLASSES",
unknown_features,
unknown_id_field,
summary_table,
summary_table_name)
Environments
Информация о лицензиях
- Basic: Нет
- Standard: Нет
- Advanced: Да