read

(Not recommended) Read image at specified index

The read function of the imageSet object is not recommended. Instead, use an imageDatastore object and its read and readimage functions. For more information, see Compatibility Considerations.

Syntax

im = read(imgSet,idx)

Description

im = read(imgSet,idx) returns an image from the image set, imgSet, located at the index idx.

Examples

Display Image from an Image Set

Create an image set.

imgFolder = fullfile(matlabroot,'toolbox','vision','visiondata','stopSignImages');
imgSet  = imageSet(imgFolder);

Display the fourth image from the set.

imshow(read(imgSet, 4));

Input Arguments

imgSet — Image set

imageSet object

Image set, specified as an imageSet object.

idx — Image location index

positive integer

Image location index, specified as a positive integer.

Output Arguments

im — Image

numeric array

Image, returned as a numeric array.

Version History

Introduced in R2014b

R2016b: read is not recommended

Not recommended starting in R2016b

The imageSet object and its read function are not recommended. Instead, manage collections of image data using an imageDatastore object, and read images from the image datastore using the read and readimage functions. There are no plans to remove the read function of the imageSet object.