Распознавание объектов
Объявление экземпляра
После добавления блока Распознавание объектов(ObjectDetection) в рабочую область в код Python автоматически вставляется следующее объявление экземпляра:
object_detection = ObjectDetection(0)
# Когда экземпляров несколько
object_detection_1 = ObjectDetection(1)Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| index | Пункт выпадающего списка | Номер экземпляра (начиная с 0) | Целое число 0 или больше | 0 |
Выбрать камеру
Задаёт камеру, используемую для распознавания объектов.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Название устройства камеры | Название камеры в системе | - |
Python
object_detection = ObjectDetection(0)
object_detection.device('')Загрузить модель объектов
Загружает обученную модель объектов. Без этого шага функции модуля «Распознавание объектов» использовать нельзя.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| wait | Флажок | Ждать ли завершения загрузки | TRUE / FALSE | TRUE |
Python
object_detection = ObjectDetection(0)
object_detection.load_model(wait=True)Установить макс. количество объектов
Задаёт, сколько объектов можно найти самое большее. Диапазон количества объектов — от 0 до 10.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| data | Ввод (блок) | Максимальное количество объектов | Целое число от 0 до 10 | - |
Python
object_detection = ObjectDetection(0)
object_detection.max_objects(5)Установить порог уверенности
Задаёт наименьшую вероятность (уверенность) при распознавании объектов. Объект появляется на экране, только если уверенность не меньше заданной. Диапазон уверенности — от 0 до 1.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| data | Ввод (блок) | Порог уверенности | Вещественное число от 0 до 1 | - |
Python
object_detection = ObjectDetection(0)
object_detection.confidence_threshold(0.5)Распознать объекты один раз
Находит объекты, которые сейчас на экране, и отмечает их только один раз.
Параметры
(нет)
Python
object_detection = ObjectDetection(0)
object_detection.detect_once()Запустить / остановить непрерывное распознавание объектов
Непрерывно отслеживает объекты на экране и отмечает их на изображении.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Действие | запустить(start), остановить(stop) | - |
Python
object_detection = ObjectDetection(0)
# unit = "start"
object_detection.detect_continuous()
# unit = "stop"
object_detection.stop()Показать результат
Определяет, показывать ли на изображении с камеры результат распознавания объектов.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| on | Пункт выпадающего списка | Отображение ON / OFF | показать(on=True), скрыть(off=False) | TRUE |
Python
object_detection = ObjectDetection(0)
object_detection.display(True)
object_detection.display(False)Положение объекта
Возвращает положение и размер указанного объекта.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Название объекта | 80 классов объектов ('person', 'bicycle', 'car', 'motorcycle', 'airplane', 'bus', 'cat', 'dog', 'apple', 'cup', 'laptop', 'cell_phone' и другие) | - |
| pos | Пункт выпадающего списка | Координата | x, y | - |
Python
object_detection = ObjectDetection(0)
object_detection.object('person', 'x')
object_detection.object('bicycle', 'y')Прямоугольник объекта
Возвращает положение и размер прямоугольника, охватывающего указанный объект.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Название объекта | 80 классов объектов | - |
| pos | Пункт выпадающего списка | Сведения о прямоугольнике | min_x, max_x, min_y, max_y, width, height, area | - |
Python
object_detection = ObjectDetection(0)
object_detection.object('person', 'width')
object_detection.object('car', 'area')Расстояние между двумя объектами
Возвращает расстояние между двумя классами объектов.
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit1 | Пункт выпадающего списка | Название первого объекта | 80 классов объектов | - |
| unit2 | Пункт выпадающего списка | Название второго объекта | 80 классов объектов | - |
| type | Пункт выпадающего списка | Вид расстояния | расстояние (пропущено или None), расстояние по горизонтали(horizontal), расстояние по вертикали(vertical) | None |
Python
object_detection = ObjectDetection(0)
object_detection.get_distance('person', 'bicycle') # расстояние
object_detection.get_distance('person', 'car', 'horizontal') # расстояние по горизонталиУверенность для объекта
Вероятность (уверенность) того, что выбранный объект распознан верно
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Название объекта | 80 классов объектов | - |
Python
object_detection = ObjectDetection(0)
object_detection.object_confidence('person')Состояние модели
Возвращает состояние загрузки модели объектов.
Возвращает 0, если модель ещё не загружена, 1 во время загрузки и 2 после её завершения.
Параметры
(нет)
Python
object_detection = ObjectDetection(0)
object_detection.model_state()Объект распознан
Найден ли объект
Параметры
(нет)
Python
object_detection = ObjectDetection(0)
object_detection.detected()Обнаружен ли данный объект
Найден ли выбранный объект
Параметры
| Название | Вид | Описание | Диапазон / Тип | По умолчанию |
|---|---|---|---|---|
| unit | Пункт выпадающего списка | Название объекта | 80 классов объектов | - |
Python
object_detection = ObjectDetection(0)
object_detection.object_detected('person')