stella.command
Class AutoFocusCcd

java.lang.Object
  java.util.EventObject
      util.rmi.RmiEvent
          stella.MessageEvent
              stella.CommandEvent
                  stella.command.AutoFocusCcd

All Implemented Interfaces:

Serializable, CcdCommand, InitializerDepending, TargetDependingCommand, TargetDepending

public class AutoFocusCcd
extends CommandEvent
implements CcdCommand, TargetDepending, TargetDependingCommand, InitializerDepending

The command to initiate a focus sequence where the scientific ccd is the only means of focussing. Some adjustment is done to get from the target definition to values the CCD can work with. Namely:

• From the fov of the target, we search for a focus star.
• If no position is given in the target, the first fov star is the focus star.
• If a position is given, the fov (which is always ordered for decreasing brightness) is scanned for the brightest star not further than DEFDISTANCE from the center position.
• Together with the derotator angle, set in the target in the setup section, a tentative x/y position on the CCD, as radian in x and y is calculated.
• This position along with the focus star's brightness and color is stored in the command. thus it gets valid.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class stella.CommandEvent

CommandEvent.Create

Field Summary

private float	bv The B-V color index.
static double	DEFDISTANCE Default maximum degree distance to center for focus star.
private double	derot The pre-set derotator angle.
private Vector2D	drade The distance of the focus star to the center.
private float	mag The Johnson V star brightnesses, in magnitudes.
private double	maxdist The maximum distance for the focus star.
private double	xrad The radian position of the focus star in CCD-x axis.
private double	yrad The radian position of the focus star in CCD-y axis.

Fields inherited from class stella.CommandEvent

COMMANDPACKAGE, JVIEWPACKAGE, TYPESEPARATOR

Fields inherited from class stella.MessageEvent

SEPCHAR

Fields inherited from class util.rmi.RmiEvent

localHost, sourceName

Fields inherited from class java.util.EventObject

source

Constructor Summary

AutoFocusCcd(Object src)
Constructs a abort adapter telescope, grabbing the type from the class name and setting the command time to the current system time.

AutoFocusCcd(Object src, String type, long time)
Constructs a move telescope command.

Method Summary

float	getBV() Returns the color index B-V of the field-of-view stars.
String[]	getLine() Returns the command line that gives the CCD x and y position in radians, the magnitude and the color of the star.
float	getMag() Returns the V-magnitude of the field-of-view stars.
double	getXrad() Returns the right ascension of the field-of-view stars.
double	getYrad() Returns the declination of the field-of-view stars.
void	initWith(String init) Registers an parameter set to this command.
boolean	parseLine(String[] all) Parse the command line into ra and dec of the move command.
void	registerTarget(TargetDefinition star) Registers the target.
void	registerTargetProperties(Object view) Calculates the command line from the properties.

Methods inherited from class stella.CommandEvent

classNameToTemplate, createCommand, createCommand, createJCommand, extractType, getExpectedAcknowledgeNumber, parseForStrings, templateToClassName

Methods inherited from class stella.MessageEvent

checkType, equals, equalTime, equalTime, fromAscii, getAllCommandLines, getExecuteGroupKey, getHead, getNr, getTime, getType, hashCode, isValid, parseFromSingleString, readFromBufferedStream, setNr, setTime, setType, setValid, toString

Methods inherited from class util.rmi.RmiEvent

getHost, getSourceName, setSourceName

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DEFDISTANCE

public static final double DEFDISTANCE

Default maximum degree distance to center for focus star.

See Also:

Constant Field Values

drade

private Vector2D drade

The distance of the focus star to the center. dra,dde, both radian.

derot

private double derot

The pre-set derotator angle. Used to calculate a x/y CCD position.

xrad

private double xrad

The radian position of the focus star in CCD-x axis.

yrad

private double yrad

The radian position of the focus star in CCD-y axis.

mag

private float mag

The Johnson V star brightnesses, in magnitudes.

bv

private float bv

The B-V color index.

maxdist

private double maxdist

The maximum distance for the focus star.

Constructor Detail

AutoFocusCcd

public AutoFocusCcd(Object src)

Constructs a abort adapter telescope, grabbing the type from the class name and setting the command time to the current system time.

AutoFocusCcd

public AutoFocusCcd(Object src,
                    String type,
                    long time)

Constructs a move telescope command. Only the header is fully qualified with the provided argumnets. The command line can only be retrieved after a DTDConstants.OBJECT element has been registered to this command.

See Also:

MessageEvent.isValid()

Method Detail

initWith

public void initWith(String init)

Registers an parameter set to this command. The parameter handed over is queried for its current value and this focus position is set.

Specified by:

initWith in interface InitializerDepending

registerTarget

public void registerTarget(TargetDefinition star)

Registers the target. We scan for the named setup with the ID #DEROTATOROFFSET. If this target does not allow the derotator offset, it is disabled.

Specified by:

registerTarget in interface TargetDepending

registerTargetProperties

public void registerTargetProperties(Object view)

Calculates the command line from the properties. For this command, the map handed over must be a StarDescription with an additional key ReservedConstants.FOV. The value mapped to this key is a list of StarDescription objects, each representing a star in the field of view. Note that the first entry in this list is always the target star.

Specified by:

registerTargetProperties in interface TargetDependingCommand

getLine

public String[] getLine()

Returns the command line that gives the CCD x and y position in radians, the magnitude and the color of the star.

Specified by:

getLine in class MessageEvent

Returns:

An array containing all command lines.

parseLine

public boolean parseLine(String[] all)

Parse the command line into ra and dec of the move command.

Specified by:

parseLine in class MessageEvent

Returns:

True, if parsing was successful.

getXrad

public double getXrad()

Returns the right ascension of the field-of-view stars. The first array element is always the target star.

getYrad

public double getYrad()

Returns the declination of the field-of-view stars. The first array element is always the target star.

getMag

public float getMag()

Returns the V-magnitude of the field-of-view stars. The first array element is always the target star.

getBV

public float getBV()

Returns the color index B-V of the field-of-view stars. The first array element is always the target star.