Scroll to navigation

MX-CALIBRATE(1) User Commands MX-CALIBRATE(1)

NAME

MX-Calibrate - calibrate the distance of a detector from a set of powder diffraction patterns

DESCRIPTION

usage: MX-Calibrate -w 1.54 -c CeO2 file1.cbf file2.cbf ...

Calibrate automatically a set of frames taken at various sample-detector distance. Return the linear regression of the fit in funtion of the samplesetector distance.

positional arguments:

List of files to calibrate

options:

show this help message and exit
show program's version number and exit
switch to debug/verbose mode
file containing d-spacing of the calibrant reference sample (MANDATORY)
wavelength of the X-Ray beam in Angstrom
energy of the X-Ray beam in keV (hc=12.398419843320026keV.A)
polarization factor, from -1 (vertical) to +1 (horizontal), default is 0, synchrotrons are around 0.95
Automatic background subtraction if no value are provided
list of dark images to average and subtract
list of flat images to average and divide
spline file describing the detector distortion
size of the pixel in micron
Detector name (instead of pixel size+spline)
file containing the mask (for image reconstruction)
select the filter, either mean(default), max or median
consider all pixel>max*(1-saturation) as saturated and reconstruct them
maximum number of rings to extract
weight fit by intensity
sample-detector distance in millimeter
Allow initially detector tilt to be refined (rot1, rot2, rot3). Default: Activated
Deactivated tilt refinement and set all rotation to 0
sample-detector distance in meter
poni1 coordinate in meter
poni2 coordinate in meter
rot1 in radians
rot2 in radians
rot3 in radians
fix the distance parameter
free the distance parameter
fix the poni1 parameter
free the poni1 parameter
fix the poni2 parameter
free the poni2 parameter
fix the rot1 parameter
free the rot1 parameter
fix the rot2 parameter
free the rot2 parameter
fix the rot3 parameter
free the rot3 parameter
fix the wavelength parameter
free the wavelength parameter
force the program to run without a Graphical interface
force the program to run with a Graphical interface
force the program to run and exit without prompting for refinements
force the program to prompt for refinements
Uses the 'massif', 'blob' or 'watershed' peak-picker algorithm (default: blob)

This tool has been developed for ESRF MX-beamlines where an acceptable calibration is usually present is the header of the image. PyFAI reads it and does a "recalib" on each of them before exporting a linear regression of all parameters versus this distance.

February 2023 MX-Calibrate from pyFAI version 0.21.3: 03/02/2022