AbstractHorizontalGeometry

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

All Implemented Interfaces:

GlobalDepending, Cloneable, CcdReference, Horizontal, RayPath, PropertySupplying

Direct Known Subclasses:

CoudeFocusGeometry, DerotatorGeometry, NasmythFocusGeometry, PrimeFocusGeometry
```
public abstract class AbstractHorizontalGeometry
extends PropertyContainer
implements GlobalDepending, RayPath
```
Author:

wooz

Field Summary

Fields
Modifier and Type	Field and Description
`private Value`	`az` We cache the azimuth parameter.
`private static String`	`DEFALTITUDE` The default name of the altitude parameter.
`private static String`	`DEFAZIMUTH` The default name of the azimuth parameter.
`private static String`	`DEFPARALLACTICANGLE` The default name of the plain image rotation.
`private static boolean`	`DEFTCSAZIMUTHANGLE` Default TCS takes azimuth angles even in offset.
`private static boolean`	`DEFTCSZENITHDISTANCE` Default zd telescope (unfortunately).
`private Value`	`el` We cache the altitude parameter.
`private Value`	`eta` We cache the parallactic angle parameter.
`static String`	`KEY_ALIGNMENTANGLE` Alignment angle of the CCD with respect to North.
`static String`	`KEY_ALTITUDE` The height of the target for calculating CCD rotation.
`static String`	`KEY_ARCSECSCALE` The guider scale on the image, arcsec per pixel.
`static String`	`KEY_AZIMUTH` The azimuth of the target for calculating CCD rotation.
`static String`	`KEY_CHIRALITY` If the CCD x/y has a different chirality than ra/dec.
`static String`	`KEY_GUIDERSCALE` The old guider scale on the image, pixel per radian.
`static String`	`KEY_PARALLACTICANGLE` The name of the `Value` holding the plain image rotation.
`static String`	`KEY_TCSAZIMUTHANGLE` If true, TCS expects azimuth offsets in azimuth angle (div cosh).
`static String`	`KEY_TCSZENITHDISTANCE` If true, TCS expects zenith distance instead of elevation.

Fields inherited from class util.PropertyContainer
KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.PropertySupplying
CONFIG, KEY_CLASS

Constructor Summary

Constructors
Modifier Constructor and Description

protected AbstractHorizontalGeometry(Map<String,String> props)

Constructors
Modifier	Constructor and Description
`protected`	`AbstractHorizontalGeometry(Map<String,String> props)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private Vector2D`	`azAltToTcs(Vector2D azel)`
`protected Number`	`getAlignmentAngle()` The fixed alignment angle from the properties.
`Number`	`getAltitude()` Returns the altitude of an predefined object or telescope pointing.
`double`	`getArcsecPerPixel()` Arcseconds per pixel guider scale.
`protected Vector2D`	`getAzAltShiftFromPixelDistance(Vector2D pix)`
`Number`	`getAzimuth()` Returns the azimuth of an predefined object or telescope pointing.
`double`	`getChirality()` Chirality of CCD system, -1 for left-handed, +1 for right-handed.
`Number`	`getParallacticAngle()` Returns the parallactiv angle in degrees.
`Vector2D`	`getPixelPositionFromRaDe(Point2D to, Vector2D rade, Star catalog)` Converts a star to an anticipated pixel position on the CCD.
`Vector2D`	`getTcsShiftFromPixelDistance(Vector2D pix)` Converts unbinned CCD-pixel shift into shifts in the telescope system.
`private Vector2D`	`pixelToAzAlt(Vector2D pxshft, double theta)`
`private Vector2D`	`radeToPixel(Vector2D drade, double chi)`
`void`	`registerGlobals(GlobalGrouping set)` We grab the parameters for azimuth, altitude and the parallactic angle.

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

Methods inherited from interface stella.acquire.CcdReference
getEquatorialAngle, getHorizontalAngle

- Field Detail
  - KEY_AZIMUTH
```
public static final String KEY_AZIMUTH
```
    The azimuth of the target for calculating CCD rotation.
    
    See Also:
    
    Constant Field Values
  - KEY_ALTITUDE
```
public static final String KEY_ALTITUDE
```
    The height of the target for calculating CCD rotation.
    
    See Also:
    
    Constant Field Values
  - KEY_PARALLACTICANGLE
```
public static final String KEY_PARALLACTICANGLE
```
    The name of the Value holding the plain image rotation.
    
    See Also:
    
    Constant Field Values
  - KEY_TCSAZIMUTHANGLE
```
public static final String KEY_TCSAZIMUTHANGLE
```
    If true, TCS expects azimuth offsets in azimuth angle (div cosh).
    
    See Also:
    
    Constant Field Values
  - KEY_TCSZENITHDISTANCE
```
public static final String KEY_TCSZENITHDISTANCE
```
    If true, TCS expects zenith distance instead of elevation.
    
    See Also:
    
    Constant Field Values
  - KEY_ALIGNMENTANGLE
```
public static final String KEY_ALIGNMENTANGLE
```
    Alignment angle of the CCD with respect to North.
    
    See Also:
    
    Constant Field Values
  - KEY_GUIDERSCALE
```
public static final String KEY_GUIDERSCALE
```
    The old guider scale on the image, pixel per radian.
    
    See Also:
    
    Constant Field Values
  - KEY_ARCSECSCALE
```
public static final String KEY_ARCSECSCALE
```
    The guider scale on the image, arcsec per pixel.
    
    See Also:
    
    Constant Field Values
  - KEY_CHIRALITY
```
public static final String KEY_CHIRALITY
```
    If the CCD x/y has a different chirality than ra/dec.
    
    See Also:
    
    Constant Field Values
  - DEFPARALLACTICANGLE
```
private static final String DEFPARALLACTICANGLE
```
    The default name of the plain image rotation.
    
    See Also:
    
    Constant Field Values
  - DEFAZIMUTH
```
private static final String DEFAZIMUTH
```
    The default name of the azimuth parameter.
    
    See Also:
    
    Constant Field Values
  - DEFALTITUDE
```
private static final String DEFALTITUDE
```
    The default name of the altitude parameter.
    
    See Also:
    
    Constant Field Values
  - DEFTCSAZIMUTHANGLE
```
private static final boolean DEFTCSAZIMUTHANGLE
```
    Default TCS takes azimuth angles even in offset.
    
    See Also:
    
    Constant Field Values
  - DEFTCSZENITHDISTANCE
```
private static final boolean DEFTCSZENITHDISTANCE
```
    Default zd telescope (unfortunately).
    
    See Also:
    
    Constant Field Values
  - az
```
private Value az
```
    We cache the azimuth parameter.
  - el
```
private Value el
```
    We cache the altitude parameter.
  - eta
```
private Value eta
```
    We cache the parallactic angle parameter.
- Constructor Detail
  - AbstractHorizontalGeometry
```
protected AbstractHorizontalGeometry(Map<String,String> props)
```
    Parameters:
    
    props -
- Method Detail
  - registerGlobals
```
public void registerGlobals(GlobalGrouping set)
```
    We grab the parameters for azimuth, altitude and the parallactic angle.
    
    Specified by:
    
    registerGlobals in interface GlobalDepending
  - getAzimuth
```
public Number getAzimuth()
```
    Description copied from interface: Horizontal
    
    Returns the azimuth of an predefined object or telescope pointing. Azimuth is zero at the meridian and counted positive to west.
    
    Specified by:
    
    getAzimuth in interface Horizontal
    
    Returns:
    
    The aziumth in degrees, S=0, W=90.
    
    Throws:
    
    InvalidParameterException
  - getAltitude
```
public Number getAltitude()
```
    Description copied from interface: Horizontal
    
    Returns the altitude of an predefined object or telescope pointing.
    
    Specified by:
    
    getAltitude in interface Horizontal
    
    Returns:
    
    The elevation in degrees.
    
    Throws:
    
    InvalidParameterException
  - getParallacticAngle
```
public Number getParallacticAngle()
```
    Description copied from interface: Horizontal
    
    Returns the parallactiv angle in degrees. This is also the image rotation in a pure Gregorian focal plane.
    
    Specified by:
    
    getParallacticAngle in interface Horizontal
    
    Returns:
    
    The parallactic angle in degrees
    
    Throws:
    
    InvalidParameterException
  - getArcsecPerPixel
```
public double getArcsecPerPixel()
```
    Description copied from interface: CcdReference
    
    Arcseconds per pixel guider scale.
    
    Specified by:
    
    getArcsecPerPixel in interface CcdReference
  - getChirality
```
public double getChirality()
```
    Description copied from interface: CcdReference
    
    Chirality of CCD system, -1 for left-handed, +1 for right-handed. Right ascension and declination is the most prominent left-handed coordinate system in astronomy.
    
    Specified by:
    
    getChirality in interface CcdReference
  - azAltToTcs
```
private Vector2D azAltToTcs(Vector2D azel)
```
  - getTcsShiftFromPixelDistance
```
public Vector2D getTcsShiftFromPixelDistance(Vector2D pix)
```
    Description copied from interface: RayPath
    
    Converts unbinned CCD-pixel shift into shifts in the telescope system. This shift can be readily applied to the telescope TCS via an offset command. Depending on the mounting geometry, the translation may be time dependent, thus we supply the parameters of the current observation as an argument.
    
    Specified by:
    
    getTcsShiftFromPixelDistance in interface RayPath
    
    Parameters:
    
    pix - The pixel shift recorded from a match
    
    Returns:
  - getAzAltShiftFromPixelDistance
```
protected Vector2D getAzAltShiftFromPixelDistance(Vector2D pix)
```
  - pixelToAzAlt
```
private Vector2D pixelToAzAlt(Vector2D pxshft,
                              double theta)
```
  - getPixelPositionFromRaDe
```
public Vector2D getPixelPositionFromRaDe(Point2D to,
                                         Vector2D rade,
                                         Star catalog)
```
    Description copied from interface: RayPath
    
    Converts a star to an anticipated pixel position on the CCD. Must provide the acquisition center on the CCD and the matching ra/dec of this center. Depending on the mounting geometry, the translation may be time dependent, thus we supply the parameters of the current observation as an argument.
    
    Specified by:
    
    getPixelPositionFromRaDe in interface RayPath
    
    Parameters:
    
    to - The CCD hot-spot coordinates, i.e. the acquisition center.
    
    rade - The acquisition center in ra/dec on sky.
    
    catalog - The star from a catalog entry.
    
    Returns:
  - radeToPixel
```
private Vector2D radeToPixel(Vector2D drade,
                             double chi)
```
    Parameters:
    
    drade - planar Δα and Δδ coordinates
    
    chi - Angle between CCD-y and declination, degrees.
    
    Returns:
  - getAlignmentAngle
```
protected Number getAlignmentAngle()
```
    The fixed alignment angle from the properties.
    
    Returns:

Class AbstractHorizontalGeometry

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

Methods inherited from interface stella.acquire.CcdReference

Field Detail

KEY_AZIMUTH

KEY_ALTITUDE

KEY_PARALLACTICANGLE

KEY_TCSAZIMUTHANGLE

KEY_TCSZENITHDISTANCE

KEY_ALIGNMENTANGLE

KEY_GUIDERSCALE

KEY_ARCSECSCALE

KEY_CHIRALITY

DEFPARALLACTICANGLE

DEFAZIMUTH

DEFALTITUDE

DEFTCSAZIMUTHANGLE

DEFTCSZENITHDISTANCE

az

el

eta

Constructor Detail

AbstractHorizontalGeometry

Method Detail

registerGlobals

getAzimuth

getAltitude

getParallacticAngle

getArcsecPerPixel

getChirality

azAltToTcs

getTcsShiftFromPixelDistance

getAzAltShiftFromPixelDistance

pixelToAzAlt

getPixelPositionFromRaDe

radeToPixel

getAlignmentAngle