stella.acquire

Class FixedFrameAcquisition

java.lang.Object

util.PropertyContainer

util.PropertyResources

stella.util.GenericUnit

stella.acquire.AncillaryCameraUnit

stella.acquire.AcquisitionUnit

stella.acquire.FixedFrameAcquisition

All Implemented Interfaces:

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

Direct Known Subclasses:

StarAcquisition

public abstract class FixedFrameAcquisition
extends AcquisitionUnit
implements ImageReducing

Author:

wooz

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	DEFDARKTIME Default dark time is dark is current frame, so 1000ms.
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 ArrayLayout	frame Layout of bias/dark/flat frame.
static String	KEY_ACQUIRESIZE The readout-size during acquisition.
static String	KEY_BIASFITS Path to the bias fits file.
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_DARKFITS Path to the bias fits file.
static String	KEY_DARKTIME Integration time of the dark frame.
static String	KEY_FLATFITS Path to the bias fits file.
static String	KEY_RESOLUTIONLIMIT A companion closer (degs) cannot be resolved.
private float[]	mbias If a bias frame was assigned to this object, we read it on init.
private float[]	mdark If a dark frame was assigned to this object, we read it on init.
private float[]	mflat If a flat frame was assigned to this object, we read it on init.

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

Modifier	Constructor and Description
protected	FixedFrameAcquisition(Map<String,String> props)

Method Summary

Modifier and Type	Method and Description
protected boolean	checkShift(Vector2D shift, double maxpixel)
float[]	getBias(MImageHDU raw) Returns a bias frame as a one-dimensional float.
float[]	getDark(MImageHDU raw, double exptime) Returns a dark frame as a one-dimensional float.
float[]	getFlat(MImageHDU raw, String filter) Returns a flat frame for the specified filter name as a one-dimensional float.
protected Rectangle	getReadoutWindow(RayPath geometry, Point2D pinhole, Vector2D rade, Star onto) If we have an acquire size, we return a read-out window centered around the expected pixel position of the acquisition star.
void	init()
private MImageHDU	readCalibrationFits(String resource)

Methods inherited from class stella.acquire.AcquisitionUnit

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

Methods inherited from class stella.acquire.AncillaryCameraUnit

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

Methods inherited from class stella.util.GenericUnit

defaultGuidingStar, getMaster, getUnitType, isValid, 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 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_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_ACQUIRESIZE

public static final String KEY_ACQUIRESIZE

The readout-size during acquisition.

See Also:

Constant Field Values

KEY_BIASFITS

public static final String KEY_BIASFITS

Path to the bias fits file.

See Also:

Constant Field Values

KEY_DARKFITS

public static final String KEY_DARKFITS

Path to the bias fits file.

See Also:

Constant Field Values

KEY_DARKTIME

public static final String KEY_DARKTIME

Integration time of the dark frame.

See Also:

Constant Field Values

KEY_FLATFITS

public static final String KEY_FLATFITS

Path to the bias fits file.

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

DEFDARKTIME

private static final double DEFDARKTIME

Default dark time is dark is current frame, so 1000ms.

See Also:

Constant Field Values

mbias

private float[] mbias

If a bias frame was assigned to this object, we read it on init.

mdark

private float[] mdark

If a dark frame was assigned to this object, we read it on init.

mflat

private float[] mflat

If a flat frame was assigned to this object, we read it on init.

frame

private ArrayLayout frame

Layout of bias/dark/flat frame.

Constructor Detail

FixedFrameAcquisition

protected FixedFrameAcquisition(Map<String,String> props)

Parameters:

props -

Method Detail

init

public void init()

Specified by:

init in interface Initializable

Overrides:

init in class GenericUnit

getReadoutWindow

protected Rectangle getReadoutWindow(RayPath geometry,
                                     Point2D pinhole,
                                     Vector2D rade,
                                     Star onto)

If we have an acquire size, we return a read-out window centered around the expected pixel position of the acquisition star. If we have no acquire size or if we cannot deduce the pixel position of the guide star we return null, indicative of full-frame readout.

Parameters:

geometry -

pinhole -

rade -

onto -

Returns:

checkShift

protected boolean checkShift(Vector2D shift,
                             double maxpixel)

readCalibrationFits

private MImageHDU readCalibrationFits(String resource)

getBias

public float[] getBias(MImageHDU raw)
                throws BasicFitsException

Description copied from interface: ImageReducing

Returns a bias frame as a one-dimensional float. The geometry follows from the raw file.

Specified by:

getBias in interface ImageReducing

Parameters:

raw - The raw image to check geometry.

Returns:

A float array in the raw image layout or null.

Throws:

BasicFitsException

getDark

public float[] getDark(MImageHDU raw,
                       double exptime)
                throws BasicFitsException

Description copied from interface: ImageReducing

Returns a dark frame as a one-dimensional float. The geometry follows from the raw file.

Specified by:

getDark in interface ImageReducing

Parameters:

raw - The raw image to check geometry.

exptime - The exposure time of the raw image in seconds

Returns:

A float array in the raw image layout or null.

Throws:

BasicFitsException

getFlat

public float[] getFlat(MImageHDU raw,
                       String filter)
                throws BasicFitsException

Description copied from interface: ImageReducing

Returns a flat frame for the specified filter name as a one-dimensional float. The geometry follows from the raw file.

Specified by:

getFlat in interface ImageReducing

Parameters:

raw - The raw image to check geometry.

filter - Name of filter or null if only white light or singled-filter system.

Returns:

A float array in the raw image layout or null.

Throws:

BasicFitsException