AuxiliaryFineUnit

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

All Implemented Interfaces:

Cloneable, Guiding.RawFrame, Initializable, 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.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 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_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_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_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

AuxiliaryFineUnit(Map<String,String> prop)
Constructs a new acquire unit.

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

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`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 `AuxiliaryUnit.FINETYPE`.
`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
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
  - 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
  - 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_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
  - 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.
  - DEFBINARYMAG
```
private static final double DEFBINARYMAG
```
    A companion may be fainter by this mag to still 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
  - 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<String,String> prop)
```
    Constructs a new acquire unit.
- Method Detail
  - getAuxiliaryType
```
protected String getAuxiliaryType()
```
    The type of this unit is AuxiliaryUnit.FINETYPE.
    
    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.

Class AuxiliaryFineUnit

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

Field Summary

Fields inherited from class stella.adapter.AuxiliaryCaptureUnit

Fields inherited from class stella.adapter.AuxiliaryUnit

Fields inherited from class util.PropertyResources

Fields inherited from class util.PropertyContainer

Fields inherited from interface util.ResourceSupplying

Fields inherited from interface util.PropertySupplying

Constructor Summary

Method Summary

Methods inherited from class stella.adapter.AuxiliaryCaptureUnit

Methods inherited from class stella.adapter.AuxiliaryUnit

Methods inherited from class util.PropertyResources

Methods inherited from class util.PropertyContainer

Methods inherited from class java.lang.Object

Methods inherited from interface util.PropertySupplying

Field Detail

KEY_TIMEINCREASE

KEY_RETRYFINE

KEY_COARSEOFFSET

KEY_ENLARGEFINE

KEY_MAXSHIFTACQUIRE

KEY_BINARYMAG

KEY_BINARYSEPARATE

KEY_BINARYTIME

DEFKEEPFITS

DEFKEEPWHAT

DEFROWTIMING

DEFTIMEINCREASE

DEFEXPOSE

DEFMINOFFTIME

DEFDATAMIN

DEFDATAMAX

DEFSEARCHBOX

DEFRETRYFINE

DEFCOARSEOFFSET

DEFGUIDERTILE

DEFENLARGEFINE

DEFBINARYMAG

DEFBINARYSEPARATE

DEFBINARYTIME

DEFMAXSHIFTACQUIRE

DEFSAFETYOFFSET

increase

Constructor Detail

AuxiliaryFineUnit

Method Detail

getAuxiliaryType

doAuxiliaryTask

setIncrease