transform

Преобразуйте datastore

Описание

пример

dsnew = transform(ds1,ds2,...,dsN,@fcn) преобразует один или несколько входных хранилищ данных с помощью функции преобразования fcn и возвращает преобразованный datastore dsnew. fcn может быть помещен до или после всех входных хранилищ данных в вызове transform функция.

dsnew = transform(ds1,ds2,...,dsN,@fcn,'IncludeInfo',IncludeInfo) использует альтернативное определение функции преобразования fcn. Альтернативное определение позволяет использовать дополнительную информацию, возвращенную read функция datastore.

Примеры

свернуть все

Создайте datastore для набора изображений и примените то же преобразование ко всем изображениям в datastore. Например, измените размер всех изображений в наборе на заданный целевой размер.

Создайте ImageDatastore с двумя изображениями.

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

                       Files: {
                              ' .../devel/bat/BR2021ad/build/matlab/toolbox/matlab/demos/street1.jpg';
                              ' .../devel/bat/BR2021ad/build/matlab/toolbox/matlab/imagesci/peppers.png'
                              }
                     Folders: {
                              '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/demos';
                              '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/imagesci'
                              }
    AlternateFileSystemRoots: {}
                    ReadSize: 1
                      Labels: {}
      SupportedOutputFormats: ["png"    "jpg"    "jpeg"    "tif"    "tiff"]
         DefaultOutputFormat: "png"
                     ReadFcn: @readDatastoreImage

Прочитайте все изображения. Заметьте, что datastore содержит изображения разных размеров.

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              

Преобразуйте все изображения в datastore к заданному целевому размеру.

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');

Figure contains 2 axes. Axes 1 with title Resized Street1.jpg contains an object of type image. Axes 2 with title Resized peppers.png contains an object of type image.

Создайте несколько объектов datastore и примените одно и то же преобразование ко всем хранилищам данных. Например, объедините несколько изображений в одно прямоугольное мозаичное изображение.

Создайте ImageDatastore с одним изображением.

imds1 = imageDatastore({'ngc6543a.jpg'})
imds1 = 
  ImageDatastore with properties:

                       Files: {
                              ' .../devel/bat/BR2021ad/build/matlab/toolbox/matlab/demos/ngc6543a.jpg'
                              }
                     Folders: {
                              '/mathworks/devel/bat/BR2021ad/build/matlab/toolbox/matlab/demos'
                              }
    AlternateFileSystemRoots: {}
                    ReadSize: 1
                      Labels: {}
      SupportedOutputFormats: ["png"    "jpg"    "jpeg"    "tif"    "tiff"]
         DefaultOutputFormat: "png"
                     ReadFcn: @readDatastoreImage

Прочтите изображение в рабочую область, чтобы создать файл изображения из каждого цветового канала в оригинальное изображение.

rgbImage = imread('ngc6543a.jpg');
imwrite(rgbImage(:,:,1),'nebula_red.jpg');
imwrite(rgbImage(:,:,2),'nebula_green.jpg'); 
imwrite(rgbImage(:,:,3),'nebula_blue.jpg');

Создайте ImageDatastore объект для каждого одноканального изображения.

imdsR = imageDatastore({'nebula_red.jpg'});
imdsG = imageDatastore({'nebula_green.jpg'});
imdsB = imageDatastore({'nebula_blue.jpg'});

Считывайте изображение, хранящееся в каждом datastore, и отображайте их размеры.

imOriginal = read(imds1);
img_red = read(imdsR);
img_green = read(imdsG);
img_blue = read(imdsB);
whos img1 img_red img_green img_blue
  Name             Size              Bytes  Class    Attributes

  img_blue       650x600            390000  uint8              
  img_green      650x600            390000  uint8              
  img_red        650x600            390000  uint8              

Преобразуйте все хранилища данных путем объединения всех изображений в одно прямоугольное мозаичное изображение. Преобразуйте цветное изображение в imds1 в градации серого так, чтобы ее размеры совпадали с размерностями других изображений.

tds1 = transform(imds1,imdsR,imdsG,imdsB, @(x1,x2,x3,x4) [rgb2gray(x1),x2;x3,x4]);
tile = read(tds1);

Отобразите мозаичное изображение.

imshow(tile)

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

Входные параметры

свернуть все

Входные хранилища данных. Полный список встроенных хранилищ данных см. в разделе Выбор Datastore для формата файла или приложения. Можно также задать пользовательский datastore.

Функция, которая преобразует данные, заданная как указатель на функцию. Функция принимает данные как вход и возвращает преобразованные данные, основанные на преобразованиях, определенных в fcn.

Функция преобразования должна иметь эту сигнатуру и ds1_data,ds2_data,...dsN_data должна иметь ту же форму, что и данные, которые возвращаются при помощи read функция.

function dataOut = transformFcn(ds1_data,ds2_data,...dsN_data)
..
end

Кроме того, можно задать функцию преобразования fcn использовать дополнительную информацию о данных, возвращенных read функция. Чтобы использовать это альтернативное определение, необходимо задать значение IncludeInfo чтобы быть true. В этом случае функция преобразования должна иметь эту сигнатуру.

function [dataOut,infoOut] = transformFcn(ds1_data,ds2_data,...dsN_data,ds1_info,ds2_info...dsN_info)
..
end

Пример: @transformFcn

Типы данных: function_handle

Включите информацию из read функция, заданная как true или false. The read функция возвращает информацию об извлеченных данных в info struct. Для получения дополнительной информации смотрите read страница функции.

Когда вы задаете значение IncludeInfo на trueнеобходимо использовать альтернативную сигнатуру для функции преобразования fcn.

Выходные аргументы

свернуть все

Новый datastore с преобразованными данными, возвращенный как TransformedDatastore объект.

Введенный в R2019a