Package gda.device.detector.xmap

Class XmapBufferedDetector

java.lang.Object

gda.factory.ConfigurableBase

gda.factory.FindableConfigurableBase

gda.device.DeviceBase

gda.device.scannable.ScannableBase

gda.device.detector.DetectorBase

gda.device.detector.xmap.XmapBufferedDetector

All Implemented Interfaces:

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

public class XmapBufferedDetector
extends DetectorBase
implements BufferedDetector, NexusDetector

For using Xia XMap within the ContinuousScan-style trajectory scans.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected ContinuousParameters	continuousParameters
protected boolean	isContinuousMode

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
XmapBufferedDetector()

Method Summary

Modifier and Type	Method	Description
void	atCommandFailure()	Hook to be used by Scan and pos commands to inform the Scannable that an exception, such as a DeviceExcpetion, has occurred.
void	atScanEnd()	Called for every Scannable at the end of a group of nested scans (or a single scan if that is the case).
void	atScanLineStart()	Called for every Scannable at the start of every scan
void	atScanStart()	Called for every Scannable at the start of a group of nested scans (or a single scan if that is the case)
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.
String	convertPathFromWindows(String windowsDirForScan)
String	convertPathToWindows(String dataDirForScan)
boolean	createsOwnFiles()	Returns a value which indicates whether the detector creates its own files.
String	getCapturepv()
double	getCollectionTime()	Returns the time, in seconds, the detector collects for during the next call to collectData()
ContinuousParameters	getContinuousParameters()
EDXDMappingController	getController()
DAServer	getDaServer()
String	getDaServerName()
String	getDefaultSubDirectory()
String	getDescription()
String	getDetectorID()
String	getDetectorType()
String[]	getExtraNames()	Additional names for extra values that returned by getPosition().
String[]	getInputNames()	gets a array of InputNames used by moveTo of this scannable.
int	getNumberFrames()
String[]	getOutputFormat()	Returns an array of strings which are the format strings to use when pretty printing parts of the output
int	getStatus()	Returns the current collecting state of the device.
String	getWindowsPathPrefix()
NexusXmap	getXmap()
boolean	isContinuousMode()
boolean	isDeadTimeEnabled()
boolean	isSlave()
boolean	isStillWriting(String fileName)
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.
NexusTreeProvider	readout()	Returns the latest data collected.
void	setCapturepv(String stoppv)
void	setCollectionTime(double time)	Sets the collection time, in seconds, to be used during the next call of collectData.
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
void	setController(EDXDMappingController controller)
void	setDaServer(DAServer daServer)
void	setDaServerName(String daServerName)
void	setDeadTimeEnabled(boolean deadTimeEnabled)
void	setDefaultSubDirectory(String defaultSubDirectory)	Set name of subdirectory in data directory where detector Hdf5 file should be written.
void	setSlave(boolean isSlave)
void	setWindowsPathPrefix(String windowsPathPrefix)
void	setXmap(NexusXmap xmap)
void	stop()	Stop the current move/operation.
void	stopAcq()
void	waitForFile()

Methods inherited from class gda.device.detector.DetectorBase

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

Methods inherited from class gda.device.scannable.ScannableBase

__call__, __call__, __doc__, __getitem__, __len__, __repr__, __str__, atLevelEnd, atLevelMoveStart, atLevelStart, atPointEnd, atPointStart, atScanLineEnd, externalToInternal, getLevel, getScanMetadataAttribute, getScanMetadataAttributeNames, getScanMetadataAttributes, internalToExternal, isAt, moveTo, rawAsynchronousMoveTo, rawGetPosition, setExtraNames, setInputNames, setLevel, setOutputFormat, setScanMetadataAttribute, setScanMetadataAttributes, 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, getDataDimensions, getFileStructure, prepareForCollection, 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, atLevelEnd, atLevelMoveStart, atLevelStart, atPointEnd, atPointStart, atScanLineEnd, checkPositionValid, getLevel, getPosition, getScanMetadataAttribute, getScanMetadataAttributeNames, getScanMetadataAttributes, isAt, isBusy, moveTo, setExtraNames, setInputNames, setLevel, setOutputFormat, setScanMetadataAttribute, setScanMetadataAttributes, toFormattedString

Field Details

continuousParameters

protected ContinuousParameters continuousParameters

isContinuousMode

protected boolean isContinuousMode

Constructor Details

XmapBufferedDetector

public XmapBufferedDetector()

Method Details

getXmap

public NexusXmap getXmap()

setXmap

public void setXmap(NexusXmap xmap)

getDaServerName

public String getDaServerName()

setDaServerName

public void setDaServerName(String daServerName)

getController

public EDXDMappingController getController()

setController

public void setController(EDXDMappingController controller)

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

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

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

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

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

getCollectionTime

public double getCollectionTime()
                         throws DeviceException

Description copied from interface: Detector

Returns the time, in seconds, the detector collects for during the next call to collectData()

Specified by:

getCollectionTime in interface Detector

Overrides:

getCollectionTime in class DetectorBase

Returns:

double

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

setCollectionTime

public void setCollectionTime(double time)
                       throws DeviceException

Description copied from interface: Detector

Sets the collection time, in seconds, to be used during the next call of collectData.

Specified by:

setCollectionTime in interface Detector

Overrides:

setCollectionTime in class DetectorBase

Parameters:

time - the collection time in seconds

Throws:

DeviceException

atScanStart

public void atScanStart()
                 throws DeviceException

Description copied from class: ScannableBase

Called for every Scannable at the start of a group of nested scans (or a single scan if that is the case) Default behaviour is to do nothing. Inheriting classes have the option to implement this if their specific behaviour requires it.

Specified by:

atScanStart in interface Scannable

Overrides:

atScanStart in class ScannableBase

Throws:

DeviceException

See Also:

• Scannable.atScanStart()

atScanEnd

public void atScanEnd()
               throws DeviceException

Description copied from class: ScannableBase

Called for every Scannable at the end of a group of nested scans (or a single scan if that is the case).

Note that this is only called if the Scan finishes normally, or has been requested to finish early. This will not be called if the scan finishes due to an exception of any kind. See Scannable.atCommandFailure() Default behaviour is to do nothing. Inheriting classes have the option to implement this if their specific behaviour requires it.

Specified by:

atScanEnd in interface Scannable

Overrides:

atScanEnd in class ScannableBase

Throws:

DeviceException

See Also:

• Scannable.atScanEnd()

atCommandFailure

public void atCommandFailure()
                      throws DeviceException

Description copied from class: ScannableBase

Hook to be used by Scan and pos commands to inform the Scannable that an exception, such as a DeviceExcpetion, has occurred. However not called when the command is aborted using an InterruptionException. If a Scan is aborted then only Scannable.stop() will be called by the Scan or pos command.

Useful for telling Scannables which hold state during a scan for example, to reset themselves. Used for example by CoordinatedMotionScannables. This hook should be used not in the same way as the stop hook. Default behaviour is to do nothing. Inheriting classes have the option to implement this if their specific behaviour requires it.

Specified by:

atCommandFailure in interface Scannable

Overrides:

atCommandFailure in class ScannableBase

Throws:

DeviceException

See Also:

• Scannable.atCommandFailure()

atScanLineStart

public void atScanLineStart()
                     throws DeviceException

Description copied from class: ScannableBase

Called for every Scannable at the start of every scan Default behaviour is to do nothing. Inheriting classes have the option to implement this if their specific behaviour requires it.

Specified by:

atScanLineStart in interface Scannable

Overrides:

atScanLineStart in class ScannableBase

Throws:

DeviceException

See Also:

• Scannable.atScanLineStart()

getInputNames

public String[] getInputNames()

Description copied from interface: Scannable

gets a array of InputNames used by moveTo of this scannable.

Specified by:

getInputNames in interface Scannable

Overrides:

getInputNames in class ScannableBase

Returns:

array of the names of the elements of the object returned by getPosition

getExtraNames

public String[] getExtraNames()

Description copied from interface: Scannable

Additional names for extra values that returned by getPosition().

Specified by:

getExtraNames in interface Scannable

Overrides:

getExtraNames in class ScannableBase

Returns:

array of names of the extra elements if the array returned by getPosition is larger than the array required by moveTo

getOutputFormat

public String[] getOutputFormat()

Description copied from interface: Scannable

Returns an array of strings which are the format strings to use when pretty printing parts of the output

Specified by:

getOutputFormat in interface Scannable

Overrides:

getOutputFormat in class ScannableBase

Returns:

string array

stop

public void stop()
          throws DeviceException

Description copied from class: ScannableBase

Stop the current move/operation. Default behaviour is to do nothing. Inheriting classes have the option to implement this if their specific behaviour requires it.

Specified by:

stop in interface Scannable

Overrides:

stop in class ScannableBase

Throws:

DeviceException

See Also:

• Scannable.stop()

readout

public NexusTreeProvider 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

Specified by:

readout in interface NexusDetector

Returns:

the data collected

Throws:

DeviceException

isStillWriting

public boolean isStillWriting(String fileName)
                       throws DeviceException

Throws:

DeviceException

waitForFile

public void waitForFile()
                 throws InterruptedException

Throws:

InterruptedException

isSlave

public boolean isSlave()

setSlave

public void setSlave(boolean isSlave)

setDaServer

public void setDaServer(DAServer daServer)

getDaServer

public DAServer getDaServer()

getCapturepv

public String getCapturepv()

setCapturepv

public void setCapturepv(String stoppv)

stopAcq

public void stopAcq()

isDeadTimeEnabled

public boolean isDeadTimeEnabled()

setDeadTimeEnabled

public void setDeadTimeEnabled(boolean deadTimeEnabled)

getDefaultSubDirectory

public String getDefaultSubDirectory()

setDefaultSubDirectory

public void setDefaultSubDirectory(String defaultSubDirectory)

Set name of subdirectory in data directory where detector Hdf5 file should be written.

Parameters:

defaultSubDirectory -

convertPathToWindows

public String convertPathToWindows(String dataDirForScan)

convertPathFromWindows

public String convertPathFromWindows(String windowsDirForScan)

getWindowsPathPrefix

public String getWindowsPathPrefix()

setWindowsPathPrefix

public void setWindowsPathPrefix(String windowsPathPrefix)