Quick Start

Aus Dpdak
Wechseln zu: Navigation, Suche

Design philosophy


Main Window

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

The Plug-in Configuration Window shows a list of available plig-ins (left), the currently used plug-ins and a connection diagram (bottom).

To add a plug-in,

click on the Quick start img5.png button

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

 click on the Quick start img3.png button.

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 Quick start img4.png button that appears. To accept the new plug-in configuration

  click the OK button.

Set plug-in parameter

Plug-in parameter are used to control the behaviour of a plug-in and are shown in the main window.

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

The log message box shows the status, warnings and errors during processing.

Everything is set up and DPDAK is ready to start reading the images. To start processing

 click the Quick start img8.png button.

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

 click Quick start img9.png button.

Add an Image Display

Main Window

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.

SAXS Calibration

Main Window

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.