getObjects {EBImage} | R Documentation

## Detection of objects from integer-based segmented images

### Description

This function will assign `features` matrix to an image that was originally segmented with `watershed` or similar functions (i.e. in which objects are encoded as positive integers).

### Usage

        getObjects(x, ref, ...)
        stackObjects(x, ref, ...)
        features(x, ...)
        features(x, ...) <- value

### Arguments

`x`
  An object of `Image-class` in the `Grayscale` mode with integer-absed object encoding, as returned by `watershed`.
`ref`
  A reference image. This can be `NULL` or Grayscale for `getObjects` to determined object intensities. This must be present and can be in any color mode for `stackObjects`.
`...`
  Reserved for future use.

### Value

`getObjects` returns a list of matrixes (one per image in stack) with image descriptors. This list can be stored with the image using the set function `features<-` and retrieved from the object using the corresponding get function `features`. Every matrix in the list will contain named columns of features starting with object position, size, perimeter etc. with one row per object detected.

`stackObjects` returns a list of Image stacks with one element of a list for each frame in the original Image (-stack). Each Image stack will contain images of single objects positioned in the middle of the image in the same color mode as the reference images. The result can be directly supplied to `tile` to generate tiled previews.

### See Also

`Image-class, watershed, paintObjects`

### References

ImageMagick: http://www.imagemagick.org.

### Author(s)

Copyright (c) 2005-2006 Oleg Sklyar : osklyar@ebi.ac.uk

### Examples

        ## Not run: See ?watershed for example

[Package EBImage version 2.0.1 Index]