combine

合并来自多个数据存储的数据

语法

dsnew = combine(ds1,ds2,...,dsN)

dsnew = combine(ds1,ds2,...,dsN) 通过水平串联 read 函数对输入数据存储返回的数据，合并两个或多个数据存储。

创建一个数据存储，用于维护基础数据存储的图像对之间的奇偶校验。例如，创建两个单独的图像数据存储，然后创建一个从这两个图像数据存储中读取对应图像的合并数据存储。

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

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

通过将 imds1 的图像变换为灰度图像，创建第二个数据存储 imds2。

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

基于 imds1 和 imds2 创建一个合并数据存储。

imdsCombined = combine(imds1,imds2);

从合并数据存储中读取第一对图像。对此合并数据存储的每次读取操作都会返回一对图像，表示为 1×2 元胞数组。

dataOut = read(imdsCombined)

dataOut=1×2 cell array
    {480x640x3 uint8}    {480x640 uint8}

显示对合并数据存储的第一次读取的输出。

imshow(imtile(dataOut));

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

要合并的数据存储，指定为两个或多个以逗号分隔的数据存储对象。有关内置数据存储的完整列表，请参阅Select Datastore for File Format or Application。您还可以指定自定义数据存储。

具有合并数据的新数据存储，以 CombinedDatastore 对象形式返回。

dsnew 对象是一个新数据存储实例，它是对每个基础数据存储进行读取操作的水平串联结果。

用法说明和限制：

在基于线程的环境中，您只能对以下数据存储使用 combine：
- ImageDatastore 对象
- 使用 combine 或 transform 从 ImageDatastore 对象创建的 CombinedDatastore 或 TransformedDatastore 对象
如果您有 Parallel Computing Toolbox™，则可以对其他数据存储使用 combine。为此，请使用基于进程的并行池运行该函数，而不是使用 backgroundPool 或 ThreadPool（使用 ProcessPool 或 ClusterPool）。