areaDetector Plugin NDPluginROI

Contents

• Overview
• Configuration
• Screen shots

Overview

NDPluginROI selects a rectangular "Region-Of-Interest" (ROI) from the NDArray callback data. The ROI can be any size, from a single array element to the entire array. NDPluginROI  does the following operations, in this order:

1. Extracts the ROI as defined by its offset (starting array element) and size in each dimension.
2. Optional binning in any dimension.
3. Optional orientation reversal (mirroring) in any dimension.
4. Optional scaling (dividing) by a scale factor.
5. Optional conversion to a new data type.
6. Optional collapsing (removing) of dimensions whose value is 1.
7. Export the ROI as a new NDArray object. The NDPluginROI is both a recipient of callbacks and a source of NDArray callbacks, as a driver is. This means that other plugins like NDPluginStdArrays and NDPluginFile can be connected to an NDPluginROI plugin, in which case they will display or save the selected ROI rather than the full detector driver data.

If scaling is enabled then the array is promoted to a double when it is extracted and binned. The scaling is done on this double-precision array, and then the array is converted back to the desired output data type. This makes scaling relatively computationally intensive, but ensures that correct results are obtained, without integer truncation problems.

Note that while the NDPluginROI should be N-dimensional, the EPICS interface to the definition of the ROI is currently limited to a maximum of 3-D. This limitation may be removed in a future release.

NDPluginROI inherits from NDPluginDriver. The NDPluginROI class documentation describes this class in detail.

NDPluginROI.h defines the following parameters. It also implements all of the standard plugin parameters from NDPluginDriver. The EPICS database NDROI.template provide access to these parameters, listed in the following table. Note that to reduce the width of this table the parameter index variable names have been split into 2 lines, but these are just a single name, for example NDPluginROIName.

A special case is made when the NDArray data has colorMode=NDColorModeRGB1 or NDColorModeRGB2. In these cases the user interface to the array dimensions is changed so that the Z PVs always refer to the color dimension (as for NDColorModeRGB3), the X dimension refers to the horizontal dimension, and the Y dimension refers to the vertical dimension. This is very convenient, because it means that the ROI does not need to redefined if, for example, the color mode is changed from Mono to RGB1, which would be required if the X, Y and Z dimensions were not automatically switched.

Configuration

The NDPluginROI plugin is created with the NDROIConfigure command, either from C/C++ or from the EPICS IOC shell.

NDROIConfigure(const char *portName, int queueSize, int blockingCallbacks,
               const char *NDArrayPort, int NDArrayAddr,
               int maxBuffers, size_t maxMemory,
               int priority, int stackSize, int maxThreads)
  

For details on the meaning of the parameters to this function refer to the detailed documentation on the NDROIConfigure function in the NDPluginROI.cpp documentation and in the documentation for the constructor for the NDPluginROI class.

Screen shots

The following MEDM screen provides access to the parameters in NDPluginDriver.h and NDPluginROI.h through records in NDPluginBase.template and NDROI.template.

NDROI.adl

The following MEDM screen provides access to 4 ROIs at once.

NDROI4.adl