stella.acquire

Class AcquisitionUnit

java.lang.Object

util.PropertyContainer

util.PropertyResources

stella.util.GenericUnit

stella.acquire.AncillaryCameraUnit

stella.acquire.AcquisitionUnit

All Implemented Interfaces:

GlobalDepending, Cloneable, PersitentAcquiring, Initializable, PropertySupplying, ResourceSupplying

Direct Known Subclasses:

AbstractAutoGuider, FixedFrameAcquisition

public abstract class AcquisitionUnit
extends AncillaryCameraUnit
implements PersitentAcquiring

Author:

wooz

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AcquisitionUnit.Modes The supported modes of acquisition, full is coarse followed by fine.

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private int	count If we have also a running number.
static String	KEY_KEEPFITS All acquire fits plus some reduction products are kept on disc.
static String	KEY_KEEPWHAT What to keep.
private int	tries If we have a running try.

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

Method Summary

Modifier and Type	Method and Description
private void	fillAndSend(String type, Object unique, int attempt, List<? extends Glint> catalog, StarFieldOfView expect)
String	getAcquisitionResource() From the type of unit plus the unique identifier and a possible count we return a unique ID describing the currently process image.
protected Star	getBinaryAcquisition(Star onto, List<Star> fov, double minsep, double maxsep, float faint) For binary acquisitions, an increase of the nominal exposure time may be indicated to make sure that there is no source confusion.
abstract 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 List<StarProspect>	getExpectedStars(List<Star> fov, double ms0, Rectangle readout, Dimension bin, int frame, boolean single, Vector2D rade, Point2D hotpix, RayPath geometry, ExposureTimeProviding etc)
protected MImageHDU	getOneExtension(CcdDriver camera, double texp) Returns the raw image-hdu from the CCD that should be used for auto guiding.
protected MImageHDU	getRaw(MFits mf) Returns the raw image-hdu from the CCD that should be used for auto guiding.
boolean	persitent(FitsReduction.Write type, ArrayLayout header, float[] data)
private File	primarySaveFits()
protected MImageHDU	reduce16(MImageHDU raw, double texp, ImageReducing ir) Returns a 16-bit MImageHDU from a raw, 16-bit image.
protected void	sendFieldOfView(String type, List<StarProspect> catalog, List<StarDetection> found, List<StarDetection> spurious, List<StarDetection> stripes, List<StarDetection> mirrors, List<StarDetection> ghosts) Sends information regarding expected and detected star fields to listeners.
protected void	sendShifts(Vector2D shift, Vector2D degoff)
protected void	sendTelescopeOffset(double daz, double del, boolean dowait) The offsets provided are already prepared for a direct sending to TCS.
protected abstract void	setAcquisitionAndGuiding(AcquisitionAndGuiding ag)
void	setCount(int count) If we repeatedly reduce fits files that all belong to a logical single ID (which has been set by #setUnique(String)), a running count may be the best way to distinguish the different processing loops.
void	setTry(int tries) If we repeatedly reduce fits file, because unsuccessful tries lead to a re-do, calling this method may help keeping all (even failed) tries.

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, init, 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_KEEPFITS

public static final String KEY_KEEPFITS

All acquire fits plus some reduction products are kept on disc.

See Also:

Constant Field Values

KEY_KEEPWHAT

public static final String KEY_KEEPWHAT

What to keep.

See Also:

Constant Field Values

count

private int count

If we have also a running number.

tries

private int tries

If we have a running try.

Constructor Detail

AcquisitionUnit

protected AcquisitionUnit(Map<String,String> props)

Parameters:

props -

Method Detail

setAcquisitionAndGuiding

protected abstract void setAcquisitionAndGuiding(AcquisitionAndGuiding ag)
                                          throws ConfigurationException

Throws:

ConfigurationException

getExpectedStars

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

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

Parameters:

texp - Exposure time in seconds.

readout -

bin -

single -

Returns:

Throws:

ConfigurationException

getExpectedStars

protected List<StarProspect> getExpectedStars(List<Star> fov,
                                              double ms0,
                                              Rectangle readout,
                                              Dimension bin,
                                              int frame,
                                              boolean single,
                                              Vector2D rade,
                                              Point2D hotpix,
                                              RayPath geometry,
                                              ExposureTimeProviding etc)

sendTelescopeOffset

protected void sendTelescopeOffset(double daz,
                                   double del,
                                   boolean dowait)
                            throws PositioningException

The offsets provided are already prepared for a direct sending to TCS. For STELLA this means, the azimuth offset has been divided by cosine of elevation, the altitude offset is sign-reversed to a zenith distance offset.

Parameters:

daz -

del -

dowait -

Throws:

ConfigurationException

PositioningException

getOneExtension

protected MImageHDU getOneExtension(CcdDriver camera,
                                    double texp)
                             throws BasicFitsException,
                                    IOException

Returns the raw image-hdu from the CCD that should be used for auto guiding.

Returns:

The first image HDU

Throws:

BasicFitsException

IOException

getRaw

protected MImageHDU getRaw(MFits mf)
                    throws BasicFitsException

Returns the raw image-hdu from the CCD that should be used for auto guiding.

Returns:

The first image HDU

Throws:

BasicFitsException

setCount

public void setCount(int count)

If we repeatedly reduce fits files that all belong to a logical single ID (which has been set by #setUnique(String)), a running count may be the best way to distinguish the different processing loops. In particular, auto-guiders will use this method.

Specified by:

setCount in interface PersitentAcquiring

Parameters:

count - the count to set

setTry

public void setTry(int tries)

If we repeatedly reduce fits file, because unsuccessful tries lead to a re-do, calling this method may help keeping all (even failed) tries. This method will be utilized by coarse and fine acquiring processes.

Specified by:

setTry in interface PersitentAcquiring

Parameters:

tries - the tries to set

getAcquisitionResource

public String getAcquisitionResource()

Description copied from interface: PersitentAcquiring

From the type of unit plus the unique identifier and a possible count we return a unique ID describing the currently process image.

Specified by:

getAcquisitionResource in interface PersitentAcquiring

Returns:

persitent

public boolean persitent(FitsReduction.Write type,
                         ArrayLayout header,
                         float[] data)

Specified by:

persitent in interface PersitentAcquiring

primarySaveFits

private File primarySaveFits()

getBinaryAcquisition

protected Star getBinaryAcquisition(Star onto,
                                    List<Star> fov,
                                    double minsep,
                                    double maxsep,
                                    float faint)

For binary acquisitions, an increase of the nominal exposure time may be indicated to make sure that there is no source confusion. This method returns the brightest star in close proximity to our main acquire target.

Parameters:

onto - Our main acquisition star

fov - The field-of-view around the acquisition star, ordered for mag.

minsep - Minimum degree separation to be visible as binary

maxsep - Maximum degree separation to trigger binary acquisition

faint - If binary star is fainter than main, ignore

Returns:

The brightest star in close proximity to our main acquire target.

sendFieldOfView

protected void sendFieldOfView(String type,
                               List<StarProspect> catalog,
                               List<StarDetection> found,
                               List<StarDetection> spurious,
                               List<StarDetection> stripes,
                               List<StarDetection> mirrors,
                               List<StarDetection> ghosts)

Sends information regarding expected and detected star fields to listeners.

Parameters:

catalog -

found -

spurious -

stripes -

mirrors -

ghosts -

fillAndSend

private void fillAndSend(String type,
                         Object unique,
                         int attempt,
                         List<? extends Glint> catalog,
                         StarFieldOfView expect)

Parameters:

type -

unique -

attempt -

catalog -

expect -

sendShifts

protected void sendShifts(Vector2D shift,
                          Vector2D degoff)

reduce16

protected MImageHDU reduce16(MImageHDU raw,
                             double texp,
                             ImageReducing ir)
                      throws BasicFitsException

Returns a 16-bit MImageHDU from a raw, 16-bit image. If the image reducer is null or does not provide any of bias, dark, or flat data, the raw data is returned, otherwise arithmetics are performed in float space before finally the data is converted back to 16 bit shorts.

Parameters:

raw -

texp -

ir -

Returns:

Throws:

BasicFitsException