GuiderParameters

java.lang.Object
- util.PropertyContainer
- - stella.util.GuiderParameters

All Implemented Interfaces:

Cloneable, PropertySupplying
```
public class GuiderParameters
extends PropertyContainer
```
A class to optimize the parameter settings in the stella guider class. It is used with a list of input stars, given with their right ascension and declination and a set of x-y coordinates as derived from an actual guider image (use something like Sextractor to get CCD pixel coordinates). The set of stellar coordinates must match the set of x/y pixels in a sense that each star given in the position list is also found on the CCD. If we have at least two stars visible, this program optimizes for four parameters, the shift of the center of the CCD (xs, ys), the field rotation θ and the combined product of focal length and pixel scale on the CCD, f. If total reflection is in effect, you can include that by setting #KEY_MIRRORX or #KEY_MIRRORY to true.
Though θ and the focal length/pixel scale are in principle known, we optimize for these parameter, too. To calculate the remaining mounting angle, i.e. the field rotation that is a fixed value for any sky position, we need also the time of the exposure, set with KEY_DATE in a date format defined within SettableTime. Then, the calculation of the apparent field rotation splits in two parts, first the rotation in the principle focal plane given by
```
 tan(θ₀)=sin(τ)/(cos(δ)tan(φ)-sin(δ)cos(τ)),
 
```
where all the symbols have their usual meaning. Additionally, on a guider CCD that is fixed at the Nashmith foci, but rotating with azimuth of the telescope, you will get an additional image rotation that is purely the elevation of the target, thus leaving you with an expected image rotation of
```
 θ=-θ₀+h.
 
```
If the date is given in the properties, this image rotation is applied prior to optimization, giving you as a result in the image rotation that should be the constant image rotation due to allignment errors.
Refraction is not taken into account, as the effect should be below 0.01 pixel at an height of 15 degrees.

Field Summary

Fields
Modifier and Type	Field and Description
`private static double`	`DEFCOUDE` The default focallength.
`private static double`	`DEFFSCALE` The default focallength.
`private static double`	`DEFNASMITH` The default focallength.
`private static double`	`DEFTHETA` The default rotation angle.
`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 Multidimensional`	`dist` The multidimensional function that is to be minimized with amoeba.
`private static long`	`EPOCHMS` The epoch of the ra/de in ms.
`static String`	`KEY_CCD` The list of CCD pixels as x,y pairs in pixel.
`static String`	`KEY_CCDFILE` The list of CCD pixels as x,y pairs in pixel.
`static String`	`KEY_COUDE` IF guider is at coude focus, otherwise gregorian image rotation.
`static String`	`KEY_DATE` If the date of the exposure is given, we calculate the field angle.
`static String`	`KEY_DECENTER` The center of the frame.
`static String`	`KEY_FSCALE` The key to the starting value of focallength times scale.
`static String`	`KEY_NASMITH` IF guider is at nasmith focus, otherwise gregorian image rotation.
`static String`	`KEY_RACENTER` The center of the frame in hh:mm:ss.ss, right ascension.
`static String`	`KEY_STARFILE` The list of stars as ra,de pairs given in degrees.
`static String`	`KEY_STARS` The list of stars as ra,de pairs given in degrees.
`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
`private List`	`pixel` The list of `Guiding#RawStars` from the ccd, `KEY_CCD`.
`private boolean`	`print` If true, amoeba should output approximation per star.
`private static double`	`PROP` Milliarcsec to degrees.
`private List`	`stars` The list of `SimpleStar` from `KEY_STARS`.
`private static long`	`YEARMS` The epoch of the ra/de in ms.

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

GuiderParameters(Map prop)
Constructs a new guider parameter object and reads in the star and ccd coordinates.

Constructors
Constructor and Description
`GuiderParameters(Map prop)` Constructs a new guider parameter object and reads in the star and ccd coordinates.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`main(String[] arg)` Reads the properties from the command line, construct a new guider parameters object and use an Amoeba to optimize the focal length times pixel scale, the field rotation and the x/y shift.

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_NASMITH
```
public static final String KEY_NASMITH
```
    IF guider is at nasmith focus, otherwise gregorian image rotation.
    
    See Also:
    
    Constant Field Values
  - KEY_COUDE
```
public static final String KEY_COUDE
```
    IF guider is at coude focus, otherwise gregorian image rotation.
    
    See Also:
    
    Constant Field Values
  - 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_STARS
```
public static final String KEY_STARS
```
    The list of stars as ra,de pairs given in degrees.
    
    See Also:
    
    Constant Field Values
  - KEY_STARFILE
```
public static final String KEY_STARFILE
```
    The list of stars as ra,de pairs given in degrees.
    
    See Also:
    
    Constant Field Values
  - KEY_CCD
```
public static final String KEY_CCD
```
    The list of CCD pixels as x,y pairs in pixel.
    
    See Also:
    
    Constant Field Values
  - KEY_CCDFILE
```
public static final String KEY_CCDFILE
```
    The list of CCD pixels as x,y pairs in pixel.
    
    See Also:
    
    Constant Field Values
  - KEY_DATE
```
public static final String KEY_DATE
```
    If the date of the exposure is given, we calculate the field angle.
    
    See Also:
    
    Constant Field Values
  - EPOCHMS
```
private static final long EPOCHMS
```
    The epoch of the ra/de in ms.
    
    See Also:
    
    Constant Field Values
  - YEARMS
```
private static final long YEARMS
```
    The epoch of the ra/de in ms.
    
    See Also:
    
    Constant Field Values
  - PROP
```
private static final double PROP
```
    Milliarcsec to degrees.
    
    See Also:
    
    Constant Field Values
  - DEFNASMITH
```
private static final double DEFNASMITH
```
    The default focallength. Pixel per radian.
    
    See Also:
    
    Constant Field Values
  - DEFCOUDE
```
private static final double DEFCOUDE
```
    The default focallength. Pixel per radian.
    
    See Also:
    
    Constant Field Values
  - DEFFSCALE
```
private static final double DEFFSCALE
```
    The default focallength. Pixel per radian.
    
    See Also:
    
    Constant Field Values
  - DEFTHETA
```
private static final double DEFTHETA
```
    The default rotation angle.
    
    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
  - stars
```
private List stars
```
    The list of SimpleStar from KEY_STARS.
  - pixel
```
private List pixel
```
    The list of Guiding#RawStars from the ccd, KEY_CCD.
  - dist
```
private Multidimensional dist
```
    The multidimensional function that is to be minimized with amoeba.
  - print
```
private boolean print
```
    If true, amoeba should output approximation per star.
- Constructor Detail
  - GuiderParameters
```
public GuiderParameters(Map prop)
```
    Constructs a new guider parameter object and reads in the star and ccd coordinates. Issues warnings if their numbers do not match or if we have too few stars.
- Method Detail
  - main
```
public static void main(String[] arg)
```
    Reads the properties from the command line, construct a new guider parameters object and use an Amoeba to optimize the focal length times pixel scale, the field rotation and the x/y shift.

Class GuiderParameters

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_NASMITH

KEY_COUDE

KEY_FSCALE

KEY_THETA

KEY_XSHIFT

KEY_YSHIFT

KEY_XMIRROR

KEY_YMIRROR

KEY_RACENTER

KEY_DECENTER

KEY_STARS

KEY_STARFILE

KEY_CCD

KEY_CCDFILE

KEY_DATE

EPOCHMS

YEARMS

PROP

DEFNASMITH

DEFCOUDE

DEFFSCALE

DEFTHETA

DEFXSHIFT

DEFYSHIFT

DEFXMIRROR

DEFYMIRROR

stars

pixel

dist

print

Constructor Detail

GuiderParameters

Method Detail

main