Page History
...
When launched, 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.
Anchor | ||||
---|---|---|---|---|
|
Single File Manager
File manager tool consists of Status panel and control panel:
...
- Button Browse - launches the file selection window which helps to select any calibration file in any location. Location is hinted in the intermediate pop-up window. Selected file is displayed in the next-left information field.
- View button - opens/closes the file viewer in separate window.
- Plot buttons - opens/closes the plotter window and plots the file as 2-d image (if applicable).
- Delete button - deletes the selected file from disc.
- Move/Copy buttons - perform associated actions on selected file. The destination directory and file name is defined by the Instrument/Experiment/Detector selection panel and next-right filelds:
- for detector selection button - sets the destination detector name from drop down menu,
- calibration type selection button - sets the destination calibration type, and
- two editable fields - set the run range for destination calibrationfile.
Anchor | ||||
---|---|---|---|---|
|
Group File Manager
Anchor | ||||
---|---|---|---|---|
|
Geometry
Metrology
Anchor | ||||
---|---|---|---|---|
|
...
Code Block |
---|
relinfo Pkg/Rel TEST BASE(ana-0.10.1215) CalibManager HEAD V00-00-1428 |
Completely implemented applications under tabs:
- Dark
- ROI
- File Manager
- Single File Manager
- Group File Manager
- Configuration
Partly implemented tab(s):
- Geometry
- Metrology
Recommended updates for release ana-0.10.
...
15
On 2014-0304-01 16
- all currently known problems has been fixed
...
- ,
- command-line interface is available
Code Block |
---|
addpkg CalibManager HEAD; (V00-00-1734) |
How to get and run calibman
...
- AFS token is expired for your terminal session. Batch system will complain. Before launching
calibman
application, first executekinit
andaklog
commands. - 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 in the Detector selection menu.
Command line interface
Available since release ana-0.10.15, CalibManager V00-00-35
.
In addition to the GUI-based calibration, command line interface for dark-run calibration of detectors is implemented by POCs request. It can be started by the command calibrun
with parameters. The list of options/parameters can be dumped by the command:
Code Block |
---|
calibrun -h |
which prints
Code Block |
---|
Usage: calibrun [options] args
Example: calibrun -e xppi0613 -d CSPAD,OPAL1000 -c ./calib -P -D -r 173
calibrun - command line calibration utility
Options:
-h, --help show this help message and exit
-e EXP, --exp=EXP experiment name, ex.: cxi12345
-r RUNNUM, --run=RUNNUM
run number
-n NUM_EVENTS, --num_events=NUM_EVENTS
number of events to process
-s SKIP_EVENTS, --skip_events=SKIP_EVENTS
number of events to skip before processing
-t THR_RMS, --thr_rms=THR_RMS
threshold on rms for hot pixel mask evaluation
-v RUNRANGE, --runrange=RUNRANGE
validity run range, ex.: 123-567 or 123-end
-q QUEUE, --queue=QUEUE
queue name, ex: psnehq, psfehq, psanacsq. If specified
- run in batch
-w WORKDIR, --workdir=WORKDIR
work directory, ex: ./work
-c CALIBDIR, --calibdir=CALIBDIR
non-standard calibration directory, ex: ./calib
-d DETECTOR, --detector=DETECTOR
detector names separated by comma,
ex:CSPAD,CSPAD2x2,PNCCD
-p PRINT_BITS, --print_bits=PRINT_BITS
=0-minimal print+warnings, =1-detailed printout
-P, --process process xtc files and produce calib files under the
"work" directory
-D, --deploy deploy calibrated files under the "calib" directory |
The calibrun
application re-uses code and approach developed for calibman
. At start calibrun
loads parameters from configuration file confpars-calibman.txt
, which by default is the same configuration file as for calibman.
If necessary parameters are set in confpars-calibman.txt, then
calibrun
can be started with a single parameter - run number and options for processing and deployment, for example:
Code Block |
---|
calibrun -r <run-number> -P -D |
otherwise, desired parameters need to be defined in the command line. Starting from the bare command calibrun
will print hint-messages about missing option(s) which needs to be added to the command line in order to complete job. An example of the command with minimal set of self-sufficient parameters,
Code Block |
---|
calibrun -e xppi0613 -d CSPAD,OPAL1000 -P -D -r 173 |
This command will process (-P) xtc files for experiment (-e) xppi0613, run (-r) 173, detectors (-d) CSPAD and (,) OPAL1000, and deploy (-D) them for default run range 173-end in the default calib directory /reg/d/psdm/xpp/xppi0613/calib/
By default the image-averaging psana job is processed interactively. If queue (-q <queue-name>) option is provided, it is submitted in batch.
By default this command produces quite extensive output on terminal window, which in most cases is enough to figure out what is going on. If the print-control option (-p 0) is provided, the major output will be suppressed and only begin, end of job comments, and warning messages will be printed. Most complete output can be found in the session log file auto-saved in the work directory with relevant time stamp in the name, for example: ./work/2014-04-16-16:43:52-log.txt
Calibration manager calibman
, using the same file name conventions, can always be used to inspect all output files and problems generated by calibrun.
References
- Calibration management tool developement notes
- Description of Calibration database
- Mask Editor button