Read Image as ExampleSet

Synopsis

Brings in images as ExampleSet-s (1 colour channel = 1 ExampleSet, all colour channels are packed into one Collection per image).

Description

This operator takes an ExampleSet that contains the meta data of images and provides the numerical values of each color channel. For example if an image with the size 50x100 is read and it is in the RGB format (so three color channels), the output will be a Collection of three ExampleSets. All three ExampleSets will have 50 rows and 100 columns each, representing the rows and columns of pixel present. One ExampleSet will contain the red color values at the given position, while the others contain the values for green and blue. If the input ExampleSet with the meta data contains multiple rows one Collection of ExampleSets per image will be created.

The input ExampleSet is expected to have attributes with information about image locations, their width and height. Use the "Read Image Meta Data" operator to create an appropriate input ExampleSet.

Note: Images read with this operator can be visualized using the heatmap plot type in the result view. Make sure to select all columns as value columns.

Input

example set

ExampleSet containing image meta data (width, height, Path). E.g. created with the "Read Image Meta Data" operator.

Output

collection

Collection of ExampleSet collections containing image data (e.g.: RGB image has 3 channels = 3 ExampleSet for that image).

Parameters

Path

Attribute containing paths to images. Supported file formats: bmp, jpg, jpeg, jp2, pbm, pgm, ppm, pnm, png, tif, tiff, exr, webp.

Height

Attribute containing height information of images.

Width

Attribute containing width information of images.

Number of color channels

Number of channels to use, e.g. 1 for grayscale images and 3 for regular ones (RGB). This parameter influences the output structure. If 3 channels are choosen, a Collection of three ExampleSets is created for each image referenced in one row of the input ExampleSet.