SPD-MOOD

by , Jun 2006 - May 2008

<UP>

Download the program here (runs on linux and needs ROOT, and DATE if you want to use it online).

SPDMood is a monitoring program based on version 4 of "Mood". It has been developed specifically for the testing of the SPD in the DSF. The source code can be downloaded from the above link. To run the program in the DSF, login as "apixel" to the "Mood PC". Then type "SPDmood.exe". You should then get the GUI shown below on your screen. Data from the "DATE PCs" can be monitored (remotely) online or offline as described below.


Logging In

First you are going to declare the monitor program to DATE. Press "Login" and fill in the parameters you desire in the popup window. Choose online or offline and the path to the source (see image below for an example).



Logging in

For the advanced user some other parameters can be changed (details).


Collecting Events

There are right now three different methods of collecting events.
  • Dump one event
  • Dump N events
    Specify the number of events you want to collect.
  • Dump Continuously
    Runs until stopped, or - in case of offline - stops at the end of the last file.
During the collection of events you may press "Update Display", which temporarily halts the run and then only updates the current display. You may also switch between different hitmap displays. When switched, the "Update Display" is automatically invoked. The status bar shows the number of events plotted on the screen.

In case you do not receive any data when running, make sure you have the correct source specified. Also, check that monitoring is enabled in DATE.



Running Options

The toolbar on top has a couple of gray buttons. They can be toggled on (green) or off (gray). Their functionalities are described here:

No Overlap The histograms are being reset after each event.
Auto-Update The displays are updated automatically with an interval that can be set from the menu "Configure-->Update Time".
Consistency A consistency check is performed on the events scanned. Error histograms will be filled. Slows down running a bit.
Display Incons Events If possible, events are displayed even if they have inconsistencies. This option only has meaning if the "Consistency" option is on.
Stop On Error Stops the run when a consistency error has been found. All "Dmp..." options will automatically be on for the last event. See also Consistency Checks documentation. Automatically turns on "Consistency" option (even if the button is not toggled).
Adv EvCount Check Makes advanced event counter check. When using this option, you probably also want to suppress the error messages from the usual event counter check. Automatically turns on "Consistency" option (even if the button is not toggled).
Clustering Performs clustering of the hits (a somewhat slow process). Some results are displayed under the "clustering" tab.
Uniformity Performs special analysis of uniformity scans. For instance, a measure of the uniformity will be displayed under the "uniformity" tab.
Dump All Displays the entire event dump (in tab "Event Dump" --> "All Event"), for every event. Slows down running considerably, since the display is cleared and updated for each event. Use with "Dump one event".
Dump Headers Displays headers in short and long form (in tab "Event Dump" --> "Headers Only (Short Form)" and "Event Dump" --> "Headers Only (Long Form)").
Dump Calib Hdr Displays all extra calibration headers and explains the values (in tab "Event Dump" --> "Calib Headers").
Mini Ev Id Check Makes check on Mini Event Id. (Output only to command line.)


The Menus

Here is a short description of the different options in the menus.

File
Show Config Shows all configuration parameters.
Load Config Loads configuration parameters from configuration file.
Save Config Saves configuration parameters to default configuration file.
Save Config As Saves configuration parameters to configuration file.
Exit Exits program, same as red cross at the top right of window. You need to logout before you can exit. The present configuration parameters are automatically saved to the default configuration file.
Settings
Change Source/Run Change data source. Can be used to switch to another run without resetting all histograms.
Equipment Activation Equipments may here be (de)activated.
Suppress Error Messages Select which type of error messages should be suppressed. The number of suppressed error codes are displayed in the top bar of the window.
Update Time Choose the interval (in seconds) between the automatic updating of the current display. This time will be used when Running Option "Update" is toggled.
Adv EvCount Dump Options Choose if all events or just events with problems should be dumped when the Running Option "Adv EvCount Check" is toggled.
Global Event Display Options Choose whether to overlap events on the global event display.
DATE Config (advanced) "Expert" configuration panel.
MOOD Config (old stuff) Old "expert" configuration panel.
Operations
ScreenShot Makes a screen shot of the current display.
Dead and Noisy Pixels Finds noisy and dead pixels, using absolute numbers of pixel hits as threshold. Noisy pixels found will automatically be masked.
Pixel Masking
Mask Pixels Panel to mask pixels. You may choose single pixels, rows, columns, chips, half-staves, and equipments.
Un-Mask Pixels Remove pixels from mask. Opposite of the above.
Load Mask Loads pixel mask from files. The files follow the same format that is used by the online calibration software (AliITSOnlineCalibrationSPDhandler).
Save Mask Saves pixel mask to files.
Clear Mask Clears the pixel mask.
Print Masked Pixels Prints the list of masked pixels in the command line.


The Half Sector Display

Clicking one of the chips shown in this display will open a new frame to the right. Here a magnified histogram of the chip is displayed. Once opened, you may choose another chip by clicking it. Close the side frame by double clicking the histogram there.



Half Sector Display (click to enlarge)



Screen Shots

Under the "Operations" menu on top, the user may choose to create and save a screen shot image. The image may be saved locally and remotely (automatically sent to the Run Info page - this option is only available in the DSF). The procedure for doing this is described here.

Below are some example screen shots. These are actually from a bit older version of SPDMood, but kept here for reference anyway.


Making Movies

It is possible to make an mpg movie out of the displays. First make sure you have mpgtx and mpeg2encode installed, try 'which mpgtx' for instance. Go to the menu "Operations --> MovieShots" and fill in some desired parameters. Here is an example movie made from a minimum threshold scan: minth2.mpg.