stella.adapter

Class AcquiringUnit

java.lang.Object

util.PropertyContainer

util.PropertyResources

stella.adapter.AdapterUnit

stella.adapter.AcquiringUnit

All Implemented Interfaces:

Cloneable, Initializable, PropertySupplying, ResourceSupplying

Direct Known Subclasses:

NasmythUnit, OffAxisUnit, PrimeFocusCamera, ScienceAcquire

public abstract class AcquiringUnit
extends AdapterUnit

An acquiring unit has the ability to fine-align the instrument. Normally this means adjusting the telescope pointing such that the target star is at the crosshairs. Normally this is done with a helper CCD, thus if transmission defects are detectable during the acquire phase, an increasde factor migfht be returned by this unit.

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
static String	COARSE Coarse acquire only.
static String	COARSEFINE Coarse and fine acquire in a row.
private static double	DEFALTCHECK
private static double	DEFAZCHECK
private static boolean	DEFOFFSETDB If true, offsets are recorded in database.
private static int	DEFOFFSETKEEP Maximum number of offset kept.
static String	FINE Fine acquire only.
private Map<Object,Vector2D>	first We record all first offsets passed to us up to a certain capacity.
static String	KEY_ALTCHECK
static String	KEY_AZCHECK
static String	KEY_OFFSETDB If true, offsets are recorded in database.
static String	KEY_OFFSETKEEP Maximum number of offset kept.
static String	NONE If no acquireing should be done.
private AcquireOffsetParameter	offset For interacting acquires, the offset parameter feed from auxiliary.

Fields inherited from class stella.adapter.AdapterUnit

ACQUIRETYPE, GUIDERTYPE, PYRAMIDTYPE

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

Modifier	Constructor and Description
protected	AcquiringUnit(Map<String,String> p)

Method Summary

Modifier and Type	Method and Description
protected Vector2D	checkAcquire() The acquiring unit can check if the last recorded offset is compatible with the suggested one.
protected 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 void	firstOffset(Object objid, Vector2D degoff)
protected abstract double	getIncrease() If acquire failed because of no-star detected, retrrieve this last increase factor.
protected AcquireOffsetParameter	getOffsetParameter()
void	setOffsetParameter(AcquireOffsetParameter off)

Methods inherited from class stella.adapter.AdapterUnit

doUnitTask, getGuider, getMaster, getTelescope, getUnitType, init, isManual, isValid, resetUnit, 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

COARSEFINE

public static final String COARSEFINE

Coarse and fine acquire in a row.

See Also:

Constant Field Values

COARSE

public static final String COARSE

Coarse acquire only.

See Also:

Constant Field Values

FINE

public static final String FINE

Fine acquire only.

See Also:

Constant Field Values

NONE

public static final String NONE

If no acquireing should be done.

See Also:

Constant Field Values

KEY_OFFSETDB

public static final String KEY_OFFSETDB

If true, offsets are recorded in database. False, if secondary acquire.

See Also:

Constant Field Values

KEY_OFFSETKEEP

public static final String KEY_OFFSETKEEP

Maximum number of offset kept.

See Also:

Constant Field Values

KEY_ALTCHECK

public static final String KEY_ALTCHECK

See Also:

Constant Field Values

KEY_AZCHECK

public static final String KEY_AZCHECK

See Also:

Constant Field Values

DEFOFFSETDB

private static final boolean DEFOFFSETDB

If true, offsets are recorded in database. False, if secondary acquire.

See Also:

Constant Field Values

DEFOFFSETKEEP

private static final int DEFOFFSETKEEP

Maximum number of offset kept.

See Also:

Constant Field Values

DEFALTCHECK

private static final double DEFALTCHECK

See Also:

Constant Field Values

DEFAZCHECK

private static final double DEFAZCHECK

See Also:

Constant Field Values

offset

private AcquireOffsetParameter offset

For interacting acquires, the offset parameter feed from auxiliary.

first

private final Map<Object,Vector2D> first

We record all first offsets passed to us up to a certain capacity.

Constructor Detail

AcquiringUnit

protected AcquiringUnit(Map<String,String> p)

Method Detail

getIncrease

protected abstract double getIncrease()

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

setOffsetParameter

public void setOffsetParameter(AcquireOffsetParameter off)

checkAcquire

protected Vector2D checkAcquire()

The acquiring unit can check if the last recorded offset is compatible with the suggested one. If not, we return the suggest offset.

Returns:

null if successful

getOffsetParameter

protected AcquireOffsetParameter getOffsetParameter()

firstOffset

protected void firstOffset(Object objid,
                           Vector2D degoff)

databaseOffset

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