stella.acquire

Class CoarseStarAcquisition

java.lang.Object

util.PropertyContainer

util.PropertyResources

stella.util.GenericUnit

stella.acquire.AncillaryCameraUnit

stella.acquire.AcquisitionUnit

stella.acquire.FixedFrameAcquisition

stella.acquire.StarAcquisition

stella.acquire.CoarseStarAcquisition

All Implemented Interfaces:

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

Direct Known Subclasses:

AuxiliaryCoarseAcquisition, OffAxisCoarseAcquisition, PinholeCoarseAcquisition

public class CoarseStarAcquisition
extends StarAcquisition
implements CoarseAcquiring

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_AVFWHM
static String	KEY_COARSEBINNING The binning used for coarse acquisition.
static String	KEY_COARSEFIELDOFVIEW
static String	KEY_COARSESIGNAL
static String	KEY_INCREASEBRIGHTBINARY
static String	KEY_INCREASEDELSTARS
static String	KEY_INCREASEFAINTBINARY
static String	KEY_INCREASENOSTARS
static String	KEY_PIXELSHIFTMAXIMUM
static String	KEY_RETRYCOARSE Maximum retries on coarse 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
CoarseStarAcquisition(Map<String,String> props)

Method Summary

Modifier and Type	Method and Description
Vector2D	coarseAcquisition(Acquisition ag, TransparencyMeasuring prior) This method is called to conduct an entire coarse acquisition cycle.
Vector2D	coarseShift(Rectangle readout, Dimension bin, double expt, MImageHDU coarse, Acquisition ag) This method should return a pixel shift from checking the apparent position through an acquisition camera.
void	configureUnit()
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.
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.CoarseAcquiring

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_RETRYCOARSE

public static final String KEY_RETRYCOARSE

Maximum retries on coarse acquire.

See Also:

Constant Field Values

KEY_COARSEBINNING

public static final String KEY_COARSEBINNING

The binning used for coarse acquisition.

See Also:

Constant Field Values

KEY_COARSESIGNAL

public static final String KEY_COARSESIGNAL

See Also:

Constant Field Values

KEY_COARSEFIELDOFVIEW

public static final String KEY_COARSEFIELDOFVIEW

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_PIXELSHIFTMAXIMUM

public static final String KEY_PIXELSHIFTMAXIMUM

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

CoarseStarAcquisition

public CoarseStarAcquisition(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

coarseAcquisition

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

Description copied from interface: CoarseAcquiring

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

Specified by:

coarseAcquisition in interface CoarseAcquiring

Returns:

Throws:

NoShiftException

ConfigurationException

coarseShift

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

Description copied from interface: CoarseAcquiring

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:

coarseShift in interface CoarseAcquiring

Returns:

A pixel shift in x/y CCD coordinates.

Throws:

ConfigurationException

NoShiftException

getUnitType

public String getUnitType()

Specified by:

getUnitType in class GenericUnit

getTransparencyIncrease

public double getTransparencyIncrease()

Description copied from interface: TransparencyMeasuring

Returns the exposure time increase after a successful acquisition.

Specified by:

getTransparencyIncrease in interface TransparencyMeasuring

configureUnit

public void configureUnit()
                   throws ConfigurationException

Overrides:

configureUnit in class StarAcquisition

Throws:

ConfigurationException