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

Fields
Modifier and Type	Field and Description
`private float[]`	`bv` The B-V color index.
`static double`	`DEFDISTANCE` Default maximum degree distance to center for focus star.
`static float`	`DEFMAGNITUDE` Default maximum magnitude for focus star.
`static double`	`DEFMAGTWIN` Default minimum companion mag difference to be ignored.
`static double`	`DEFMINTWIN` Default minimum companion distance for focus star, arcsec.
`static Vector2D`	`DEFPIVOT` The pivoting in x/y radians for zero rotation.
`private static double`	`DEFPIXELSCALE` The default pixel scale in pixel per radian.
`private double`	`derot` The pre-set derotator angle.
`private float[]`	`mag` The Johnson V star brightnesses, in magnitudes.
`private double`	`magtwin` If companion is fainter than this, we can ignore it.
`private double`	`maxdist` The maximum distance for the focus star.
`private float`	`maxmag` The maximum magnitude for the focus star.
`private double`	`mintwin` The minimum twin distance.
`private static long`	`serialVersionUID`
`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

Constructors
Constructor and Description
`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

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`float`	`getBV(int i0)` Returns the color index B-V of the field-of-view stars.
`int`	`getFoucsStarCount()`
`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(int i0)` Returns the V-magnitude of the field-of-view stars.
`double`	`getXrad(int i0)` Returns the right ascension of the field-of-view stars.
`double`	`getYrad(int i0)` Returns the declination of the field-of-view stars.
`private static boolean`	`hasCompanion(Star focus, List<Star> fov, double dist, double mag)` We scan the field of view for detecting companions to the possible focus star.
`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, toSkippedString, 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
  - serialVersionUID
```
private static final long serialVersionUID
```
    See Also:
    
    Constant Field Values
  - DEFPIXELSCALE
```
private static final double DEFPIXELSCALE
```
    The default pixel scale in pixel per radian.
    
    See Also:
    
    Constant Field Values
  - DEFDISTANCE
```
public static final double DEFDISTANCE
```
    Default maximum degree distance to center for focus star.
    
    See Also:
    
    Constant Field Values
  - DEFMAGNITUDE
```
public static final float DEFMAGNITUDE
```
    Default maximum magnitude for focus star.
    
    See Also:
    
    Constant Field Values
  - DEFMINTWIN
```
public static final double DEFMINTWIN
```
    Default minimum companion distance for focus star, arcsec.
    
    See Also:
    
    Constant Field Values
  - DEFMAGTWIN
```
public static final double DEFMAGTWIN
```
    Default minimum companion mag difference to be ignored.
    
    See Also:
    
    Constant Field Values
  - DEFPIVOT
```
public static final Vector2D DEFPIVOT
```
    The pivoting in x/y radians for zero rotation.
  - 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.
  - maxmag
```
private float maxmag
```
    The maximum magnitude for the focus star.
  - mintwin
```
private double mintwin
```
    The minimum twin distance.
  - magtwin
```
private double magtwin
```
    If companion is fainter than this, we can ignore it.
- 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 SimpleStar with an additional key ReservedConstants.FOV. The value mapped to this key is a list of SimpleStar 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.
  - getFoucsStarCount
```
public int getFoucsStarCount()
```
  - getXrad
```
public double getXrad(int i0)
```
    Returns the right ascension of the field-of-view stars. The first array element is always the target star.
  - getYrad
```
public double getYrad(int i0)
```
    Returns the declination of the field-of-view stars. The first array element is always the target star.
  - getMag
```
public float getMag(int i0)
```
    Returns the V-magnitude of the field-of-view stars. The first array element is always the target star.
  - getBV
```
public float getBV(int i0)
```
    Returns the color index B-V of the field-of-view stars. The first array element is always the target star.
  - hasCompanion
```
private static boolean hasCompanion(Star focus,
                                    List<Star> fov,
                                    double dist,
                                    double mag)
```
    We scan the field of view for detecting companions to the possible focus star.
    
    Parameters:
    
    focus - Possible focus star
    
    fov - List of field of view stars.
    
    dist - Maximum distance in arcsec to be considered companion.
    
    mag - Maximum mag difference to be considered companion.
    
    Returns:
    
    True if at least one companion was found.

Class AutoFocusCcd

Nested Class Summary

Nested classes/interfaces inherited from class stella.CommandEvent

Field Summary

Fields inherited from class stella.CommandEvent

Fields inherited from class stella.MessageEvent

Fields inherited from class util.rmi.RmiEvent

Fields inherited from class java.util.EventObject

Constructor Summary

Method Summary

Methods inherited from class stella.CommandEvent

Methods inherited from class stella.MessageEvent

Methods inherited from class util.rmi.RmiEvent

Methods inherited from class java.util.EventObject

Methods inherited from class java.lang.Object

Field Detail

serialVersionUID

DEFPIXELSCALE

DEFDISTANCE

DEFMAGNITUDE

DEFMINTWIN

DEFMAGTWIN

DEFPIVOT

derot

xrad

yrad

mag

bv

maxdist

maxmag

mintwin

magtwin

Constructor Detail

AutoFocusCcd

AutoFocusCcd

Method Detail

initWith

registerTarget

registerTargetProperties

getLine

parseLine

getFoucsStarCount

getXrad

getYrad

getMag

getBV

hasCompanion