主要内容

readall

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

折叠所有页面

语法

数据= readall(ds)
数据= readall(ds,UseParallel=tf)

描述

例子

数据= readall (ds）返回指定的数据存储中的所有数据ds．如果数据存储中的所有数据都不适合内存，则readall返回一个错误。

例子

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

例子

全部折叠

打开实时脚本

创建一个ImageDatastore对象，其中包含四张图像。

imds = imageDatastore({“street1.jpg”，“street2.jpg”，“peppers.png”，“corn.tif”})；

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

T = readall(imds);

检查输出。

imout = imtile(T);imshow (imout)

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

打开实时脚本

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

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

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

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

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

T = readall(ds,UseParallel=true);

readall返回表中的所有数据。

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

T.Properties
描述:" UserData: [] DimensionNames: {'Row' 'Variables'} VariableNames: {'DepTime' 'ArrTime' 'ActualElapsedTime'} variabledescription: {} VariableUnits: {} variableccontinucontinuue: [] 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 = combine(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通过使用低开金宝app销的计算环境(例如基于线程的并行池)，本地机器上支持的数据存储的读取速度更快。有关基于线程的并行池的更多信息，请参见parpool(并行计算工具箱)．

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

例子:readall (ds, UseParallel = true)

输出参数

全部折叠

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

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

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

如果底层数据存储中数据子集的数量不同，则readall仅返回数据，而所有底层数据存储都有数据。例如，假设组合的数据存储有两个底层数据存储，其中一个具有米子集的数据和一个与n数据的子集，其中米>n．输出是一个包含两列和的单元格数组n行。
SequentialDatastore 不同 输出是来自底层数据存储的所有数据垂直连接的结果。如果所有底层数据存储都为空，则输出是基于第一个底层数据存储的空类型。如果没有底层数据存储，则输出为空double。

扩展功能

版本历史

在R2014b中引入

另请参阅

||