Платформа 4.0 / BOX 5.0
Редактор сценария и обмен данными
Редактор сценария и обмен данными: подробная инструкция, назначение полей, порядок действий и иллюстрации интерфейса.
На этой странице
Редактор графа: последовательность работы
Откройте черновик версии → «Настроить логику работы». Страница содержит тестирование на видео/изображениях и редактор Node-RED; блоки можно сворачивать и разворачивать независимо.
- Найдите узел в палитре слева и перетащите на рабочее поле.
- Двойным щелчком откройте параметры узла. Заполните имя, модель/версию при необходимости и параметры. Нажмите «Готово», чтобы принять изменения в графе, либо «Отмена», чтобы закрыть форму без них.
- Соедините выход одного узла со входом следующего. Проверьте направление связи и назначение порта, особенно у фильтров с двумя выходами.
- Добавьте локальный визуализатор к проверяемому этапу. При необходимости временно разбирайте цепочку по частям.
- Нажмите «Развернуть» внутри редактора, чтобы применить граф в текущей среде отладки.
- Испытайте на подготовленном файле. Исправляйте причину на том этапе, где данные впервые становятся неверными.
- Нажмите внешнюю кнопку «Сохранить изменения», чтобы сохранить логику в версии сценария.
- Вернитесь в карточку. Проверьте зависимости, описание и тип результата. Сохраните черновик или опубликуйте подготовленную версию.
| Действие | Результат | Чего ещё нужно добиться |
|---|---|---|
| Готово в свойствах узла | Параметры приняты в редактируемый граф | Развернуть и проверить граф |
| Развернуть | Граф применён в редакторе/песочнице | Сохранить логику в системе |
| Сохранить изменения | Логика записана в версию | Завершить описание, испытать и опубликовать |
| Сохранить и опубликовать | Выпуск доступен для назначения | Назначить камере и проверить выполнение |
| Сохранить назначение камеры | Выбрана рабочая версия для источника | Проверить фактический запуск и полный результат |
«Развернуть» применяет граф в редакторе, но изменения нужно также сохранить в версии сценария перед выходом. Проверьте оба действия. Для редактирования опубликованного выпуска создайте новую версию; недоступная кнопка сохранения не является поводом изменять рабочую версию обходным способом.
Кнопка «Обновить зоны и модели из СОВА» обновляет доступные редактору ресурсы. Историческое название кнопки не означает, что для каждого BOX требуется внешняя СОВА заказчика. После обновления повторно проверьте выбранные версии и идентификаторы зон.
Формат данных между блоками
Граф передаёт сообщение msg, содержащее результаты обработки. В интерфейсе поля сообщения называются топиками. Здесь это ключи данных между узлами; они не тождественны Kafka-топикам архитектуры платформы.
| Топик / данные | Назначение | Типичная ошибка |
|---|---|---|
image |
Текущий кадр | Следующий блок читает другое имя или уже обрезанный фрагмент |
image_timestamp |
Время кадра | Сравнение времени файла с текущим временем сервера |
frame_index |
Номер кадра в источнике | Использование как номера обработанного шага после прореживания |
step_index |
Номер шага обработки | Неправильный перевод длины истории в секунды |
camera_id |
Источник | Смешивание состояния нескольких камер |
image_id |
Связь результатов с кадром | Объединение веток от разных кадров |
camera_params |
Параметры камеры и зоны | Зона есть на картинке, но её тип не тот, который ждёт граф |
detections |
Найденные объекты: категории, уверенность, геометрия | Ожидание устойчивого идентификатора объекта от обычной детекции |
tracks |
Связанные во времени объекты и история | Перепутаны рамки одного кадра и треки |
events |
Сформированные события | В отправитель переданы треки вместо событий |
visualized_image |
Кадр с наложениями | Отсутствие нарисованных рамок принято за отсутствие детекций |
Имена топиков связывают выход одного блока со входом следующего. При переименовании выходного топика измените вход потребителя. Соединительная линия передаёт сообщение, но не переименовывает поля. Для программного блока проверьте вложенную структуру в «Логе сообщений» и в описании формата данных установленного пакета.
Время и кадры. При стабильных 2 обработанных кадрах/с история 180 шагов соответствует примерно 90 секундам наблюдения. При 5 кадрах/с та же история — примерно 36 секундам. Это оценка, а не таймер: при пропусках и переменной частоте используйте метки времени. Значения «30 секунд» и «30 кадров» нельзя переносить между блоками без пересчёта.
Геометрия. В параметрах камеры зоны могут передаваться в нормированных координатах, а минимальные размеры детекции задаются в пикселях изображения обработки. Проверьте масштабирование, обрезку и систему координат перед сравнением зон с рамками. После изменения входного размера повторно испытайте пороги размера.
Ветвления. Общий детектор можно поставить до развилки, если веткам подходят одинаковые категории, размер кадра и профиль исполнения. Объединяя ветки, сохраняйте связь с кадром и не считайте слияние списков автоматической синхронизацией независимых потоков.