stella.adapter
Class AuxiliaryCoarseUnit

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

All Implemented Interfaces:

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

public class AuxiliaryCoarseUnit
extends AuxiliaryCaptureUnit

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

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.URLResource

Field Summary

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	DEFENLARGECOARSE 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	DEFMAGERROR An estimate of the mgnitude error.
private static long	DEFMINOFFTIME Minimum exposure time on acquire in ms.
private static double	DEFPOSITIONERROR An estimate of the catalog errors in pixels on ccd.
private static int	DEFRETRYCOARSE 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 If the acquire exposure time was increased, this is the final factor.
static String	KEY_ENLARGECOARSE A gray-zone around the acquire field for catalog star inclusion.
static String	KEY_RETRYCOARSE Maximum retries on coarse 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

AuxiliaryCoarseUnit(Map prop)
Constructs a new acquire unit.

Method Summary

private void	databaseOffset(Object objid, Vector2D degoff) We try to write a valid offset to the database using the current unique parameter and the first offset encountered.
protected ErrorEvent	doAuxiliaryTask(String ignored) Brings the acquire star at the cross-hair of the guider.
protected String	getAuxiliaryType() The type of this unit is #ACQUIRETYPE.
protected double	getIncrease() If acquire failed within its tries because of no-star detected, retrieve the last time-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_RETRYCOARSE

public static final String KEY_RETRYCOARSE

Maximum retries on coarse acquire.

See Also:

Constant Field Values

KEY_ENLARGECOARSE

public static final String KEY_ENLARGECOARSE

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

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

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

DEFPOSITIONERROR

private static final double DEFPOSITIONERROR

An estimate of the catalog errors in pixels on ccd.

See Also:

Constant Field Values

DEFMAGERROR

private static final double DEFMAGERROR

An estimate of the mgnitude error.

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

DEFRETRYCOARSE

private static final int DEFRETRYCOARSE

The default number of retries on acquire.

See Also:

Constant Field Values

DEFGUIDERTILE

private static final int DEFGUIDERTILE

The default acquire frame.

See Also:

Constant Field Values

DEFENLARGECOARSE

private static final Dimension DEFENLARGECOARSE

The default pixel enlargement during acquire.

DEFSAFETYOFFSET

private static final Dimension DEFSAFETYOFFSET

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

increase

private double increase

If the acquire exposure time was increased, this is the final factor.

Constructor Detail

AuxiliaryCoarseUnit

public AuxiliaryCoarseUnit(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 ignored)

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:

ignored - An integer specifying the action to be taken.

Returns:

null on okay, or an ErrorEvent desribing the failure.

getIncrease

protected double getIncrease()

If acquire failed within its tries because of no-star detected, retrieve the last time-increase factor. This can be signaled to other AuxiliarUnits.

databaseOffset

private void databaseOffset(Object objid,
                            Vector2D degoff)

We try to write a valid offset to the database using the current unique parameter and the first offset encountered. This is done immediately after the acquiring phase has completed successfully.