Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

GUI intended to create mask of the bad pixels and save it as 2-d image and 3-d data like array.

Translate and zoom image

Click on Image mde button, then click and drag or scroll mouse for translation or zomming image, respectively.

Add ROI

Click on Add button and select ROI type from pop-up menu:

Image Added




Adding ROI

Right after selected ROI type click on image to mark ROI control point locations as manyy times as it is necessary to define particular ROI shape.


Image Added

Add/Select PIXEL and PIXGROUP


Image Added

Edit mode

Image Added

Image Added

Image Added

Select file GUI

Use standard dialog to select I/O files

Image Added

Image AddedImage AddedImage AddedImage AddedImage AddedImage AddedImage AddedImage AddedImage Added

Content

Table of Contents

Launch Mask Editor

Run without parameters

masked

  • opens GUI and allows to set parameters interactively

Get command help

masked -h

Code Block
titleoutput for option "-h" on version from 2023-09-29
collapsetrue
ps-4.6.0 [dubrovin@sdfiana001:~/LCLS/con-lcls2]$ masked -h
usage: Usage:
  masked -a <fname-nda.npy> -k <DataSource-kwargs> -d <detector> -g <fname-geometry.npy> [-L <logging-mode>] [...]

Help:
  masked -h

Examples:
  masked  # set all parameters using GUI
  masked -d epix10ka_000001                          # takes geometry from detector DB
  masked -d epix10ka_000001 -k exp=ueddaq02,run=569  # takes geometry from experiment DB
  masked -g /sdf/group/lcls/ds/ana/detector/data2_test/geometry/geo-epix10kaquad-tstx00117.data  # takes geometry from file
  masked -a /sdf/group/lcls/ds/ana/detector/data2_test/misc/epix10kaquad-meclv2518-0101-CeO2-ave.npy  # takes array for image from file
  masked -a /sdf/group/lcls/ds/ana/detector/data2_test/misc/epix10kaquad-meclv2518-0101-CeO2-ave.npy -g /sdf/group/lcls/ds/ana/detector/data2_test/geometry/geo-epix10kaquad-tstx00117.data
  masked -d epix10ka_000001 -a /sdf/group/lcls/ds/ana/detector/data2_test/misc/epix10kaquad-meclv2518-0101-CeO2-ave.npy
  masked -d epix10ka_000001 -k exp=ueddaq02,run=569 -a /sdf/group/lcls/ds/ana/detector/data2_test/misc/epix10kaquad-meclv2518-0101-CeO2-ave.npy

masked - command opens mask editor GUI

positional arguments:
  posargs               list of positional arguments: [<fname-nda.npy>] [<fname-geometry.txt>], default = []

optional arguments:
  -h, --help            show this help message and exit
  -a NDAFNAME, --ndafname NDAFNAME
                        image array file name*.nda, default = Select
  -d DETNAME, --detname DETNAME
                        detector name, default = Select
  -k DSKWARGS, --dskwargs DSKWARGS
                        string of comma-separated (no spaces) simple parameters for DataSource(**kwargs), ex: exp=<expname>,run=<runs>,dir=<xtc-dir>, ..., or <fname.xtc> or files=<fname.xtc> or
                        pythonic dict of generic kwargs, e.g.: "{'exp':'tmoc00318', 'run':[10,11,12], 'dir':'/a/b/c/xtc'}", default = Select
  -g GEOFNAME, --geofname GEOFNAME
                        geometry description constants file name *.txt, *.data, default = Select
  -L LOGMODE, --logmode LOGMODE
                        logging mode, one of CRITICAL, FATAL, ERROR, WARN, WARNING, INFO, DEBUG, NOTSET, default = INFO
  -o DIRREPO, --dirrepo DIRREPO
                        repository for files, default = ./repo-masked
  --ctab CTAB           color table index in range [1,8], default = 3
  --dirmode DIRMODE     directory access mode, default = 0o2775
  --filemode FILEMODE   file access mode, default = 0o664
  --group GROUP         group ownership for all files, default = ps-users
  --savelog             On/Off saving log file, default = 1
ps-4.6.0 [dubrovin@sdfiana001:~/LCLS/con-lcls2]$

Launch with optional parameters

To speed-up work at start, application can be started with optional parameters.

  • masked -d epix10ka_000001
    • takes geometry from detector-DB
  • masked -d epix10ka_000001 -k exp=ueddaq02,run=569
    • takes geometry from experiment-DB
  • masked -g /sdf/group/lcls/ds/ana/detector/data2_test/geometry/geo-epix10kaquad-tstx00117.data
    • takes geometry from file
  • masked -a /sdf/group/lcls/ds/ana/detector/data2_test/misc/epix10kaquad-meclv2518-0101-CeO2-ave.npy
    • takes array for image from file
  • And combination of above pareameters
    • masked -a /sdf/group/lcls/ds/ana/detector/data2_test/misc/epix10kaquad-meclv2518-0101-CeO2-ave.npy -g /sdf/group/lcls/ds/ana/detector/data2_test/geometry/geo-epix10kaquad-tstx00117.data
    • masked -d epix10ka_000001 -a /sdf/group/lcls/ds/ana/detector/data2_test/misc/epix10kaquad-meclv2518-0101-CeO2-ave.npy
    • masked -d epix10ka_000001 -k exp=ueddaq02,run=569 -a /sdf/group/lcls/ds/ana/detector/data2_test/misc/epix10kaquad-meclv2518-0101-CeO2-ave.npy

GUI parts

Image RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage RemovedImage Removed

References