stella.adapter
Class WifsipGuider

java.lang.Object
  util.PropertyContainer
      util.PropertyResources
          util.PropertyBundles
              stella.adapter.StellaGuider
                  stella.adapter.AbstractStarGuider
                      stella.adapter.AbstractNasmythGuider
                          stella.adapter.WifsipGuider

All Implemented Interfaces:

Cloneable, Guiding, MultiExtension, Initializable, LocalizedSupplying, PropertySupplying, ResourceSupplying

public class WifsipGuider
extends AbstractNasmythGuider
implements MultiExtension

A helper class that allows an adapter master (not an auxiliary master) to use the WiFSIP camera for acquiring. The only use for this class is during pointing model generation of the main telescope and the auxiliary piggy-back telescope such that acquiring is done with wifsip through the main telescope. Then, if successful, the auxiliary telescope takes an exposure with its guiding camera to establish a pointing model between main telescope and auxiliary telescope.

The adapter should provide the pixel on Wifsip, where the derotator axis is imaged. This has to be the acquire center.

Nested Class Summary

static class

WifsipGuider.Test To test the class, we can provide a pre-recorded fits file and pass it thru getSingleExtension(nom.tam.fits.Fits), then use the writtn fits file in an adapter reduce class.

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.URLResource

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

Guiding.RawFrame, Guiding.RawStar

Field Summary

private static double	DEFALIGNMENTANGLE Alignment angle of the guider ccd with respect to north.
private static double	DEFALTITUDEFLIP If the altitude is flipped, it cannot be compensated by a rotation.
private static double	DEFDARKGUIDER The default dark/sky countrate.
private static double	DEFDETECTIONLIMIT The default minimum instrumental magnitude to not be spurious.
private static Point2D	DEFDIRECTPINHOLE The derotator position in the full frame.
private static double	DEFELONGATIONMAX The default maximum elongation for round stars.
private static double	DEFELONGATIONWIDTH The minimum fwhm for a valid star detection.
private static double	DEFEPSILONMAG The default epsilon for the full light guider CCD.
private static boolean	DEFFIXEDDEROTATOR Default status of the derotator.
private static double	DEFGUIDERSCALE The default image scale on the mirror image.
private static double	DEFKMAG The default k prime parameter for the full light guider CCD.
private static long	DEFMAXTIMEGUIDER Maximum exposure time on acquire in ms.
private static double	DEFMOUNTPORT Default mount port.
private static double	DEFREADOUTGUIDER The default bias level on the guider CCD.
private static double	DEFSHARPPEAK The default minimum sharpness for star images.
private static double	DEFSHARPWIDTH The default maximum sharpness for star images.
private static double	DEFSOURCEGUIDER The gain for a R=10 star.
private static double	DEFZETAMAG The default zero point for the guider CCD.

Fields inherited from class stella.adapter.AbstractNasmythGuider

KEY_FIXEDDEROTATOR, KEY_MOUNTPORT

Fields inherited from class stella.adapter.AbstractStarGuider

KEY_ALIGNMENTANGLE, KEY_ALTITUDEFLIP, 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, LOWPASS, LOWPASSNAME, maxsize, MEDIAN, MEDIANNAME, RECTANGULARMATCHER, REDUCED, REDUCEDNAME, SKYFRAME, STARREGISTER

Fields inherited from class util.PropertyBundles

KEY_LOCALECOUNTRY, KEY_LOCALELANGUAGE, KEY_RESOURCEBUNDLES

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, localurl, locate, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_URL, urlset

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

WifsipGuider(Map<String,String> prop)
Constructs a new adapter helper, defaulting all properties.

Method Summary

List<Guiding.RawStar>	getGuidingStars(Guiding.RawFrame frame, long expt, float gaussfwhm, float gausstrunc, int datamin, int datamax, int search, String type, String store, int steps) Wifsip has four Quadrants, thus we must stitch the frame together before we can issue it to the starfinder logic.
protected Vector2D	getRaDeCenter() We guide directly on the object, thus we return the first object in the field of view.
nom.tam.fits.Fits	getSingleExtension(nom.tam.fits.Fits raw) We read a four -quadrant extension and convert it to a single-extension fits.

Methods inherited from class stella.adapter.AbstractNasmythGuider

getCurrentAzAltRotation, getCurrentFieldRotation

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, getPinhole, getPinholeNeighbours, getRotation, getStrip, getUnique, isStar, offsetAzAltToPixel, pixelToAzAltOffset, removeSpurious, removeStripes, setFocus, setFov, setOrientationValues, setOrientationValues, setPinhole, setUnique, starOffset, starOffset, starShift, starShift

Methods inherited from class stella.adapter.StellaGuider

background, cancelContinuous, countSum, fluxInside, getCcd, getCcdSize, getContinuousList, getContinuousMinimumExpose, getCurrentExpsoureNumber, getFitsDir, getGuidingStars, getGuidingStars, isReady, match, photometry, prepareContinuous, reduceFitsFile, registerCcd, setBiasReduction, setDarkReduction, startContinuous, startContinuous, stopContinuous

Methods inherited from class util.PropertyBundles

clone, getLocalized, getLocalized, getLocalizedString, getLocalizedString, loadResource

Methods inherited from class util.PropertyResources

createFrom, createFrom, createFrom, getApplet, getAsResources, getLocalClassLoader, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, init, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

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, reload, removeProperty, 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.ResourceSupplying

getResource, getResourceAsStream, getResources

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

Methods inherited from interface util.Initializable

init

Field Detail

DEFGUIDERSCALE

private static final double DEFGUIDERSCALE

The default image scale on the mirror image. Pixel per radian.

See Also:

Constant Field Values

DEFDIRECTPINHOLE

private static final Point2D DEFDIRECTPINHOLE

The derotator position in the full frame.

DEFREADOUTGUIDER

private static final double DEFREADOUTGUIDER

The default bias level on the guider CCD.

See Also:

Constant Field Values

DEFDARKGUIDER

private static final double DEFDARKGUIDER

The default dark/sky countrate.

See Also:

Constant Field Values

DEFSOURCEGUIDER

private static final double DEFSOURCEGUIDER

The gain for a R=10 star.

See Also:

Constant Field Values

DEFMAXTIMEGUIDER

private static final long DEFMAXTIMEGUIDER

Maximum exposure time on acquire in ms.

See Also:

Constant Field Values

DEFSHARPPEAK

private static final double DEFSHARPPEAK

The default minimum sharpness for star images.

See Also:

Constant Field Values

DEFSHARPWIDTH

private static final double DEFSHARPWIDTH

The default maximum sharpness for star images.

See Also:

Constant Field Values

DEFELONGATIONMAX

private static final double DEFELONGATIONMAX

The default maximum elongation for round stars.

See Also:

Constant Field Values

DEFELONGATIONWIDTH

private static final double DEFELONGATIONWIDTH

The minimum fwhm for a valid star detection.

See Also:

Constant Field Values

DEFDETECTIONLIMIT

private static final double DEFDETECTIONLIMIT

The default minimum instrumental magnitude to not be spurious.

See Also:

Constant Field Values

DEFALIGNMENTANGLE

private static final double DEFALIGNMENTANGLE

Alignment angle of the guider ccd with respect to north.

See Also:

Constant Field Values

DEFZETAMAG

private static final double DEFZETAMAG

The default zero point for the guider CCD.

See Also:

Constant Field Values

DEFKMAG

private static final double DEFKMAG

The default k prime parameter for the full light guider CCD.

See Also:

Constant Field Values

DEFEPSILONMAG

private static final double DEFEPSILONMAG

The default epsilon for the full light guider CCD.

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

Constructor Detail

WifsipGuider

public WifsipGuider(Map<String,String> prop)

Constructs a new adapter helper, defaulting all properties.

Method Detail

getRaDeCenter

protected Vector2D getRaDeCenter()

We guide directly on the object, thus we return the first object in the field of view.

Specified by:

getRaDeCenter in class AbstractStarGuider

getGuidingStars

public List<Guiding.RawStar> getGuidingStars(Guiding.RawFrame frame,
                                             long expt,
                                             float gaussfwhm,
                                             float gausstrunc,
                                             int datamin,
                                             int datamax,
                                             int search,
                                             String type,
                                             String store,
                                             int steps)
                                      throws IOException,
                                             IllegalWindowException,
                                             IllegalSearchBoxException

Wifsip has four Quadrants, thus we must stitch the frame together before we can issue it to the starfinder logic.

Overrides:

getGuidingStars in class StellaGuider

Throws:

IOException

IllegalWindowException

IllegalSearchBoxException

getSingleExtension

public nom.tam.fits.Fits getSingleExtension(nom.tam.fits.Fits raw)
                                     throws IOException

We read a four -quadrant extension and convert it to a single-extension fits. Also takes care of proper flipping snd clipping.

Specified by:

getSingleExtension in interface MultiExtension

Throws:

IOException