stella.acquire

Interface AcquisitionAndGuiding

All Known Subinterfaces:

Acquisition, Guiding

All Known Implementing Classes:

AbstractAcquisition, AbstractAcquisitionAndGuiding, AbstractGuiding, GuidingOnCrosshair, StarDetectingOnCrosshair

public interface AcquisitionAndGuiding

Composition of all subinterfaces required to perform an acquisition on a guide star and to allow auto-guiding on it.

Author:

wooz

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.
PromptMatching	getPromptMatching() If an AG is capable of prompt matching, the prompt matcher is returned here.
ImageClassifying	getStarDetection() Instance to detect star and to filter out spurious detection.
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.
boolean	isValid() The AG is in a valid state, i.e., acquisition or guiding can commence.
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	setPromptMatching(PromptMatching vanish) If an AG is capable of prompt matching, the prompt matcher is returned here.
void	setStarDetection(ImageClassifying detect) Instance to detect star and to filter out spurious detection.
void	setTelescopePointing(Pointing center) For matching, this is the ra/de center providing instance.

Method Detail

getTelescopePointing

Pointing getTelescopePointing()

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

getCatalogFieldOfView

FieldOfViewProviding getCatalogFieldOfView()

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

getOpticalGeometry

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.

getAcquisitionHotPoint

Pivoting getAcquisitionHotPoint()

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

getExposureTimeCalculator

ExposureTimeProviding getExposureTimeCalculator()

Converts stellar magnitude to exposure times on the CCD.

getTwinpix

double getTwinpix()

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

Returns:

the twinpix

setAcquisitionTwin

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.

Parameters:

onto -

twin -

getStarDetection

ImageClassifying getStarDetection()

Instance to detect star and to filter out spurious detection. Can be null for spontaneous acquisition or acquisition on a pinhole.

setStarDetection

void setStarDetection(ImageClassifying detect)

Instance to detect star and to filter out spurious detection. Can be null for spontaneous acquisition or acquisition on a pinhole.

getMatchingAlgorithm

CatalogMatching getMatchingAlgorithm()

Provides the matching algorithm of detected stars to catalog stars.

setMatchingAlgorithm

void setMatchingAlgorithm(CatalogMatching cm)

Injects the matching algorithm of detected stars to catalog stars.

getPromptMatching

PromptMatching getPromptMatching()

If an AG is capable of prompt matching, the prompt matcher is returned here.

setPromptMatching

void setPromptMatching(PromptMatching vanish)

If an AG is capable of prompt matching, the prompt matcher is returned here.

setTelescopePointing

void setTelescopePointing(Pointing center)

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

Parameters:

center - the center to set

setCatalogFieldOfView

void setCatalogFieldOfView(FieldOfViewProviding fov)

This provides all possible catalog stars.

Parameters:

center - the center to set

setOpticalGeometry

void setOpticalGeometry(RayPath geometry)

Parameters:

geometry - the geometry to set

setAcquisitionHotPoint

void setAcquisitionHotPoint(Pivoting pinhole)

Parameters:

pinhole - the pinhole to set

setExposureTimeCalculator

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.

Parameters:

center - the center to set

isValid

boolean isValid()

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

Returns: