BilinearCatalogMatch

java.lang.Object
- util.PropertyContainer
- - stella.acquire.BilinearCatalogMatch

All Implemented Interfaces:

Cloneable, CatalogMatching, PropertySupplying
```
public class BilinearCatalogMatch
extends PropertyContainer
implements CatalogMatching
```
Based on the idea that image rotation and scaling is known, we can directly compare the x/y coordinates of the image stars with the catalog stars. For each star in the image and in the catalog, we calculate its distance for all other stars. During matching, we search for the pixel shift that is inherent to most of the catalog and image stars.

Author:

wooz

Field Summary

Fields
Modifier and Type	Field and Description
`private List<StarProspect>`	`catalog` Pixel coordinates as deduced from the catalog.
`private Vector2D[][]`	`catalogdist` Distance of star at first index to star on second, catalog space.
`private static double`	`DEFDIFFMAGERROR` An estimate of the mgnitude error.
`private static double`	`DEFMAGTRUNCATE`
`private static double`	`DEFPOSITIONERROR` An estimate of the catalog errors in pixels on ccd.
`private static double`	`DEFTOTMAGERROR` Per default, we assume that differential magnitudes are more accurate.
`private List<Integer>[]`	`freq` For each star in the image the indices of the catalog matches.
`private List<StarDetection>`	`image` Pixel coordinates of the stars on the image.
`private Vector2D[][]`	`imagedist` Distance of star at first index to star on second, image space.
`static String`	`KEY_DIFFMAGERROR` Assumed error in differential magnitudes.
`static String`	`KEY_MAGTRUNCATE`
`static String`	`KEY_POSITIONERROR` Assumed error in pixel position, combined catalog and image.
`static String`	`KEY_TOTMAGERROR` Assumed error in total magnitudes.
`private List<Integer>[]`	`match` For each star in the image the indices of the catalog matches.

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

BilinearCatalogMatch(Map<String,String> prop)
Constructs a new matcher that is based on shifts in x and y.

Constructors
Constructor and Description
`BilinearCatalogMatch(Map<String,String> prop)` Constructs a new matcher that is based on shifts in x and y.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private Vector2D`	`bestMatch()` Assumption: all the stars can be seen in the image can also be found in the catalog.
`private static Vector2D[][]`	`calcDistances(List<? extends Glint> pix)` Calculates all distances between pixels.
`Vector2D`	`match(List<StarDetection> raw, List<StarProspect> catalog)` Returns an unbinned pixel shift, as the catalog position minus the CCD-detected star position.
`private void`	`setCatalog(List<StarProspect> fov)`
`private void`	`setDetections(List<StarDetection> ccd)`

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

- Field Detail
  - KEY_TOTMAGERROR
```
public static final String KEY_TOTMAGERROR
```
    Assumed error in total magnitudes.
    
    See Also:
    
    Constant Field Values
  - KEY_DIFFMAGERROR
```
public static final String KEY_DIFFMAGERROR
```
    Assumed error in differential magnitudes.
    
    See Also:
    
    Constant Field Values
  - KEY_POSITIONERROR
```
public static final String KEY_POSITIONERROR
```
    Assumed error in pixel position, combined catalog and image.
    
    See Also:
    
    Constant Field Values
  - KEY_MAGTRUNCATE
```
public static final String KEY_MAGTRUNCATE
```
    See Also:
    
    Constant Field Values
  - DEFPOSITIONERROR
```
private static final double DEFPOSITIONERROR
```
    An estimate of the catalog errors in pixels on ccd.
    
    See Also:
    
    Constant Field Values
  - DEFDIFFMAGERROR
```
private static final double DEFDIFFMAGERROR
```
    An estimate of the mgnitude error.
    
    See Also:
    
    Constant Field Values
  - DEFTOTMAGERROR
```
private static final double DEFTOTMAGERROR
```
    Per default, we assume that differential magnitudes are more accurate.
    
    See Also:
    
    Constant Field Values
  - DEFMAGTRUNCATE
```
private static final double DEFMAGTRUNCATE
```
    See Also:
    
    Constant Field Values
  - image
```
private List<StarDetection> image
```
    Pixel coordinates of the stars on the image.
  - catalog
```
private List<StarProspect> catalog
```
    Pixel coordinates as deduced from the catalog.
  - imagedist
```
private Vector2D[][] imagedist
```
    Distance of star at first index to star on second, image space.
  - catalogdist
```
private Vector2D[][] catalogdist
```
    Distance of star at first index to star on second, catalog space.
  - match
```
private List<Integer>[] match
```
    For each star in the image the indices of the catalog matches.
  - freq
```
private List<Integer>[] freq
```
    For each star in the image the indices of the catalog matches.
- Constructor Detail
  - BilinearCatalogMatch
```
public BilinearCatalogMatch(Map<String,String> prop)
```
    Constructs a new matcher that is based on shifts in x and y.
- Method Detail
  - setDetections
```
private void setDetections(List<StarDetection> ccd)
```
  - setCatalog
```
private void setCatalog(List<StarProspect> fov)
```
  - calcDistances
```
private static final Vector2D[][] calcDistances(List<? extends Glint> pix)
```
    Calculates all distances between pixels.
  - bestMatch
```
private Vector2D bestMatch()
```
    Assumption: all the stars can be seen in the image can also be found in the catalog.
  - match
```
public Vector2D match(List<StarDetection> raw,
                      List<StarProspect> catalog)
               throws AmbiguousPatternException,
                      NoStarException,
                      CannotMatchException
```
    Description copied from interface: CatalogMatching
    
    Returns an unbinned pixel shift, as the catalog position minus the CCD-detected star position.
    
    Specified by:
    
    match in interface CatalogMatching
    
    Returns:
    
    Nominal minus actual
    
    Throws:
    
    AmbiguousPatternException
    
    NoStarException
    
    CannotMatchException

Class BilinearCatalogMatch

Field Summary

Fields inherited from class util.PropertyContainer

Fields inherited from interface util.PropertySupplying

Constructor Summary

Method Summary

Methods inherited from class util.PropertyContainer

Methods inherited from class java.lang.Object

Field Detail

KEY_TOTMAGERROR

KEY_DIFFMAGERROR

KEY_POSITIONERROR

KEY_MAGTRUNCATE

DEFPOSITIONERROR

DEFDIFFMAGERROR

DEFTOTMAGERROR

DEFMAGTRUNCATE

image

catalog

imagedist

catalogdist

match

freq

Constructor Detail

BilinearCatalogMatch

Method Detail

setDetections

setCatalog

calcDistances

bestMatch

match