MagellanDriver

java.lang.Object
- util.PropertyContainer
- - io.AbstractDriver
  - - ccd.AbstractCcdDriver
    - - ccd.SynchronousCcdDriver
      - ccd.sta0502.MagellanDriver

All Implemented Interfaces:

AutoClearing, CcdDriver, Continuous, Driver, Cloneable, Asynchronous, Initializable, PropertySupplying, StatusProviding
```
public class MagellanDriver
extends SynchronousCcdDriver
implements StatusProviding, AutoClearing, Asynchronous
```
This class interfaces to Thomas Fechner's Wifsip controller (Magellan) type. Due to increased version spread, each new RPC package is put in its own directory.

Nested Class Summary
- Nested classes/interfaces inherited from class ccd.SynchronousCcdDriver
  SynchronousCcdDriver.ExposureThread, SynchronousCcdDriver.ThreadShot
- Nested classes/interfaces inherited from class ccd.AbstractCcdDriver
  AbstractCcdDriver.Endurance, AbstractCcdDriver.Exposure, AbstractCcdDriver.Shot

Field Summary

Fields
Modifier and Type	Field and Description
`private MFits`	`async` The data buffer for asynchroneous retrieval.
`private static WifsipMagellanClient`	`ccdclient` RPC client instance.
`static String`	`CCDSEC` Fits key for entering y-pregap info to header.
`static String`	`CCDSECREM` Comment for entering y-pregap info to header.
`static String`	`CCDTEMP` The keyword for the CCD temperature.
`static double`	`COPYBSCALE` Default scaling factor copied into the extensions, if not in primary.
`static double`	`COPYBZERO` Default zero offset copied into the extensions, if not in primary.
`static String`	`COPYREM` Comment for a key that was copied from the primary.
`static String`	`DATECOAL` Header keyword for receive exposure end.
`static String`	`DATECOALREM` Comment for receive exposure end.
`static String`	`DATESEND` Header keyword for send exposure start.
`static String`	`DATESENDREM` Comment for send exposure start.
`private static int`	`DEFAMPLIFIERS` Default property value.
`private static boolean`	`DEFAUTOFLUSH` The parameters for the extra setup, autoflush .
`private static int`	`DEFCOLAMPLIFIERS` Default property value.
`static String`	`DEFDRIVERNAME` The name of this ccd.
`private static long`	`DEFEXPOSEMULTIPLY` Default property value.
`private static boolean`	`DEFEXTRASETUP` If true the special setup comands copied from TF *.sh are called.
`private static long`	`DEFMAXTIME` Default property value.
`private static long`	`DEFMINIMUMABORTMS`
`private static long`	`DEFMINTIME` Default property value.
`private static boolean`	`DEFNOSIZESET` Default property value.
`private static int`	`DEFRPCTIMEOUT` Default property value.
`private static String`	`DEFSERVERNAME` Default property value.
`private static int`	`DEFSHUTTERCLOSE` Default property value.
`private static int`	`DEFSHUTTEROPEN` Default property value.
`private static boolean`	`DEFSUPPORTSHUTTER` Default property value.
`private static boolean`	`DEFWRONGENDIAN` Default property value.
`static String`	`DETSIZE` Fits key for entering x-pregap info to header.
`static String`	`DETSIZEREM` Comment for entering x-pregap info to header.
`static String`	`KEY_AUTOFLUSH` The parameters for the extra setup, autoflush .
`static String`	`KEY_COLAMPLIFIERS` Total number of amplifiers expected in row direction.
`static String`	`KEY_EXPOSEMULTIPLY` The multiplier for exposure times returned to ms.
`static String`	`KEY_EXTRASETUP` If true the special setup comands copied from TF *.sh are called.
`static String`	`KEY_HCLKDIR` The parameters for the extra setup, vclkdir .
`static String`	`KEY_MINIMUMABORTMS` Aborts are issued via a stop command only if at least ms exposure left.
`static String`	`KEY_MUSEC` The parameters for the extra setup, usec .
`static String`	`KEY_NOSIZESET` If true changing or setting maxpixel is not allowed.
`static String`	`KEY_OUTPUTCH` The parameters for the extra setup, outputch .
`static String`	`KEY_RPCTIMEOUT` The RPC time-out in millisecond.
`static String`	`KEY_SERVERNAME` FCDN of the host where the guider rpc server is running.
`static String`	`KEY_SHUTTERCLOSE` The short paramter for shutter-close.
`static String`	`KEY_SHUTTEROPEN` The short paramter for shutter-open.
`static String`	`KEY_SUPPORTSHUTTER` If true, driver supports shutter operation.
`static String`	`KEY_VCLKDIR` The parameters for the extra setup, vclkdir .
`static String`	`KEY_WRONGENDIAN` If true, endian of received short are little.
`static String`	`KEY_XMAXSIZE` If set, the max size is not the chip size (for multi-amplifier readout).
`static String`	`KEY_YMAXSIZE` If set, the max size is not the chip size (for multi-amplifier readout).
`private Rectangle`	`lastwindow` Last window set (offset is not recoverable otherwise).
`static String`	`LN2TEMP` The keyword for the CCD temperature.
`static int`	`OK` General return code from rpc calls indicating okay.
`private static WifsipMagellanClient`	`status` RPC client solely for status retrieval.

Fields inherited from class ccd.AbstractCcdDriver
KEY_AMPLIFIERS, KEY_AREAREADOUT, KEY_COLUMNPOST, KEY_COLUMNPRIOR, KEY_COLUMNREADOUT, KEY_FIXEDREADOUT, KEY_INITSIZE, KEY_MAXTIME, KEY_MINTIME, KEY_ROWPOST, KEY_ROWPRIOR, KEY_ROWREADOUT, KEY_XBINNING, KEY_XCHIPSIZE, KEY_XDETECTORSIZE, KEY_XORIGIN, KEY_XSIZE, KEY_YBINNING, KEY_YCHIPSIZE, KEY_YDETECTORSIZE, KEY_YORIGIN, KEY_YSIZE

Fields inherited from class io.AbstractDriver
KEY_DRIVERNAME

Fields inherited from class util.PropertyContainer
KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface ccd.CcdDriver
FITSEXTENSION

Fields inherited from interface util.PropertySupplying
CONFIG, KEY_CLASS

Constructor Summary

Constructors
Constructor and Description

MagellanDriver(Map<String,String> info)
Constructor.

Constructors
Constructor and Description
`MagellanDriver(Map<String,String> info)` Constructor.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`close()` Close the RPC communication.
`String`	`conciseStatus()` Returns the current state of the CCD.
`private boolean`	`doDark()` Does a dark exposure.
`private boolean`	`doExposure()` Does an open-shutter exposure.
`private boolean`	`download(Date t0, Date t1, ergf result)` Takes the result of an exposure and makes a fits file out of it.
`int`	`expose()` Make an exposure.
`int`	`exposeBias()` Makes a bias exposure.
`int`	`exposeDark()` Makes a dark exposure.
`Object`	`extendedStatus()` Returns the current state of the CCD.
`Dimension`	`getBinning()` Get the binning values in x (columns) and y (rows).
`Map<String,Object>`	`getCcdInfo()` We return the temperature of the cold head plus the temperature of the CCD here.
`MFits`	`getData()` Returns the output buffer.
`double`	`getExposureTime()` Get the current exposure time in milliseconds.
`protected Dimension`	`getMaxPixel()` Get the max_pixel values for x (columns) and y (rows).
`private Point`	`getPregap()` Returns the pregap.
`private Dimension`	`getReadoutArea()` Returns read-ouyt area as a dimension.
`protected double`	`getReadoutDirectionX(int x0, int y0, int n)` Get the readout direction in x for the current amplifier position
`protected double`	`getReadoutDirectionY(int x0, int y0, int n)` Get the readout direction in y for the current amplifier position
`private static String`	`getSection(int xl, int yd, int xll, int ydd)` Formats a window to a section string.
`Rectangle`	`getWindow()` Get the current image origin (pre-gap) in x (columns) and y (rows) and the size
`void`	`init()` Clear any leftovers.
`boolean`	`interruptProcess()` Aborts the ongoing exposure.
`boolean`	`interruptProcess(Method any)` Aborts the ongoing exposure.
`boolean`	`isAutoClearing()` Gets the autoflush property.
`boolean`	`isExposing()` We are exposing if the `#provideStatus` method returns 1.
`boolean`	`isOpen()` We consider the driver to be open if the ccdclient is initialized.
`boolean`	`isReadingOut()` We are exposing if the `#provideStatus` method returns 1.
`protected boolean`	`openController()` Initializes the fechner driver.
`private Integer`	`readStatus(int param)` Returns the current state of the CCD.
`boolean`	`setAutoClearing(boolean to)` Sets the autoflush property.
`boolean`	`setBinning(int xbin, int ybin)` Set the binning values in x (columns) and y (rows).
`boolean`	`setExposureTime(double exptime)` Set the current exposure time in milliseconds.
`protected boolean`	`setMaxPixel(Dimension max)` Set the max_pixel values for x (columns) and y (rows).
`private boolean`	`setShutter(boolean open)` Sets the shutter position.
`boolean`	`setWindow(Rectangle window)` Set the current image window.
`private boolean`	`stopExposure()` Tries to stop the SES exposure by issuing the new STOP command.
`private static short[]`	`swap(short[] little, int start, int len)` Swaps wrong endian in a short array.

Methods inherited from class ccd.SynchronousCcdDriver
cancelContinuous, ensureReady, getRunning, startContinuous, stopContinuous, threadedBiasExpose, threadedDarkExpose, threadedExpose

Methods inherited from class ccd.AbstractCcdDriver
getDetectorSize, getMaximumExposureTime, getMinimumExposureTime, getReadoutMaximum, getReadoutTime, open

Methods inherited from class io.AbstractDriver
createDriver, equals, getDriverName, hashCode

Methods inherited from class util.PropertyContainer
augment, augment, augment, augment, augment, clone, 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, initProperties, isNew, parseObject, parseObject, reload, reload, removeProperty, requires, rescanned, setObject, setProperties, setProperty, stringProperties, toString

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface ccd.CcdDriver
getDetectorSize, getMaximumExposureTime, getMinimumExposureTime, getReadoutMaximum, getReadoutTime

Methods inherited from interface io.Driver
getDriverName, open

- Field Detail
  - CCDTEMP
```
public static final String CCDTEMP
```
    The keyword for the CCD temperature.
    
    See Also:
    
    Constant Field Values
  - LN2TEMP
```
public static final String LN2TEMP
```
    The keyword for the CCD temperature.
    
    See Also:
    
    Constant Field Values
  - OK
```
public static final int OK
```
    General return code from rpc calls indicating okay.
    
    See Also:
    
    Constant Field Values
  - COPYBZERO
```
public static final double COPYBZERO
```
    Default zero offset copied into the extensions, if not in primary.
    
    See Also:
    
    Constant Field Values
  - COPYBSCALE
```
public static final double COPYBSCALE
```
    Default scaling factor copied into the extensions, if not in primary.
    
    See Also:
    
    Constant Field Values
  - DETSIZE
```
public static final String DETSIZE
```
    Fits key for entering x-pregap info to header.
    
    See Also:
    
    Constant Field Values
  - DETSIZEREM
```
public static final String DETSIZEREM
```
    Comment for entering x-pregap info to header.
    
    See Also:
    
    Constant Field Values
  - CCDSEC
```
public static final String CCDSEC
```
    Fits key for entering y-pregap info to header.
    
    See Also:
    
    Constant Field Values
  - CCDSECREM
```
public static final String CCDSECREM
```
    Comment for entering y-pregap info to header.
    
    See Also:
    
    Constant Field Values
  - COPYREM
```
public static final String COPYREM
```
    Comment for a key that was copied from the primary.
    
    See Also:
    
    Constant Field Values
  - DATESEND
```
public static final String DATESEND
```
    Header keyword for send exposure start.
    
    See Also:
    
    Constant Field Values
  - DATECOAL
```
public static final String DATECOAL
```
    Header keyword for receive exposure end.
    
    See Also:
    
    Constant Field Values
  - DATESENDREM
```
public static final String DATESENDREM
```
    Comment for send exposure start.
    
    See Also:
    
    Constant Field Values
  - DATECOALREM
```
public static final String DATECOALREM
```
    Comment for receive exposure end.
    
    See Also:
    
    Constant Field Values
  - KEY_SERVERNAME
```
public static final String KEY_SERVERNAME
```
    FCDN of the host where the guider rpc server is running.
    
    See Also:
    
    Constant Field Values
  - KEY_EXPOSEMULTIPLY
```
public static final String KEY_EXPOSEMULTIPLY
```
    The multiplier for exposure times returned to ms.
    
    See Also:
    
    Constant Field Values
  - KEY_SUPPORTSHUTTER
```
public static final String KEY_SUPPORTSHUTTER
```
    If true, driver supports shutter operation.
    
    See Also:
    
    Constant Field Values
  - KEY_SHUTTEROPEN
```
public static final String KEY_SHUTTEROPEN
```
    The short paramter for shutter-open.
    
    See Also:
    
    Constant Field Values
  - KEY_SHUTTERCLOSE
```
public static final String KEY_SHUTTERCLOSE
```
    The short paramter for shutter-close.
    
    See Also:
    
    Constant Field Values
  - KEY_RPCTIMEOUT
```
public static final String KEY_RPCTIMEOUT
```
    The RPC time-out in millisecond.
    
    See Also:
    
    Constant Field Values
  - KEY_WRONGENDIAN
```
public static final String KEY_WRONGENDIAN
```
    If true, endian of received short are little.
    
    See Also:
    
    Constant Field Values
  - KEY_COLAMPLIFIERS
```
public static final String KEY_COLAMPLIFIERS
```
    Total number of amplifiers expected in row direction.
    
    See Also:
    
    Constant Field Values
  - KEY_NOSIZESET
```
public static final String KEY_NOSIZESET
```
    If true changing or setting maxpixel is not allowed.
    
    See Also:
    
    Constant Field Values
  - KEY_XMAXSIZE
```
public static final String KEY_XMAXSIZE
```
    If set, the max size is not the chip size (for multi-amplifier readout).
    
    See Also:
    
    Constant Field Values
  - KEY_YMAXSIZE
```
public static final String KEY_YMAXSIZE
```
    If set, the max size is not the chip size (for multi-amplifier readout).
    
    See Also:
    
    Constant Field Values
  - KEY_EXTRASETUP
```
public static final String KEY_EXTRASETUP
```
    If true the special setup comands copied from TF *.sh are called.
    
    See Also:
    
    Constant Field Values
  - KEY_VCLKDIR
```
public static final String KEY_VCLKDIR
```
    The parameters for the extra setup, vclkdir .
    
    See Also:
    
    Constant Field Values
  - KEY_HCLKDIR
```
public static final String KEY_HCLKDIR
```
    The parameters for the extra setup, vclkdir .
    
    See Also:
    
    Constant Field Values
  - KEY_OUTPUTCH
```
public static final String KEY_OUTPUTCH
```
    The parameters for the extra setup, outputch .
    
    See Also:
    
    Constant Field Values
  - KEY_MUSEC
```
public static final String KEY_MUSEC
```
    The parameters for the extra setup, usec .
    
    See Also:
    
    Constant Field Values
  - KEY_AUTOFLUSH
```
public static final String KEY_AUTOFLUSH
```
    The parameters for the extra setup, autoflush .
    
    See Also:
    
    Constant Field Values
  - KEY_MINIMUMABORTMS
```
public static final String KEY_MINIMUMABORTMS
```
    Aborts are issued via a stop command only if at least ms exposure left.
    
    See Also:
    
    Constant Field Values
  - DEFMINIMUMABORTMS
```
private static final long DEFMINIMUMABORTMS
```
    See Also:
    
    Constant Field Values
  - DEFDRIVERNAME
```
public static final String DEFDRIVERNAME
```
    The name of this ccd.
    
    See Also:
    
    Constant Field Values
  - DEFSERVERNAME
```
private static final String DEFSERVERNAME
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFSUPPORTSHUTTER
```
private static final boolean DEFSUPPORTSHUTTER
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFSHUTTEROPEN
```
private static final int DEFSHUTTEROPEN
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFSHUTTERCLOSE
```
private static final int DEFSHUTTERCLOSE
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFMINTIME
```
private static final long DEFMINTIME
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFEXPOSEMULTIPLY
```
private static final long DEFEXPOSEMULTIPLY
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFMAXTIME
```
private static final long DEFMAXTIME
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFRPCTIMEOUT
```
private static final int DEFRPCTIMEOUT
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFWRONGENDIAN
```
private static final boolean DEFWRONGENDIAN
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFNOSIZESET
```
private static final boolean DEFNOSIZESET
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFAMPLIFIERS
```
private static final int DEFAMPLIFIERS
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFCOLAMPLIFIERS
```
private static final int DEFCOLAMPLIFIERS
```
    Default property value.
    
    See Also:
    
    Constant Field Values
  - DEFEXTRASETUP
```
private static final boolean DEFEXTRASETUP
```
    If true the special setup comands copied from TF *.sh are called.
    
    See Also:
    
    Constant Field Values
  - DEFAUTOFLUSH
```
private static final boolean DEFAUTOFLUSH
```
    The parameters for the extra setup, autoflush .
    
    See Also:
    
    Constant Field Values
  - ccdclient
```
private static WifsipMagellanClient ccdclient
```
    RPC client instance.
  - status
```
private static WifsipMagellanClient status
```
    RPC client solely for status retrieval.
  - async
```
private MFits async
```
    The data buffer for asynchroneous retrieval.
  - lastwindow
```
private Rectangle lastwindow
```
    Last window set (offset is not recoverable otherwise).
- Constructor Detail
  - MagellanDriver
```
public MagellanDriver(Map<String,String> info)
```
    Constructor. Does not open the connection, this is done in init().
- Method Detail
  - init
```
public void init()
          throws InitException
```
    Clear any leftovers.
    
    Specified by:
    
    init in interface Initializable
    
    Overrides:
    
    init in class AbstractCcdDriver
    
    Throws:
    
    InitException
  - isExposing
```
public boolean isExposing()
```
    We are exposing if the #provideStatus method returns 1. Never ask directly at exposure start, may yield inadequate results.
    
    Specified by:
    
    isExposing in interface CcdDriver
    
    Overrides:
    
    isExposing in class SynchronousCcdDriver
  - interruptProcess
```
public boolean interruptProcess()
                         throws InterruptedException
```
    Aborts the ongoing exposure.
    
    Specified by:
    
    interruptProcess in interface Asynchronous
    
    Throws:
    
    InterruptedException
  - interruptProcess
```
public boolean interruptProcess(Method any)
                         throws InterruptedException
```
    Aborts the ongoing exposure. There is only one process to be interrupted, that is an exposure thread.
    
    Specified by:
    
    interruptProcess in interface Asynchronous
    
    Throws:
    
    InterruptedException
  - isReadingOut
```
public boolean isReadingOut()
```
    We are exposing if the #provideStatus method returns 1. Never ask directly at exposure start, may yield inadequate results.
    
    Specified by:
    
    isReadingOut in interface CcdDriver
    
    Overrides:
    
    isReadingOut in class SynchronousCcdDriver
  - extendedStatus
```
public Object extendedStatus()
```
    Returns the current state of the CCD. We query the underlying client's GET_STATUS and deliver the returned value as an Integer. SCI_IDLE = 00 SCI_EXPOSE = 01 ; entweder prewipe oder expose SCI_READOUT = 02 ; auslesen SCI_WIPE = 03 ; auto clean SCI_BUSY = 99
    
    Specified by:
    
    extendedStatus in interface StatusProviding
  - conciseStatus
```
public String conciseStatus()
```
    Returns the current state of the CCD. We query the underlying client's GET_STATUS and deliver the returned value as an Integer. SCI_IDLE = 00 SCI_EXPOSE = 01 ; entweder prewipe oder expose SCI_READOUT = 02 ; auslesen SCI_WIPE = 03 ; auto clean SCI_BUSY = 99
    
    Specified by:
    
    conciseStatus in interface StatusProviding
  - readStatus
```
private Integer readStatus(int param)
```
    Returns the current state of the CCD. We query the underlying client's GET_STATUS and deliver the returned value as an Integer. SCI_IDLE = 00 SCI_EXPOSE = 01 ; entweder prewipe oder expose SCI_READOUT = 02 ; auslesen SCI_WIPE = 03 ; auto clean SCI_BUSY = 99
  - openController
```
protected boolean openController()
                          throws IOException
```
    Initializes the fechner driver. Tries to connect to the server and sets default values for binning, maximum size of the chip and read-out window. If a shutter is supported, it is closed. Returns true if initialization was successful.
    
    Specified by:
    
    openController in class AbstractCcdDriver
    
    Returns:
    
    False If controller could not be opened.
    
    Throws:
    
    IOException - If controller connection fails.
  - isOpen
```
public boolean isOpen()
```
    We consider the driver to be open if the ccdclient is initialized.
    
    Specified by:
    
    isOpen in interface Driver
    
    Returns:
    
    True, if a previous initialization was successful
  - close
```
public boolean close()
              throws IOException
```
    Close the RPC communication.
    
    Specified by:
    
    close in interface Driver
    
    Returns:
    
    True if clean-up was successful.
    
    Throws:
    
    IOException
  - setMaxPixel
```
protected boolean setMaxPixel(Dimension max)
                       throws IOException
```
    Set the max_pixel values for x (columns) and y (rows).
    
    Parameters:
    
    max - maximum CCD size in x-direction and y-direction
    
    Throws:
    
    IOException
  - getMaxPixel
```
protected Dimension getMaxPixel()
                         throws IOException
```
    Get the max_pixel values for x (columns) and y (rows).
    
    Returns:
    
    A dimension object, where the size in x is the width.
    
    Throws:
    
    IOException
  - setBinning
```
public boolean setBinning(int xbin,
                          int ybin)
                   throws IOException
```
    Set the binning values in x (columns) and y (rows).
    
    Specified by:
    
    setBinning in interface CcdDriver
    
    Parameters:
    
    xbin - binning factor in x-direction (1 <= binning factor <= 255)
    
    ybin - binning factor in y-direction (1 <= binning factor <= 255)
    
    Returns:
    
    True if successful.
    
    Throws:
    
    IOException - Any subclass of IOException
  - getBinning
```
public Dimension getBinning()
                     throws IOException
```
    Get the binning values in x (columns) and y (rows).
    
    Specified by:
    
    getBinning in interface CcdDriver
    
    Returns:
    
    Dimension object, columns in width.
    
    Throws:
    
    IOException - Any subclass of IOException.
  - setWindow
```
public boolean setWindow(Rectangle window)
                  throws IOException
```
    Set the current image window.
    
    Specified by:
    
    setWindow in interface CcdDriver
    
    Parameters:
    
    window - The origin being the upper left corner of the rectangle.
    
    Returns:
    
    True if successful.
    
    Throws:
    
    IOException - Any subclass of IOException.
  - getWindow
```
public Rectangle getWindow()
                    throws IOException
```
    Get the current image origin (pre-gap) in x (columns) and y (rows) and the size
    
    Specified by:
    
    getWindow in interface CcdDriver
    
    Returns:
    
    A rectangle with pre-gap upper left corner.
    
    Throws:
    
    IOException - Any subclass of IOException.
  - setExposureTime
```
public boolean setExposureTime(double exptime)
                        throws IOException
```
    Set the current exposure time in milliseconds.
    
    Specified by:
    
    setExposureTime in interface CcdDriver
    
    Parameters:
    
    expTime - exposure time in milliseconds. (0 <= expTime < 65536 ms)
    
    Returns:
    
    True if successful.
    
    Throws:
    
    IOException - Any subclass of IOException.
  - getExposureTime
```
public double getExposureTime()
                       throws IOException
```
    Get the current exposure time in milliseconds.
    
    Specified by:
    
    getExposureTime in interface CcdDriver
    
    Returns:
    
    current exposure time (in milliseconds).
    
    Throws:
    
    IOException - Any subclass of IOException.
  - setAutoClearing
```
public boolean setAutoClearing(boolean to)
                        throws IOException
```
    Sets the autoflush property. Without autoflushing, a few seconds can be spared on an exposure, but the danger of charge-buildup remains.
    
    Specified by:
    
    setAutoClearing in interface AutoClearing
    
    Throws:
    
    IOException
  - isAutoClearing
```
public boolean isAutoClearing()
                       throws IOException
```
    Gets the autoflush property.
    
    Specified by:
    
    isAutoClearing in interface AutoClearing
    
    Throws:
    
    IOException
  - getData
```
public MFits getData()
              throws IOException
```
    Returns the output buffer. This is either the fits buffer set via a call to #setDataBuffer, or null if not set and no exposure has been taken. If an exposure has finished and the buffer has not been explicedly set, a new fits object has been allocated, which will be returned here.
    
    Specified by:
    
    getData in interface CcdDriver
    
    Throws:
    
    IOException - Any subclass of IOException.
  - getCcdInfo
```
public Map<String,Object> getCcdInfo()
                              throws IOException
```
    We return the temperature of the cold head plus the temperature of the CCD here.
    
    Specified by:
    
    getCcdInfo in interface CcdDriver
    
    Throws:
    
    IOException
  - expose
```
public int expose()
           throws IOException
```
    Make an exposure. The exposure time and the data buffer must be set prior to a call to this function. If the driver supports a shutter, the shutter is opened before the exposure starts and closed after. Note that this method does not check for proper settings. In TF's driver this method blocks.
    
    Specified by:
    
    expose in interface CcdDriver
    
    Returns:
    
    Number of pixel writtn.
    
    Throws:
    
    IOException - Any subclass of IOException.
    
    See Also:
    
    startExpose
  - exposeBias
```
public int exposeBias()
               throws IOException
```
    Makes a bias exposure. Does an dark exposure with minimum time. The data buffer has to be set prior to a call to this method.
    
    Specified by:
    
    exposeBias in interface CcdDriver
    
    Returns:
    
    Number of pixel writtn.
    
    Throws:
    
    IOException - Any subclass of IOException.
  - exposeDark
```
public int exposeDark()
               throws IOException
```
    Makes a dark exposure. The shutter is not moved, even if present. The data buffer has to be set prior to a call to this method.
    
    Specified by:
    
    exposeDark in interface CcdDriver
    
    Returns:
    
    Number of pixel writtn..
    
    Throws:
    
    IOException - Any subclass of IOException.
  - stopExposure
```
private boolean stopExposure()
                      throws IOException
```
    Tries to stop the SES exposure by issuing the new STOP command. I suspect similar behavior of the ONC/RPC client as with get status, thus this command is issued via the status channel.
    
    Throws:
    
    IOException
  - getPregap
```
private Point getPregap()
                 throws IOException
```
    Returns the pregap. Returns property setting if not open.
    
    Throws:
    
    IOException
  - swap
```
private static short[] swap(short[] little,
                            int start,
                            int len)
```
    Swaps wrong endian in a short array.
  - getReadoutArea
```
private Dimension getReadoutArea()
                          throws IOException
```
    Returns read-ouyt area as a dimension. Returns property setting if not open.
    
    Throws:
    
    IOException
  - setShutter
```
private boolean setShutter(boolean open)
                    throws IOException
```
    Sets the shutter position. If called with true, shutter is opened. Driver must be opened, this is unchecked.
    
    Throws:
    
    IOException
  - getReadoutDirectionX
```
protected double getReadoutDirectionX(int x0,
                                      int y0,
                                      int n)
```
    Get the readout direction in x for the current amplifier position
  - getReadoutDirectionY
```
protected double getReadoutDirectionY(int x0,
                                      int y0,
                                      int n)
```
    Get the readout direction in y for the current amplifier position
  - getSection
```
private static String getSection(int xl,
                                 int yd,
                                 int xll,
                                 int ydd)
```
    Formats a window to a section string. The counting starts at zero, but the correct value is added.
  - doExposure
```
private boolean doExposure()
                    throws IOException
```
    Does an open-shutter exposure. This method calls the RPC-method StreamClient#DO_EXPOSURE_2, grabs the returned fits object and transforms it to the more general MFits java object. If a data buffer-fits is set, all of its HDU's are deleted and the new Image is added to the fits file. If no async buffer was set, a new fits file is generated with the current data. // the END card is always missing, but we want to add origin
    
    Throws:
    
    IOException
  - doDark
```
private boolean doDark()
                throws IOException
```
    Does a dark exposure. This method calls the RPC-method StreamClient#DO_DARK_2, grabs the returned fits object and transforms it to the more general MFits java object. If a data buffer-fits is set, all of its HDU's are deleted and the new Image is added to the fits file. If no async buffer was set, a new fits file is generated with the current data. // the END card is always missing, but we want to add origin
    
    Throws:
    
    IOException
  - download
```
private boolean download(Date t0,
                         Date t1,
                         ergf result)
                  throws BasicFitsException
```
    Takes the result of an exposure and makes a fits file out of it.
    
    Throws:
    
    BasicFitsException

Class MagellanDriver

Nested Class Summary

Nested classes/interfaces inherited from class ccd.SynchronousCcdDriver

Nested classes/interfaces inherited from class ccd.AbstractCcdDriver

Field Summary

Fields inherited from class ccd.AbstractCcdDriver

Fields inherited from class io.AbstractDriver

Fields inherited from class util.PropertyContainer

Fields inherited from interface ccd.CcdDriver

Fields inherited from interface util.PropertySupplying

Constructor Summary

Method Summary

Methods inherited from class ccd.SynchronousCcdDriver

Methods inherited from class ccd.AbstractCcdDriver

Methods inherited from class io.AbstractDriver

Methods inherited from class util.PropertyContainer

Methods inherited from class java.lang.Object

Methods inherited from interface ccd.CcdDriver

Methods inherited from interface io.Driver

Field Detail

CCDTEMP

LN2TEMP

OK

COPYBZERO

COPYBSCALE

DETSIZE

DETSIZEREM

CCDSEC

CCDSECREM

COPYREM

DATESEND

DATECOAL

DATESENDREM

DATECOALREM

KEY_SERVERNAME

KEY_EXPOSEMULTIPLY

KEY_SUPPORTSHUTTER

KEY_SHUTTEROPEN

KEY_SHUTTERCLOSE

KEY_RPCTIMEOUT

KEY_WRONGENDIAN

KEY_COLAMPLIFIERS

KEY_NOSIZESET

KEY_XMAXSIZE

KEY_YMAXSIZE

KEY_EXTRASETUP

KEY_VCLKDIR

KEY_HCLKDIR

KEY_OUTPUTCH

KEY_MUSEC

KEY_AUTOFLUSH

KEY_MINIMUMABORTMS

DEFMINIMUMABORTMS

DEFDRIVERNAME

DEFSERVERNAME

DEFSUPPORTSHUTTER

DEFSHUTTEROPEN

DEFSHUTTERCLOSE

DEFMINTIME

DEFEXPOSEMULTIPLY

DEFMAXTIME

DEFRPCTIMEOUT

DEFWRONGENDIAN

DEFNOSIZESET

DEFAMPLIFIERS

DEFCOLAMPLIFIERS

DEFEXTRASETUP

DEFAUTOFLUSH

ccdclient

status

async

lastwindow

Constructor Detail

MagellanDriver

Method Detail

init

isExposing

interruptProcess

interruptProcess

isReadingOut