ImageSourceFinder.h

Classes

ImageSourceFinder -- Provides functionality to find sources in an image (full description)

template <class T> class ImageSourceFinder

Interface

Public Members
ImageSourceFinder (const ImageInterface<T>&)
ImageSourceFinder (const ImageSourceFinder<T> &other)
~ImageSourceFinder()
ImageSourceFinder<T> &operator=(const ImageSourceFinder<T> &other)
ComponentList findSources (LogIO& os, Int nMax, Double cutoff=0.1, Bool absFind=True, Bool doPoint=True, Int width=4)
SkyComponent findSourceInSky (LogIO& os, Vector<Double>& absPixel, Double cutoff=0.1, Bool absFind=True, Bool doPoint=True, Int width=4)
Bool setNewImage (const ImageInterface<T>& image)
Private Members
ComponentList findSources (LogIO& os, const ImageInterface<T>& image, Int nMax, Double cutoff, Bool absFind, Bool doPoint, Int width)

Description

Review Status

Date Reviewed:
yyyy/mm/dd

Prerequisite

Etymology

It finds sources.

Synopsis

This class provides methods to find sources in an image.

The finding procedes in two stages. First, strong point sources are found via an efficient algorithm producing POINT components. If you wish, you can further request a Gaussian fit to these found point sources and then return the parameters of the fit (as a GAUSIAN component).

Example


 


 
Motivation

 This complements source fitting by providing an initial estimate
 


 
To Do






Member Description


ImageSourceFinder (const ImageInterface<T>&)

 Constructor

ImageSourceFinder (const ImageSourceFinder<T> &other)



 Copy constructor

~ImageSourceFinder()



 Destructor

ImageSourceFinder<T> &operator=(const ImageSourceFinder<T> &other)



 Assignment operator

ComponentList findSources (LogIO& os, Int nMax, Double cutoff=0.1, Bool absFind=True, Bool doPoint=True, Int width=4)



 Find strong sources.  nMax specifies the maximum number of sources to find.
 cutoff is the fractional cutoff (of peak) and soiurces below this limit
 will not be found. If absFind is True, only positive sources are found, else
 positive and negative are found. If doPoint=True, the returned components
 are of type POINT.  If doPoint=False, the position and shape information is 
 returned via a Gaussian fit (and components will be of
 type GAUSSIAN) to the point sources initially found.    The parameter width
 specifies the half-width of a square grid of pixels centered on the initial
 point source location to be used in the fit.  If you set doPoint=False and width=0,
 a default width of 3 and position angle 0 is returned in the GAUSSIAN component.
 Because  the flux of the component is integrated, this rough shape influences the 
 flux values as well.  

SkyComponent findSourceInSky (LogIO& os, Vector<Double>& absPixel, Double cutoff=0.1, Bool absFind=True, Bool doPoint=True, Int width=4)



 Find one source in sky plane.  Exception if no sky

Bool setNewImage (const ImageInterface<T>& image)



 Set a new image

ComponentList findSources (LogIO& os, const ImageInterface<T>& image, Int nMax, Double cutoff, Bool absFind, Bool doPoint, Int width)



 Find strong (point) sources