Main Content

readall

Read all data in datastore

Description

example

data= readall(ds)returns all the data in the datastore specified byds. If all the data in the datastore does not fit in memory, thenreadallreturns an error.

example

data= readall(ds,'UseParallel',tf)reads the data in parallel (requires Parallel Computing Toolbox™).

Examples

collapse all

Create anImageDatastoreobject containing four images.

imds = imageDatastore({'street1.jpg','street2.jpg','peppers.png','corn.tif'});

Read all the data in the datastore.

T = readall(imds);

Examine the output.

imout = imtile(T); imshow(imout)

Figure contains an axes object. The axes object contains an object of type image.

Create a datastore from the sample fileairlinesmall.csv, which contains tabular data.

ds = tabularTextDatastore('airlinesmall.csv','TreatAsMissing','NA');

Specify the variables of interest using theSelectedVariableNamesproperty.

ds.SelectedVariableNames = {'DepTime','ArrTime','ActualElapsedTime'};

Read all the data in the datastore in parallel.

T = readall(ds,'UseParallel',true);

readallreturns all the data in a table.

View information about the table. Only the selected variables are included in the output.

T.Properties
ans = TableProperties属性:描述: '' UserData: [] DimensionNames: {'Row' 'Variables'} VariableNames: {'DepTime' 'ArrTime' 'ActualElapsedTime'} VariableDescriptions: {} VariableUnits: {} VariableContinuity: [] RowNames: {} CustomProperties: No custom properties are set. Use addprop and rmprop to modify CustomProperties.

Create a datastore that maintains parity between the pair of images of the underlying datastores. For instance, create two separate image datastores, and then create a combined datastore representing the two underlying datastores.

Create an image datastoreimds1representing a collection of three images.

imds1 = imageDatastore({'street1.jpg','street2.jpg','peppers.png'});

Create a second datastoreimds2by transforming the images ofimds1to grayscale and then downsizing the images.

imds2 = transform(imds1,@(x) imresize(im2gray(x),0.5));

Create a combined datastore fromimds1andimds2.

imdsCombined = combine(imds1,imds2);

Read all of the data from the combined datastore. The output is a 3-by-2 cell array. The two columns represent all of the read data from the two underlying datastoresimds1andimds2, respectively.

dataOut = readall(imdsCombined)
dataOut=3×2 cell array{480x640x3 uint8} {240x320 uint8} {480x640x3 uint8} {240x320 uint8} {384x512x3 uint8} {192x256 uint8}

Input Arguments

collapse all

Input datastore. You can use these datastores as input to thereadallmethod.

Read in parallel, specified astrueorfalse. If you specifytrue,readallreads all data from the datastore in parallel (requires Parallel Computing Toolbox). Parallel reading may result in improved performance when reading data, especially with remote data.

  • Datastore processing can be improved with theUseParallelproperty and the Parallel Computing Toolbox.readallreads supported datastores faster on the local machine by using low overhead computing environments such as thread-based parallel pools. For more information on thread-based parallel pools seeparpool(Parallel Computing Toolbox).

  • As a result of MATLAB's built-in multithreading, certain datastores (for example,imageDatastore) perform faster on the local machine when not using parallelism based on MATLAB workers. For more information seeMATLAB Multicore.

Example:readall(ds,'UseParallel',true)

Output Arguments

collapse all

All data in the datastore, returned as a table or a cell array depending on the type ofds.

Type of Datastore Data type ofdata Description
TabularTextDatastoreandSpreadsheetDatastore Table TheSelectedVariableNamesproperty determines the table variables.
ImageDatastore Cell array Each element in the cell array contains the image data for one image. Thereadallfunction supports all image types supported by theimreadfunction. For more information on the supported image types, seeimread.
KeyValueDatastore Table The table variable names areKeyandValue.
FileDatastore Cell array Each element in the cell array contains the data read from one file using the custom read function specified by theReadFcnproperty.
TransformedDatastore Varies The output is the same as the output returned by the underlying datastore specified by theUnderlyingDatastoresproperty. For example, if the underlying datastore is an image datastore, thendatais returned as a cell array where each element in the cell array contains the image data for one image.
CombinedDatastore Cell array

Each column of the cell array contains the result from callingreadallon the corresponding underlying datastore specified by theUnderlyingDatastoresproperty.

If the number of subsets of data in the underlying datastores differs, thenreadallonly returns data while all underlying datastores have data. For example, suppose a combined datastore has two underlying datastores, one withmsubsets of data and one withnsubsets of data, wherem>n. The output is a cell array with two columns andnrows.

Extended Capabilities

Version History

Introduced in R2014b