Scroll to navigation

SPARSIFY-BRAGG(1) User Commands SPARSIFY-BRAGG(1)

NAME

sparsify-Bragg - Sparsify 2D single crystall diffraction images by separating Bragg peaks from background signal.

Positive outlier pixels (i.e. Bragg peaks) are all recorded as they are without destruction. Peaks are not integrated.

Background is calculated by an iterative sigma-clipping in the polar space. The number of iteration, the clipping value and the number of radial bins could be adjusted.

This program requires OpenCL. The device needs be properly selected.

DESCRIPTION

usage: spasify-Bragg [-h] [-V] [-v] [--debug] [-o OUTPUT] [--save-source]

[-b BEAMLINE] [-p PONI] [-m MASK] [--dummy DUMMY]
[--delta-dummy DELTA_DUMMY] [--radial-range RADIAL_RANGE RADIAL_RANGE] [--bins BINS] [--cycle CYCLE] [--cutoff-clip CUTOFF_CLIP] [--cutoff-pick CUTOFF_PICK] [--error-model ERROR_MODEL] [--noise NOISE] [--device DEVICE DEVICE] [--device-type DEVICE_TYPE] [IMAGE ...]

Sparsify 2D single crystall diffraction images by separating Bragg peaks from background signal. Positive outlier pixels (i.e. Bragg peaks) are all recorded as they are without destruction. Peaks are not integrated. Background is calculated by an iterative sigma-clipping in the polar space. The number of iteration, the clipping value and the number of radial bins could be adjusted. This program requires OpenCL. The device needs be properly selected.

positional arguments:

File with input images. All frames will be concatenated in a single HDF5 file.

optional arguments:

show this help message and exit
output version and exit
show information for each frame
show debug information

main arguments:

Output filename
save the path for all source files

Experimental setup options:

Name of the instument (for the HDF5 NXinstrument)
geometry description file
mask to be used for invalid pixels
value of dynamically masked pixels
precision for dummy value
radial range as a 2-tuple of number of pixels, by default all available range

Sigma-clipping options:

Number of radial bins to consider
precision for dummy value
Threshold to be used when performing the sigmaclipping
Threshold to be used when picking the pixels to be saved
Statistical model for the signal error, may be `poisson`(default) or `azimuthal` (slower)
Noise level: n-sigma cannot be smaller than this value

Opencl setup options:

definition of thee platform and device identifyer: 2 integers. Use `clinfo` to get a description of your system
device type like `cpu` or `gpu` or `acc`. Can help to select the proper device.

Current status of the program: status

November 2021 sparsify-Bragg 0.20.0