edgeFeatures             package:EBImage             R Documentation

_E_x_t_r_a_c_t_i_o_n _o_f _e_d_g_e _p_r_o_f_i_l_e_s _a_n_d _e_d_g_e _f_e_a_t_u_r_e_s _f_r_o_m _i_m_a_g_e _o_b_j_e_c_t_s

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

     Extract the edge profile from image objects, computing for each
     object the distances of edge points to the object geometric
     center, at different rotation angles.

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

       edgeFeatures(x, ref)
       edgeProfile(x, ref, n=32, fft=TRUE, scale=TRUE, rotate=TRUE)
      

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

       x: An 'Image' object or an array containing object masks. Object
          masks are sets of pixels with the same unique integer value.

     ref: An 'Image' object or an array, containing the intensity
          values of the objects.

       n: An integer value giving the number of angle measures. The
          full circle of '[-pi,pi]' is divided into 'n-1' segments, at
          which edges the profile is approximated. 

     fft: A logical value. If 'TRUE', the resulting profile is the
          'fft' transformation of the distance profile giving the
          frequences of angular changes in shape. 

   scale: A logical value. If 'TRUE', the resulting profile is scaled
          by the effective radius (calcualted as part of
          'link{hull.features}') making the profile scale invariant. 

  rotate: A logical value. If 'TRUE', the resulting profile is shifted
          by the object's roation angle (calculated from the 'moments'
          on the 'ref' image, if provided, and on the hull otherwise. 

_D_e_t_a_i_l_s:

     'edgeFeatures' returns the following features:

        *  'e.irr': difference between the smallest and largest
           distance profile values.

        *  'e.f2Pi': 2pi/1 frequency component of the distance profile.

        *  'e.fPi': 2pi/2 frequency component of the distance profile.

        *  'e.f2Pi3': 2pi/3 frequency component of the distance
           profile.

        *  'e.fPi2': 2pi/4 frequency component of the distance profile.

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

     'edgeFeatures' returns a matrix (or a list of matrices if 'x'
     contains multiple frames) of features computed of the objects
     present in 'x' and using the intensity values of 'ref'.

     'edgeProfile' returns a matrix ((or a list of matrices if 'x'
     contains multiple frames) of profile values, corresponding, from
     left to right, to the equidistant divisions of the range
     '[-pi,pi]' if 'fft' is 'FALSE'. Otherwise, the matrix contains the
     FFT transform of the corresponding distance profile.

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

     Oleg Sklyar, osklyar@ebi.ac.uk, 2007

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

     'getFeatures', 'ocontour'

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

        example(getFeatures)

