exponenta event banner

читать

Считывание данных из хранилища данных

Описание

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

[C,info] = read(ds) также возвращает информацию об извлеченных данных в info, включая метаданные.

Входные аргументы

свернуть все

Хранилище входных данных, указанное как PixelLabelDatastore, pixelLabelImageDatastore, или boxLabelDatastore объект.

Выходные аргументы

свернуть все

Выходные данные, возвращаемые в виде массива M-by-2 ячеек, массива ячеек категориальных матриц или таблицы.

Хранилище данныхОписание вывода
PixelLabelDatastoreТаблица с MiniBatchSize количество строк. Для последнего пакета данных в хранилище данных, numObservations должен быть разделен на MiniBatchSize или read возвращает частичный пакет, содержащий все оставшиеся наблюдения в хранилище данных.
PixelLabelImageDatastore
boxLabelDatastore

N-by-2 или N-by-3 клеточная матрица. N должно быть меньше или равно ReadSize(ds).

Первый столбец может содержать данные, например данные облака точек для детекторов облака точек или изображения для детекторов объектов.

Второй столбец должен быть вектором ячейки, который содержит M-by-5 матрицы ограничивающих прямоугольников в формате [xcenter, ycenter, width, height, yaw].

Третий столбец должен быть вектором ячейки, который содержит имена меток, соответствующие каждой ограничивающей рамке. Имена меток представлены в виде M-by-1 категориального вектора.

Вы можете использовать combine для создания хранилища данных, используемого для обучения.

  • imageDatastore - Создание хранилища данных, содержащего изображения.

  • PixelLabelDatastore - Создание хранилища данных, содержащего пиксельные данные.

  • boxLabelDatastore - создание хранилища данных, содержащего ограничивающие рамки и метки.

  • combine(imds,blds) - объединяет изображения, ограничивающие рамки и метки в одном хранилище данных.

  • combine(pxds,blds) - объединение пиксельных данных, ограничивающих рамок и меток в одно хранилище данных.

Дополнительные сведения см. в разделе Хранилища данных для глубокого обучения (панель инструментов глубокого обучения).

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

Хранилище данныхИмя поляОписание
PixelLabelDatastoreFilenameПолностью разрешенный путь, содержащий строку пути, имя файла и расширение файла. Для PixelLabelDatastore объекты, ReadSize свойство больше 1, Filename - массив ячеек имен файлов, соответствующих каждому изображению.
FileSize

Общий размер файла, в байтах. Для файлов MAT FileSize общее число пар ключ-значение в файле. Для PixelLabelDatastore объекты, ReadSize свойство больше 1, FileSize - вектор размеров файла, соответствующий каждому изображению.

PixelLabelImageDatastoreImageFilenameПолностью разрешенный путь, содержащий строку пути, имя файла изображения и расширение файла.
PixelLabelFilenameПолностью разрешенный путь, содержащий строку пути, имя файла метки пикселя и расширение файла.
boxLabelDatastoreCurrentIndexИсходное положение каждого read работа с данными метки.
ReadSizeReadSize свойства хранилища данных.

Совет

  • read(ds) возвращает ошибку, если во входном хранилище данных больше нет данных, ds. Использовать hasdata(ds) с read(ds) во избежание ошибки.

Представлен в R2017b