Main Content


(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.



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


collapse all

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

collapse all

Image set, specified as an imageSet object.

Image location index, specified as a positive integer.

Output Arguments

collapse all

Image, returned as a numeric array.

Version History

Introduced in R2014b

collapse all

R2016b: read is not recommended

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.