BEATS Dashboard

This dashboard has been developed to help in the starting tomoscan scanning process by allowing the user to monitor and control everything associated with tomoscan.

To access the BEATS Dashboard, type the following command:

$ BEATS_DAQ_Control_Monitor

the main GUI will appear:

BEATS_Dashboard GUI

Figure 1: BEATS Dashboard main window

The BEATS Dashboard shown below is divided into three sections for controlling and five sections for monitoring:

BEATS_DashboardSections

Figure 2: BEATS Dashboard sections

Controlling Sections:
    1. Common IOCs: These are the mandatory EPICS BEATS IOCs for scanning.

      -Shutter IOC. -Motor IOC. -TomoScan Support IOC. -Writer Support IOC. -SSCAN IOC.

    1. Detector Type: The available detectors for the scanning.

      -Detector Status (indicate if the (hardware, Software) is connected or not (Power, Ethernet, IOC)). -Detector IOC. -Detector Driver.

    1. Scanning Methodology: The available scanning techniques for BEATS beamline.
      -Step Scan:
      • TomoScan IOC.

      • Python Server.

      • writer Server.

      • Filter Plugin Feature.

      • MEDM (TomoScan MEDM)

      -Continuous Scan:
      • TomoScan IOC.

      • Python Server.

      • writer Server.

      • MEDM (TomoScan MEDM)

Monitoring Sections:
    1. The detector type and the scanning technique are chosen.

    1. The online logging (last log).

    1. Shutters Status.

    1. Current tomoscan mode.

    1. The current detector chosen & current rotation stage.

Other Features

The following new features have been added to the BEATS dashboard:

  1. ImageJ: starts imageJ viewer.

  2. Single Shot Image.

  3. Rot. Internal Movement Speed: the speed of the micos rotary stage that tomoscan set when go to max speed.

Selecting Process

The user has the option to choose the detector after opening the main window. Once the user has selected a detector, the Current Chosen Detector will display their selection. Following that, the user has the option to choose the scanning technique. Once the user has selected a scanning method (started the Tomoscan IOC), the detector type and scanning technique will display their choice. Additionally, as shown below, the other types of detectors will be disabled and the other scanning techniques hidden.

BEATS_SelectingProcess

Figure 3: Selecting Process of Scanning Technique

To change the detector type or scanning technique, the current process (TomoScan) must be stopped.

Note

All operations will be opened in tmux sessions, to attach any session, write the following commands:

$ tmux ls
$ tmux a -t "session name"
$ Esc, Ctrl b, d (to detach the session)

Warning

Make sure the TCPServerSocket.py is running on the server.

Warning

There is an interlocking between (Start, Stop, Restart) for all operations, depending on the status of the IOCs, whether they are running or not.

Warning

If one of the common IOCs is stopped (except SSCAN IOC), the other controlling sections will be disabled until all the common IOCs are running.

Warning

If the combined stopper shutter has a fault or the PSS is interlocked, the DAQ Tomoscan will be available only in Testing Mode.

Note

In the scanning techniques section, the python server (start button) is disabled until the tomoscan IOC is started.

Warning

There is an interlocking between the scanning techniques. This means that if any other scanning is started while the first one is still running, the first scanning will be automatically halted.

Warning

If the detector’s IOC is stopped and you select any detector type, you cannot start the scan until the IOC is running.

Note

If the GUI is unexpectedly closed and then reopened, selecting one of the detectors will show the current choice if one of the other sections is hidden or disabled.

Single Shot Image

The fundamental idea behind a single shot image is to capture one or more frames based on the capturing type chosen. To begin this process, once opened, its features will be disabled as shown in the figure.4, and you must type the detector’s prefix (TEST-PCO: or FLIR:) to be able to proceed as shown in the figure.5.

Note

The Single Shot Image main window button will be disabled if any tomoscan mode is running.

SingleShotImageMainWindow

Figure 4: Single Shot Image -Main Window-

SingleShotImagePrefix

Figure 5: Single Shot Image -Available Prefixes-

The redout and collect sections, which contain the detector’s parameters, become active once you type the prefix.

The available capture modes are as follows:

1. Single Image Acquiring

The idea behind this mode is to open the exposure shutter, take one shot, and then close the exposure shutter.

Both clicking the “Acquire” button or using the “Space” key will initiate the acquisition process. The image can also be saved (TIFF or PNG format).

SingleShotImageStart

Figure 6: Single Shot Image -Main Parameters-

Note

To save the image, you have to determine the path and define the image name only without any extension. Moreover you will be alerted if the path is not valid.

Note

The acquiring process is shown in the main terminal as figure below. Moreover, the Status yellow field shows the last log.

SingleShotImageTerminal

Figure 7: Single Shot Image -Acquiring Process-

2. SSCAN

The idea behind this mode is to collect multiple images for each motion step. more info can be found here: SSCAN reference

SSCANMainParameters

Figure 8: SSCAN -Main Parameters-

The main write fields parameters of SSCAN section are:
  • File name

  • File format (the main format is h5 file)

  • Next file number

The figure below will appear after clicking on the desired SSCAN dimension; you can start SSCAN up to 4 dimensions.
SSCANMainWindow

Figure 9: SSCAN -Main Window-

Note

The trigger PVs to start acquiring for both detectors are: - for PCO: TEST-PCO:cam1:Acquire - for FLIR: FLIR:cam1:Acquire

Note

Very Important! You must ensure that the data from the detector are gathered; the value for the Capturing? field should be (Capture yellow Colored instead of Done).

Note

The file extension of SSCAN outout is binary format (.mda), to read it you have to convert it to txt file.

cd /home/control/Desktop/SSCAN_Data
./SSCAN -f (file name)  e.g. ./SSCAN -f test1.mda

Note

The data of SSCAN (output h5 files) are located in shared folder.

cd /home/control/Desktop/SSCAN
cd PCO_Data or FLIR_Data