Next: , Previous: , Up: Image Processing   [Contents][Index]


Particles

The Guile-CV procedures and methods to obtain and clean image particles.

Procedures

im-particles
im-particle-clean
Procedure: im-particles image features [#:clean #t]

Returns two values, a list of images (the particles) and a list of their bounding boxes in the original image.

Each returned image is a ‘particle’, which is a subpart of image determined by its bounding box, given by the left top right bottom values of the corresponding ‘entry’ in features (see im-features for a complete description of a feature value list.

When #:clean is #t, which is the default, im-particle-clean is called upon each particle (see below for a description of the expected result).

Procedure: im-particle-clean particle

Returns a new image.

Cleaning a particle (which is an image) means detecting and removing any object(s) that is(are) not connected to the ‘particle’ itself.

This procedure is based on the property that in a ‘particle’, which is an (sub)image resulting from a im-crop based on the bounding box coordinates as returned by im-features, there precisely is one object that, if you call im-features upon particle, would have its bounding box coordinates being the entire particle. In other words, if you call im-particle-clean upon an image that is not a ‘particle’, the result will just be a black image.