stella.auxiliary

Class AuxiliaryFieldOfView

java.lang.Object

util.PropertyContainer

stella.acquire.AbstractFieldOfView

stella.auxiliary.AuxiliaryFieldOfView

All Implemented Interfaces:

Cloneable, FieldOfViewProviding, Pointing, PropertySupplying

public class AuxiliaryFieldOfView
extends AbstractFieldOfView

In an auxiliary field-of-view, the best coarse star is the brightest star well inside the auxiliary guider's visible field of view, while the fine acquisition and guide star is as close to the pointing center as possible (to mitigate leverage errors). The minimum accessible field, i.e., the field that will be always within the auxiliary guider chip, regardless of pointing model residuals, is defined with the KEY_DISTLIMIT property. Only guide stars brighter than KEY_FAINTLIMIT may be considered.

Author:

wooz

Field Summary

Fields

Modifier and Type	Field and Description
private static double	DEFDISTLIMIT The maximum degree distance from the center for guide stars.
private static float	DEFFAINTLIMIT The minimum brightness for useful guide stars.
private static float	DEFGUIDELIMIT The minimum brightness for useful guide stars.
static String	KEY_DISTLIMIT The distance limit for useful guiding stars.
static String	KEY_FAINTLIMIT The faintness limit for useful guiding stars.
static String	KEY_GUIDELIMIT The faintness limit for useful guiding stars.

Fields inherited from class stella.acquire.AbstractFieldOfView

catalog, center, dither

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
AuxiliaryFieldOfView(Map<String,String> props)

Method Summary

Modifier and Type	Method and Description
protected Star	closestToCenter(double ra, double de, float maglim) Returns the star closest to the axis and also above the limiting magnitude.
protected double	getAcquisitionMerit(double dist, Star test) Default aptness for guiding/acquisition is distance to center.
Star	getCoarseStar() Returns the star for coarse acquisition.
Star	getFineStar() Returns the star for fine acquisition.
Star	getGuideStar() Returns the star for guiding.

Methods inherited from class stella.acquire.AbstractFieldOfView

defaultGuidingStar, getFieldOfView, getFieldOfViewAround, getRaDeCenter, reset, setDitherOffset, setFindList, setRaDePointing

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_FAINTLIMIT

public static final String KEY_FAINTLIMIT

The faintness limit for useful guiding stars.

See Also:

Constant Field Values

KEY_GUIDELIMIT

public static final String KEY_GUIDELIMIT

The faintness limit for useful guiding stars.

See Also:

Constant Field Values

KEY_DISTLIMIT

public static final String KEY_DISTLIMIT

The distance limit for useful guiding stars.

See Also:

Constant Field Values

DEFGUIDELIMIT

private static final float DEFGUIDELIMIT

The minimum brightness for useful guide stars.

See Also:

Constant Field Values

DEFFAINTLIMIT

private static final float DEFFAINTLIMIT

The minimum brightness for useful guide stars.

See Also:

Constant Field Values

DEFDISTLIMIT

private static final double DEFDISTLIMIT

The maximum degree distance from the center for guide stars.

See Also:

Constant Field Values

Constructor Detail

AuxiliaryFieldOfView

public AuxiliaryFieldOfView(Map<String,String> props)

Parameters:

props -

Method Detail

getCoarseStar

public Star getCoarseStar()

Description copied from interface: FieldOfViewProviding

Returns the star for coarse acquisition.

getFineStar

public Star getFineStar()

Description copied from interface: FieldOfViewProviding

Returns the star for fine acquisition.

getGuideStar

public Star getGuideStar()

Description copied from interface: FieldOfViewProviding

Returns the star for guiding.

getAcquisitionMerit

protected double getAcquisitionMerit(double dist,
                                     Star test)

Default aptness for guiding/acquisition is distance to center. Subclasses may provide a different merit, also depending on the possible guide star.

Parameters:

dist - Distance to center in degrees.

test - Possible guide star

Returns:

1./dist

closestToCenter

protected Star closestToCenter(double ra,
                               double de,
                               float maglim)

Returns the star closest to the axis and also above the limiting magnitude.