ccd

Class SynchronousCcdDriver

java.lang.Object

util.PropertyContainer

io.AbstractDriver

ccd.AbstractCcdDriver

ccd.SynchronousCcdDriver

All Implemented Interfaces:

CcdDriver, Continuous, Driver, Cloneable, Initializable, PropertySupplying

Direct Known Subclasses:

AbstractGigeDriver, E2VDriver, FechnerDriver, FireDriver, MagellanDriver, MagellanDriver, MagellanDriver, ScienceCcdDriver, SesDriver, StreamingCcdDriver

public abstract class SynchronousCcdDriver
extends AbstractCcdDriver
implements Continuous

A blocking ccd-driver acts on the CcdDriver.expose(), CcdDriver.exposeBias(), and CcdDriver.exposeDark() methods. This abstract base class allows the #startExpose and #startDarkExpose to be wrapped around.

See Also:

AsynchronousCcdDriver

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	SynchronousCcdDriver.ExposureThread An exposure thread simly calls CcdDriver.expose() or CcdDriver.exposeDark(), depending on the argument it was constructed with.
private class	SynchronousCcdDriver.MakeImage The thread that does continuous exposures.
private class	SynchronousCcdDriver.ReduceImage This thread does the reduction of CCD data to a level that a list of detected stars can be retrieved.
static class	SynchronousCcdDriver.ThreadShot Class to take a ccd driver as the first command line argument, open it and make a science exposure.

Nested classes/interfaces inherited from class ccd.AbstractCcdDriver

AbstractCcdDriver.Endurance, AbstractCcdDriver.Exposure, AbstractCcdDriver.Shot

Field Summary

Fields

Modifier and Type	Field and Description
private Object	ccdlock And my lock.
private static long	CONTJOIN
private int	curcount The current exposure number, used by exposure thread, set reduced.
private SynchronousCcdDriver.MakeImage	doexpose For continuous exposures.
private SynchronousCcdDriver.ReduceImage	doreduce For continuous exposures.
private Thread	running A thread that exposes.

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

Modifier	Constructor and Description
protected	SynchronousCcdDriver(Map<String,String> info) Constructor.

Method Summary

Modifier and Type	Method and Description
void	cancelContinuous() Stops a continuous guiding exposure.
boolean	ensureReady() We are ready if we either have no exposure thread or if this thread is dead.
protected Thread	getRunning()
boolean	isExposing() We are exposing if the running thread is not equal null and alive.
boolean	isReadingOut() We are exposing if the running thread is not equal null and alive.
boolean	startContinuous(ReadoutProviding frame, ImageProcessing process) Starts a continuous guiding exposure.
void	stopContinuous() Asks for the continuous loop of exposures to stop.
Thread	threadedBiasExpose() Starts a bias exposure.
Thread	threadedDarkExpose() Starts a dark exposure.
Thread	threadedExpose() Starts an exposure.

Methods inherited from class ccd.AbstractCcdDriver

getDetectorSize, getMaximumExposureTime, getMinimumExposureTime, getReadoutMaximum, getReadoutTime, init, open, openController

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

expose, exposeBias, exposeDark, getBinning, getCcdInfo, getData, getDetectorSize, getExposureTime, getMaximumExposureTime, getMinimumExposureTime, getReadoutMaximum, getReadoutTime, getWindow, setBinning, setExposureTime, setWindow

Methods inherited from interface io.Driver

close, getDriverName, isOpen, open

Methods inherited from interface util.Initializable

init

Field Detail

CONTJOIN

private static final long CONTJOIN

See Also:

Constant Field Values

running

private Thread running

A thread that exposes. Initialized with threadedExpose().

doexpose

private SynchronousCcdDriver.MakeImage doexpose

For continuous exposures.

doreduce

private SynchronousCcdDriver.ReduceImage doreduce

For continuous exposures.

curcount

private int curcount

The current exposure number, used by exposure thread, set reduced.

ccdlock

private final Object ccdlock

And my lock.

Constructor Detail

SynchronousCcdDriver

protected SynchronousCcdDriver(Map<String,String> info)

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

Method Detail

threadedExpose

public Thread threadedExpose()
                      throws IOException

Starts an exposure. This method generates a thread and starts it that calls the CcdDriver.expose() method. The thread returned will be interrupted if an I/O error occurs during reading.

Specified by:

threadedExpose in interface CcdDriver

Returns:

The thread that ends when the exposure is done.

Throws:

IOException - Any subclass of IOException.

See Also:

expose

threadedDarkExpose

public Thread threadedDarkExpose()
                          throws IOException

Starts a dark exposure. This method generates a thread and starts it that calls the CcdDriver.exposeDark() method. The thread returned will be interrupted if an I/O error occurs during reading.

Specified by:

threadedDarkExpose in interface CcdDriver

Returns:

The thread that ends when the exposure is done.

Throws:

IOException - Any subclass of IOException.

See Also:

expose

threadedBiasExpose

public Thread threadedBiasExpose()
                          throws IOException

Starts a bias exposure. This method generates a thread and starts it that calls the CcdDriver.exposeDark() method. The thread returned will be interrupted if an I/O error occurs during reading.

Specified by:

threadedBiasExpose in interface CcdDriver

Returns:

The thread that ends when the exposure is done.

Throws:

IOException - Any subclass of IOException.

See Also:

expose

isExposing

public boolean isExposing()

We are exposing if the running thread is not equal null and alive.

Specified by:

isExposing in interface CcdDriver

isReadingOut

public boolean isReadingOut()

We are exposing if the running thread is not equal null and alive.

Specified by:

isReadingOut in interface CcdDriver

ensureReady

public boolean ensureReady()

We are ready if we either have no exposure thread or if this thread is dead.

Specified by:

ensureReady in interface CcdDriver

Returns:

True, if data is ready.

startContinuous

public boolean startContinuous(ReadoutProviding frame,
                               ImageProcessing process)

Starts a continuous guiding exposure. This method starts two thread, one doing the exposure and one doing the reduction of the image taken. Until the continuous guiding is stopped with stopContinuous(), each new image is piped after arrival to ImageProcessing.processFits(MFits, Rectangle, Dimension, double, Date, int) .

Specified by:

startContinuous in interface Continuous

cancelContinuous

public void cancelContinuous()

Stops a continuous guiding exposure.

Specified by:

cancelContinuous in interface Continuous

See Also:

Continuous.stopContinuous()

stopContinuous

public void stopContinuous()

Description copied from interface: Continuous

Asks for the continuous loop of exposures to stop. This method should block until all resources have been freed again and the exposures really ceased.

Specified by:

stopContinuous in interface Continuous

See Also:

Continuous.cancelContinuous()

getRunning

protected Thread getRunning()

Returns:

the running thread