readall

读取数据存储中的所有数据

折叠所有页面

语法

data = readall (ds)

data = readall (ds, UseParallel, tf)

描述

例子

数据= readall (ds）返回指定的数据存储中的所有数据ds．如果数据存储中的所有数据都不能装入内存，那么readall返回一个错误。

例子

数据= readall (ds“UseParallel”,特遣部队）并行读取数据(需要并行计算工具箱™)。

例子

全部折叠

读取ImageDatastore中的所有数据

打开生活的脚本

创建一个ImageDatastore对象包含四个图像。

imd = imageDatastore ({“street1.jpg”，“street2.jpg”，“peppers.png”，“corn.tif”}）;

读取数据存储中的所有数据。

T = readall (imd);

检查输出。

imout = imtile (T);imshow (imout)

图中包含一个轴对象。axis对象包含一个image类型的对象。

并行读取TabularTextDatastore中的所有数据

打开生活的脚本

从示例文件创建数据存储airlinesmall.csv，其中包含表格数据。

ds = tabularTextDatastore (“airlinesmall.csv”，“TreatAsMissing”，“NA”)；

属性指定感兴趣的变量SelectedVariableNames财产。

ds。SelectedVariableNames = {“DepTime”，“ArrTime”，“ActualElapsedTime”}；

并行读取数据存储中的所有数据。

T = readall (ds,“UseParallel”,真正的);

readall返回表中的所有数据。

查看表信息。输出中只包含选定的变量。

T.Properties

ans = TableProperties with properties: Description: " UserData: [] DimensionNames: {'Row' 'Variables'} VariableNames: {'DepTime' 'ArrTime' 'ActualElapsedTime'} VariableDescriptions: {} VariableUnits: {} variablecontinuity: [] RowNames: {} CustomProperties:没有自定义属性设置。使用addprop和rmprop修改CustomProperties。

读取CombinedDatastore中的所有数据

打开生活的脚本

创建一个数据存储来维护底层数据存储的一对映像之间的奇偶性。例如，创建两个独立的图像数据存储，然后创建一个表示两个底层数据存储的组合数据存储。

创建镜像数据存储imds1表示三幅图像的集合。

imds1 = imageDatastore ({“street1.jpg”，“street2.jpg”，“peppers.png”}）;

创建第二个数据存储imds2通过变换图像imds1变成灰度，然后缩小图像。

Imds2 = transform(imds1，@(x) imresize(im2gray(x)，0.5));

从创建组合数据存储imds1和imds2．

imdsCombined =结合(imds1 imds2);

从合并的数据存储中读取所有数据。输出是一个3 × 2单元阵列。这两列表示从两个底层数据存储中读取的所有数据imds1和imds2,分别。

dataOut = readall (imdsCombined)

dataOut =3×2单元阵列{480x640x3 uint8} {240x320 uint8} {480x640x3 uint8} {240x320 uint8} {384x512x3 uint8} {192x256 uint8}

输入参数

全部折叠

`ds`- - - - - -输入数据存储
数据存储

输入数据存储。控件的输入可以使用这些数据存储readall方法。

MATLAB^®datastores -使用MATLAB创建的数据存储数据存储功能。例如，使用ImageDatastore．有关数据存储的完整列表，请参见“文件格式”或“应用程序”选择“数据存储”．
组合和转换的数据存储-使用结合和变换功能。
自定义数据存储—使用自定义数据存储框架创建的数据存储。看到开发自定义数据存储．

`特遣部队`- - - - - -读并行
false(缺省值)|真正的

并行阅读，指定为真正的或假．如果您指定真正的，readall并行地从数据存储读取所有数据(需要并行计算工具箱)。在读取数据时，并行读取可能会提高性能，特别是在读取远程数据时。

的数据存储处理可以改进UseParallel属性和并行计算工具箱。readall通过使用低开金宝app销的计算环境(如基于线程的并行池)，可以在本地机器上更快地读取受支持的数据存储。有关基于线程的并行池的更多信息，请参见parpool(并行计算工具箱)．
由于MATLAB的内置多线程，某些数据存储(例如，imageDatastore)在本地机器上执行更快时，不使用基于MATLAB工作者并行。有关更多信息，请参见MATLAB多核．

例子:readall (ds, UseParallel,真的)

输出参数

全部折叠

`数据`—数据存储上的所有数据
表|单元格数组

数据存储中的所有数据，根据类型以表或单元格数组的形式返回ds．

类型的数据存储	数据类型的`数据`	描述
`TabularTextDatastore`和`SpreadsheetDatastore`	表格	的`SelectedVariableNames`属性确定表变量。
`ImageDatastore`	单元阵列	单元格数组中的每个元素都包含一张图像的图像数据。的`readall`函数支持的所有图像金宝app类型`imread`函数。有关支持的图像类型的更多信息，请参见金宝app`imread`．
`KeyValueDatastore`	表格	表变量名为`关键`和`价值`．
`FileDatastore`	单元阵列	属性指定的自定义read函数从一个文件读取的数据，单元格数组中的每个元素都包含该函数`ReadFcn`财产。
`TransformedDatastore`	不同	属性指定的基础数据存储返回的输出与`UnderlyingDatastores`财产。例如，如果底层数据存储是一个图像数据存储，则`数据`作为单元格数组返回，其中单元格数组中的每个元素包含一张图像的图像数据。
`CombinedDatastore`	单元阵列	单元格数组的每一列都包含调用的结果`readall`控件指定的相应底层数据存储上`UnderlyingDatastores`财产。如果底层数据存储中数据子集的数量不同，则`readall`仅在所有底层数据存储都有数据时返回数据。例如，假设一个组合数据存储有两个底层数据存储，其中一个是米子集数据和一个n数据子集，其中米>n．输出是一个包含两列和的单元格数组n行。

扩展功能

自动并行支持金宝app
使用并行计算工具箱™自动并行运行计算，加速代码。

使用注意事项及限制:

要并行运行，请设置“UseParallel”选项真正的．

有关更多信息，请参见运行MATLAB函数与自动并行支持金宝app(并行计算工具箱)．

线程环境
使用MATLAB®在后台运行代码`backgroundPool`或使用并行计算工具箱™加速代码`ThreadPool`．

使用注意事项及限制:

在基于线程的环境中，可以使用readall仅与以下数据存储:
- ImageDatastore对象
- CombinedDatastore或TransformedDatastore创建的对象ImageDatastore通过使用对象结合或变换
您可以使用readall如果您有“并行计算工具箱”，则可以使用其他数据存储。为此，使用进程支持的并行池而不是使用backgroundPool或ThreadPool(使用ProcessPool或ClusterPool)．
readall在基于线程的环境中金宝app不支持以下图像格式:
- 分层数据格式(HDF)
- sv
- TIFF