read

Чтение данных из datastore

Описание

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

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

Входные параметры

свернуть все

Введите datastore, заданный как PixelLabelDatastore, pixelLabelImageDatastore, или boxLabelDatastore объект.

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

свернуть все

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

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

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

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

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

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

Вы можете использовать combine функция для создания datastore, который будет использоваться для обучения.

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

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

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

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

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

Для получения дополнительной информации смотрите Datastores for Глубокое Обучение (Deep Learning Toolbox).

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

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

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

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

Совет

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

Введенный в R2017b