stella.adapter
Class StellaGuider

java.lang.Object
  util.PropertyContainer
      util.PropertyResources
          util.PropertyBundles
              stella.adapter.StellaGuider

All Implemented Interfaces:

Cloneable, Guiding, Initializable, LocalizedSupplying, PropertySupplying, ResourceSupplying

Direct Known Subclasses:

AbstractStarGuider, AdapterGuider

public class StellaGuider
extends PropertyBundles
implements Guiding

STELLA-I guider class.

Nested Class Summary

static class	StellaGuider.Continuous A class to test the continuous mode.
private class	StellaGuider.ExposeThread The thread that does continuous exposures.
private class	StellaGuider.ReduceThread This thread does the reduction of CCD data to a level that a list of detected stars can be retrieved.
static class	StellaGuider.Single Takes a single shot through the guider and detects the stars there.

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.URLResource

Nested classes/interfaces inherited from interface stella.adapter.Guiding

Guiding.RawFrame, Guiding.RawStar

Field Summary

protected File	biasfits The file name of the master bias or empty if not available.
protected double	biastime The exposure time of the bias, non-null on shutter-less systems.
private List<String>	bundlenames The list of bundle names.
private Map<String,ResourceBundle>	bundles A mapping of resource bundle names to resource bundle objects.
private CcdDriver	ccd My guider ccd camera.
private Object	ccdlock And my lock.
static int	CLEAN Flag for writing clean-images.
static String	CLEANNAME Ending of fits for clean image.
private long	contexpose If we ask for a continuous guiding, this is the exposure time.
private StarFinder	cppfits The star finder native interface.
private int	curcount The current exposure number, used by exposure thread, set reduced.
protected File	darkfits The file name of the master dark or empty if not available.
protected double	darktime The exposure time of the dark in ms.
private static float	DEFDEPTHMEDIAN Depth of the applied median filter.
private static String	DEFFITSDIR Default fits directory where the guider server writes.
private static float	DEFGAUSSFWHM FWHM of the gaussian filter applied.
private static float	DEFGAUSSTRUNCATE Truncation of the gaussian filter applied.
private static String	DEFGUIDINGIMG Default file name of the guider image.
private static double	DEFLOWPASS Characteristic length-scale of the low-pass filter applied.
private static double	DEFMAGTRUNCATE Raw entries truncate threshold.
private static String	DEFMATCHERVERSION Default matching algorithm to use.
private static String	DEFREDUCEDIR Default file name of the guider image.
private static long	DEFREDUCETIME The default reduce time during a guider period.
private static int	DEFSIZELOWPASS Radius of the applied low-pass filter.
private static int	DEFSIZEMEDIAN Radius of the applied median filter.
private StellaGuider.ExposeThread	doexpose This is the thread that continuosly exposes and notifies.
private StellaGuider.ReduceThread	doreduce This is the thread that continuosly reduces fits data.
static int	GAUSS Flag for writing enhanced-images.
static String	GAUSSNAME Ending of fits for gauss enhanced image.
static String	KEY_DEPTHMEDIAN Radius of the applied median filter.
static String	KEY_FITSDIR Directory path where the FITS image will be stored.
static String	KEY_GAUSSFWHM FWHM of the gaussian filter applied.
static String	KEY_GAUSSTRUNCATE Truncation of the gaussian filter applied.
static String	KEY_GUIDINGIMG Name of the CCD image.
static String	KEY_LOWPASS Characteristic length-scale of the low-pass filter applied.
static String	KEY_MAGTRUNCATE Raw entries deviating more then this from last catalog are deleted.
static String	KEY_MATCHERVERSION Matcher version.
static String	KEY_REDUCEDIR Directory path where the bias/dark frames reside.
static String	KEY_REDUCETIME Reduction time of a single guider loop execution.
static String	KEY_SIZELOWPASS Radius of the applied low-pass filter.
static String	KEY_SIZEMEDIAN Radius of the applied median filter.
static int	LOWPASS Flag for writing lowpass-images.
static String	LOWPASSNAME Ending of fits for lowpass image.
protected Dimension	maxsize The maximum size of the ccd, queried at registering.
static int	MEDIAN Flag for writing median-images.
static String	MEDIANNAME Ending of fits for reduced image.
static String	RECTANGULARMATCHER Constatn for RectangularMatcher matcher version.
static int	REDUCED Flag for writing reduced images.
static String	REDUCEDNAME Ending of fits for reduced image.
private Locale	region The locale used for this property container.
static int	SKYFRAME Pixel width of the skyframe in native part.
static String	STARREGISTER Constant for StarRegister matcher version.

Fields inherited from class util.PropertyBundles

KEY_LOCALECOUNTRY, KEY_LOCALELANGUAGE, KEY_RESOURCEBUNDLES

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, localurl, locate, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_URL, urlset

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Constructor Summary

StellaGuider(Map<String,String> info)
Constructor.

Method Summary

protected double	background(Point2D center, int xoff, int yoff, int binx, int biny, int box) Returns the background estimate around the anticipated star.
void	cancelContinuous() Stops a continuous guiding exposure.
protected int	countSum(Point2D center, int xoff, int yoff, int binx, int biny, int box) Returns the count sum around the anticipated star.
protected double	fluxInside(int sbox, double fwhm) Returns the amount of flux inside the quadratic aperture in pixel, if the fwhm is given.
protected CcdDriver	getCcd() Returns the ccd driver.
protected Dimension	getCcdSize() Returns the maximum size of the guider ccd.
List<Guiding.RawStar>	getContinuousList() Retrieves the recently read stars during continuos operation.
long	getContinuousMinimumExpose() Returns the minimum time allowd in continuous mode.
protected int	getCurrentExpsoureNumber() Returns the current exposure number, which may differ from the current reduce number.
protected File	getFitsDir() Returns the directory where the fits file will be writtn.
List<Guiding.RawStar>	getGuidingStars(Guiding.RawFrame frame, long expt, float gaussfwhm, float gausstrunc, int datamin, int datamax, int search, String type, String store, int steps)
List<Guiding.RawStar>	getGuidingStars(Guiding.RawFrame frame, long expt, int datamin, int datamax, int search, String type) Takes a guiding frame and processes it in a way that any steps necessary to derive star positions out of it.
List<Guiding.RawStar>	getGuidingStars(Guiding.RawFrame frame, long expt, int datamin, int datamax, int search, String type, String store, int steps) Takes a guiding frame and processes it in a way that any steps necessary to derive star positions out of it.
boolean	isReady() Returns if we are ready to take guider ccd images.
Point2D	match(List<? extends Guiding.RawStar> raw, List<? extends Guiding.RawStar> catalog, double deltaPix, double dmag) Matches a list of Guiding.RawStars measured against a list of Guiding.RawStars constructed from a catalog.
protected double	photometry(Point2D center, int xoff, int yoff, int binx, int biny, double fwhm, int box) Does aperture photometry.
void	prepareContinuous(long expt) Prepares a continuous guiding exposure.
protected List<Guiding.RawStar>	reduceFitsFile(File fitsfile, String biasname, double btime, String darkname, double dtime, int xoff, int yoff, int binx, int biny, long expt, float gaussfwhm, float gausstrunc, int datamin, int datamax, int search, String type, String store, int steps) Does reduction on a writtn fits file.
void	registerCcd(CcdDriver fechner) Registers the guider ccd driver to the stella guider.
protected void	setBiasReduction(File biasfile, double exposure) Sets the fits file holding the bias frame, and additionally on shutter-less systems, the exposure time of the bias frame.
protected void	setDarkReduction(File darkfile, double exposure) Sets the fits file holding the bias frame, and additionally on shutter-less systems, the exposure time of the bias frame.
boolean	startContinuous(String keepfits, float gaufwhm, float gautrunc, int min, int max, int box, int keep, FrameShifting guide, PostReducing loop) Starts a continuous guiding exposure.
boolean	startContinuous(String keepfits, int min, int max, int box, int keep, FrameShifting guide, PostReducing loop) Starts a continuous guiding exposure.
void	stopContinuous()

Methods inherited from class util.PropertyBundles

clone, getLocalized, getLocalized, getLocalizedString, getLocalizedString, loadResource

Methods inherited from class util.PropertyResources

createFrom, createFrom, createFrom, getApplet, getAsResources, getLocalClassLoader, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, init, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

augment, augment, augment, defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsEnums, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, isNew, parseObject, reload, removeProperty, rescanned, setObject, setProperties, setProperty, stringProperties, toString

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface util.ResourceSupplying

getResource, getResourceAsStream, getResources

Methods inherited from interface util.PropertySupplying

defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

Methods inherited from interface util.Initializable

init

Field Detail

REDUCED

public static final int REDUCED

Flag for writing reduced images.

See Also:

Constant Field Values

LOWPASS

public static final int LOWPASS

Flag for writing lowpass-images.

See Also:

Constant Field Values

MEDIAN

public static final int MEDIAN

Flag for writing median-images.

See Also:

Constant Field Values

CLEAN

public static final int CLEAN

Flag for writing clean-images.

See Also:

Constant Field Values

GAUSS

public static final int GAUSS

Flag for writing enhanced-images.

See Also:

Constant Field Values

SKYFRAME

public static final int SKYFRAME

Pixel width of the skyframe in native part.

See Also:

Constant Field Values

REDUCEDNAME

public static final String REDUCEDNAME

Ending of fits for reduced image.

See Also:

Constant Field Values

LOWPASSNAME

public static final String LOWPASSNAME

Ending of fits for lowpass image.

See Also:

Constant Field Values

MEDIANNAME

public static final String MEDIANNAME

Ending of fits for reduced image.

See Also:

Constant Field Values

CLEANNAME

public static final String CLEANNAME

Ending of fits for clean image.

See Also:

Constant Field Values

GAUSSNAME

public static final String GAUSSNAME

Ending of fits for gauss enhanced image.

See Also:

Constant Field Values

STARREGISTER

public static final String STARREGISTER

Constant for StarRegister matcher version.

See Also:

Constant Field Values

RECTANGULARMATCHER

public static final String RECTANGULARMATCHER

Constatn for RectangularMatcher matcher version.

See Also:

Constant Field Values

KEY_FITSDIR

public static final String KEY_FITSDIR

Directory path where the FITS image will be stored.

See Also:

Constant Field Values

KEY_GUIDINGIMG

public static final String KEY_GUIDINGIMG

Name of the CCD image.

See Also:

Constant Field Values

KEY_REDUCEDIR

public static final String KEY_REDUCEDIR

Directory path where the bias/dark frames reside.

See Also:

Constant Field Values

KEY_SIZELOWPASS

public static final String KEY_SIZELOWPASS

Radius of the applied low-pass filter.

See Also:

Constant Field Values

KEY_LOWPASS

public static final String KEY_LOWPASS

Characteristic length-scale of the low-pass filter applied.

See Also:

Constant Field Values

KEY_SIZEMEDIAN

public static final String KEY_SIZEMEDIAN

Radius of the applied median filter.

See Also:

Constant Field Values

KEY_DEPTHMEDIAN

public static final String KEY_DEPTHMEDIAN

Radius of the applied median filter.

See Also:

Constant Field Values

KEY_GAUSSFWHM

public static final String KEY_GAUSSFWHM

FWHM of the gaussian filter applied.

See Also:

Constant Field Values

KEY_GAUSSTRUNCATE

public static final String KEY_GAUSSTRUNCATE

Truncation of the gaussian filter applied.

See Also:

Constant Field Values

KEY_MATCHERVERSION

public static final String KEY_MATCHERVERSION

Matcher version.

See Also:

Constant Field Values

KEY_REDUCETIME

public static final String KEY_REDUCETIME

Reduction time of a single guider loop execution.

See Also:

Constant Field Values

KEY_MAGTRUNCATE

public static final String KEY_MAGTRUNCATE

Raw entries deviating more then this from last catalog are deleted.

See Also:

Constant Field Values

DEFFITSDIR

private static final String DEFFITSDIR

Default fits directory where the guider server writes.

See Also:

Constant Field Values

DEFGUIDINGIMG

private static final String DEFGUIDINGIMG

Default file name of the guider image. Will be overwrittn.

See Also:

Constant Field Values

DEFREDUCEDIR

private static final String DEFREDUCEDIR

Default file name of the guider image. Will be overwrittn.

See Also:

Constant Field Values

DEFSIZELOWPASS

private static final int DEFSIZELOWPASS

Radius of the applied low-pass filter.

See Also:

Constant Field Values

DEFLOWPASS

private static final double DEFLOWPASS

Characteristic length-scale of the low-pass filter applied.

See Also:

Constant Field Values

DEFSIZEMEDIAN

private static final int DEFSIZEMEDIAN

Radius of the applied median filter.

See Also:

Constant Field Values

DEFDEPTHMEDIAN

private static final float DEFDEPTHMEDIAN

Depth of the applied median filter.

See Also:

Constant Field Values

DEFGAUSSFWHM

private static final float DEFGAUSSFWHM

FWHM of the gaussian filter applied.

See Also:

Constant Field Values

DEFGAUSSTRUNCATE

private static final float DEFGAUSSTRUNCATE

Truncation of the gaussian filter applied.

See Also:

Constant Field Values

DEFMATCHERVERSION

private static final String DEFMATCHERVERSION

Default matching algorithm to use.

See Also:

Constant Field Values

DEFREDUCETIME

private static final long DEFREDUCETIME

The default reduce time during a guider period.

See Also:

Constant Field Values

DEFMAGTRUNCATE

private static final double DEFMAGTRUNCATE

Raw entries truncate threshold.

See Also:

Constant Field Values

biasfits

protected File biasfits

The file name of the master bias or empty if not available.

biastime

protected double biastime

The exposure time of the bias, non-null on shutter-less systems.

darkfits

protected File darkfits

The file name of the master dark or empty if not available.

darktime

protected double darktime

The exposure time of the dark in ms.

ccd

private CcdDriver ccd

My guider ccd camera.

ccdlock

private Object ccdlock

And my lock.

maxsize

protected Dimension maxsize

The maximum size of the ccd, queried at registering.

cppfits

private StarFinder cppfits

The star finder native interface.

contexpose

private long contexpose

If we ask for a continuous guiding, this is the exposure time.

doexpose

private StellaGuider.ExposeThread doexpose

This is the thread that continuosly exposes and notifies.

doreduce

private StellaGuider.ReduceThread doreduce

This is the thread that continuosly reduces fits data.

curcount

private int curcount

The current exposure number, used by exposure thread, set reduced.

region

private Locale region

The locale used for this property container.

bundlenames

private List<String> bundlenames

The list of bundle names. Initialized on first unspecific search.

bundles

private Map<String,ResourceBundle> bundles

A mapping of resource bundle names to resource bundle objects.

Constructor Detail

StellaGuider

public StellaGuider(Map<String,String> info)

Constructor.

Method Detail

getFitsDir

protected File getFitsDir()

Returns the directory where the fits file will be writtn.

setBiasReduction

protected void setBiasReduction(File biasfile,
                                double exposure)

Sets the fits file holding the bias frame, and additionally on shutter-less systems, the exposure time of the bias frame.

Parameters:

biasfile - The fits file containing the bias frame.

exposure - The exposure time of this frame in milliseconds.

setDarkReduction

protected void setDarkReduction(File darkfile,
                                double exposure)

Sets the fits file holding the bias frame, and additionally on shutter-less systems, the exposure time of the bias frame.

Parameters:

darkfile - The fits file containing the dark frame.

exposure - The exposure time of this frame in milliseconds.

registerCcd

public void registerCcd(CcdDriver fechner)

Registers the guider ccd driver to the stella guider. The ccd must be initialized by the caller.

Specified by:

registerCcd in interface Guiding

getCcd

protected CcdDriver getCcd()

Returns the ccd driver.

isReady

public boolean isReady()

Returns if we are ready to take guider ccd images. This means that we have a guider ccd registerd and that this ccd is open.

getGuidingStars

public List<Guiding.RawStar> getGuidingStars(Guiding.RawFrame frame,
                                             long expt,
                                             int datamin,
                                             int datamax,
                                             int search,
                                             String type)
                                      throws IOException,
                                             IllegalWindowException,
                                             IllegalSearchBoxException

Takes a guiding frame and processes it in a way that any steps necessary to derive star positions out of it. The returned list is a list of Guiding.RawStars. The search box is a dimension in pixel.

Specified by:

getGuidingStars in interface Guiding

Parameters:

guide - A rectangle specifying the guiding frame in pixel.

binx - Binning factor in x.

biny - Binning factor in y.

expt - The exposure time in ms.

search - The size of the quadratic search box in unbinned pixel.

datamin - Minimum data value to consider.

datamax - Maximum data value to consider to exclude cosmics.

Returns:

A list of Guiding.RawStars.

Throws:

IllegalWindowException - If the rectangle is invalid, i.e. if the size and/or the upper left coordinate cannot be realized on the guider CCD.

IllegalSearchBoxException - If the search box is too large.

IOException - If the CCD cannot be read.

getGuidingStars

public List<Guiding.RawStar> getGuidingStars(Guiding.RawFrame frame,
                                             long expt,
                                             int datamin,
                                             int datamax,
                                             int search,
                                             String type,
                                             String store,
                                             int steps)
                                      throws IOException,
                                             IllegalWindowException,
                                             IllegalSearchBoxException

Takes a guiding frame and processes it in a way that any steps necessary to derive star positions out of it. The returned list is a list of Guiding.RawStars. The search box is a dimension in pixel. Additionally the user may specify which reduction fits should be stored giving a truncated file name and an integer specifying the fits to store.

Parameters:

guide - A rectangle specifying the guiding frame in pixel.

binx - Binning factor in x.

biny - Binning factor in y.

expt - The exposure time in ms.

search - The size of the quadratic search box in unbinned pixel.

datamin - Minimum data value to consider.

datamax - Maximum data value to consider to exclude cosmics.

store - A truncated file name for the guider frames

steps - An ored int of MEDIAN etc.

Returns:

A list of Guiding.RawStars.

Throws:

IllegalWindowException - If the rectangle is invalid, i.e. if the size and/or the upper left coordinate cannot be realized on the guider CCD.

IllegalSearchBoxException - If the search box is too large.

IOException - If the CCD cannot be read.

getGuidingStars

public List<Guiding.RawStar> getGuidingStars(Guiding.RawFrame frame,
                                             long expt,
                                             float gaussfwhm,
                                             float gausstrunc,
                                             int datamin,
                                             int datamax,
                                             int search,
                                             String type,
                                             String store,
                                             int steps)
                                      throws IOException,
                                             IllegalWindowException,
                                             IllegalSearchBoxException

Throws:

IOException

IllegalWindowException

IllegalSearchBoxException

prepareContinuous

public void prepareContinuous(long expt)
                       throws IOException,
                              IllegalWindowException

Prepares a continuous guiding exposure. This method must be called before any call to startContinuous(java.lang.String, int, int, int, int, stella.adapter.FrameShifting, stella.adapter.PostReducing). The settings are invalidated with a call to #stopContiuous.

Throws:

IOException

IllegalWindowException

getContinuousMinimumExpose

public long getContinuousMinimumExpose()

Returns the minimum time allowd in continuous mode.

startContinuous

public boolean startContinuous(String keepfits,
                               int min,
                               int max,
                               int box,
                               int keep,
                               FrameShifting guide,
                               PostReducing loop)

Starts a continuous guiding exposure. This method starts two thread, one doing the exposure and one doing the reduction of the image taken. Until the continuous guiding is stopped with #stopContiuous, lists of raw stars can be retrieved with #getLatestStars. The method does return immediately.
Uses default values for fwhm and truncate in gauss fitting.

startContinuous

public boolean startContinuous(String keepfits,
                               float gaufwhm,
                               float gautrunc,
                               int min,
                               int max,
                               int box,
                               int keep,
                               FrameShifting guide,
                               PostReducing loop)

Starts a continuous guiding exposure. This method starts two thread, one doing the exposure and one doing the reduction of the image taken. Until the continuous guiding is stopped with stopContinuous(), lists of raw stars can be retrieved with getContinuousList(). The method does return immediately.

cancelContinuous

public void cancelContinuous()

Stops a continuous guiding exposure.

stopContinuous

public void stopContinuous()

getContinuousList

public List<Guiding.RawStar> getContinuousList()
                                        throws IOException

Retrieves the recently read stars during continuos operation.

Throws:

IOException

getCcdSize

protected Dimension getCcdSize()

Returns the maximum size of the guider ccd.

getCurrentExpsoureNumber

protected int getCurrentExpsoureNumber()

Returns the current exposure number, which may differ from the current reduce number.

photometry

protected double photometry(Point2D center,
                            int xoff,
                            int yoff,
                            int binx,
                            int biny,
                            double fwhm,
                            int box)

Does aperture photometry.

Parameters:

center - The star center in physical CCD-coordinates.

xoff - Upper left corner of the frame, x.

yoff - Upper left corner of the frame, y.

binx - Binning in x direction.

biny - Binning in y direction.

fwhm - In unbinned pixels, determined from somewhere else, probably the seeing fit.

box - Radius of the squared aperture box in unbinned pixel.

fluxInside

protected double fluxInside(int sbox,
                            double fwhm)

Returns the amount of flux inside the quadratic aperture in pixel, if the fwhm is given. Only the ratio of fwhm to sbox is used, so binning is not an issue, if the same for both values.

background

protected double background(Point2D center,
                            int xoff,
                            int yoff,
                            int binx,
                            int biny,
                            int box)

Returns the background estimate around the anticipated star.

Parameters:

center - The star center in physical CCD-coordinates.

xoff - Upper left corner of the frame, x.

yoff - Upper left corner of the frame, y.

binx - Binning in x direction.

biny - Binning in y direction.

box - Radius of the squared aperture box in unbinned pixel.

countSum

protected int countSum(Point2D center,
                       int xoff,
                       int yoff,
                       int binx,
                       int biny,
                       int box)

Returns the count sum around the anticipated star.

Parameters:

center - The star center in physical CCD-coordinates.

xoff - Upper left corner of the frame, x.

yoff - Upper left corner of the frame, y.

binx - Binning in x direction.

biny - Binning in y direction.

box - Radius of the squared aperture box in unbinned pixel.

reduceFitsFile

protected List<Guiding.RawStar> reduceFitsFile(File fitsfile,
                                               String biasname,
                                               double btime,
                                               String darkname,
                                               double dtime,
                                               int xoff,
                                               int yoff,
                                               int binx,
                                               int biny,
                                               long expt,
                                               float gaussfwhm,
                                               float gausstrunc,
                                               int datamin,
                                               int datamax,
                                               int search,
                                               String type,
                                               String store,
                                               int steps)

Does reduction on a writtn fits file.

Parameters:

binx - Binning factor in x.

biny - Binning factor in y.

expt - The exposure time in ms.

search - The size of the quadratic search box in unbinned pixel.

datamin - Minimum data value to consider.

datamax - Maximum data value to consider to exclude cosmics.

type - Ignored, may be null

store - A truncated file name for the guider frames

steps - An ored int of MEDIAN etc.

Returns:

A list of Guiding.RawStars.

match

public Point2D match(List<? extends Guiding.RawStar> raw,
                     List<? extends Guiding.RawStar> catalog,
                     double deltaPix,
                     double dmag)
              throws AmbiguousPatternException,
                     NoStarException,
                     CannotMatchException

Matches a list of Guiding.RawStars measured against a list of Guiding.RawStars constructed from a catalog. In constructing the list from a catalog, an extra border is applied to account for possible misspointings of the telescope. The supplied pixel values are applied to both sides of the guiding frame.

Specified by:

match in interface Guiding

Parameters:

raw - The list of Guiding.RawStars. The master deletes all invalid (i.e. non-star objects) from the list returned by getGuidingStars(stella.adapter.Guiding.RawFrame, long, int, int, int, java.lang.String).

catalog - The list of Guiding.RawStarss provided by the AdapterMaster, calculated from a star catalog. This list will comprise a bigger field then the expected actual guider field.

width - The additional frame thickness between catalog and image in pixel.

height - The additional frame thickness between catalog and image in pixel.

deltaPix - expected uncertainity of the catalog positions in pixels.

Returns:

The shift of the catalog position minus the measured position.

Throws:

AmbiguousPatternException - If more stars are seen in the raw data than can be matched to the catalog.

NoStarException - If the supplied list of raw stars is empty.

CannotMatchException - If matching fails for any other reason.