Name

---

    FIND_CLUSTER_CENTERS

Purpose

---

    This function will find the centroid coordinates for clusters
    located throughout a provided image. The clusters will first
    be refined by thresholding the provided image using the
    supplied digital count threshold value.

Category

---

    Image Processing.

Calling Sequence

---

    Result = $
        FIND_CLUSTER_CENTERS( image, $
                              threshold )

Return Value

---

    This function will return a 2xN array of cluster centroid values
    that have been located in the thresholded version of the image
    provided.

Inputs

---

    image:
        An array containing the clusters of points for which the
        centroid coordinates are to be found.
    threshold:
        A scalar defining the digital count threshold to be used
        in the creation of the binary version of the provided array.

Keyword Parameters

---

    NONE

Return Value

---

    This function returns a 2xn array containing the cluster center coordinates
    for the clusters identified by this routine.

Side Effects

---

    None

Requires

---

    FILL_REGIN
    FIND_CENTER

Reference

---

    Gonzalez, R.C. and R.E. Woods, Digital Image Processing,
    Third Edition, Prentice Hall, Upper Saddle River, New Jersey,
    2007 (ISBN: 0131687288X / ISBN-13: 978-0131687288)

Modification History

---

    Written by: Philip Salvaggio
    March, 2007 Original code
    September, 2008 Converted to a general-purpose routine (Carl Salvaggio)