LinearPrimeFocus

java.lang.Object
- util.PropertyContainer
- - util.PropertyResources
  - - stella.util.GenericUnit
    - - stella.acquire.AncillaryCameraUnit
      - stella.auxiliary.AbstractFocussingUnit
        
        stella.auxiliary.MomentsFocussing
        
        stella.auxiliary.LinearPrimeFocus

All Implemented Interfaces:

GlobalDepending, DriverDepending, Cloneable, Abortable, Focussing, Initializable, PropertySupplying, ResourceSupplying
```
public class LinearPrimeFocus
extends MomentsFocussing
implements DriverDepending
```
Class that allows focusing of the prime focus unit on STELLA-II. It operates a linear stage that can attain positions from zero to 31400. For auto-focus, the fiber-viewing unit is used.

Nested Class Summary
- Nested classes/interfaces inherited from class stella.auxiliary.AbstractFocussingUnit
  AbstractFocussingUnit.Method
- Nested classes/interfaces inherited from class util.PropertyResources
  PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields
Modifier and Type	Field and Description
`private static double`	`DEFA4ERROR` Default A4 error (2011-10-14).
`private static double`	`DEFA4SLOPE` Default A4 slope (2011-10-14).
`private static double`	`DEFALTSHIFT` Shift the image by 60 pixel to avoid obsuration by the pinhole.
`private static String`	`DEFALTTARGET` Default focus temperature parameter name.
`private static double`	`DEFAZSHIFT` Shift the image by 60 pixel to avoid obsuration by the pinhole.
`private static Rectangle`	`DEFBLOBFRAME` The default blob frame.
`private static boolean`	`DEFDOSAVE` If true we save the indivdual images during focus.
`private static double`	`DEFERRORCRUDE` Default temperature focusing error in steps.
`private static double`	`DEFEXPOSEFOCUS` The default S/N on acquire.
`private static String`	`DEFFOCUSAXIS` Default name of the linear dirver.
`private static Dimension`	`DEFFOCUSBINNING` The default binning on acquire.
`private static double`	`DEFFOCUSOFFSET` Default focusoffset fine.
`private static int`	`DEFFOCUSORDER` The moment during fine focus.
`private static String`	`DEFFOCUSTEMP` Default focus temperature parameter name.
`private static String`	`DEFFOCUSVALUE` Default focus temperature parameter name.
`private static Dimension`	`DEFFWHMBLOB` The default blob size.
`private static Dimension`	`DEFFWHMSIZE` The default size around the bright spot.
`private static double`	`DEFHIGHSKYSIGMA` Per default we do not do ADU rejection, thus this is zero.
`private static String`	`DEFLINEARDRIVER` Default name of the linear dirver.
`private static double`	`DEFLOWSKYSIGMA` Per default we do not do ADU rejection, thus this is zero.
`private static boolean`	`DEFMEDIANSKY` Default we use median for sky-level determination.
`private static double`	`DEFSEARCHOFFSET` Default focusoffset on step, where we search a coarse focus.
`private static int`	`DEFSEARCHORDER` The moment during coarse focus.
`private static int`	`DEFSEARCHSTEPS` Default half-number of search steps.
`private static int`	`DEFSKYFRAME` The defautl sky frame size.
`private static double`	`DEFSTEP0` Default step0 (March 2013)
`private static double`	`DEFSTEPSINALT` Default steptemp (March 2013)
`private static double`	`DEFSTEPTEMP` Default steptemp (March 2013)
`private static double`	`DEFSTEPTEMPSQ` Default steptemp (March 2013)
`private static double`	`DEFTEMP0` Default temp0
`private static Dimension`	`DEFZERNIKEBLOB` The default blob size.
`private static Dimension`	`DEFZERNIKESIZE` The default size around the bright spot.
`private static double`	`DEFZERNIKESTEP` Default no extra Zernike images.
`private static double`	`DEFZEXPOSE` Default no extra increase in exposure time on Zernikes.
`private Value`	`focus` The focus position updated by me.
`private Value`	`focusmodel` We have a focus model.
`private Value`	`height` The height of the target/telescope.
`static String`	`KEY_ALTSHIFT` Points to the offset to apply to altitude before focusing.
`static String`	`KEY_ALTTARGET` The name of the temperature sensor to use.
`static String`	`KEY_AZSHIFT` Points to the offset to apply to azimuth before focusing.
`static String`	`KEY_FOCUSAXIS` The name of the focus axis on the linear stage.
`static String`	`KEY_FOCUSMODEL` The temperature focus model from adapter master.
`static String`	`KEY_FOCUSTEMP` The name of the temperature sensor to use.
`static String`	`KEY_FOCUSVALUE` The name of the parameter that holds the focus.
`static String`	`KEY_LINEARDRIVER` The name of the driver in the master that holds the linear stage.
`static String`	`KEY_SHIFT` The name of the ADC focus shift parameter.
`static String`	`KEY_STEP0` The step position for focus temperature T0.
`static String`	`KEY_STEPSINALT` Per sinus height, we add this number of steps.
`static String`	`KEY_STEPTEMP` Per degree difference to T0, we add this number of steps.
`static String`	`KEY_STEPTEMPSQ` Per degree difference to T0, we add this number of steps.
`static String`	`KEY_TEMP0` At this temperature, optimal focus is at step0.
`static String`	`KEY_TEMPMIN` If this is set, we do not do a focus search in colder temps.
`private MultiAxes`	`linear` The Multi-axis driver used for linear positioning.
`static String`	`LINEARTYPE` The type of this unit as a string.
`private int`	`maxsteps` The focus axis can assume values from zero to this.
`private Value`	`shift` The external focus offset, e.g.
`private Value`	`temp` The temperature value.

Fields inherited from class stella.acquire.AncillaryCameraUnit
KEY_FITSDIR, KEY_XTENSION

Fields inherited from class stella.util.GenericUnit
KEY_UNITTYPE

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

LinearPrimeFocus(Map<String,String> prop)
Constructs a new focussing unit.

Constructors
Constructor and Description
`LinearPrimeFocus(Map<String,String> prop)` Constructs a new focussing unit.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`configureUnit()`
`Vector2D`	`crudeFocus()` We calculate a focus position from the temperature and telescope pointing.
`protected boolean`	`finished()` After a successful focus set
`double`	`getMaximumFocus()` Returns the maximum focus step this unit can reach, which is step 31400 something.
`double`	`getMinimumFocus()` Returns the minimum focus step this unit can reach, which is step 0.
`String`	`getUnitType()` This is the linear stage in the prime focus of stella one, used for focusing.
`protected boolean`	`isValid()` We are valid only if we have the linear drive and the moments.
`protected boolean`	`prepare()` Prepare for a focus sequence.
`boolean`	`registerDriver(Driver ls)` Registers a `Driver` object to this object.
`void`	`registerGlobals(GlobalGrouping set)` We scan the parameter set for the windspeed, seeing, a counter for spurious guiding losses and target losses.
`boolean`	`setFocus(double step)` We set the focus of the linear stage to the specified value.
`boolean`	`setFocusOffset(double step)` We set the offset of the linear stage to the specified value.

Methods inherited from class stella.auxiliary.MomentsFocussing
coarseFocus, fineFocus, getFwhm, scanFocus, setAbort

Methods inherited from class stella.acquire.AncillaryCameraUnit
binningAndWindow, getAcquisitionExtension, getFitsDirectory, getOneExposure, isManual, reducedFloat, save, save, setManual

Methods inherited from class stella.util.GenericUnit
defaultGuidingStar, getMaster, init, isValid, setMaster

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
  - LINEARTYPE
```
public static final String LINEARTYPE
```
    The type of this unit as a string.
    
    See Also:
    
    Constant Field Values
  - KEY_LINEARDRIVER
```
public static final String KEY_LINEARDRIVER
```
    The name of the driver in the master that holds the linear stage.
    
    See Also:
    
    Constant Field Values
  - KEY_FOCUSAXIS
```
public static final String KEY_FOCUSAXIS
```
    The name of the focus axis on the linear stage.
    
    See Also:
    
    Constant Field Values
  - KEY_STEP0
```
public static final String KEY_STEP0
```
    The step position for focus temperature T0.
    
    See Also:
    
    Constant Field Values
  - KEY_TEMP0
```
public static final String KEY_TEMP0
```
    At this temperature, optimal focus is at step0.
    
    See Also:
    
    Constant Field Values
  - KEY_STEPTEMP
```
public static final String KEY_STEPTEMP
```
    Per degree difference to T0, we add this number of steps.
    
    See Also:
    
    Constant Field Values
  - KEY_STEPTEMPSQ
```
public static final String KEY_STEPTEMPSQ
```
    Per degree difference to T0, we add this number of steps.
    
    See Also:
    
    Constant Field Values
  - KEY_STEPSINALT
```
public static final String KEY_STEPSINALT
```
    Per sinus height, we add this number of steps.
    
    See Also:
    
    Constant Field Values
  - KEY_FOCUSMODEL
```
public static final String KEY_FOCUSMODEL
```
    The temperature focus model from adapter master.
    
    See Also:
    
    Constant Field Values
  - KEY_SHIFT
```
public static final String KEY_SHIFT
```
    The name of the ADC focus shift parameter.
    
    See Also:
    
    Constant Field Values
  - KEY_FOCUSTEMP
```
public static final String KEY_FOCUSTEMP
```
    The name of the temperature sensor to use.
    
    See Also:
    
    Constant Field Values
  - KEY_ALTTARGET
```
public static final String KEY_ALTTARGET
```
    The name of the temperature sensor to use.
    
    See Also:
    
    Constant Field Values
  - KEY_FOCUSVALUE
```
public static final String KEY_FOCUSVALUE
```
    The name of the parameter that holds the focus.
    
    See Also:
    
    Constant Field Values
  - KEY_AZSHIFT
```
public static final String KEY_AZSHIFT
```
    Points to the offset to apply to azimuth before focusing.
    
    See Also:
    
    Constant Field Values
  - KEY_ALTSHIFT
```
public static final String KEY_ALTSHIFT
```
    Points to the offset to apply to altitude before focusing.
    
    See Also:
    
    Constant Field Values
  - KEY_TEMPMIN
```
public static final String KEY_TEMPMIN
```
    If this is set, we do not do a focus search in colder temps.
    
    See Also:
    
    Constant Field Values
  - DEFLINEARDRIVER
```
private static final String DEFLINEARDRIVER
```
    Default name of the linear dirver.
    
    See Also:
    
    Constant Field Values
  - DEFFOCUSAXIS
```
private static final String DEFFOCUSAXIS
```
    Default name of the linear dirver.
    
    See Also:
    
    Constant Field Values
  - DEFFOCUSVALUE
```
private static final String DEFFOCUSVALUE
```
    Default focus temperature parameter name.
    
    See Also:
    
    Constant Field Values
  - DEFFOCUSTEMP
```
private static final String DEFFOCUSTEMP
```
    Default focus temperature parameter name.
    
    See Also:
    
    Constant Field Values
  - DEFALTTARGET
```
private static final String DEFALTTARGET
```
    Default focus temperature parameter name.
    
    See Also:
    
    Constant Field Values
  - DEFSTEP0
```
private static final double DEFSTEP0
```
    Default step0 (March 2013)
    
    See Also:
    
    Constant Field Values
  - DEFTEMP0
```
private static final double DEFTEMP0
```
    Default temp0
    
    See Also:
    
    Constant Field Values
  - DEFSTEPTEMP
```
private static final double DEFSTEPTEMP
```
    Default steptemp (March 2013)
    
    See Also:
    
    Constant Field Values
  - DEFSTEPTEMPSQ
```
private static final double DEFSTEPTEMPSQ
```
    Default steptemp (March 2013)
    
    See Also:
    
    Constant Field Values
  - DEFSTEPSINALT
```
private static final double DEFSTEPSINALT
```
    Default steptemp (March 2013)
    
    See Also:
    
    Constant Field Values
  - DEFFOCUSOFFSET
```
private static final double DEFFOCUSOFFSET
```
    Default focusoffset fine.
    
    See Also:
    
    Constant Field Values
  - DEFSEARCHOFFSET
```
private static final double DEFSEARCHOFFSET
```
    Default focusoffset on step, where we search a coarse focus.
    
    See Also:
    
    Constant Field Values
  - DEFALTSHIFT
```
private static final double DEFALTSHIFT
```
    Shift the image by 60 pixel to avoid obsuration by the pinhole.
    
    See Also:
    
    Constant Field Values
  - DEFAZSHIFT
```
private static final double DEFAZSHIFT
```
    Shift the image by 60 pixel to avoid obsuration by the pinhole.
    
    See Also:
    
    Constant Field Values
  - DEFSEARCHSTEPS
```
private static final int DEFSEARCHSTEPS
```
    Default half-number of search steps.
    
    See Also:
    
    Constant Field Values
  - DEFDOSAVE
```
private static final boolean DEFDOSAVE
```
    If true we save the indivdual images during focus.
    
    See Also:
    
    Constant Field Values
  - DEFEXPOSEFOCUS
```
private static final double DEFEXPOSEFOCUS
```
    The default S/N on acquire.
    
    See Also:
    
    Constant Field Values
  - DEFSEARCHORDER
```
private static final int DEFSEARCHORDER
```
    The moment during coarse focus.
    
    See Also:
    
    Constant Field Values
  - DEFFOCUSORDER
```
private static final int DEFFOCUSORDER
```
    The moment during fine focus.
    
    See Also:
    
    Constant Field Values
  - DEFFOCUSBINNING
```
private static final Dimension DEFFOCUSBINNING
```
    The default binning on acquire.
  - DEFZERNIKESTEP
```
private static final double DEFZERNIKESTEP
```
    Default no extra Zernike images.
    
    See Also:
    
    Constant Field Values
  - DEFZEXPOSE
```
private static final double DEFZEXPOSE
```
    Default no extra increase in exposure time on Zernikes.
    
    See Also:
    
    Constant Field Values
  - DEFA4SLOPE
```
private static final double DEFA4SLOPE
```
    Default A4 slope (2011-10-14).
    
    See Also:
    
    Constant Field Values
  - DEFA4ERROR
```
private static final double DEFA4ERROR
```
    Default A4 error (2011-10-14).
    
    See Also:
    
    Constant Field Values
  - DEFBLOBFRAME
```
private static final Rectangle DEFBLOBFRAME
```
    The default blob frame.
  - DEFZERNIKEBLOB
```
private static final Dimension DEFZERNIKEBLOB
```
    The default blob size.
  - DEFFWHMBLOB
```
private static final Dimension DEFFWHMBLOB
```
    The default blob size.
  - DEFZERNIKESIZE
```
private static final Dimension DEFZERNIKESIZE
```
    The default size around the bright spot.
  - DEFFWHMSIZE
```
private static final Dimension DEFFWHMSIZE
```
    The default size around the bright spot.
  - DEFSKYFRAME
```
private static final int DEFSKYFRAME
```
    The defautl sky frame size.
    
    See Also:
    
    Constant Field Values
  - DEFMEDIANSKY
```
private static final boolean DEFMEDIANSKY
```
    Default we use median for sky-level determination.
    
    See Also:
    
    Constant Field Values
  - DEFLOWSKYSIGMA
```
private static final double DEFLOWSKYSIGMA
```
    Per default we do not do ADU rejection, thus this is zero.
    
    See Also:
    
    Constant Field Values
  - DEFHIGHSKYSIGMA
```
private static final double DEFHIGHSKYSIGMA
```
    Per default we do not do ADU rejection, thus this is zero.
    
    See Also:
    
    Constant Field Values
  - DEFERRORCRUDE
```
private static final double DEFERRORCRUDE
```
    Default temperature focusing error in steps.
    
    See Also:
    
    Constant Field Values
  - linear
```
private MultiAxes linear
```
    The Multi-axis driver used for linear positioning.
  - maxsteps
```
private int maxsteps
```
    The focus axis can assume values from zero to this.
  - focusmodel
```
private Value focusmodel
```
    We have a focus model.
  - temp
```
private Value temp
```
    The temperature value.
  - height
```
private Value height
```
    The height of the target/telescope.
  - shift
```
private Value shift
```
    The external focus offset, e.g. by an ADC.
  - focus
```
private Value focus
```
    The focus position updated by me.
- Constructor Detail
  - LinearPrimeFocus
```
public LinearPrimeFocus(Map<String,String> prop)
```
    Constructs a new focussing unit. On registering of the master we query the driver for the linear stage.
- Method Detail
  - getMinimumFocus
```
public double getMinimumFocus()
```
    Returns the minimum focus step this unit can reach, which is step 0.
    
    Specified by:
    
    getMinimumFocus in class MomentsFocussing
  - getMaximumFocus
```
public double getMaximumFocus()
```
    Returns the maximum focus step this unit can reach, which is step 31400 something.
    
    Specified by:
    
    getMaximumFocus in class MomentsFocussing
  - registerDriver
```
public boolean registerDriver(Driver ls)
```
    Description copied from interface: DriverDepending
    
    Registers a Driver object to this object. If the driver handed over is not of the appropriate type or registering to the driver fails for any other reson, this method should return false.
    Main use with RS485Server and its subclasses.
    
    Specified by:
    
    registerDriver in interface DriverDepending
    
    Returns:
    
    True if registering at the driver was successful.
  - registerGlobals
```
public void registerGlobals(GlobalGrouping set)
```
    We scan the parameter set for the windspeed, seeing, a counter for spurious guiding losses and target losses.
    
    Specified by:
    
    registerGlobals in interface GlobalDepending
    
    Overrides:
    
    registerGlobals in class MomentsFocussing
  - configureUnit
```
public void configureUnit()
                   throws ConfigurationException
```
    Specified by:
    
    configureUnit in class AncillaryCameraUnit
    
    Throws:
    
    ConfigurationException
  - isValid
```
protected boolean isValid()
```
    We are valid only if we have the linear drive and the moments.
    
    Overrides:
    
    isValid in class MomentsFocussing
  - prepare
```
protected boolean prepare()
```
    Description copied from class: AbstractFocussingUnit
    
    Prepare for a focus sequence.
    
    Specified by:
    
    prepare in class AbstractFocussingUnit
  - finished
```
protected boolean finished()
```
    Description copied from class: AbstractFocussingUnit
    
    After a successful focus set
    
    Specified by:
    
    finished in class AbstractFocussingUnit
  - crudeFocus
```
public Vector2D crudeFocus()
```
    We calculate a focus position from the temperature and telescope pointing. If an additional shift is indicated (i.e. an ADC has been applied), this is included here via an external KEY_SHIFT parameter.
    The stage is *not* moved.
    
    Specified by:
    
    crudeFocus in interface Focussing
    
    Returns:
    
    The focus position in x and its error estimate in y, zero for no error estimate possible.
  - getUnitType
```
public String getUnitType()
```
    This is the linear stage in the prime focus of stella one, used for focusing.
    
    Specified by:
    
    getUnitType in class GenericUnit
  - setFocus
```
public boolean setFocus(double step)
                 throws FocussingException
```
    We set the focus of the linear stage to the specified value. This is a number in the range of 0-31400, its units is steps.
    
    Specified by:
    
    setFocus in interface Focussing
    
    Throws:
    
    FocussingException
  - setFocusOffset
```
public boolean setFocusOffset(double step)
                       throws FocussingException
```
    We set the offset of the linear stage to the specified value. This is a number in the range of 0-31400, its units is steps.
    
    Specified by:
    
    setFocusOffset in interface Focussing
    
    Throws:
    
    FocussingException

Class LinearPrimeFocus

Nested Class Summary

Nested classes/interfaces inherited from class stella.auxiliary.AbstractFocussingUnit

Nested classes/interfaces inherited from class util.PropertyResources

Field Summary

Fields inherited from class stella.auxiliary.MomentsFocussing

Fields inherited from class stella.acquire.AncillaryCameraUnit

Fields inherited from class stella.util.GenericUnit

Fields inherited from class util.PropertyResources

Fields inherited from class util.PropertyContainer

Fields inherited from interface util.ResourceSupplying

Fields inherited from interface util.PropertySupplying

Constructor Summary

Method Summary

Methods inherited from class stella.auxiliary.MomentsFocussing

Methods inherited from class stella.acquire.AncillaryCameraUnit

Methods inherited from class stella.util.GenericUnit

Methods inherited from class util.PropertyResources

Methods inherited from class util.PropertyContainer

Methods inherited from class java.lang.Object

Methods inherited from interface util.PropertySupplying

Field Detail

LINEARTYPE

KEY_LINEARDRIVER

KEY_FOCUSAXIS

KEY_STEP0

KEY_TEMP0

KEY_STEPTEMP

KEY_STEPTEMPSQ

KEY_STEPSINALT

KEY_FOCUSMODEL

KEY_SHIFT

KEY_FOCUSTEMP

KEY_ALTTARGET

KEY_FOCUSVALUE

KEY_AZSHIFT

KEY_ALTSHIFT

KEY_TEMPMIN

DEFLINEARDRIVER

DEFFOCUSAXIS

DEFFOCUSVALUE

DEFFOCUSTEMP

DEFALTTARGET

DEFSTEP0

DEFTEMP0

DEFSTEPTEMP

DEFSTEPTEMPSQ

DEFSTEPSINALT

DEFFOCUSOFFSET

DEFSEARCHOFFSET

DEFALTSHIFT

DEFAZSHIFT

DEFSEARCHSTEPS

DEFDOSAVE

DEFEXPOSEFOCUS

DEFSEARCHORDER

DEFFOCUSORDER

DEFFOCUSBINNING

DEFZERNIKESTEP

DEFZEXPOSE

DEFA4SLOPE

DEFA4ERROR

DEFBLOBFRAME

DEFZERNIKEBLOB

DEFFWHMBLOB

DEFZERNIKESIZE

DEFFWHMSIZE

DEFSKYFRAME

DEFMEDIANSKY

DEFLOWSKYSIGMA

DEFHIGHSKYSIGMA

DEFERRORCRUDE

linear

maxsteps

focusmodel

temp

height

shift

focus

Constructor Detail