WcsMatch

java.lang.Object
- util.PropertyContainer
- - astro.WcsMatch

All Implemented Interfaces:

Cloneable, PropertySupplying
```
public class WcsMatch
extends PropertyContainer
```
We match the brightest stars found in an image at given x/y coordinates to given catalog entries.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`WcsMatch.Coarse` Simple matcher class that takes an input catalog and matches it to a (sextractor) output of positions.
`private class`	`WcsMatch.Stereographic` The multidimensional for stereographic projection.
`static class`	`WcsMatch.Test` Test the method on a very simple system.

Field Summary

Fields
Modifier and Type	Field and Description
`private static double`	`DEFDEVIATION` The default normalized deviation.
`private static double`	`DEFFSCALE` The default scale
`private static double`	`DEFIMPROVABLE` The default normalized deviation.
`private static double`	`DEFMAGNITUDE` The default magnitude scale
`private static double`	`DEFOUTLIE` The default normalized deviation.
`private static double`	`DEFPIXEL` The default normalized deviation.
`private static double`	`DEFSECOND` The default normalized deviation.
`private static double`	`DEFTHETA` The default rotation
`private static boolean`	`DEFXMIRROR` The default x mirror
`private static double`	`DEFXSHIFT` The default x shift
`private static boolean`	`DEFYMIRROR` The default x mirror
`private static double`	`DEFYSHIFT` The default y shift
`private static double`	`DEFZEROOFF` The default normalized deviation.
`static String`	`KEY_DECENTER` The center of the frame.
`static String`	`KEY_DEVIATION` The maximum deviation for similarity of triangles.
`static String`	`KEY_FSCALE` The key to the starting value of focallength times scale.
`static String`	`KEY_IMPROVABLE` The maximum deviation of final fit in pixel.
`static String`	`KEY_MAGNITUDE` The maximum deviation of the instrumental to catalog magnitudes.
`static String`	`KEY_OUTLIE` The maximum deviation of final fit in pixel.
`static String`	`KEY_PIXEL` The maximum deviation of final fit in pixel.
`static String`	`KEY_RACENTER` The center of the frame in hh:mm:ss.ss, right ascension.
`static String`	`KEY_SECOND` The maximum deviation of second final fit in pixel.
`static String`	`KEY_THETA` The key to the starting value of field angle
`static String`	`KEY_XMIRROR` The key to the mirroring along x-axis.
`static String`	`KEY_XSHIFT` The key to the starting value of CCD shift, x
`static String`	`KEY_YMIRROR` The key to the mirroring along x-axis.
`static String`	`KEY_YSHIFT` The key to the starting value of CCD shift, y
`static String`	`KEY_ZERO` The rough zero point in magnitude.
`static String`	`KEY_ZEROOFF` The rough zero point in magnitude.
`private Vector3D[]`	`rawcatalog` The ra, dec, mag of the catalog stars.
`private Vector3D[]`	`rawmeasure` The identified candidates to the catalog.

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

WcsMatch(Map<String,String> prop)

Constructors
Constructor and Description
`WcsMatch(Map<String,String> prop)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private static double`	`deviation(Vector2D[] cat, Vector2D[] test)` Calculates the deviation between the two triangles.
`VectorG`	`invert(VectorG result, Dimension chip)` From the chip size, invert the solution and return the central ra, de in 0/1, the pixel scale in arcsec/pixel in 2 and the field rotation in degrees in 3.
`private int[]`	`matchTriangle(Vector2D[] triangle, Vector3D[] meas, int[] id)` Tries to match a normalized triangle in the first array to any triangle formed by the measurements provided in the second array, which must have at least three entries.
`private static Vector2D[]`	`normalizeTriangle(Vector3D[] p)` Normalizes a triangle by calculating side length.
`private static String`	`printTriangle(Vector2D[] tri)` Converts a triangle to a string.
`void`	`setCatalog(Vector3D[] cat)` Sets the list of measured stars.
`void`	`setMeasures(Vector3D[] meas)` Sets the list of measured stars.
`private int[]`	`similarTriangles()` Tries to find matches from catalog to measured.
`VectorG`	`solve()` Solves for a solution using previously defined catalog and measures.

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_FSCALE
```
public static final String KEY_FSCALE
```
    The key to the starting value of focallength times scale.
    
    See Also:
    
    Constant Field Values
  - KEY_THETA
```
public static final String KEY_THETA
```
    The key to the starting value of field angle
    
    See Also:
    
    Constant Field Values
  - KEY_XSHIFT
```
public static final String KEY_XSHIFT
```
    The key to the starting value of CCD shift, x
    
    See Also:
    
    Constant Field Values
  - KEY_YSHIFT
```
public static final String KEY_YSHIFT
```
    The key to the starting value of CCD shift, y
    
    See Also:
    
    Constant Field Values
  - KEY_XMIRROR
```
public static final String KEY_XMIRROR
```
    The key to the mirroring along x-axis.
    
    See Also:
    
    Constant Field Values
  - KEY_YMIRROR
```
public static final String KEY_YMIRROR
```
    The key to the mirroring along x-axis.
    
    See Also:
    
    Constant Field Values
  - KEY_RACENTER
```
public static final String KEY_RACENTER
```
    The center of the frame in hh:mm:ss.ss, right ascension.
    
    See Also:
    
    Constant Field Values
  - KEY_DECENTER
```
public static final String KEY_DECENTER
```
    The center of the frame. i.e. the pointing of the telescope at expose.
    
    See Also:
    
    Constant Field Values
  - KEY_DEVIATION
```
public static final String KEY_DEVIATION
```
    The maximum deviation for similarity of triangles.
    
    See Also:
    
    Constant Field Values
  - KEY_MAGNITUDE
```
public static final String KEY_MAGNITUDE
```
    The maximum deviation of the instrumental to catalog magnitudes.
    
    See Also:
    
    Constant Field Values
  - KEY_PIXEL
```
public static final String KEY_PIXEL
```
    The maximum deviation of final fit in pixel.
    
    See Also:
    
    Constant Field Values
  - KEY_SECOND
```
public static final String KEY_SECOND
```
    The maximum deviation of second final fit in pixel.
    
    See Also:
    
    Constant Field Values
  - KEY_IMPROVABLE
```
public static final String KEY_IMPROVABLE
```
    The maximum deviation of final fit in pixel.
    
    See Also:
    
    Constant Field Values
  - KEY_OUTLIE
```
public static final String KEY_OUTLIE
```
    The maximum deviation of final fit in pixel.
    
    See Also:
    
    Constant Field Values
  - KEY_ZERO
```
public static final String KEY_ZERO
```
    The rough zero point in magnitude.
    
    See Also:
    
    Constant Field Values
  - KEY_ZEROOFF
```
public static final String KEY_ZEROOFF
```
    The rough zero point in magnitude.
    
    See Also:
    
    Constant Field Values
  - DEFMAGNITUDE
```
private static final double DEFMAGNITUDE
```
    The default magnitude scale
    
    See Also:
    
    Constant Field Values
  - DEFFSCALE
```
private static final double DEFFSCALE
```
    The default scale
    
    See Also:
    
    Constant Field Values
  - DEFTHETA
```
private static final double DEFTHETA
```
    The default rotation
    
    See Also:
    
    Constant Field Values
  - DEFXSHIFT
```
private static final double DEFXSHIFT
```
    The default x shift
    
    See Also:
    
    Constant Field Values
  - DEFYSHIFT
```
private static final double DEFYSHIFT
```
    The default y shift
    
    See Also:
    
    Constant Field Values
  - DEFXMIRROR
```
private static final boolean DEFXMIRROR
```
    The default x mirror
    
    See Also:
    
    Constant Field Values
  - DEFYMIRROR
```
private static final boolean DEFYMIRROR
```
    The default x mirror
    
    See Also:
    
    Constant Field Values
  - DEFDEVIATION
```
private static final double DEFDEVIATION
```
    The default normalized deviation.
    
    See Also:
    
    Constant Field Values
  - DEFPIXEL
```
private static final double DEFPIXEL
```
    The default normalized deviation.
    
    See Also:
    
    Constant Field Values
  - DEFIMPROVABLE
```
private static final double DEFIMPROVABLE
```
    The default normalized deviation.
    
    See Also:
    
    Constant Field Values
  - DEFOUTLIE
```
private static final double DEFOUTLIE
```
    The default normalized deviation.
    
    See Also:
    
    Constant Field Values
  - DEFZEROOFF
```
private static final double DEFZEROOFF
```
    The default normalized deviation.
    
    See Also:
    
    Constant Field Values
  - DEFSECOND
```
private static final double DEFSECOND
```
    The default normalized deviation.
    
    See Also:
    
    Constant Field Values
  - rawcatalog
```
private Vector3D[] rawcatalog
```
    The ra, dec, mag of the catalog stars.
  - rawmeasure
```
private Vector3D[] rawmeasure
```
    The identified candidates to the catalog.
- Constructor Detail
  - WcsMatch
```
public WcsMatch(Map<String,String> prop)
```
- Method Detail
  - setCatalog
```
public void setCatalog(Vector3D[] cat)
```
    Sets the list of measured stars. First, we sort according to magnitude. Then, we scout for the three catalog stars by comparing the length of the triangles.
  - setMeasures
```
public void setMeasures(Vector3D[] meas)
```
    Sets the list of measured stars. First, we sort according to magnitude. Then, we scout for the three catalog stars by comparing the length of the triangles.
  - similarTriangles
```
private int[] similarTriangles()
```
    Tries to find matches from catalog to measured.
  - matchTriangle
```
private int[] matchTriangle(Vector2D[] triangle,
                            Vector3D[] meas,
                            int[] id)
```
    Tries to match a normalized triangle in the first array to any triangle formed by the measurements provided in the second array, which must have at least three entries. If some of the points have already identified, only the remaining matches are sought.
  - printTriangle
```
private static final String printTriangle(Vector2D[] tri)
```
    Converts a triangle to a string. Prints side length.
  - normalizeTriangle
```
private static Vector2D[] normalizeTriangle(Vector3D[] p)
```
    Normalizes a triangle by calculating side length. Keeps mag info in y
  - deviation
```
private static double deviation(Vector2D[] cat,
                                Vector2D[] test)
```
    Calculates the deviation between the two triangles. The x values are side length, y are mags and are ignored here.
  - invert
```
public VectorG invert(VectorG result,
                      Dimension chip)
```
    From the chip size, invert the solution and return the central ra, de in 0/1, the pixel scale in arcsec/pixel in 2 and the field rotation in degrees in 3.
  - solve
```
public VectorG solve()
```
    Solves for a solution using previously defined catalog and measures.

Class WcsMatch

Nested Class Summary

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_FSCALE

KEY_THETA

KEY_XSHIFT

KEY_YSHIFT

KEY_XMIRROR

KEY_YMIRROR

KEY_RACENTER

KEY_DECENTER

KEY_DEVIATION

KEY_MAGNITUDE

KEY_PIXEL

KEY_SECOND

KEY_IMPROVABLE

KEY_OUTLIE

KEY_ZERO

KEY_ZEROOFF

DEFMAGNITUDE

DEFFSCALE

DEFTHETA

DEFXSHIFT

DEFYSHIFT

DEFXMIRROR

DEFYMIRROR

DEFDEVIATION

DEFPIXEL

DEFIMPROVABLE

DEFOUTLIE

DEFZEROOFF

DEFSECOND

rawcatalog

rawmeasure

Constructor Detail

WcsMatch

Method Detail

setCatalog

setMeasures

similarTriangles

matchTriangle

printTriangle

normalizeTriangle

deviation

invert

solve