read

Считайте данные из datastore

Описание

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

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

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

свернуть все

Введите datastore в виде PixelLabelDatastore, pixelLabelImageDatastore, или boxLabelDatastore объект.

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

свернуть все

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

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

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

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

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

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

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

  • imageDatastore — Создайте datastore, содержащий изображения.

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

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

  • combineimds , blds) — Комбинируют изображения, ограничительные рамки и метки в один datastore.

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

Для получения дополнительной информации смотрите Хранилища данных для Глубокого обучения (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