Main Content

read

Read data fromaugmentedImageDatastore

所有的页面崩溃

Syntax

data = read(auimds)
[data,info] = read(auimds)

Description

data= read(auimds)returns a batch of data from an augmented image datastore,auimds. Subsequent calls to thereadfunction continue reading from the endpoint of the previous call.

[data,info) =阅读(auimds)also returns information about the extracted data, including metadata, ininfo.

Input Arguments

collapse all

Augmented image datastore, specified as anaugmentedImageDatastoreobject. The datastore specifies aMiniBatchSizenumber of observations in each batch, and anumObservationstotal number of observations.

Output Arguments

collapse all

Output data, returned as a table. When the datastoreauimdsreads a full batch of data, the table hasMiniBatchSizerows. For the last batch of data in the datastore, ifnumObservations不干净的红利sible byMiniBatchSize, thenreadreturns a partial batch containing all of the remaining observations.

The first column of the table,"input", returns the data for each image. The table has a second column,"response", whenauimdsreads data of these types:

  • Image files containing labeled image data, when the file names are specified by an image datastore

  • A numeric array containing categorical labels or numeric responses

  • A table that includes one or more responses

Information about read data, returned as a structure array. The structure array can contain these fields.

Field Name Description
Filename

Cell array of character vectors. Each element is a fully resolved path containing the path string, name of the file, and file extension for the corresponding image. This field is present whenauimdsreads data from files specified by an image datastore.
FileSize

Numeric vector. Each element is the total file size, in bytes, of the corresponding image. For MAT-files,FileSizeis the total number of key-value pairs in the file. This field is present whenauimdsreads data from files specified by an image datastore.
Label

Categorical vector. Each element is the category label of the corresponding image. This field is present whenauimdsreads labeled data from files specified by an image datastore.
MiniBatchIndices

Numeric vector. Each element is the index of the input image in the array. This field is present whenauimdsreads data from numeric arrays.

Version History

Introduced in R2018a

See Also

||