Package gda.device.detector.buffereddetector

Class EpicsScanData

java.lang.Object

gda.factory.ConfigurableBase

gda.factory.FindableConfigurableBase

gda.device.DeviceBase

gda.device.scannable.ScannableBase

gda.device.detector.DetectorBase

gda.device.detector.buffereddetector.EpicsScanData

All Implemented Interfaces:

Detector, BufferedDetector, Device, Scannable, InitializationListener, Configurable, Findable, gda.observable.IObservable, Serializable

public class EpicsScanData
extends DetectorBase
implements BufferedDetector, InitializationListener

Untested on hardware! This is simply coded against the information in the Controls group wiki for the moment...

Operates the Epics Scan Data Template in ContinuousScans when the motion is controlled by an Epics Trajectory template and the detector this class represetns is to be read from an Epics ScanData template.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static String	counterPV
static String	detNPV
static String	numDetectorsPV
static String	numReadElementsPV
static String	startReadIndexPV
static String	updatePV

Fields inherited from class gda.device.detector.DetectorBase

collectionTime

Fields inherited from class gda.device.scannable.ScannableBase

__doc__, DEFAULT_INPUT_NAME, DEFAULT_OUTPUT_FORMAT, extraNames, inputNames, level, outputFormat

Fields inherited from class gda.device.DeviceBase

DEFAULT_PROTECTION_LEVEL_PROPERTY

Fields inherited from interface gda.device.Detector

BUSY, FAULT, IDLE, MONITORING, PAUSED, STANDBY

Fields inherited from interface gda.device.Scannable

ATTR_NEXUS_CATEGORY, ATTR_NX_CLASS, DEFAULT_INPUT_NAME, VALUE_UNAVAILABLE

Constructor Summary

Constructors

Constructor	Description
EpicsScanData()

Method Summary

Modifier and Type	Method	Description
void	clearMemory()	Clears the detector memory
void	collectData()	Tells the detector to begin to collect a set of data, then returns immediately.
void	configure()	Default implementation for classes that do not have to do any specific configuration. Classes that do their own configuration should *not* call this superclass function, as it may cause the object to appear configured before it really is.
boolean	createsOwnFiles()	Returns a value which indicates whether the detector creates its own files.
ContinuousParameters	getContinuousParameters()
String	getDescription()
String	getDetectorID()
String	getDetectorType()
int	getNumberFrames()
int	getStatus()	Returns the current collecting state of the device.
void	initializationCompleted()	Called when all critical channels are connected.
boolean	isContinuousMode()
int	maximumReadFrames()	As certain detectors may cause memory issues if too many frames are attempted to be read in one go, this is the maximum for this detector based on its current configuration (i.e.
Object[]	readAllFrames()	An array of the data from the detector.
Object[]	readFrames(int startFrame, int finalFrame)	An array of the data from the detector.
Object	readout()	Returns the latest data collected.
void	setContinuousMode(boolean on)	When in slave mode the detector will be triggered by an external signal to collect each frame of data.
void	setContinuousParameters(ContinuousParameters parameters)	Sets the parameters which define the continuous movement to use

Methods inherited from class gda.device.detector.DetectorBase

asynchronousMoveTo, checkPositionValid, endCollection, getCollectionTime, getDataDimensions, getPosition, isBusy, prepareForCollection, setCollectionTime, toFormattedString

Methods inherited from class gda.device.scannable.ScannableBase

__call__, __call__, __doc__, __getitem__, __len__, __repr__, __str__, atCommandFailure, atLevelEnd, atLevelMoveStart, atLevelStart, atPointEnd, atPointStart, atScanEnd, atScanLineEnd, atScanLineStart, atScanStart, externalToInternal, getExtraNames, getInputNames, getLevel, getOutputFormat, getScanMetadataAttribute, getScanMetadataAttributeNames, getScanMetadataAttributes, internalToExternal, isAt, moveTo, rawAsynchronousMoveTo, rawGetPosition, setExtraNames, setInputNames, setLevel, setOutputFormat, setScanMetadataAttribute, setScanMetadataAttributes, stop, throwExceptionIfInvalidTarget, toString, validateScannable, valueUnavailableString, waitWhileBusy, waitWhileBusy

Methods inherited from class gda.device.DeviceBase

addIObserver, close, deleteIObserver, deleteIObservers, getAttribute, getName, getProtectionLevel, isBeingObserved, isConfigureAtStartup, notifyIObservers, setAttribute, setConfigureAtStartup, setName, setProtectionLevel

Methods inherited from class gda.factory.ConfigurableBase

isConfigured, reconfigure, setConfigured

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface gda.factory.Configurable

isConfigureAtStartup, isConfigured, reconfigure

Methods inherited from interface gda.device.Detector

endCollection, getCollectionTime, getDataDimensions, getFileStructure, prepareForCollection, setCollectionTime, waitWhileBusy

Methods inherited from interface gda.device.Device

close, getAttribute, getProtectionLevel, setAttribute, setProtectionLevel

Methods inherited from interface gda.factory.Findable

getName, setName

Methods inherited from interface gda.observable.IObservable

addIObserver, deleteIObserver, deleteIObservers

Methods inherited from interface gda.device.Scannable

asynchronousMoveTo, atCommandFailure, atLevelEnd, atLevelMoveStart, atLevelStart, atPointEnd, atPointStart, atScanEnd, atScanLineEnd, atScanLineStart, atScanStart, checkPositionValid, getExtraNames, getInputNames, getLevel, getOutputFormat, getPosition, getScanMetadataAttribute, getScanMetadataAttributeNames, getScanMetadataAttributes, isAt, isBusy, moveTo, setExtraNames, setInputNames, setLevel, setOutputFormat, setScanMetadataAttribute, setScanMetadataAttributes, stop, toFormattedString

Field Details

counterPV

public static String counterPV

startReadIndexPV

public static String startReadIndexPV

numReadElementsPV

public static String numReadElementsPV

updatePV

public static String updatePV

numDetectorsPV

public static String numDetectorsPV

detNPV

public static String detNPV

Constructor Details

EpicsScanData

public EpicsScanData()

Method Details

configure

public void configure()
               throws FactoryException

Description copied from class: ConfigurableBase

Default implementation for classes that do not have to do any specific configuration.
Classes that do their own configuration should *not* call this superclass function, as it may cause the object to appear configured before it really is.

Specified by:

configure in interface Configurable

Overrides:

configure in class ConfigurableBase

Throws:

FactoryException - if there is an error in configuration e.g. required variable not set or cannot connect to device

initializationCompleted

public void initializationCompleted()

Description copied from interface: InitializationListener

Called when all critical channels are connected.

Specified by:

initializationCompleted in interface InitializationListener

clearMemory

public void clearMemory()
                 throws DeviceException

Description copied from interface: BufferedDetector

Clears the detector memory

Specified by:

clearMemory in interface BufferedDetector

Throws:

DeviceException

getContinuousParameters

public ContinuousParameters getContinuousParameters()
                                             throws DeviceException

Specified by:

getContinuousParameters in interface BufferedDetector

Returns:

ContinuousParameters

Throws:

DeviceException

getNumberFrames

public int getNumberFrames()
                    throws DeviceException

Specified by:

getNumberFrames in interface BufferedDetector

Returns:

number of frames of data in memory which have been collected

Throws:

DeviceException

isContinuousMode

public boolean isContinuousMode()
                         throws DeviceException

Specified by:

isContinuousMode in interface BufferedDetector

Returns:

true if the detector is ready to accept trigger pulses

Throws:

DeviceException

readAllFrames

public Object[] readAllFrames()
                       throws DeviceException

Description copied from interface: BufferedDetector

An array of the data from the detector. Each element is one frame of data.

Specified by:

readAllFrames in interface BufferedDetector

Returns:

Object

Throws:

DeviceException

readFrames

public Object[] readFrames(int startFrame,
 int finalFrame)
                    throws DeviceException

Description copied from interface: BufferedDetector

An array of the data from the detector. Each element is one frame of data. The first frame is 0.

Specified by:

readFrames in interface BufferedDetector

Parameters:

startFrame -

finalFrame -

Returns:

Object

Throws:

DeviceException

setContinuousMode

public void setContinuousMode(boolean on)
                       throws DeviceException

Description copied from interface: BufferedDetector

When in slave mode the detector will be triggered by an external signal to collect each frame of data.

Specified by:

setContinuousMode in interface BufferedDetector

Parameters:

on -

Throws:

DeviceException

setContinuousParameters

public void setContinuousParameters(ContinuousParameters parameters)
                             throws DeviceException

Description copied from interface: BufferedDetector

Sets the parameters which define the continuous movement to use

Specified by:

setContinuousParameters in interface BufferedDetector

Parameters:

parameters -

Throws:

DeviceException

collectData

public void collectData()
                 throws DeviceException

Description copied from interface: Detector

Tells the detector to begin to collect a set of data, then returns immediately. Should cause the hardware to start collecting immediately: if there is any delay then detectors used in the same scan would collect over different times when beam conditions may differ.

Specified by:

collectData in interface Detector

Throws:

DeviceException

createsOwnFiles

public boolean createsOwnFiles()
                        throws DeviceException

Description copied from interface: Detector

Returns a value which indicates whether the detector creates its own files. If it does (return true) the readout() method returns the name of the latest file created as a string. If it does not (return false) the readout() method will return the data directly.

Specified by:

createsOwnFiles in interface Detector

Returns:

true if readout() returns filenames

Throws:

DeviceException

getDescription

public String getDescription()
                      throws DeviceException

Specified by:

getDescription in interface Detector

Overrides:

getDescription in class DetectorBase

Returns:

A description of the detector.

Throws:

DeviceException

getDetectorID

public String getDetectorID()
                     throws DeviceException

Specified by:

getDetectorID in interface Detector

Overrides:

getDetectorID in class DetectorBase

Returns:

A identifier for this detector.

Throws:

DeviceException

getDetectorType

public String getDetectorType()
                       throws DeviceException

Specified by:

getDetectorType in interface Detector

Overrides:

getDetectorType in class DetectorBase

Returns:

The type of detector.

Throws:

DeviceException

getStatus

public int getStatus()
              throws DeviceException

Description copied from interface: Detector

Returns the current collecting state of the device.

Specified by:

getStatus in interface Detector

Returns:

BUSY if the detector has not finished the requested operation(s), IDLE if in an completely idle state and STANDBY if temporarily suspended.

Throws:

DeviceException

readout

public Object readout()
               throws DeviceException

Description copied from interface: Detector

Returns the latest data collected. The size of the Object returned must be consistent with the values returned by getDataDimensions and getExtraNames.

If LocalProperties.GDA_SCAN_CONCURRENTSCAN_READOUT_CONCURRENTLY is true then motors may be moved while the detector readouts. The value returned must not be effected by any concurrent motor or shutter movements. See Detector.waitWhileBusy() and ConcurrentScan. Readout must block until the detector is ready to respond quickly to Detector.collectData() again.

Specified by:

readout in interface Detector

Returns:

the data collected

Throws:

DeviceException

maximumReadFrames

public int maximumReadFrames()
                      throws DeviceException

Description copied from interface: BufferedDetector

As certain detectors may cause memory issues if too many frames are attempted to be read in one go, this is the maximum for this detector based on its current configuration (i.e. after setContinuousMode(True) has been called.

The lowest value returned from any of the detectors in a continuous scan will be the limit set.

If there is no limit then this method should return Integer.MAX_VALUE.

Specified by:

maximumReadFrames in interface BufferedDetector

Returns:

int - the maximum number of frames which should be read at any one time from this detector

Throws:

DeviceException