You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Calibration Management Tool is intended to help in population of the calibration database.

Users' Interface

User Interface (UI) of the Calibration Management Tool is implemented in Python using PyQt4, matplotlib, and other packages. Beside interactive commands to OS some jobs are submitted in batch for processing of data with psana framework. Main window of the UI shows up at start of calibman application. Its content may be different for the first and next sessions; current session status is preserved in configuration file at exit and restored at start of the next session.

Main window consists of 3 panels from top to bottom:

  • Instrument/experiment/detector selection panel,
  • Tab-bar with application panel, which allows to switch between different applications,
  • Log-book information panel.

Instrument/Experiment/Detector selection panel

This panel contains three buttons, Instrument, Experiment, and Detector, which mast be set before any other actions. Button Browser launch optional selection dialog of different destination calibration directory, if default directory is not intended for file saving.

 

Log-book panel

Log-book panel is located in the bottom of the main window. It is intended as a global information panel in order to minimize a number of specific information fields. Records from most important manipulations or information buttons are posted in this panel. At the end of each session content of this panel is saved in the log-file in the work directory.

Status panel

Status panel shows up in some of applications on the top of application space. In most cases it shows content of the calibration directory for specified list of detectors. 

Tab-bar

Tab-bar allows to switch between different applications. Completely implemented applications under tabs:

  • Dark
  • ROI
  • File Manager
  • Configuration

Dark

ROI

Application panel under ROI (Region Of Interest) tab has a minimal number of control fields, which allow to specify the file with image and open/close Mask Editor UI in separate window. Then the Mask Editor works as completely independent application. The Mask Editor allows to draw on image any number of a few geometry figure types and finally generate and save positive or negative mask for loaded image.

 

File Manager

Configuration

Parameters

Configuration file

Confirmation windows

There is a bunch of confirmation popup windows with modal-style dialog. Appropriate selection need to be done by clicking on possible continuation buttons.

 

 

Project status

Current status corresponds to:

relinfo
Pkg/Rel             TEST    BASE(ana-0.10.10)
CalibManager   HEAD   V00-00-09

Completely implemented applications under tabs:

  • Dark
  • ROI
  • File Manager
  • Configuration

How to get and run calibman

Run application for current release

If there is no known recent changes in the code of the project, then it may be launched using current release (≥ ana-0.10.10) from any directory :

cd <your-favorite-directory>;
sit_setup;
calibman;

 

Get latest version, compile, and run

The latest version of this application with recent modifications for packages can be created and executed from the local release directory. Login to psana, then run use commands with appropriate substitutions for <...> fields:

cd <your-favorite-test-directory>;
newrel ana-current test-CalibManager;
cd test-CalibManager;
sit_setup;
addpkg CalibManager HEAD;
addpkg <package2> HEAD;
addpkg <package3> HEAD;
...
scons;
calibman; 

 

 

 

 

What to do next

  • Set correct queue which will be used for batch jobs: click on tabs: Configuration -> Parameters, select Queue combo box.
  • Click on tab Dark.
  • Set Instrument, Experiment, from combo boxes and click on Select button to select Detector(s) from pop-up window.
  • Set filter for runs to show using combo boxes to the right from labels Show runs and for detectors

  • For runs in the table, which you want to calibrate, click on button Go, relax and wait until button Deploy show-up to the right from button 

  • Change validity range if necessary, click on Deploy button.  If everything is ok, it is done!

Known problems and ways around

World is not perfect. Anything may happen during this long workflow. Expert mode sheds light on most of the problems. Here is a list of most frequent problems;

  • AFS token is expired for your terminal session. Batch system will complain. Use aklog command.
  • work directory is missing... make it manually in accordance with selected or default path in Configuration -> Parameters, Dir work
  • job on data from NEH/FEH are submitted to the wrong butch queue psfehq/psnehq. Set appropriate queue.
  • DB has a list of sources (detectors) which does not coincide with what is written in xtc file. After job is submitted, check the list of detectors found in xtc scan and check only available detectors.

References

  • No labels