主要内容

readall

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

描述

例子

数据= readall (ds返回指定的数据存储中的所有数据ds.如果数据存储中的所有数据都不能装入内存,则readall返回一个错误。

例子

数据= readall (dsUseParallel =特遣部队并行读取数据特遣部队真正的(需要并行计算工具箱™)。

例子

全部折叠

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

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

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

T = readall (imd);

检查输出。

imout = imtile (T);imshow (imout)

图中包含一个axes对象。坐标轴对象包含一个image类型的对象。

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

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

方法指定感兴趣的变量SelectedVariableNames财产。

ds。SelectedVariableNames = [“DepTime”“ArrTime”“ActualElapsedTime”];

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

T = readall (ds, UseParallel = true);

readall返回表中的所有数据。

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

T.Properties
ans =具有属性的TableProperties: Description: " UserData: [] DimensionNames: {'Row' 'Variables'} VariableNames: {'DepTime' 'ArrTime' 'ActualElapsedTime'} variabledescription: {} VariableUnits: {} variablecontinity: [] RowNames: {} CustomProperties:没有设置自定义属性。使用addprop和rmprop修改CustomProperties。

创建一个数据存储,在基础数据存储的一对映像之间维护奇偶校验。例如,创建两个独立的图像数据存储,然后创建一个表示这两个底层数据存储的组合数据存储。

创建映像数据存储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}

输入参数

全部折叠

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

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

  • 可以改进数据存储处理UseParallel属性和并行计算工具箱。readall通过使用低开销的计算环境(如基于线程的并行池),可以更快地在本地机器上读取受支持的数据存储。有关基于线程的并行池的更多信息,请参见parpool(并行计算工具箱)

  • 由于MATLAB的内置多线程,某些数据存储(例如,imageDatastore)在不使用基于MATLAB worker的并行时,在本地机器上执行得更快。有关更多信息,请参见MATLAB多核

例子:readall (ds, UseParallel = true)

输出参数

全部折叠

的类型作为表或单元格数组返回的数据存储中的所有数据ds

类型的数据存储 数据类型的数据 描述
TabularTextDatastore而且SpreadsheetDatastore 表格 SelectedVariableNames属性确定表变量。
ImageDatastore 单元阵列 单元格数组中的每个元素都包含一张图像的图像数据。的readall函数支持的所有图像类型imread函数。有关支持的映像类型的更多信息,请参见imread
KeyValueDatastore 表格 表变量名为关键而且价值
FileDatastore 单元阵列 类指定的自定义读取函数从一个文件中读取的数据ReadFcn财产。
TransformedDatastore 不同 类指定的基础数据存储返回的输出相同UnderlyingDatastores财产。例如,如果底层数据存储是图像数据存储,则数据作为单元格数组返回,其中单元格数组中的每个元素包含一张图像的图像数据。
CombinedDatastore 单元阵列

单元格数组的每一列都包含调用的结果readall控件指定的相应底层数据存储上的UnderlyingDatastores财产。

如果底层数据存储中数据子集的数量不同,则readall当所有底层数据存储都有数据时,只返回数据。例如,假设一个组合数据存储具有两个底层数据存储,其中一个具有子集的数据和一个有n数据子集,其中>n.输出是一个包含两列和的单元格数组n行。

SequentialDatastore 不同 输出是来自底层数据存储的所有数据垂直连接的结果。如果所有底层数据存储都为空,则输出为基于第一个底层数据存储的空类型。如果没有底层数据存储,则输出为空双精度值。

扩展功能

版本历史

介绍了R2014b

另请参阅

||

Baidu
map