stella.adapter

Class OffAxisGuider

java.lang.Object

util.PropertyContainer

util.PropertyResources

stella.adapter.StellaGuider

stella.adapter.AbstractStarGuider

stella.adapter.AbstractNasmythGuider

stella.adapter.OffAxisGuider

All Implemented Interfaces:

Cloneable, CatalogFrameProviding, FitsGuiding, Guiding, Initializable, PropertySupplying, ResourceSupplying

public class OffAxisGuider
extends AbstractNasmythGuider
implements CatalogFrameProviding

Author:

wooz

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	OffAxisGuider.CatalogFrame

Nested classes/interfaces inherited from class stella.adapter.AbstractStarGuider

AbstractStarGuider.Exposure, AbstractStarGuider.Magnitudes

Nested classes/interfaces inherited from class stella.adapter.StellaGuider

StellaGuider.Continuous, StellaGuider.Single

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Nested classes/interfaces inherited from interface stella.adapter.Guiding

Guiding.RawFrame, Guiding.RawStar

Field Summary

Fields

Modifier and Type	Field and Description
private Vector2D	centeroffset If the guiding star should not be placed at the center of the field.
private static double	DEFALIGNMENTANGLE Alignment angle of the off-axis guider with respect to wifsip field.
private static double	DEFALTITUDEFLIP If the altitude is flipped, it cannot be compensated by a rotation.
private static Dimension	DEFENLARGECOARSE The default pixel enlargement during coarse acquire.
private static Dimension	DEFENLARGEFINE The default pixel enlargement during coarse acquire.
private static boolean	DEFFIXEDDEROTATOR Default status of the derotator.
private static long	DEFMAXTIMEGUIDER Maximum exposure time on acquire in ms.
private static double	DEFMOUNTPORT Default mount port.
private static Point2D	DEFOFFAXISCENTER Measured distance from WiFSIP center to guider center, guider pixel.
static String	KEY_ENLARGECOARSE Catalog enlargment on coarse.
static String	KEY_ENLARGEFINE A gray-zone around the acquire field for catalog star inclusion.
static String	KEY_OFFAXISCENTER From the center of Wifsip to center of guider, guider pixel.
private Vector2D	rade The position of the telescope after move.

Fields inherited from class stella.adapter.AbstractNasmythGuider

KEY_FIXEDDEROTATOR, KEY_MOUNTPORT

Fields inherited from class stella.adapter.AbstractStarGuider

KEY_ALIGNMENTANGLE, KEY_ALTITUDEFLIP, KEY_CATALOGMAGLIMIT, KEY_CCDCHIRALITY, KEY_DARKGUIDER, KEY_DETECTIONLIMIT, KEY_DIRECTPINHOLE, KEY_ELONGATIONMAX, KEY_ELONGATIONWIDTH, KEY_EPSILONMAG, KEY_GUIDERSCALE, KEY_KMAG, KEY_MAXTIMEGUIDER, KEY_READOUTGUIDER, KEY_SHARPPEAK, KEY_SHARPWIDTH, KEY_SOURCEGUIDER, KEY_STRIPDISTANCE, KEY_STRIPESMAX, KEY_SURESTRIPES, KEY_ZETAMAG, REFERENCEEXPOSE, REFERENCEMAG

Fields inherited from class stella.adapter.StellaGuider

biasfits, biastime, CLEAN, CLEANNAME, darkfits, darktime, GAUSS, GAUSSNAME, KEY_DEPTHMEDIAN, KEY_FITSDIR, KEY_GAUSSFWHM, KEY_GAUSSTRUNCATE, KEY_GUIDINGIMG, KEY_LOWPASS, KEY_MAGTRUNCATE, KEY_MATCHERVERSION, KEY_REDUCEDIR, KEY_REDUCETIME, KEY_SIZELOWPASS, KEY_SIZEMEDIAN, KEY_SKYFRAME, KEY_SKYTHRESHOLD, KEY_TMPDIR, LOWPASS, LOWPASSNAME, maxsize, MEDIAN, MEDIANNAME, RECTANGULARMATCHER, REDUCED, REDUCEDNAME, SKYFRAME, STARREGISTER

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
OffAxisGuider(Map<String,String> prop)

Method Summary

Modifier and Type	Method and Description
Rectangle2D	getCatalogFrame(Rectangle tight, boolean coarse) This returns the read-out window of the off-axis guider.
protected Vector2D	getCentralOffset() Gets the measured offset in pixel.
protected Point2D	getPinhole() Returns the pixel on the CCD the guiding star should reside on.
protected Vector2D	getRaDeCenter() Returns a previously set center or the first fov star, if no center was set.
private Rectangle2D	getTightFit(Rectangle read) Using the alignment angle and the size of the CCD, this method returns the closest rectangle that fits around the guider ccd.
private Rectangle2D	getTwistedTightFit(Rectangle read, double thetarad) Using the alignment angle and the size of the CCD, this method returns the closest rectangle that fits around the guider ccd.
boolean	isCentralFov() As the call name implies, this guider is non-centered.
protected void	setCentralOffset(Vector2D pinhole) Sets a measured offset in pixel of the rotational center of the auxiliar guider.
protected void	setRaDeCenter(Vector2D pointto) Sets the requested pointing direction of the telescope in right ascension and declination.

Methods inherited from class stella.adapter.AbstractNasmythGuider

getCurrentAzAltRotation, getCurrentFieldRotation, init

Methods inherited from class stella.adapter.AbstractStarGuider

closestToPinhole, closestToPixel, detect, detect, estimateDataMin, estimateExposureTime, estimateGuiderMag, estimateReferenceMag, fieldOfViewOffset, fieldOfViewShift, formatWithUnique, getAltitude, getAzimuth, getCatalogPosition, getDerotator, getExpectedList, getFocus, getFov, getGuiderScale, getMaximumExposureTime, getNeighbours, getPinholeNeighbours, getPinholeOffset, getRotation, getStrip, getUnique, isStar, offsetAzAltToPixel, pixelToAzAltOffset, removeSpurious, removeStripes, saveMatches, setFocus, setFov, setOrientationValues, setOrientationValues, setPinholeOffset, setUnique, starOffset, starOffset, starShift, starShift

Methods inherited from class stella.adapter.StellaGuider

background, cancelContinuous, countSum, createFitsFile, createFitsObject, fluxInside, getCcd, getCcdSize, getContinuousList, getContinuousMinimumExpose, getCurrentExpsoureNumber, getFitsDir, getGuidingStars, getGuidingStars, getGuidingStars, getLastGuidingImage, getTmpDir, getTmpFitsname, interpretFitsFile, interpretFitsFile, isReady, match, photometry, prepareContinuous, reduceFitsFile, registerCcd, setBiasReduction, setDarkReduction, setGuiding, startContinuous, startContinuous, stopContinuous

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_OFFAXISCENTER

public static final String KEY_OFFAXISCENTER

From the center of Wifsip to center of guider, guider pixel.

See Also:

Constant Field Values

KEY_ENLARGECOARSE

public static final String KEY_ENLARGECOARSE

Catalog enlargment on coarse.

See Also:

Constant Field Values

KEY_ENLARGEFINE

public static final String KEY_ENLARGEFINE

A gray-zone around the acquire field for catalog star inclusion.

See Also:

Constant Field Values

DEFALIGNMENTANGLE

private static final double DEFALIGNMENTANGLE

Alignment angle of the off-axis guider with respect to wifsip field.

See Also:

Constant Field Values

DEFALTITUDEFLIP

private static final double DEFALTITUDEFLIP

If the altitude is flipped, it cannot be compensated by a rotation.

See Also:

Constant Field Values

DEFFIXEDDEROTATOR

private static final boolean DEFFIXEDDEROTATOR

Default status of the derotator.

See Also:

Constant Field Values

DEFMOUNTPORT

private static final double DEFMOUNTPORT

Default mount port.

See Also:

Constant Field Values

DEFOFFAXISCENTER

private static final Point2D DEFOFFAXISCENTER

Measured distance from WiFSIP center to guider center, guider pixel.

DEFENLARGECOARSE

private static final Dimension DEFENLARGECOARSE

The default pixel enlargement during coarse acquire.

DEFENLARGEFINE

private static final Dimension DEFENLARGEFINE

The default pixel enlargement during coarse acquire.

DEFMAXTIMEGUIDER

private static final long DEFMAXTIMEGUIDER

Maximum exposure time on acquire in ms.

See Also:

Constant Field Values

rade

private Vector2D rade

The position of the telescope after move.

centeroffset

private Vector2D centeroffset

If the guiding star should not be placed at the center of the field.

Constructor Detail

OffAxisGuider

public OffAxisGuider(Map<String,String> prop)

Parameters:

prop -

Method Detail

isCentralFov

public boolean isCentralFov()

As the call name implies, this guider is non-centered.

Specified by:

isCentralFov in interface CatalogFrameProviding

getCatalogFrame

public Rectangle2D getCatalogFrame(Rectangle tight,
                                   boolean coarse)

This returns the read-out window of the off-axis guider. As this is now done correctly with a dedicated second object, no need to fiddle around any more.

Specified by:

getCatalogFrame in interface CatalogFrameProviding

Returns:

getTightFit

private Rectangle2D getTightFit(Rectangle read)

Using the alignment angle and the size of the CCD, this method returns the closest rectangle that fits around the guider ccd. If the alignment is perfect, this is the size of the chip.

getTwistedTightFit

private Rectangle2D getTwistedTightFit(Rectangle read,
                                       double thetarad)

Using the alignment angle and the size of the CCD, this method returns the closest rectangle that fits around the guider ccd. If the alignment is perfect, this is the size of the chip.

getPinhole

protected Point2D getPinhole()

Returns the pixel on the CCD the guiding star should reside on. If no offset is set, this is the center of the CCD.

Overrides:

getPinhole in class AbstractStarGuider

setRaDeCenter

protected void setRaDeCenter(Vector2D pointto)

Sets the requested pointing direction of the telescope in right ascension and declination.

getRaDeCenter

protected Vector2D getRaDeCenter()

Returns a previously set center or the first fov star, if no center was set.

Specified by:

getRaDeCenter in class AbstractStarGuider

setCentralOffset

protected void setCentralOffset(Vector2D pinhole)

Sets a measured offset in pixel of the rotational center of the auxiliar guider. This method is used if a secondary guiding unit is present. The offset set here is always added to the pixel position of the pinhole in getPinhole().

Parameters:

pinhole - pixel offset measured or null for reset.

getCentralOffset

protected Vector2D getCentralOffset()

Gets the measured offset in pixel.