本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

transform

转换数据存储

说明

示例

dsnew = transform(ds,@fcn) 使用转换函数 fcn 转换输入数据存储 ds,并返回转换后的数据存储 dsnew

dsnew = transform(ds,@fcn,'IncludeInfo',IncludeInfo) 使用转换函数 fcn 的替代定义。您可以通过替代定义使用数据存储的 read 函数返回的附加信息。

示例

全部折叠

为图像集合创建一个数据存储,并对数据存储中的所有图像应用相同的转换。例如,将集合中的所有图像调整到指定的目标大小。

创建一个包含两个图像的 ImageDatastore

imds = imageDatastore({'street1.jpg','peppers.png'})
imds = 
  ImageDatastore with properties:

                       Files: {
                              ' .../devel/bat/Bdoc19b/build/matlab/toolbox/matlab/demos/street1.jpg';
                              ' .../devel/bat/Bdoc19b/build/matlab/toolbox/matlab/imagesci/peppers.png'
                              }
    AlternateFileSystemRoots: {}
                    ReadSize: 1
                      Labels: {}
                     ReadFcn: @readDatastoreImage

读取所有图像。请注意,该数据存储包含不同大小的图像。

img1 = read(imds); % reads the first image
img2 = read(imds); % reads the next image
whos img1 img2
  Name        Size                Bytes  Class    Attributes

  img1      480x640x3            921600  uint8              
  img2      384x512x3            589824  uint8              

将数据存储中的所有图像转换为指定的目标大小。

targetSize = [224,224];
imdsReSz = transform(imds,@(x) imresize(x,targetSize));

读取图像并显示其大小。

imgReSz1 = read(imdsReSz);
imgReSz2 = read(imdsReSz);
whos imgReSz1 imgReSz2
  Name            Size                Bytes  Class    Attributes

  imgReSz1      224x224x3            150528  uint8              
  imgReSz2      224x224x3            150528  uint8              

显示调整大小后的图像。

subplot(121); imshow(imgReSz1); axis on; title('Resized Street1.jpg');
subplot(122); imshow(imgReSz2); axis on; title('Resized peppers.png');

输入参数

全部折叠

输入数据存储。有关内置数据存储的完整列表,请参阅Select Datastore for File Format or Application。您也可以指定自定义数据存储。

用于转换数据的函数,指定为函数句柄。该函数将数据作为输入,并根据 fcn 中定义的转换返回转换后的数据。

转换函数必须具有以下签名,并且 dataIn 必须与使用 read 函数返回的数据具有相同的形式。

function dataOut = transformFcn(dataIn)
..
end

您也可以将您的转换函数 fcn定义为使用有关 read 函数返回的数据的附加信息。要使用此替代定义,您必须将 IncludeInfo 的值指定为 true。在本例中,转换函数必须有以下签名。

function [dataOut,infoOut] = transformFcn(dataIn,infoIn)
..
end

示例: @transformFcn

数据类型: function_handle

包含来自 read 函数的信息,指定为 truefalseread 函数以 info 结构体形式返回有关所提取数据的信息。有关详细信息,请参阅 read 函数页。

当您将 IncludeInfo 的值设置为 true 时,您必须为转换函数 fcn 使用替代签名。

输出参数

全部折叠

包含转换后数据的新数据存储,以 TransformedDatastore 对象形式返回。

在 R2019a 中推出