stella.adapter
Class AuxiliaryFineUnit

java.lang.Object
  util.PropertyContainer
      util.PropertyResources
          util.PropertyBundles
              stella.adapter.AuxiliaryUnit
                  stella.adapter.AuxiliaryCaptureUnit
                      stella.adapter.AuxiliaryFineUnit

All Implemented Interfaces:

Cloneable, Guiding.RawFrame, Initializable, LocalizedSupplying, PropertySupplying, ResourceSupplying

public class AuxiliaryFineUnit
extends AuxiliaryCaptureUnit

The adapter sub-unit that does acquiring on a target star.

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.URLResource

Field Summary

private static double	DEFCOARSEOFFSET An estimate of the allowed coarse offset in pixel.
private static int	DEFDATAMAX The default data max for 'good' filtered pixels.
private static int	DEFDATAMIN The default data min for 'good' filtered pixels.
private static Dimension	DEFENLARGEFINE The default pixel enlargement during acquire.
private static double	DEFEXPOSE The default S/N on acquire.
private static int	DEFGUIDERTILE The default acquire frame.
private static boolean	DEFKEEPFITS If true, all acquire fits are kept on disc.
private static int	DEFKEEPWHAT An integer specifying which acquire fits to keep.
private static double	DEFMAXSHIFTACQUIRE The default maximum shift for a successful acquire, pixel.
private static long	DEFMINOFFTIME Minimum exposure time on acquire in ms.
private static int	DEFRETRYFINE The default number of retries on acquire.
private static long	DEFROWTIMING Read out time for a single row, acquire frame in mu-seconds.
private static Dimension	DEFSAFETYOFFSET An estimate of the allowed pointing error in az/alt PIXEL.
private static int	DEFSEARCHBOX The default search box, unbiased.
private static double	DEFTIMEINCREASE The default time increase if no stars have been found.
private double	increase This is the increase factor that was used for coarse to find stars.
static String	KEY_COARSEOFFSET The expected maximum distance of target to pinhole after coarse.
static String	KEY_ENLARGEFINE A gray-zone around the acquire field for catalog star inclusion.
static String	KEY_MAXSHIFTACQUIRE Maximum allowed shift during acquire.
static String	KEY_RETRYFINE Maximum retries on fine acquire.
static String	KEY_TIMEINCREASE Increase the exposure time on coarse acquire fails.

Fields inherited from class stella.adapter.AuxiliaryCaptureUnit

KEY_DATAMAX, KEY_DATAMIN, KEY_EXPOSE, KEY_KEEPFITS, KEY_KEEPWHAT, KEY_MAGERROR, KEY_MINOFFTIME, KEY_MINTIME, KEY_POSITIONERROR, KEY_ROWTIMING, KEY_SAFETYOFFSET, KEY_SEARCHBOX, KEY_USECENTRAL

Fields inherited from class stella.adapter.AuxiliaryUnit

COARSETYPE, FINETYPE, GUIDERTYPE, KEY_FALLBACK, KEY_GUIDERTILE, PINHOLETYPE

Fields inherited from class util.PropertyBundles

KEY_LOCALECOUNTRY, KEY_LOCALELANGUAGE, KEY_RESOURCEBUNDLES

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, localurl, locate, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_URL, urlset

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Constructor Summary

AuxiliaryFineUnit(Map prop)
Constructs a new acquire unit.

Method Summary

protected ErrorEvent	doAuxiliaryTask(String ignore) Brings the acquire star at the cross-hair of the guider.
protected String	getAuxiliaryType() The type of this unit is #ACQUIRETYPE.
protected void	setIncrease(double multiply) If acquire failed because of no-star detected, set this last increase factor.

Methods inherited from class stella.adapter.AuxiliaryCaptureUnit

canUseCentral, getCaptureSignal, getCaptureTime, getFocusPoint, getGuideStar, getMinimumCaptureTime, init, isGuideCenter, isUseCentral, setGuideStar, setGuideStar

Methods inherited from class stella.adapter.AuxiliaryUnit

getBiasFrame, getBiasTime, getBinning, getDarkFrame, getDarkTime, getGuider, getMaster, getReadoutFrame, getTelescope, isManual, isValid, setGuider, setManual, setMaster, setTelescope

Methods inherited from class util.PropertyBundles

clone, getLocalized, getLocalized, getLocalizedString, getLocalizedString, loadResource

Methods inherited from class util.PropertyResources

createFrom, createFrom, createFrom, getApplet, getAsResources, getLocalClassLoader, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

augment, augment, augment, 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, isNew, parseObject, reload, removeProperty, 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 util.ResourceSupplying

getResource, getResourceAsStream, getResources

Methods inherited from interface util.PropertySupplying

defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

Field Detail

KEY_TIMEINCREASE

public static final String KEY_TIMEINCREASE

Increase the exposure time on coarse acquire fails.

See Also:

Constant Field Values

KEY_RETRYFINE

public static final String KEY_RETRYFINE

Maximum retries on fine acquire.

See Also:

Constant Field Values

KEY_COARSEOFFSET

public static final String KEY_COARSEOFFSET

The expected maximum distance of target to pinhole after coarse.

See Also:

Constant Field Values

KEY_ENLARGEFINE

public static final String KEY_ENLARGEFINE

A gray-zone around the acquire field for catalog star inclusion.

See Also:

Constant Field Values

KEY_MAXSHIFTACQUIRE

public static final String KEY_MAXSHIFTACQUIRE

Maximum allowed shift during acquire. Pixel distance.

See Also:

Constant Field Values

DEFKEEPFITS

private static final boolean DEFKEEPFITS

If true, all acquire fits are kept on disc.

See Also:

Constant Field Values

DEFKEEPWHAT

private static final int DEFKEEPWHAT

An integer specifying which acquire fits to keep.

See Also:

Constant Field Values

DEFROWTIMING

private static final long DEFROWTIMING

Read out time for a single row, acquire frame in mu-seconds.

See Also:

Constant Field Values

DEFTIMEINCREASE

private static final double DEFTIMEINCREASE

The default time increase if no stars have been found.

See Also:

Constant Field Values

DEFEXPOSE

private static final double DEFEXPOSE

The default S/N on acquire.

See Also:

Constant Field Values

DEFMINOFFTIME

private static final long DEFMINOFFTIME

Minimum exposure time on acquire in ms.

See Also:

Constant Field Values

DEFDATAMIN

private static final int DEFDATAMIN

The default data min for 'good' filtered pixels.

See Also:

Constant Field Values

DEFDATAMAX

private static final int DEFDATAMAX

The default data max for 'good' filtered pixels.

See Also:

Constant Field Values

DEFSEARCHBOX

private static final int DEFSEARCHBOX

The default search box, unbiased.

See Also:

Constant Field Values

DEFRETRYFINE

private static final int DEFRETRYFINE

The default number of retries on acquire.

See Also:

Constant Field Values

DEFCOARSEOFFSET

private static final double DEFCOARSEOFFSET

An estimate of the allowed coarse offset in pixel.

See Also:

Constant Field Values

DEFGUIDERTILE

private static final int DEFGUIDERTILE

The default acquire frame.

See Also:

Constant Field Values

DEFENLARGEFINE

private static final Dimension DEFENLARGEFINE

The default pixel enlargement during acquire.

DEFMAXSHIFTACQUIRE

private static final double DEFMAXSHIFTACQUIRE

The default maximum shift for a successful acquire, pixel.

See Also:

Constant Field Values

DEFSAFETYOFFSET

private static final Dimension DEFSAFETYOFFSET

An estimate of the allowed pointing error in az/alt PIXEL.

increase

private double increase

This is the increase factor that was used for coarse to find stars.

Constructor Detail

AuxiliaryFineUnit

public AuxiliaryFineUnit(Map prop)

Constructs a new acquire unit.

Method Detail

getAuxiliaryType

protected String getAuxiliaryType()

The type of this unit is #ACQUIRETYPE.

Specified by:

getAuxiliaryType in class AuxiliaryUnit

doAuxiliaryTask

protected ErrorEvent doAuxiliaryTask(String ignore)

Brings the acquire star at the cross-hair of the guider. Needs the image rotation and the target altitude. If acquiring was not successful an error event describing the error is returned. In case of success, null is returned.

Specified by:

doAuxiliaryTask in class AuxiliaryUnit

Parameters:

ignore - An integer specifying the action to be taken.

Returns:

null on okay, or an ErrorEvent desribing the failure.

setIncrease

protected void setIncrease(double multiply)

If acquire failed because of no-star detected, set this last increase factor.