stella.adapter

Class AuxiliaryCoarseUnit

java.lang.Object

util.PropertyContainer

util.PropertyResources

stella.adapter.AuxiliaryUnit

stella.adapter.AuxiliaryCaptureUnit

stella.adapter.AuxiliaryCoarseUnit

All Implemented Interfaces:

Cloneable, Guiding.RawFrame, Initializable, 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.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private static double	DEFBINARYMAG A companion may be fainter by this mag to still trigger proximity.
private static double	DEFBINARYSEPARATE A companion must be closer (degs) to trigger proximity.
private static double	DEFBINARYTIME Time factorial increase in proximity.
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	DEFMAXDITHERSHIFT
private static long	DEFMINOFFTIME Minimum exposure time on acquire in ms.
private static double	DEFRESOLUTIONLIMIT A companion must be closer (degs) to trigger proximity.
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_BINARYMAG A companion may be fainter by this mag to still trigger proximity.
static String	KEY_BINARYSEPARATE A companion must be closer (degs) to trigger proximity.
static String	KEY_BINARYTIME Time factorial increase in proximity.
static String	KEY_ENLARGECOARSE A gray-zone around the acquire field for catalog star inclusion.
private static String	KEY_MAXDITHERSHIFT If the applied dither is higher than this shift, also repos tel.
static String	KEY_RESOLUTIONLIMIT A companion closer (degs) cannot be resolved.
static String	KEY_RETRYCOARSE Maximum retries on coarse acquire.
static String	KEY_TIMEINCREASE Increase the exposure time on coarse acquire fails.
static String	SUGGEST This mode is the suggest mode, where the offset is not applied.

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_BINNING, KEY_FALLBACK, KEY_GUIDERTILE, KEY_USETILING, PINHOLETYPE

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

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

Constructors

Constructor and Description
AuxiliaryCoarseUnit(Map<String,String> prop) Constructs a new acquire unit.

Method Summary

Modifier and Type	Method and Description
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 suggest) Brings the acquire star at the cross-hair of the guider.
protected String	getAuxiliaryType() The type of this unit is AuxiliaryUnit.COARSETYPE.
protected double	getIncrease() If acquire failed within its tries because of no-star detected, retrieve the last time-increase factor.
private Pair<Vector2D,Boolean>	oneExposure(Object objid, long acquireexpose, long acquireraw, double twininc, int datamin, int curacq) For the unique object objid we do an exposure with acquireexpose ms, first estimate was acquireraw.

Methods inherited from class stella.adapter.AuxiliaryCaptureUnit

applyOffsetMeasure, canUseCentral, getCaptureSignal, getCaptureTime, getFocusPoint, getGuideStar, getMinimumCaptureTime, getOffsetMeasure, init, isGuideCenter, isUseCentral, setGuideStar, setGuideStar, setOffsetMeasure

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.PropertyResources

clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

augment, augment, 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, parseObject, 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 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

SUGGEST

public static final String SUGGEST

This mode is the suggest mode, where the offset is not applied.

See Also:

Constant Field Values

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

KEY_MAXDITHERSHIFT

private static final String KEY_MAXDITHERSHIFT

If the applied dither is higher than this shift, also repos tel.

See Also:

Constant Field Values

KEY_BINARYMAG

public static final String KEY_BINARYMAG

A companion may be fainter by this mag to still trigger proximity.

See Also:

Constant Field Values

KEY_RESOLUTIONLIMIT

public static final String KEY_RESOLUTIONLIMIT

A companion closer (degs) cannot be resolved.

See Also:

Constant Field Values

KEY_BINARYSEPARATE

public static final String KEY_BINARYSEPARATE

A companion must be closer (degs) to trigger proximity.

See Also:

Constant Field Values

KEY_BINARYTIME

public static final String KEY_BINARYTIME

Time factorial increase in proximity.

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

DEFMAXDITHERSHIFT

private static final double DEFMAXDITHERSHIFT

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

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.

DEFBINARYMAG

private static final double DEFBINARYMAG

A companion may be fainter by this mag to still trigger proximity.

See Also:

Constant Field Values

DEFRESOLUTIONLIMIT

private static final double DEFRESOLUTIONLIMIT

A companion must be closer (degs) to trigger proximity.

See Also:

Constant Field Values

DEFBINARYSEPARATE

private static final double DEFBINARYSEPARATE

A companion must be closer (degs) to trigger proximity.

See Also:

Constant Field Values

DEFBINARYTIME

private static final double DEFBINARYTIME

Time factorial increase in proximity.

See Also:

Constant Field Values

increase

private double increase

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

Constructor Detail

AuxiliaryCoarseUnit

public AuxiliaryCoarseUnit(Map<String,String> prop)

Constructs a new acquire unit.

Method Detail

getAuxiliaryType

protected String getAuxiliaryType()

The type of this unit is AuxiliaryUnit.COARSETYPE.

Specified by:

getAuxiliaryType in class AuxiliaryUnit

doAuxiliaryTask

protected ErrorEvent doAuxiliaryTask(String suggest)

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:

suggest - An integer specifying the action to be taken.

Returns:

null on okay, or an ErrorEvent desribing the failure.

oneExposure

private Pair<Vector2D,Boolean> oneExposure(Object objid,
                                           long acquireexpose,
                                           long acquireraw,
                                           double twininc,
                                           int datamin,
                                           int curacq)
                                    throws IllegalWindowException,
                                           IllegalSearchBoxException,
                                           AmbiguousPatternException,
                                           NoStarException,
                                           CannotMatchException

For the unique object objid we do an exposure with acquireexpose ms, first estimate was acquireraw. The current acquire number is provided for logging.

Parameters:

objid - Unique

acquireexpose - The exposure time to use

acquireraw - The exposure time first estimated

twininc - Increase of exposure time due to twin

curacq - Running number in tries.

Returns:

A vector with the measured azimuth/altitude shift and a boolean, true if good shift.

Throws:

IllegalSearchBoxException

IllegalWindowException

CannotMatchException

NoStarException

AmbiguousPatternException

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.