getObjects              package:EBImage              R Documentation

_D_e_t_e_c_t_i_o_n _o_f _o_b_j_e_c_t_s _f_r_o_m _i_n_t_e_g_e_r-_b_a_s_e_d _s_e_g_m_e_n_t_e_d _i_m_a_g_e_s

_D_e_s_c_r_i_p_t_i_o_n:

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

_U_s_a_g_e:


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


_A_r_g_u_m_e_n_t_s:


     '_x' An object of 'Image-class' in the 'Grayscale' mode with
          integer-absed object encoding, as returned by 'watershed'. 

     '_r_e_f' 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. 

_V_a_l_u_e:

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

_S_e_e _A_l_s_o:

     ' Image-class, watershed, paintObjects '

_R_e_f_e_r_e_n_c_e_s:

     _ImageMagick_: <URL: http://www.imagemagick.org>.

_A_u_t_h_o_r(_s):

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

_E_x_a_m_p_l_e_s:

         ## Not run: See ?watershed for example
       

