nonMaxSuprList

PURPOSE ^

Applies nonmaximal suppression to a list.

SYNOPSIS ^

function [subs,vals,keepLocs] = nonMaxSuprList( subs, vals, radii,thresh, maxn, suprEq)

DESCRIPTION ^

 Applies nonmaximal suppression to a list.

 See nonMaxSupr for more information.  Has the same effect as nonMaxSupr
 except it operates on a list of position/values pairs.  Running time is
 n^2 in the number of such pairs.  For comparison running time of
 nonMaxSupr is order( sum( size(I,d)*radii(d) ).

 This function has an additional parameter - suprEq that causes a value
 in a given window to be suppressed unless it is the UNIQUE maximum in the
 window.  This is if suprEq==1, then all locations that are not strictly
 the biggest in their window are suppressed.  This can be useful for large
 flat regions -- nonMaxSupr(ones(30),3) does no suppression since all
 values are equal in each window, but nonMaxSuprList(ones(30),3)
 suppresses all locations.

 USAGE
  [subs,vals,keepLocs] = nonMaxSuprList( subs, vals, radii, ...
                                        [thresh], [maxn], [suprEq] )

 INPUTS
  subs       - subscripts of point locations (m x d)
  vals       - values at point locations (m x 1)
  radii      - suppression window dimensions
  thresh     - [] minimum value below which not to look for (or [])
  maxn       - [] return at most maxn of the largest vals
  suprEq     - [] suppress equal vals (see above)

 OUTPUTS
  subs       - subscripts of non-suppressed point locations (n x d)
  vals       - values at non-suppressed point locations (n x 1)
  keepLocs   - indicies of kept locations from subs (n x 1)

 EXAMPLE

 See also SUBSTOARRAY, NONMAXSUPR, NONMAXSUPRWIN

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Wed 03-Oct-2007 13:09:09 by m2html © 2003