ccd

Class StreamingCcdDriver

java.lang.Object

util.PropertyContainer

io.AbstractDriver

ccd.AbstractCcdDriver

ccd.SynchronousCcdDriver

ccd.StreamingCcdDriver

All Implemented Interfaces:

CcdDriver, Continuous, Driver, Cloneable, Initializable, PropertySupplying

public class StreamingCcdDriver
extends SynchronousCcdDriver

This class interfaces to Thomas Fechner's new CCD class that allows data retrieval via the RPC calls.

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 StreamClient	ccdclient RPC client instance.
static String	DATESEND Header keyword for send exposure start.
static String	DATESENDREM Comment for send exposure start.
static String	DEFDRIVERNAME The name of this ccd.
private static long	DEFEXPOSEMULTIPLY Default property value.
private static long	DEFMINTIME 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	KEY_EXPOSEMULTIPLY The multiplier for exposure times returned to ms.
static String	KEY_MANUALCLEAR If true, we have to do a dummy exposure before every frame.
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_WRONGENDIAN If true, endian of received short are little.
static int	OK General return code from rpc calls indicating okay.
static String	XORGREM Comment for entering x-pregap info to header.
static String	YORGREM Comment for entering y-pregap info to header.

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
StreamingCcdDriver(Map<String,String> info) Constructor.

Method Summary

Modifier and Type	Method and Description
boolean	close() Close the RPC communication.
private boolean	doExposure() Does an exposure.
int	expose() Make an exposure.
int	exposeBias() Makes a bias exposure.
int	exposeDark() Makes a dark exposure.
Dimension	getBinning() Get the binning values in x (columns) and y (rows).
Map<String,Object>	getCcdInfo() This ccd does not provide any additional info.
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.
Rectangle	getWindow() Get the current image origin (pre-gap) in x (columns) and y (rows) and the size
void	init() Clear any leftovers.
boolean	isOpen() We consider the driver to be open if the ccdclient is initialized.
protected boolean	openController() Initializes the fechner driver.
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 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, isExposing, isReadingOut, 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

OK

public static final int OK

General return code from rpc calls indicating okay.

See Also:

Constant Field Values

XORGREM

public static final String XORGREM

Comment for entering x-pregap info to header.

See Also:

Constant Field Values

YORGREM

public static final String YORGREM

Comment for entering y-pregap info to header.

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_WRONGENDIAN

public static final String KEY_WRONGENDIAN

If true, endian of received short are little.

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_MANUALCLEAR

public static final String KEY_MANUALCLEAR

If true, we have to do a dummy exposure before every frame.

See Also:

Constant Field Values

DATESEND

public static final String DATESEND

Header keyword for send exposure start.

See Also:

Constant Field Values

DATESENDREM

public static final String DATESENDREM

Comment for send exposure start.

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

DEFWRONGENDIAN

private static final boolean DEFWRONGENDIAN

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

DEFRPCTIMEOUT

private static final int DEFRPCTIMEOUT

Default property value.

See Also:

Constant Field Values

ccdclient

private static StreamClient ccdclient

RPC client instance.

async

private MFits async

The data buffer for asynchroneous retrieval.

Constructor Detail

StreamingCcdDriver

public StreamingCcdDriver(Map<String,String> info)

Constructor. Does not open the connection, this is done in openController().

Method Detail

init

public void init()
          throws InitException

Clear any leftovers. Does not open the connection, this is done in openController().

Specified by:

init in interface Initializable

Overrides:

init in class AbstractCcdDriver

Throws:

InitException

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.

Returns:

True, if a previous initialization was successful

close

public boolean close()
              throws IOException

Close the RPC communication.

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:

xmax - maximum CCD size in x-direction (1 <= value < 65536)

ymax - maximum CCD size in y-direction (1 <= value < 65536)

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

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

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.

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

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.

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.

Returns:

current exposure time (in milliseconds).

Throws:

IOException - Any subclass of 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.

Throws:

IOException - Any subclass of IOException.

getCcdInfo

public Map<String,Object> getCcdInfo()

This ccd does not provide any additional info.

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.

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.

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.

Returns:

Number of pixel writtn..

Throws:

IOException - Any subclass of IOException.

getPregap

private Point getPregap()
                 throws IOException

Returns the pregap. Returns property setting if not open.

Throws:

IOException

getReadoutArea

private Dimension getReadoutArea()
                          throws IOException

Returns read-ouyt area as a dimension. 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.

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

doExposure

private boolean doExposure()
                    throws IOException

Does an exposure. This method calls the RPC-method StreamClient.DO_EXPOSURE_1(ccd.cmd), grabs the returned fits object and transforms it to the more general ImageHDU 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.

Throws:

IOException