stella.acquire

Class FineStarAcquisition

java.lang.Object

util.PropertyContainer

util.PropertyResources

stella.util.GenericUnit

stella.acquire.AncillaryCameraUnit

stella.acquire.AcquisitionUnit

stella.acquire.FixedFrameAcquisition

stella.acquire.StarAcquisition

stella.acquire.FineStarAcquisition

All Implemented Interfaces:

ImageReducing, GlobalDepending, Cloneable, FineAcquiring, PersitentAcquiring, TransparencyMeasuring, Initializable, PropertySupplying, ResourceSupplying

Direct Known Subclasses:

AuxiliaryFineAcquisition, OffAxisFineAcquisition, PinholeFineAcquisition

public class FineStarAcquisition
extends StarAcquisition
implements FineAcquiring

Nested Class Summary

Nested classes/interfaces inherited from class stella.acquire.AcquisitionUnit

AcquisitionUnit.Modes

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	DEFRESOLUTIONLIMIT A companion must be closer (degs) to trigger proximity.
private double	increase Keep track of the exposure time increase due to transparency loss.
static String	KEY_ACQUIRETOLERANCE Maximum allowed tolerance in pixel to consider acquire a success.
static String	KEY_AVFWHM
static String	KEY_FINEBINNING The binning used for coarse acquisition.
static String	KEY_FINEFIELDOFVIEW
static String	KEY_FINESIGNAL
static String	KEY_INCREASEBRIGHTBINARY
static String	KEY_INCREASEDELSTARS
static String	KEY_INCREASEFAINTBINARY
static String	KEY_INCREASENOSTARS
static String	KEY_PINHOLEOFFSET Expected maximum pointing error after coarse in acquisition pixel.
static String	KEY_PIXELSHIFTMAXIMUM Maximum allowed pixel shift on fine.
static String	KEY_RETRYFINE Maximum retries on fine acquire.
static String	KEY_ROWTIMING

Fields inherited from class stella.acquire.StarAcquisition

KEY_DATAMAX, KEY_DATAMIN, KEY_GAUSSFWHM, KEY_GAUSSTRUNCATE, KEY_SEARCHBOX, KEY_STRIPEADU

Fields inherited from class stella.acquire.FixedFrameAcquisition

KEY_ACQUIRESIZE, KEY_BIASFITS, KEY_BINARYMAG, KEY_BINARYSEPARATE, KEY_DARKFITS, KEY_DARKTIME, KEY_FLATFITS, KEY_RESOLUTIONLIMIT

Fields inherited from class stella.acquire.AcquisitionUnit

KEY_KEEPFITS, KEY_KEEPWHAT

Fields inherited from class stella.acquire.AncillaryCameraUnit

KEY_FITSDIR, KEY_XTENSION

Fields inherited from class stella.util.GenericUnit

KEY_UNITTYPE

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
FineStarAcquisition(Map<String,String> props)

Method Summary

Modifier and Type	Method and Description
void	configureUnit()
Vector2D	fineAcquisition(Acquisition ag, TransparencyMeasuring prior) This method is called to conduct an entire fine acquisition cycle.
Vector2D	fineShift(Rectangle readout, Dimension bin, double expt, MImageHDU fine, Acquisition ag) This method should return a pixel shift from checking the apparent position through an acquisition camera.
List<StarProspect>	getExpectedStars(double texp, Rectangle readout, Dimension bin, boolean single) From a readout frame plus binning on a detector, return a list of star one expects to see on the CCD.
protected Vector2D	getPivotProxima(Vector2D cent, List<StarDetection> raw, double maxoff) Checks all identifies stars to a maximum distance and returns the closest, if any.
double	getTransparencyIncrease() Returns the exposure time increase after a successful acquisition.
String	getUnitType()
void	init()

Methods inherited from class stella.acquire.StarAcquisition

getAcquisition, isValid, setAcquisitionAndGuiding

Methods inherited from class stella.acquire.FixedFrameAcquisition

checkShift, getBias, getDark, getFlat, getReadoutWindow

Methods inherited from class stella.acquire.AcquisitionUnit

getAcquisitionResource, getBinaryAcquisition, getExpectedStars, getOneExtension, getRaw, persitent, reduce16, sendFieldOfView, sendShifts, sendTelescopeOffset, setCount, setTry

Methods inherited from class stella.acquire.AncillaryCameraUnit

binningAndWindow, getAcquisitionExtension, getFitsDirectory, getOneExposure, isManual, reducedFloat, save, save, setManual

Methods inherited from class stella.util.GenericUnit

defaultGuidingStar, getMaster, isValid, registerGlobals, setMaster

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 stella.acquire.FineAcquiring

getAcquisition

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_RETRYFINE

public static final String KEY_RETRYFINE

Maximum retries on fine acquire.

See Also:

Constant Field Values

KEY_FINEBINNING

public static final String KEY_FINEBINNING

The binning used for coarse acquisition.

See Also:

Constant Field Values

KEY_FINESIGNAL

public static final String KEY_FINESIGNAL

See Also:

Constant Field Values

KEY_FINEFIELDOFVIEW

public static final String KEY_FINEFIELDOFVIEW

See Also:

Constant Field Values

KEY_INCREASEFAINTBINARY

public static final String KEY_INCREASEFAINTBINARY

See Also:

Constant Field Values

KEY_INCREASEBRIGHTBINARY

public static final String KEY_INCREASEBRIGHTBINARY

See Also:

Constant Field Values

KEY_INCREASENOSTARS

public static final String KEY_INCREASENOSTARS

See Also:

Constant Field Values

KEY_INCREASEDELSTARS

public static final String KEY_INCREASEDELSTARS

See Also:

Constant Field Values

KEY_ROWTIMING

public static final String KEY_ROWTIMING

See Also:

Constant Field Values

KEY_AVFWHM

public static final String KEY_AVFWHM

See Also:

Constant Field Values

KEY_PINHOLEOFFSET

public static final String KEY_PINHOLEOFFSET

Expected maximum pointing error after coarse in acquisition pixel.

See Also:

Constant Field Values

KEY_PIXELSHIFTMAXIMUM

public static final String KEY_PIXELSHIFTMAXIMUM

Maximum allowed pixel shift on fine.

See Also:

Constant Field Values

KEY_ACQUIRETOLERANCE

public static final String KEY_ACQUIRETOLERANCE

Maximum allowed tolerance in pixel to consider acquire a success.

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

DEFBINARYMAG

private static final double DEFBINARYMAG

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

See Also:

Constant Field Values

increase

private double increase

Keep track of the exposure time increase due to transparency loss.

Constructor Detail

FineStarAcquisition

public FineStarAcquisition(Map<String,String> props)

Method Detail

init

public void init()

Specified by:

init in interface Initializable

Overrides:

init in class FixedFrameAcquisition

getExpectedStars

public List<StarProspect> getExpectedStars(double texp,
                                           Rectangle readout,
                                           Dimension bin,
                                           boolean single)
                                    throws ConfigurationException

Description copied from class: AcquisitionUnit

From a readout frame plus binning on a detector, return a list of star one expects to see on the CCD.

Specified by:

getExpectedStars in class AcquisitionUnit

Parameters:

texp - Exposure time in seconds.

Returns:

Throws:

ConfigurationException

fineAcquisition

public Vector2D fineAcquisition(Acquisition ag,
                                TransparencyMeasuring prior)
                         throws NoShiftException,
                                ConfigurationException

Description copied from interface: FineAcquiring

This method is called to conduct an entire fine acquisition cycle. During fine Acquisition, the #fineShift(Rectangle, Dimension, double, MImageHDU, AcquisitionAndGuiding) method will be called repeatedly.

Specified by:

fineAcquisition in interface FineAcquiring

Returns:

Throws:

NoShiftException

ConfigurationException

fineShift

public Vector2D fineShift(Rectangle readout,
                          Dimension bin,
                          double expt,
                          MImageHDU fine,
                          Acquisition ag)
                   throws NoShiftException,
                          ConfigurationException

Description copied from interface: FineAcquiring

This method should return a pixel shift from checking the apparent position through an acquisition camera. It will be converted into a telescope offset using a RayPath assigned to the acquisition unit.

Specified by:

fineShift in interface FineAcquiring

Returns:

A pixel shift in x/y CCD coordinates.

Throws:

ConfigurationException

NoShiftException

getTransparencyIncrease

public double getTransparencyIncrease()

Description copied from interface: TransparencyMeasuring

Returns the exposure time increase after a successful acquisition.

Specified by:

getTransparencyIncrease in interface TransparencyMeasuring

getUnitType

public String getUnitType()

Specified by:

getUnitType in class GenericUnit

getPivotProxima

protected Vector2D getPivotProxima(Vector2D cent,
                                   List<StarDetection> raw,
                                   double maxoff)

Checks all identifies stars to a maximum distance and returns the closest, if any.

Parameters:

cent - The pixel where the acquire star should be found

found - All stars identified

maxoff - Do not trust stars further than this distance.

Returns:

The shift between expected and seen acquire star, pixel.

configureUnit

public void configureUnit()
                   throws ConfigurationException

Overrides:

configureUnit in class StarAcquisition

Throws:

ConfigurationException