stella.adapter

Class SpillSignal

java.lang.Object

util.PropertyContainer

stella.adapter.SpillSignal

All Implemented Interfaces:

Cloneable, PropertySupplying

public class SpillSignal
extends PropertyContainer

On guiding frames with a spill-over signal we try to see if we can get a shift from the guiding fits frame. The idea is to first estimate the background, keep all relevant pixel above this background around the pinhole. If the remaining signal appears to be non-spurious, do a simple center-of-gravity estimation.

Author:

wooz

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SpillSignal.Background
static class	SpillSignal.Closest
static class	SpillSignal.Growth We start from a small rectangle and grow
static class	SpillSignal.Single
static class	SpillSignal.Twin

Field Summary

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Constructor Summary

Constructors

Constructor and Description
SpillSignal(Map<String,String> prop)

Method Summary

Modifier and Type	Method and Description
static Vector2D	background(MImageHDU f, Rectangle box, int thick, double maxdev) Tries to estimate the background and its error.
private static Pair<Integer,Vector3D>	brightestBlob(MImageHDU f, Rectangle around, double back, double maxdev, Point2D pinhole, int twinpix, int nmin)
static int	brightestBlob(MImageHDU f, Rectangle pinframe, double back, double maxdev, Point2D pinhole, int twinpix, int nmin, Vector3D into)
private static Pair<Integer,Vector3D>	centerOfGravity(MImageHDU f, Rectangle around, double back, double maxdev) Fills the 3d vector with the CoG of the image ADUs minus background within the boxing rectangle, using the background plus the maximum deviation as threshold.
static int	centerOfGravity(MImageHDU f, Rectangle around, double back, double maxdev, Vector3D into) Fills the 3d vector with the CoG of the image ADUs minus background within the boxing rectangle, using the background plus the maximum deviation as threshold.
private static Pair<Integer,Vector3D>	centerOfGravityPlusTwin(MImageHDU f, Rectangle around, double back, double maxdev, int twinpix)
static int	centerOfGravityPlusTwin(MImageHDU adu, Rectangle around, double back, double maxdev, int twinpix, Vector3D into)

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, clone, 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, initProperties, isNew, parseObject, parseObject, reload, 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

Constructor Detail

SpillSignal

public SpillSignal(Map<String,String> prop)

Method Detail

centerOfGravity

public static int centerOfGravity(MImageHDU f,
                                  Rectangle around,
                                  double back,
                                  double maxdev,
                                  Vector3D into)
                           throws BasicFitsException

Fills the 3d vector with the CoG of the image ADUs minus background within the boxing rectangle, using the background plus the maximum deviation as threshold. Only ADUs within around are considered, and only if their value exceeds back+maxdev. If so, their contributing image moment is addes as (ADU-back)*x/y. The CoG is then calculated in image coordinates, i.e. the calculated value is offset to the around rectangle. The number of contributing ADUS is returned.

Parameters:

f - The image HDU

around - Only within this rectangle ADUs are considered.

back - The expected background level, subtracted from ADUs on calculation.

maxdev - The expected maximum deviation in background counts for threshold.

into - The results are saved in this parameter

Returns:

The number of contributing pixels

Throws:

FitsException

BasicFitsException

centerOfGravity

private static Pair<Integer,Vector3D> centerOfGravity(MImageHDU f,
                                                      Rectangle around,
                                                      double back,
                                                      double maxdev)
                                               throws BasicFitsException

Fills the 3d vector with the CoG of the image ADUs minus background within the boxing rectangle, using the background plus the maximum deviation as threshold. Only ADUs within around are considered, and only if their value exceeds back+maxdev. If so, their contributing image moment is addes as (ADU-back)*x/y. The CoG is then calculated in image coordinates, i.e. the calculated value is offset to the around rectangle. The number of contributing ADUS is returned.

Parameters:

f - The image HDU

around - Only within this rectangle ADUs are considered.

back - The expected background level, subtracted from ADUs on calculation.

maxdev - The expected maximum deviation in background counts for threshold.

Returns:

The number of contributing pixels plus the center of gravity shift in the first two coordinated and the total signal in z.

Throws:

FitsException

BasicFitsException

centerOfGravityPlusTwin

public static int centerOfGravityPlusTwin(MImageHDU adu,
                                          Rectangle around,
                                          double back,
                                          double maxdev,
                                          int twinpix,
                                          Vector3D into)
                                   throws BasicFitsException

Throws:

BasicFitsException

centerOfGravityPlusTwin

private static Pair<Integer,Vector3D> centerOfGravityPlusTwin(MImageHDU f,
                                                              Rectangle around,
                                                              double back,
                                                              double maxdev,
                                                              int twinpix)
                                                       throws BasicFitsException

Throws:

BasicFitsException

brightestBlob

public static int brightestBlob(MImageHDU f,
                                Rectangle pinframe,
                                double back,
                                double maxdev,
                                Point2D pinhole,
                                int twinpix,
                                int nmin,
                                Vector3D into)
                         throws BasicFitsException

Throws:

BasicFitsException

brightestBlob

private static Pair<Integer,Vector3D> brightestBlob(MImageHDU f,
                                                    Rectangle around,
                                                    double back,
                                                    double maxdev,
                                                    Point2D pinhole,
                                                    int twinpix,
                                                    int nmin)
                                             throws BasicFitsException

Throws:

BasicFitsException

background

public static Vector2D background(MImageHDU f,
                                  Rectangle box,
                                  int thick,
                                  double maxdev)
                           throws BasicFitsException

Tries to estimate the background and its error.

Throws:

FitsException

BasicFitsException