stella.acquire

Class AbstractAcquisitionAndGuiding

java.lang.Object

util.PropertyContainer

stella.acquire.AbstractAcquisitionAndGuiding

All Implemented Interfaces:

GlobalDepending, Cloneable, AcquisitionAndGuiding, Initializable, PropertySupplying

Direct Known Subclasses:

AbstractAcquisition, AbstractGuiding

public abstract class AbstractAcquisitionAndGuiding
extends PropertyContainer
implements AcquisitionAndGuiding, GlobalDepending, Initializable

An acquisition and guiding instance composes all necessary object to conduct an acquisition and auto guiding, respectively. All AG will share the same telescope pointing, the global field of view (though the applicable excerpt may vary going from coarse to fine to guide), they will have the same ETC and telescope/optical geometry. Acquisition units will share the same hot pixel and the came acquisition camera, while all mechanism may rely on different algorithm to match/detect stars, vulgo pixel shifts, from the AG camera(s). Thus, this class supports setters for all true common components, aka:

Author:

wooz

Field Summary

Fields

Modifier and Type	Field and Description
private Pointing	center Telescope pointing is the center of the acquisition.
private static boolean	DEFFILEOVERSTRING If true, file properties are replaced by matching string properties.
private ExposureTimeProviding	etc Exposure time calculator created on construct.
private FieldOfViewProviding	fov The master receives a find list and a acquire command, both for fov.
private RayPath	geometry Ray path created on construct.
static String	KEY_FILEOVERSTRING If true, file properties are replaced by matching string properties.
private CatalogMatching	match Matching of pixel ccd-positions to catalog-derived positions.
private Pivoting	pinhole Pivot (hot point) of the acquisition CCD, created on construct.
private double	twinpix Distance to recognized twin star in pixel.

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
Pivoting	getAcquisitionHotPoint() Returns the instance that provides the hot point on the guiding CCD.
FieldOfViewProviding	getCatalogFieldOfView() Returns the instance that provides the field-of-view as an excerpt from a star catalog around the requeste telescope pointing.
ExposureTimeProviding	getExposureTimeCalculator() Converts stellar magnitude to exposure times on the CCD.
CatalogMatching	getMatchingAlgorithm() Provides the matching algorithm of detected stars to catalog stars.
RayPath	getOpticalGeometry() Returns the telescope ray geometry, i.e., how CCD pixel coordinates, ra and de and the telescope coordinate system (az/alt, tau/de) are combined.
Pointing	getTelescopePointing() Returns the ra/de of the requested telescope pointing, including possible dithering offsets.
double	getTwinpix() If acquisition or guiding occurs on a visible binary, this method returns the distance in CCD pixel.
void	init()
boolean	isValid() The AG is in a valid state, i.e., acquisition or guiding can commence.
void	registerGlobals(GlobalGrouping set) We grab the parameters to pipe them to the four subsystems created on init.
void	setAcquisitionHotPoint(Pivoting pinhole)
void	setAcquisitionTwin(Star onto, Star twin) If acquisition or guiding occurs on a visible binary, we set the the binary star to the principle guide star here.
void	setCatalogFieldOfView(FieldOfViewProviding fov) This provides all possible catalog stars.
void	setExposureTimeCalculator(ExposureTimeProviding etc) For exposure time calculations, we use one ETC per master to allow increases in exposure time due to thick clouds to be reported through all devices.
void	setMatchingAlgorithm(CatalogMatching cm) Injects the matching algorithm of detected stars to catalog stars.
void	setOpticalGeometry(RayPath geometry)
void	setTelescopePointing(Pointing center) For matching, this is the ra/de center providing instance.

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, clone, 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, initProperties, isNew, parseObject, parseObject, reload, 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.AcquisitionAndGuiding

getPromptMatching, getStarDetection, setPromptMatching, setStarDetection

Field Detail

KEY_FILEOVERSTRING

public static final String KEY_FILEOVERSTRING

If true, file properties are replaced by matching string properties.

See Also:

Constant Field Values

DEFFILEOVERSTRING

private static final boolean DEFFILEOVERSTRING

If true, file properties are replaced by matching string properties.

See Also:

Constant Field Values

match

private CatalogMatching match

Matching of pixel ccd-positions to catalog-derived positions.

center

private Pointing center

Telescope pointing is the center of the acquisition.

fov

private FieldOfViewProviding fov

The master receives a find list and a acquire command, both for fov.

twinpix

private double twinpix

Distance to recognized twin star in pixel.

geometry

private RayPath geometry

Ray path created on construct.

etc

private ExposureTimeProviding etc

Exposure time calculator created on construct.

pinhole

private Pivoting pinhole

Pivot (hot point) of the acquisition CCD, created on construct.

Constructor Detail

AbstractAcquisitionAndGuiding

protected AbstractAcquisitionAndGuiding(Map<String,String> props)

Parameters:

props -

Method Detail

init

public void init()
          throws InitException

Specified by:

init in interface Initializable

Throws:

InitException

isValid

public boolean isValid()

Description copied from interface: AcquisitionAndGuiding

The AG is in a valid state, i.e., acquisition or guiding can commence.

Specified by:

isValid in interface AcquisitionAndGuiding

Returns:

registerGlobals

public void registerGlobals(GlobalGrouping set)

We grab the parameters to pipe them to the four subsystems created on init. Others that are set from outside have to be registered at outside, too.

Specified by:

registerGlobals in interface GlobalDepending

setMatchingAlgorithm

public void setMatchingAlgorithm(CatalogMatching cm)

Injects the matching algorithm of detected stars to catalog stars.

Specified by:

setMatchingAlgorithm in interface AcquisitionAndGuiding

setTelescopePointing

public void setTelescopePointing(Pointing center)

For matching, this is the ra/de center providing instance. Called prior to any acquisition.

Specified by:

setTelescopePointing in interface AcquisitionAndGuiding

Parameters:

center - the center to set

setCatalogFieldOfView

public void setCatalogFieldOfView(FieldOfViewProviding fov)

This provides all possible catalog stars.

Specified by:

setCatalogFieldOfView in interface AcquisitionAndGuiding

Parameters:

center - the center to set

getMatchingAlgorithm

public CatalogMatching getMatchingAlgorithm()

Description copied from interface: AcquisitionAndGuiding

Provides the matching algorithm of detected stars to catalog stars.

Specified by:

getMatchingAlgorithm in interface AcquisitionAndGuiding

getTelescopePointing

public Pointing getTelescopePointing()

Description copied from interface: AcquisitionAndGuiding

Returns the ra/de of the requested telescope pointing, including possible dithering offsets.

Specified by:

getTelescopePointing in interface AcquisitionAndGuiding

getCatalogFieldOfView

public FieldOfViewProviding getCatalogFieldOfView()

Description copied from interface: AcquisitionAndGuiding

Returns the instance that provides the field-of-view as an excerpt from a star catalog around the requeste telescope pointing.

Specified by:

getCatalogFieldOfView in interface AcquisitionAndGuiding

getTwinpix

public double getTwinpix()

If acquisition or guiding occurs on a visible binary, this method returns the distance in CCD pixel.

Specified by:

getTwinpix in interface AcquisitionAndGuiding

Returns:

the twinpix

setAcquisitionTwin

public void setAcquisitionTwin(Star onto,
                               Star twin)

If acquisition or guiding occurs on a visible binary, we set the the binary star to the principle guide star here.

Specified by:

setAcquisitionTwin in interface AcquisitionAndGuiding

Parameters:

onto -

twin -

setOpticalGeometry

public void setOpticalGeometry(RayPath geometry)

Specified by:

setOpticalGeometry in interface AcquisitionAndGuiding

Parameters:

geometry - the geometry to set

setAcquisitionHotPoint

public void setAcquisitionHotPoint(Pivoting pinhole)

Specified by:

setAcquisitionHotPoint in interface AcquisitionAndGuiding

Parameters:

pinhole - the pinhole to set

setExposureTimeCalculator

public void setExposureTimeCalculator(ExposureTimeProviding etc)

For exposure time calculations, we use one ETC per master to allow increases in exposure time due to thick clouds to be reported through all devices.

Specified by:

setExposureTimeCalculator in interface AcquisitionAndGuiding

Parameters:

center - the center to set

getOpticalGeometry

public RayPath getOpticalGeometry()

Description copied from interface: AcquisitionAndGuiding

Returns the telescope ray geometry, i.e., how CCD pixel coordinates, ra and de and the telescope coordinate system (az/alt, tau/de) are combined.

Specified by:

getOpticalGeometry in interface AcquisitionAndGuiding

getAcquisitionHotPoint

public Pivoting getAcquisitionHotPoint()

Description copied from interface: AcquisitionAndGuiding

Returns the instance that provides the hot point on the guiding CCD.

Specified by:

getAcquisitionHotPoint in interface AcquisitionAndGuiding

getExposureTimeCalculator

public ExposureTimeProviding getExposureTimeCalculator()

Description copied from interface: AcquisitionAndGuiding

Converts stellar magnitude to exposure times on the CCD.

Specified by:

getExposureTimeCalculator in interface AcquisitionAndGuiding