areaDetector  3-7-0
EPICS areaDetector framework
Public Member Functions | Protected Attributes | List of all members
NDPluginStats Class Reference

Does image statistics. More...

#include <NDPluginStats.h>

Inheritance diagram for NDPluginStats:
NDPluginDriver asynNDArrayDriver

Public Member Functions

 NDPluginStats (const char *portName, int queueSize, int blockingCallbacks, const char *NDArrayPort, int NDArrayAddr, int maxBuffers, size_t maxMemory, int priority, int stackSize, int maxThreads=1)
 Constructor for NDPluginStats; most parameters are simply passed to NDPluginDriver::NDPluginDriver. More...
 
void processCallbacks (NDArray *pArray)
 Callback function that is called by the NDArray driver with new NDArray data. More...
 
asynStatus writeInt32 (asynUser *pasynUser, epicsInt32 value)
 Called when asyn clients call pasynInt32->write(). More...
 
asynStatus writeFloat64 (asynUser *pasynUser, epicsFloat64 value)
 Called when asyn clients call pasynFloat64->write(). More...
 
template<typename epicsType >
void doComputeStatisticsT (NDArray *pArray, NDStats_t *pStats)
 
int doComputeStatistics (NDArray *pArray, NDStats_t *pStats)
 
template<typename epicsType >
asynStatus doComputeCentroidT (NDArray *pArray, NDStats_t *pStats)
 
asynStatus doComputeCentroid (NDArray *pArray, NDStats_t *pStats)
 
template<typename epicsType >
asynStatus doComputeProfilesT (NDArray *pArray, NDStats_t *pStats)
 
asynStatus doComputeProfiles (NDArray *pArray, NDStats_t *pStats)
 
template<typename epicsType >
asynStatus doComputeHistogramT (NDArray *pArray, NDStats_t *pStats)
 
asynStatus doComputeHistogram (NDArray *pArray, NDStats_t *pStats)
 
- Public Member Functions inherited from NDPluginDriver
 NDPluginDriver (const char *portName, int queueSize, int blockingCallbacks, const char *NDArrayPort, int NDArrayAddr, int maxAddr, int maxBuffers, size_t maxMemory, int interfaceMask, int interruptMask, int asynFlags, int autoConnect, int priority, int stackSize, int maxThreads, bool compressionAware=false)
 Constructor for NDPluginDriver; most parameters are simply passed to asynNDArrayDriver::asynNDArrayDriver. More...
 
 ~NDPluginDriver ()
 
virtual asynStatus writeOctet (asynUser *pasynUser, const char *value, size_t maxChars, size_t *nActual)
 Called when asyn clients call pasynOctet->write(). More...
 
virtual asynStatus readInt32Array (asynUser *pasynUser, epicsInt32 *value, size_t nElements, size_t *nIn)
 Called when asyn clients call pasynInt32Array->read(). More...
 
virtual void driverCallback (asynUser *pasynUser, void *genericPointer)
 Method that is called from the driver with a new NDArray. More...
 
virtual void run (void)
 Starts the thread that receives NDArrays from the epicsMessageQueue. More...
 
virtual asynStatus start (void)
 Starts the plugin threads. More...
 
void sortingTask ()
 Method runs as a separate thread, periodically doing NDArray callbacks to downstream plugins. More...
 
- Public Member Functions inherited from asynNDArrayDriver
 asynNDArrayDriver (const char *portName, int maxAddr, int maxBuffers, size_t maxMemory, int interfaceMask, int interruptMask, int asynFlags, int autoConnect, int priority, int stackSize)
 This is the constructor for the asynNDArrayDriver class. More...
 
virtual ~asynNDArrayDriver ()
 
virtual asynStatus readGenericPointer (asynUser *pasynUser, void *genericPointer)
 This method copies an NDArray object from the asynNDArrayDriver to an NDArray pointer passed in by the caller. More...
 
virtual asynStatus writeGenericPointer (asynUser *pasynUser, void *genericPointer)
 This method currently does nothing, but it should be implemented in this base class. More...
 
virtual asynStatus readInt32 (asynUser *pasynUser, epicsInt32 *value)
 
virtual asynStatus readFloat64 (asynUser *pasynUser, epicsFloat64 *value)
 
virtual void report (FILE *fp, int details)
 Report status of the driver. More...
 
virtual asynStatus createFilePath (const char *path, int pathDepth)
 Function to create a directory path for a file. More...
 
virtual asynStatus checkPath ()
 Checks whether the directory specified NDFilePath parameter exists. More...
 
virtual bool checkPath (std::string &filePath)
 Checks whether the directory specified exists. More...
 
virtual asynStatus createFileName (int maxChars, char *fullFileName)
 Build a file name from component parts. More...
 
virtual asynStatus createFileName (int maxChars, char *filePath, char *fileName)
 Build a file name from component parts. More...
 
virtual asynStatus readNDAttributesFile ()
 Create this driver's NDAttributeList (pAttributeList) by reading an XML file This clears any existing attributes from this drivers' NDAttributeList and then creates a new list based on the XML file. More...
 
virtual asynStatus getAttributes (NDAttributeList *pAttributeList)
 Get the current values of attributes from this driver and appends them to an output attribute list. More...
 
asynStatus incrementQueuedArrayCount ()
 
asynStatus decrementQueuedArrayCount ()
 
int getQueuedArrayCount ()
 
void updateQueuedArrayCount ()
 

Protected Attributes

int NDPluginStatsComputeStatistics
 
int NDPluginStatsBgdWidth
 
int NDPluginStatsMinValue
 
int NDPluginStatsMinX
 
int NDPluginStatsMinY
 
int NDPluginStatsMaxValue
 
int NDPluginStatsMaxX
 
int NDPluginStatsMaxY
 
int NDPluginStatsMeanValue
 
int NDPluginStatsSigmaValue
 
int NDPluginStatsTotal
 
int NDPluginStatsNet
 
int NDPluginStatsComputeCentroid
 
int NDPluginStatsCentroidThreshold
 
int NDPluginStatsCentroidTotal
 
int NDPluginStatsCentroidX
 
int NDPluginStatsCentroidY
 
int NDPluginStatsSigmaX
 
int NDPluginStatsSigmaY
 
int NDPluginStatsSigmaXY
 
int NDPluginStatsSkewX
 
int NDPluginStatsSkewY
 
int NDPluginStatsKurtosisX
 
int NDPluginStatsKurtosisY
 
int NDPluginStatsEccentricity
 
int NDPluginStatsOrientation
 
int NDPluginStatsComputeProfiles
 
int NDPluginStatsProfileSizeX
 
int NDPluginStatsProfileSizeY
 
int NDPluginStatsCursorX
 
int NDPluginStatsCursorY
 
int NDPluginStatsProfileAverageX
 
int NDPluginStatsProfileAverageY
 
int NDPluginStatsProfileThresholdX
 
int NDPluginStatsProfileThresholdY
 
int NDPluginStatsProfileCentroidX
 
int NDPluginStatsProfileCentroidY
 
int NDPluginStatsProfileCursorX
 
int NDPluginStatsProfileCursorY
 
int NDPluginStatsComputeHistogram
 
int NDPluginStatsHistSize
 
int NDPluginStatsHistMin
 
int NDPluginStatsHistMax
 
int NDPluginStatsHistBelow
 
int NDPluginStatsHistAbove
 
int NDPluginStatsHistEntropy
 
int NDPluginStatsHistArray
 
int NDPluginStatsHistXArray
 
- Protected Attributes inherited from NDPluginDriver
int NDPluginDriverArrayPort
 
int NDPluginDriverArrayAddr
 
int NDPluginDriverPluginType
 
int NDPluginDriverDroppedArrays
 
int NDPluginDriverQueueSize
 
int NDPluginDriverQueueFree
 
int NDPluginDriverMaxThreads
 
int NDPluginDriverNumThreads
 
int NDPluginDriverSortMode
 
int NDPluginDriverSortTime
 
int NDPluginDriverSortSize
 
int NDPluginDriverSortFree
 
int NDPluginDriverDisorderedArrays
 
int NDPluginDriverDroppedOutputArrays
 
int NDPluginDriverEnableCallbacks
 
int NDPluginDriverBlockingCallbacks
 
int NDPluginDriverProcessPlugin
 
int NDPluginDriverExecutionTime
 
int NDPluginDriverMinCallbackTime
 
int NDPluginDriverMaxByteRate
 
NDArraypPrevInputArray_
 
- Protected Attributes inherited from asynNDArrayDriver
int NDPortNameSelf
 
int NDADCoreVersion
 
int NDDriverVersion
 
int NDArraySizeX
 
int NDArraySizeY
 
int NDArraySizeZ
 
int NDArraySize
 
int NDNDimensions
 
int NDDimensions
 
int NDDataType
 
int NDColorMode
 
int NDUniqueId
 
int NDTimeStamp
 
int NDEpicsTSSec
 
int NDEpicsTSNsec
 
int NDBayerPattern
 
int NDCodec
 
int NDCompressedSize
 
int NDArrayCounter
 
int NDFilePath
 
int NDFilePathExists
 
int NDFileName
 
int NDFileNumber
 
int NDFileTemplate
 
int NDAutoIncrement
 
int NDFullFileName
 
int NDFileFormat
 
int NDAutoSave
 
int NDWriteFile
 
int NDReadFile
 
int NDFileWriteMode
 
int NDFileWriteStatus
 
int NDFileWriteMessage
 
int NDFileNumCapture
 
int NDFileNumCaptured
 
int NDFileCapture
 
int NDFileDeleteDriverFile
 
int NDFileLazyOpen
 
int NDFileCreateDir
 
int NDFileTempSuffix
 
int NDAttributesFile
 
int NDAttributesStatus
 
int NDAttributesMacros
 
int NDArrayData
 
int NDArrayCallbacks
 
int NDPoolMaxBuffers
 
int NDPoolAllocBuffers
 
int NDPoolFreeBuffers
 
int NDPoolMaxMemory
 
int NDPoolUsedMemory
 
int NDPoolEmptyFreeList
 
int NDNumQueuedArrays
 
class NDArray ** pArrays
 An array of NDArray pointers used to store data in the driver. More...
 
class NDAttributeListpAttributeList
 An NDAttributeList object used to obtain the current values of a set of attributes. More...
 
int threadStackSize_
 
int threadPriority_
 

Additional Inherited Members

- Public Attributes inherited from asynNDArrayDriver
class NDArrayPoolpNDArrayPool
 An NDArrayPool pointer that is initialized to pNDArrayPoolPvt_ in the constructor. More...
 
- Protected Member Functions inherited from NDPluginDriver
virtual void beginProcessCallbacks (NDArray *pArray)
 Method that is normally called at the beginning of the processCallbacks method in derived classes. More...
 
virtual asynStatus endProcessCallbacks (NDArray *pArray, bool copyArray=false, bool readAttributes=true)
 Method that is normally called at the end of the processCallbacks()) method in derived classes. More...
 
virtual asynStatus connectToArrayPort (void)
 Connect this plugin to an NDArray port driver; disconnect from any existing driver first, register for callbacks if enabled. More...
 
virtual asynStatus setArrayInterrupt (int connect)
 Register or unregister to receive asynGenericPointer (NDArray) callbacks from the driver. More...
 
bool throttled (NDArray *pArray)
 

Detailed Description

Does image statistics.

These include Min, max, mean, sigma X and Y centroid and sigma Histogram

Constructor & Destructor Documentation

◆ NDPluginStats()

NDPluginStats::NDPluginStats ( const char *  portName,
int  queueSize,
int  blockingCallbacks,
const char *  NDArrayPort,
int  NDArrayAddr,
int  maxBuffers,
size_t  maxMemory,
int  priority,
int  stackSize,
int  maxThreads = 1 
)

Constructor for NDPluginStats; most parameters are simply passed to NDPluginDriver::NDPluginDriver.

After calling the base class constructor this method sets reasonable default values for all of the parameters.

Parameters
[in]portNameThe name of the asyn port driver to be created.
[in]queueSizeThe number of NDArrays that the input queue for this plugin can hold when NDPluginDriverBlockingCallbacks=0. Larger queues can decrease the number of dropped arrays, at the expense of more NDArray buffers being allocated from the underlying driver's NDArrayPool.
[in]blockingCallbacksInitial setting for the NDPluginDriverBlockingCallbacks flag. 0=callbacks are queued and executed by the callback thread; 1 callbacks execute in the thread of the driver doing the callbacks.
[in]NDArrayPortName of asyn port driver for initial source of NDArray callbacks.
[in]NDArrayAddrasyn port driver address for initial source of NDArray callbacks.
[in]maxBuffersThe maximum number of NDArray buffers that the NDArrayPool for this driver is allowed to allocate. Set this to -1 to allow an unlimited number of buffers.
[in]maxMemoryThe maximum amount of memory that the NDArrayPool for this driver is allowed to allocate. Set this to -1 to allow an unlimited amount of memory.
[in]priorityThe thread priority for the asyn port driver thread if ASYN_CANBLOCK is set in asynFlags.
[in]stackSizeThe stack size for the asyn port driver thread if ASYN_CANBLOCK is set in asynFlags.
[in]maxThreadsThe maximum number of threads this driver is allowed to use. If 0 then 1 will be used.

Member Function Documentation

◆ doComputeCentroid()

asynStatus NDPluginStats::doComputeCentroid ( NDArray pArray,
NDStats_t pStats 
)

◆ doComputeCentroidT()

template<typename epicsType >
asynStatus NDPluginStats::doComputeCentroidT ( NDArray pArray,
NDStats_t pStats 
)

◆ doComputeHistogram()

asynStatus NDPluginStats::doComputeHistogram ( NDArray pArray,
NDStats_t pStats 
)

◆ doComputeHistogramT()

template<typename epicsType >
asynStatus NDPluginStats::doComputeHistogramT ( NDArray pArray,
NDStats_t pStats 
)

◆ doComputeProfiles()

asynStatus NDPluginStats::doComputeProfiles ( NDArray pArray,
NDStats_t pStats 
)

◆ doComputeProfilesT()

template<typename epicsType >
asynStatus NDPluginStats::doComputeProfilesT ( NDArray pArray,
NDStats_t pStats 
)

◆ doComputeStatistics()

int NDPluginStats::doComputeStatistics ( NDArray pArray,
NDStats_t pStats 
)

◆ doComputeStatisticsT()

template<typename epicsType >
void NDPluginStats::doComputeStatisticsT ( NDArray pArray,
NDStats_t pStats 
)

◆ processCallbacks()

void NDPluginStats::processCallbacks ( NDArray pArray)
virtual

Callback function that is called by the NDArray driver with new NDArray data.

Does image statistics.

Parameters
[in]pArrayThe NDArray from the callback.

Implements NDPluginDriver.

◆ writeFloat64()

asynStatus NDPluginStats::writeFloat64 ( asynUser *  pasynUser,
epicsFloat64  value 
)
virtual

Called when asyn clients call pasynFloat64->write().

This function performs actions for some parameters. For all parameters it sets the value in the parameter library and calls any registered callbacks..

Parameters
[in]pasynUserpasynUser structure that encodes the reason and address.
[in]valueValue to write.

Reimplemented from NDPluginDriver.

◆ writeInt32()

asynStatus NDPluginStats::writeInt32 ( asynUser *  pasynUser,
epicsInt32  value 
)
virtual

Called when asyn clients call pasynInt32->write().

This function performs actions for some parameters. For all parameters it sets the value in the parameter library and calls any registered callbacks..

Parameters
[in]pasynUserpasynUser structure that encodes the reason and address.
[in]valueValue to write.

Reimplemented from NDPluginDriver.

Member Data Documentation

◆ NDPluginStatsBgdWidth

int NDPluginStats::NDPluginStatsBgdWidth
protected

◆ NDPluginStatsCentroidThreshold

int NDPluginStats::NDPluginStatsCentroidThreshold
protected

◆ NDPluginStatsCentroidTotal

int NDPluginStats::NDPluginStatsCentroidTotal
protected

◆ NDPluginStatsCentroidX

int NDPluginStats::NDPluginStatsCentroidX
protected

◆ NDPluginStatsCentroidY

int NDPluginStats::NDPluginStatsCentroidY
protected

◆ NDPluginStatsComputeCentroid

int NDPluginStats::NDPluginStatsComputeCentroid
protected

◆ NDPluginStatsComputeHistogram

int NDPluginStats::NDPluginStatsComputeHistogram
protected

◆ NDPluginStatsComputeProfiles

int NDPluginStats::NDPluginStatsComputeProfiles
protected

◆ NDPluginStatsComputeStatistics

int NDPluginStats::NDPluginStatsComputeStatistics
protected

◆ NDPluginStatsCursorX

int NDPluginStats::NDPluginStatsCursorX
protected

◆ NDPluginStatsCursorY

int NDPluginStats::NDPluginStatsCursorY
protected

◆ NDPluginStatsEccentricity

int NDPluginStats::NDPluginStatsEccentricity
protected

◆ NDPluginStatsHistAbove

int NDPluginStats::NDPluginStatsHistAbove
protected

◆ NDPluginStatsHistArray

int NDPluginStats::NDPluginStatsHistArray
protected

◆ NDPluginStatsHistBelow

int NDPluginStats::NDPluginStatsHistBelow
protected

◆ NDPluginStatsHistEntropy

int NDPluginStats::NDPluginStatsHistEntropy
protected

◆ NDPluginStatsHistMax

int NDPluginStats::NDPluginStatsHistMax
protected

◆ NDPluginStatsHistMin

int NDPluginStats::NDPluginStatsHistMin
protected

◆ NDPluginStatsHistSize

int NDPluginStats::NDPluginStatsHistSize
protected

◆ NDPluginStatsHistXArray

int NDPluginStats::NDPluginStatsHistXArray
protected

◆ NDPluginStatsKurtosisX

int NDPluginStats::NDPluginStatsKurtosisX
protected

◆ NDPluginStatsKurtosisY

int NDPluginStats::NDPluginStatsKurtosisY
protected

◆ NDPluginStatsMaxValue

int NDPluginStats::NDPluginStatsMaxValue
protected

◆ NDPluginStatsMaxX

int NDPluginStats::NDPluginStatsMaxX
protected

◆ NDPluginStatsMaxY

int NDPluginStats::NDPluginStatsMaxY
protected

◆ NDPluginStatsMeanValue

int NDPluginStats::NDPluginStatsMeanValue
protected

◆ NDPluginStatsMinValue

int NDPluginStats::NDPluginStatsMinValue
protected

◆ NDPluginStatsMinX

int NDPluginStats::NDPluginStatsMinX
protected

◆ NDPluginStatsMinY

int NDPluginStats::NDPluginStatsMinY
protected

◆ NDPluginStatsNet

int NDPluginStats::NDPluginStatsNet
protected

◆ NDPluginStatsOrientation

int NDPluginStats::NDPluginStatsOrientation
protected

◆ NDPluginStatsProfileAverageX

int NDPluginStats::NDPluginStatsProfileAverageX
protected

◆ NDPluginStatsProfileAverageY

int NDPluginStats::NDPluginStatsProfileAverageY
protected

◆ NDPluginStatsProfileCentroidX

int NDPluginStats::NDPluginStatsProfileCentroidX
protected

◆ NDPluginStatsProfileCentroidY

int NDPluginStats::NDPluginStatsProfileCentroidY
protected

◆ NDPluginStatsProfileCursorX

int NDPluginStats::NDPluginStatsProfileCursorX
protected

◆ NDPluginStatsProfileCursorY

int NDPluginStats::NDPluginStatsProfileCursorY
protected

◆ NDPluginStatsProfileSizeX

int NDPluginStats::NDPluginStatsProfileSizeX
protected

◆ NDPluginStatsProfileSizeY

int NDPluginStats::NDPluginStatsProfileSizeY
protected

◆ NDPluginStatsProfileThresholdX

int NDPluginStats::NDPluginStatsProfileThresholdX
protected

◆ NDPluginStatsProfileThresholdY

int NDPluginStats::NDPluginStatsProfileThresholdY
protected

◆ NDPluginStatsSigmaValue

int NDPluginStats::NDPluginStatsSigmaValue
protected

◆ NDPluginStatsSigmaX

int NDPluginStats::NDPluginStatsSigmaX
protected

◆ NDPluginStatsSigmaXY

int NDPluginStats::NDPluginStatsSigmaXY
protected

◆ NDPluginStatsSigmaY

int NDPluginStats::NDPluginStatsSigmaY
protected

◆ NDPluginStatsSkewX

int NDPluginStats::NDPluginStatsSkewX
protected

◆ NDPluginStatsSkewY

int NDPluginStats::NDPluginStatsSkewY
protected

◆ NDPluginStatsTotal

int NDPluginStats::NDPluginStatsTotal
protected

The documentation for this class was generated from the following files: