addImages

Add new images to image index

collapse all in page

Syntax

addImages(imageIndex,imds)

addImages(imageIndex,I,imageId)

addImages(___,Verbose=tf)

Description

addImages(imageIndex,imds) adds the images in imds to imageIndex.

example

addImages(imageIndex,I,imageId) adds an image, I, to imageIndex, specified by the image identifier imageId.

addImages(___,Verbose=tf) specifies whether or not to display progress information, in addition to any combination of input arguments from previous syntaxes. By default, the addImages function displays progress information. To hide the display, specify tf as false.

Examples

collapse all

Add Image to Image Index

Open Live Script

Define a set of images to search

imageFiles = ...
  {'elephant.jpg', 'cameraman.tif', ...
   'peppers.png',  'saturn.png',...
   'pears.png',    'stapleRemover.jpg', ...
   'football.jpg', 'mandi.tif', ...
   'kids.tif',     'liftingbody.png', ...
   'office_5.jpg', 'gantrycrane.png', ...
   'moon.tif',     'circuit.tif', ...
   'tape.png',     'coins.png'};

imds = imageDatastore(imageFiles);

Learn the visual vocabulary of the image view set.

numlevels = 1;
branchingFactor = 1000;
bag = bagOfFeatures(imds,'PointSelection','Detector', ...
        'TreeProperties',[numlevels,branchingFactor],'Verbose',false);

Create an image search index.

imageIndex = invertedImageIndex(bag);

Add to the image view set images to the image search index.

addImages(imageIndex,imds);

Encoding images using Bag-Of-Features.
--------------------------------------

* Encoding 16 images...done.

Input Arguments

collapse all

`imageIndex` — Image search index
`invertedImageIndex` object

Image search index, specified as an invertedImageIndex object.

`imds` — Images
`ImageDatastore` object

Images, specified as an ImageDatastore object. imds contains new images to add to an existing index. The function does not ignore duplicate images.

`I` — Input image
M-by-N-by-3 array | M-by-N 2-D matrix

Input image, specified as either an M-by-N-by-3 array, representing a truecolor image, or an M-by-N array, representing a 2-D grayscale image.

`imageId` — Indexed image identifier
positive integer

Indexed image identifier, specified as an positive integer.

Tips

The addImages function supports parallel computing using multiple MATLAB^® workers. Enable parallel computing from the Computer Vision Toolbox Preferences dialog box. To open Computer Vision Toolbox™ preferences, on the Home tab, in the Environment section, select Preferences. Then select Computer Vision Toolbox.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

For code generation, the addImages object does not support the ImageDatastore object as input. Instead, specify the input as a structure with fields Images and Locations. The Images field must contain a cell array of grayscale or RGB color images. The Locations field must contain a cell array of the file paths to the locations of input images.

Version History

Introduced in R2015a