Совместное использование и хранение маркированных достоверных данных

Приложения Image Labeler, Video Labeler и Ground Truth Labeler (Automated Driving Toolbox) позволяют маркировать изображения, видео и другие источники достоверных данных. Затем можно экспортировать метки основной истины как groundTruth объект или, для приложения Ground Truth Labeler (Automated Driving Toolbox), groundTruthMultisignal (Automated Driving Toolbox) объект. Объект основная истина содержит информацию о:

  • Источник данных (или источники данных)

  • Определения меток

  • Нарисованные метки основной истины

Вы можете совместно использовать этот объект с:

  • Другие коллеги по маркировке, которые могут использовать его для продолжения маркировки

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

  • Инженеры по валидации, которые могут использовать его для валидации алгоритмов

Поделитесь основной истиной

Чтобы экспортировать и поделиться маркированными достоверными данными из одного из приложений для маркировки, выберите Export Labels > To File. Затем либо поделитесь экспортированным MAT-файлом непосредственно с индивидуумами вашей команды, либо поместите его в общее сетевое расположение.

Если экспортированные достоверные данные содержат пиксельные метки, приложение также генерирует PixelLabelData папка, содержащая данные о пиксельных метках. Таблица данных о метках, сохраненная в основной истине, ссылается на путь к этой папке. Совместное использование этой папки вместе с основной истиной.

Приложения для маркировки также позволяют вам сохранить MAT-файл всего сеанса приложения. Не предоставлять общий доступ к этому файлу. Поскольку файл сеанса содержит настройки приложения, характерные для локальной машины, этот файл может не работать на других компьютерах.

Если вы повторно экспортируете основную истину, содержащий данные о пиксельных метках, приложение генерирует новую PixelLabelData папка. Даже если вы перезаписываете исходный объект основная истина, приложение генерирует новую PixelLabelData папка. При реэкспорте основной истины сгенерированные папки называются PixelLabelData_1, PixelLabelData_2, и так далее, в зависимости от того, сколько раз вы повторно экспортируете объект в одну и ту же папку.

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

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

Файлы приложения Image Labeler для совместного использования

Источник данныхФайлы для совместного использования
Коллекция изображений
  • groundTruth объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Папки, содержащие коллекции изображений (если нет в общем расположении)

Файлы приложения Video Labeler для совместного использования

Источник данныхФайлы для совместного использования
Видео
  • groundTruth объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Исходный файл видео (если не в общем расположении)

Image sequence (изображение
  • groundTruth объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Папка, содержащая изображение последовательность (если нет в общем расположении)

  • Метки времени duration вектор (если задан)

Устройство чтения пользовательских источников данных
  • groundTruth объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Файлы источника данных (если нет в общем расположении)

  • Функция пользовательского считывателя

Файлы приложения Ground Truth Labeler для совместного использования

Источник данныхФайлы для совместного использования
Видео
  • groundTruthMultisignal объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Исходный файл видео (если не в общем расположении)

Image sequence (изображение
  • groundTruthMultisignal объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Папка, содержащая изображение последовательность (если нет в общем расположении)

  • Метки времени duration вектор (если задан)

Устройство чтения пользовательских источников данных
  • groundTruthMultisignal объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Файлы источника данных (если нет в общем расположении)

  • Функция пользовательского считывателя

Последовательность облака точек
  • groundTruthMultisignal объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Папка, содержащая последовательность облака точек (если нет в общем расположении)

  • Метки времени duration вектор (если задан)

Velodyne® Файл захвата пакетов (PCAP)
  • groundTruthMultisignal объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Исходный файл PCAP (если нет общего местоположения)

  • Файл калибровки PCAP

  • Метки времени duration вектор (если задан)

Rosbag
  • groundTruthMultisignal объект MAT-файл

  • PixelLabelData папка (только метки пикселей)

  • Файл Росбага

Перемещение Основная истина

В экспортированной основной истине DataSource свойство содержит абсолютные пути к файлам источника данных. Например, предположим, что вы хотите просмотреть пути для groundTruth объект, gTruth, который был экспортирован из Image Labeler приложения. В MATLAB® введите этот код в командной строке.

gTruth.DataSource
ans = 

groundTruthDataSource for an image collection with properties

                      Source: {
                              ' ...\matlab\toolbox\vision\visiondata\imageSets\cups\bigMug.jpg';
                              ' ...\matlab\toolbox\vision\visiondata\imageSets\cups\blueCup.jpg';
                              ' ...\matlab\toolbox\vision\visiondata\imageSets\cups\handMade.jpg'
                               ... and 9 more
                              }
Если вы перемещаете объект основная истина в новое место, вам может потребоваться изменить пути к файлам, хранящиеся в источнике данных (или источниках данных). Даже если файлы источника данных находятся в общей сети, если другие люди сопоставляют другую букву диска с их сетевой папкой, пути к файлам могут быть неправильными.

Чтобы обновить эти пути, используйте changeFilePaths функция. Задайте объект основной истины как входной параметр к этой функции. Если пути изменились, но имена файлов не изменились, задайте строковый вектор, содержащий старый и новый путь. Функция возвращает все пути, которые она не может разрешить. Для примера этот код выборки показов, как изменить букву диска для папки изображений.

alternativePaths = ["C:\Shared\ImgFolder" "D:\Shared\ImgFolder"];
unresolvedPaths = changeFilePaths(gTruth,alternativePaths);

Если имена файлов также изменились, задайте массив ячеек из строковых векторов, содержащий старый и новый пути. Например, эту выборку кода показывает, как изменить букву диска для отдельных файлов и как добавить суффикс к каждому файлу.

alternativePaths =  ...
    {["C:\Shared\ImgFolder\Img1.png" "D:\Shared\ImgFolder\Img1_new.png"], ...
     ["C:\Shared\ImgFolder\Img2.png" "D:\Shared\ImgFolder\Img2_new.png"], ...
     .
     .
     .
     ["C:\Shared\ImgFolder\ImgN.png" "D:\Shared\ImgFolder\ImgN_new.png"]};
unresolvedPaths = changeFilePaths(gTruth,alternativePaths);

Если объект основная истина содержит данные о пиксельных метках, можно также использовать changeFilePaths функция для обновления имен путей к данным о пиксельных метках, хранящимся в PixelLabelData папка.

Храните основную истину

Сохраните объект основная истина в расположении, расположенном на пути поиска файлов MATLAB. Для получения дополнительной информации смотрите Что такой Путь поиска файлов MATLAB?.

Для источников данных, содержимое которых находится в одной папке, рассмотрите хранение основной истины в родительской папке источника данных. Для коллекций изображений, содержащих изображения из разных папок, не существует конкретных рекомендаций относительно того, где хранить объект. Чтобы пометить коллекции изображений, используйте приложение Image Labeler.

См. также

Приложения

Объекты

Функции

Похожие темы