stella.acquire

Class TruncatedGaussClassification

java.lang.Object

util.PropertyContainer

util.PropertyResources

stella.acquire.TruncatedGaussClassification

All Implemented Interfaces:

Cloneable, ImageClassifying, PropertySupplying, ResourceSupplying

public class TruncatedGaussClassification
extends PropertyResources
implements ImageClassifying

Author:

wooz

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private int	datamax
private int	datamin
private double	gauss
static String	KEY_BACKTHICK The thickness for the background frame around searchbox.
static String	KEY_BACKTHRESHOLD For signal, ADU must be at least this sigma above background.
static String	KEY_DETECTIONLIMIT Stars have a probability higher than this value.
static String	KEY_ELONGATIONMAX The maximum elongation for a valid star detection, 0=round.
static String	KEY_ELONGATIONWIDTH The steepness of the elongation drop.
static String	KEY_GLOBALWIDTH The sharpness peak width for a valid star detection.
static String	KEY_NATIVEFRAME Thickness of frame to be skipped in addition to searchbox.
static String	KEY_SHARPLOWLIMIT Overexposed star may even fall below this.
static String	KEY_SHARPLOWVALUE Then we give this for the sharpness indicator.
static String	KEY_SHARPPEAKS The sharpness peak for a valid star detection.
static String	KEY_SHARPWIDTHS The sharpness peak width for a valid star detection.
static String	KEY_STRIPDISTANCE Read-out stripes have this maximum column offset.
static String	KEY_STRIPESMAX Read-out stripes have this maximum stroke.
static String	KEY_SURESTRIPES Strokes below this are immediately identified as stripes.
private PersitentAcquiring	save
private int	searchbox
private boolean	shutter
private int	stripes
private double	truncate

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

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

Constructors

Constructor and Description
TruncatedGaussClassification(Map<String,String> props)

Method Summary

Modifier and Type	Method and Description
List<StarDetection>	detect(MImageHDU reduced, Rectangle readout, Dimension bin) Converts a reduced detector image into a list of possible stars.
protected List<StarDetection>	detect(MImageHDU reduced, Rectangle readout, Dimension bin, double gauss, double trunc, int datamin, int datamax, int searchbox, PersitentAcquiring save)
private List<StarDetection>	getStrip(List<StarDetection> principal, Point2D center) We scan a list of StarProspect.RawStars and return all entries that are within a certain column, defined in center.
boolean	isShutterless()
private boolean	isStar(StarDetection star) We compare the stars sharpness with an allowed list of peaks and width.
boolean	isValid()
List<StarDetection>	removeGhosts(List<StarDetection> mirrors, List<StarDetection> found) Default empty.
List<StarDetection>	removeMirrors(List<StarDetection> found) Default empty.
List<StarDetection>	removeSpurious(List<StarDetection> raw) Removes the spurious detections from the list of stars detected.
List<StarDetection>	removeStripes(List<StarDetection> stars) For bright stars, read-out stripes may be seen in the image if CCD operation is shutterless.
void	setAduMinMax(int adumin, int adumax)
void	setGaussFiltering(double fwhm, double size)
void	setPersistantAcquiring(PersitentAcquiring unit)
boolean	setReadoutStripes(int adu) Expected ADU signal for a read-out stripe on shutterless systems.
void	setSearchbox(int halfbox)
boolean	setShutterless(boolean noshutter) If called with true, we indicate that we have shutterless readout, i.e.

Methods inherited from class util.PropertyResources

clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

augment, augment, 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, parseObject, reload, removeProperty, requires, 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.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

Field Detail

KEY_NATIVEFRAME

public static final String KEY_NATIVEFRAME

Thickness of frame to be skipped in addition to searchbox.

See Also:

Constant Field Values

KEY_BACKTHICK

public static final String KEY_BACKTHICK

The thickness for the background frame around searchbox.

See Also:

Constant Field Values

KEY_BACKTHRESHOLD

public static final String KEY_BACKTHRESHOLD

For signal, ADU must be at least this sigma above background.

See Also:

Constant Field Values

KEY_DETECTIONLIMIT

public static final String KEY_DETECTIONLIMIT

Stars have a probability higher than this value.

See Also:

Constant Field Values

KEY_SHARPPEAKS

public static final String KEY_SHARPPEAKS

The sharpness peak for a valid star detection.

See Also:

Constant Field Values

KEY_SHARPWIDTHS

public static final String KEY_SHARPWIDTHS

The sharpness peak width for a valid star detection.

See Also:

Constant Field Values

KEY_GLOBALWIDTH

public static final String KEY_GLOBALWIDTH

The sharpness peak width for a valid star detection.

See Also:

Constant Field Values

KEY_ELONGATIONMAX

public static final String KEY_ELONGATIONMAX

The maximum elongation for a valid star detection, 0=round.

See Also:

Constant Field Values

KEY_ELONGATIONWIDTH

public static final String KEY_ELONGATIONWIDTH

The steepness of the elongation drop.

See Also:

Constant Field Values

KEY_SHARPLOWLIMIT

public static final String KEY_SHARPLOWLIMIT

Overexposed star may even fall below this.

See Also:

Constant Field Values

KEY_SHARPLOWVALUE

public static final String KEY_SHARPLOWVALUE

Then we give this for the sharpness indicator.

See Also:

Constant Field Values

KEY_SURESTRIPES

public static final String KEY_SURESTRIPES

Strokes below this are immediately identified as stripes.

See Also:

Constant Field Values

KEY_STRIPESMAX

public static final String KEY_STRIPESMAX

Read-out stripes have this maximum stroke.

See Also:

Constant Field Values

KEY_STRIPDISTANCE

public static final String KEY_STRIPDISTANCE

Read-out stripes have this maximum column offset.

See Also:

Constant Field Values

shutter

private boolean shutter

gauss

private double gauss

truncate

private double truncate

stripes

private int stripes

datamin

private int datamin

datamax

private int datamax

searchbox

private int searchbox

save

private PersitentAcquiring save

Constructor Detail

TruncatedGaussClassification

public TruncatedGaussClassification(Map<String,String> props)

Parameters:

props -

Method Detail

setGaussFiltering

public void setGaussFiltering(double fwhm,
                              double size)

setAduMinMax

public void setAduMinMax(int adumin,
                         int adumax)

setSearchbox

public void setSearchbox(int halfbox)

isValid

public boolean isValid()

setPersistantAcquiring

public void setPersistantAcquiring(PersitentAcquiring unit)

setShutterless

public boolean setShutterless(boolean noshutter)

If called with true, we indicate that we have shutterless readout, i.e. possible read-out stripes.

Specified by:

setShutterless in interface ImageClassifying

Parameters:

noshutter -

isShutterless

public boolean isShutterless()

setReadoutStripes

public boolean setReadoutStripes(int adu)

Description copied from interface: ImageClassifying

Expected ADU signal for a read-out stripe on shutterless systems.

Specified by:

setReadoutStripes in interface ImageClassifying

detect

public List<StarDetection> detect(MImageHDU reduced,
                                  Rectangle readout,
                                  Dimension bin)
                           throws BasicFitsException

Description copied from interface: ImageClassifying

Converts a reduced detector image into a list of possible stars.

Specified by:

detect in interface ImageClassifying

Returns:

Throws:

BasicFitsException

detect

protected List<StarDetection> detect(MImageHDU reduced,
                                     Rectangle readout,
                                     Dimension bin,
                                     double gauss,
                                     double trunc,
                                     int datamin,
                                     int datamax,
                                     int searchbox,
                                     PersitentAcquiring save)
                              throws BasicFitsException

Parameters:

reduced - The bias-subtracted, dark corrected and flat-fielded image.

readout - Readout window on detector (for detector positions).

bin - Binning used (for detector positions).

gauss - FWHM-Size of Gaussian filter in unbinned pixel.

trunc - Truncation radius of Gaussian filter, multiple of FWHM.

datamin - Minimum ADU to account for a star signal.

datamax - Maximum ADU to account for a star signal.

searchbox - All detected pixel within this box belong to a star. If too small, a star might show up as two detections. If too big, binaries may show up only as a single detection.

Throws:

BasicFitsException

removeSpurious

public List<StarDetection> removeSpurious(List<StarDetection> raw)

Description copied from interface: ImageClassifying

Removes the spurious detections from the list of stars detected.

Specified by:

removeSpurious in interface ImageClassifying

Parameters:

raw - All possible stars, on return without spurious detections

Returns:

The spurious list or null.

removeStripes

public List<StarDetection> removeStripes(List<StarDetection> stars)

For bright stars, read-out stripes may be seen in the image if CCD operation is shutterless. We remove those here assuming the following: The star that produces the read-out stripes is always at the position with the highest y value. Stripes have only marginally different x. The stroke parameter of the raw star is then queried, if it is lower than KEY_STRIPESMAX, the image is considered a read-out stripe and removed from the list.

Specified by:

removeStripes in interface ImageClassifying

Parameters:

stars - All possible stars, on return without stripes

Returns:

The read-out stripes or null.

removeMirrors

public List<StarDetection> removeMirrors(List<StarDetection> found)

Default empty.

Specified by:

removeMirrors in interface ImageClassifying

Parameters:

found -

Returns:

removeGhosts

public List<StarDetection> removeGhosts(List<StarDetection> mirrors,
                                        List<StarDetection> found)

Default empty.

Specified by:

removeGhosts in interface ImageClassifying

Parameters:

found -

Returns:

isStar

private boolean isStar(StarDetection star)

We compare the stars sharpness with an allowed list of peaks and width. The closer this star's sharpness to the allowed peaks, the higher its probability to be a true star. In a last step, its elongation is tested to be as round as possible. All together describe a probability value, if high enough we decide for a positive detection of a star.,

Parameters:

star -

Returns:

getStrip

private List<StarDetection> getStrip(List<StarDetection> principal,
                                     Point2D center)

We scan a list of StarProspect.RawStars and return all entries that are within a certain column, defined in center.