If you start DPDAK for the first time, you will see a quite empty main window with following parts (top to bottom):
- a File Menu with File, View, Tools, Options, Export and Help menu
- a Toolbar with six icons (Load, Save, Start, Stop, Configure Plugins)
- a (currently empty) array for paramter
- a log message box for status messages
This Quick Start tutorial will teach you how to:
- read a sequence of detector images,
- do a calibration of a SAXS measurement,
- integrate a sequence of detector images.
You can download the files used in the tutorial here.
Add a plug-in
To add a plug-in,
on the toolbar of the main window. The Plug-in Configuration window shows a list of all available plug-ins (left) and the currently used plug-ins (right). A schematic diagram (bottom) shows how the currently used plug-ins are connected. Now
select Image Logger plug-in
from the list and
The plug-in will appear in the right list and will be shown in the diagram. To remove a plug-in, click on the small arrow (right of the name) from the currently used plug-ins list and click on the small button that appears. To accept the new plug-in configuration
click the OK button.
Set plug-in parameter
Now there is a plug-in loaded which will read detector images from a file system. But the plug-in needs to know from which folder and which files to read. For that reason, most plug-ins have parameter. Those parameter are shown in the main windows in the area between the toolbar and the log message box. The Image Reader plug-in has two parameter: Image Path and Sequence. The first parameter is the path to any file from a sequence of detector files and tells the plug-in where the files are located and their name.
Click the 'Browse' button and select a detector file from a sequence.
The second parameter is telling the plug-in which files from the sequence to read. If empty, just the one file selected in the first parameter is read. The input '12-20' tells the plug-in to read the files with the sequence number 12 to 20.
Input '12-20' into the field next to Sequence (without quotation marks).
Start & stop processing
Everything is set up and DPDAK is ready to start reading the images. To start processing
While DPDAK processes the data, the status is displayed in the log message box. A counter, starting with zero, is incremented for every processed data set (loading a detector image in our case). The Image Logger was set up to read ten images, so the last message will be 'Processing counter: 9'. DPDAK is still in processing mode, to stop processing
Add an Image Display
All processed data is stored in the an internal database. The data base is like an Excel sheet with a column for each plug-in output and as many rows as data had been processed. In our case the is one column with 10 rows filled with the loaded images (for memory reasons only the path will be stored). DPDAK has various displays to examine the data in the database. They can be opened by selecting 'Tools->...' from the menu bar. To add a display to see the detector images
select 'Tools->Image Display' from the menu bar.
Now a new Display opens showing the detector images. Use the small arrows on the numerical control in the tool bar to open the next or previous file from the sequence. To jump directly to an image, just type the sequence number into the control. You can start processing again to see how DPDAK always shows automatically the latest detector image that was read. This works with most displays and can be useful during a measurement at beam line to follow the experiment. Don’t forget to stop processing when the last image was read.
To be described...
This Quick Start guide explained the basics of how to work with DPDAK. It explained how to add and set up plug-ins, to start and stop the processing of data and how to open displays to examine the processed data. Have a look at the GISAXS Tutorial for a more complex use of plug-ins and displays.