pyFAI-calib1
Cli tool for determining the geometry of a detector using a reference sample.
Overview
usage: pyFAI-calib [options] -w 1 -D detector -c calibrant.D imagefile.edf
Calibrate the diffraction setup geometry based on Debye-Sherrer rings images without a priori knowledge of your setup. You will need to provide a calibrant or a "d-spacing" file containing the spacing of Miller plans in Angstrom (in decreasing order). Calibrants available: AgBh, Al, Au, C14H30O, CeO2, Cr2O3, CrOx, CuO, LaB6, LaB6_SRM660a, LaB6_SRM660b, LaB6_SRM660c, NaCl, Ni, PBBA, Pt, Si, Si_SRM640, Si_SRM640a, Si_SRM640b, Si_SRM640c, Si_SRM640d, Si_SRM640e, TiO2, ZnO, alpha_Al2O3, cristobaltite, mock, quartz or search in the American Mineralogist database: http://rruff.geo.arizona.edu/AMS/amcsd.php The --calibrant option is mandatory !
positional arguments:
- FILE
-
List of files to calibrate
optional arguments:
-
-h, --help -
show this help message and exit
-
-V, --version -
show program's version number and exit
-
-o FILE, --out FILE -
Filename where processed image is saved
-
-v, --verbose -
switch to debug/verbose mode
-
-c FILE, --calibrant FILE -
Calibrant name or file containing d-spacing of the reference sample (MANDATORY, case sensitive !)
-
-w WAVELENGTH, --wavelength WAVELENGTH -
wavelength of the X-Ray beam in Angstrom. Mandatory
-
-e ENERGY, --energy ENERGY -
energy of the X-Ray beam in keV (hc=12.398419843320026keV.A).
-
-P POLARIZATION_FACTOR, --polarization POLARIZATION_FACTOR -
polarization factor, from
-1(vertical) to +1 (horizontal), default is None (no correction), synchrotrons are around 0.95
-
-i FILE, --poni FILE -
file containing the diffraction parameter (poni-file). MANDATORY for pyFAI-recalib!
-
-b BACKGROUND, --background BACKGROUND -
Automatic background subtraction if no value are provided
-
-d DARK, --dark DARK -
list of comma separated dark images to average and subtract
-
-f FLAT, --flat FLAT -
list of comma separated flat images to average and divide
-
-s SPLINE, --spline SPLINE -
spline file describing the detector distortion
-
-D DETECTOR_NAME, --detector DETECTOR_NAME -
Detector name (instead of pixel size+spline)
-
-m MASK, --mask MASK -
file containing the mask (for image reconstruction)
-
-n NPT, --pt NPT -
file with datapoints saved. Default: basename.npt
-
--filter FILTER -
select the filter, either mean(default), max or median
-
-l DISTANCE, --distance DISTANCE -
sample-detector distance in millimeter. Default: 100mm
-
--dist DIST -
sample-detector distance in meter. Default: 0.1m
-
--poni1 PONI1 -
poni1 coordinate in meter. Default: center of detector
-
--poni2 PONI2 -
poni2 coordinate in meter. Default: center of detector
-
--rot1 ROT1 -
rot1 in radians. default: 0
-
--rot2 ROT2 -
rot2 in radians. default: 0
-
--rot3 ROT3 -
rot3 in radians. default: 0
-
--fix-dist -
fix the distance parameter
-
--free-dist -
free the distance parameter. Default: Activated
-
--fix-poni1 -
fix the poni1 parameter
-
--free-poni1 -
free the poni1 parameter. Default: Activated
-
--fix-poni2 -
fix the poni2 parameter
-
--free-poni2 -
free the poni2 parameter. Default: Activated
-
--fix-rot1 -
fix the rot1 parameter
-
--free-rot1 -
free the rot1 parameter. Default: Activated
-
--fix-rot2 -
fix the rot2 parameter
-
--free-rot2 -
free the rot2 parameter. Default: Activated
-
--fix-rot3 -
fix the rot3 parameter
-
--free-rot3 -
free the rot3 parameter. Default: Activated
-
--fix-wavelength -
fix the wavelength parameter. Default: Activated
-
--free-wavelength -
free the wavelength parameter. Default: Deactivated
-
--tilt -
Allow initially detector tilt to be refined (rot1, rot2, rot3). Default: Activated
-
--no-tilt -
Deactivated tilt refinement and set all rotation to 0
-
--saturation SATURATION -
consider all pixel>max*(1-saturation) as saturated and reconstruct them, default: 0 (deactivated)
-
--weighted -
weight fit by intensity, by default not.
-
--npt NPT_1D -
Number of point in 1D integrated pattern, Default: 1024
-
--npt-azim NPT_2D_AZIM -
Number of azimuthal sectors in 2D integrated images. Default: 360
-
--npt-rad NPT_2D_RAD -
Number of radial bins in 2D integrated images. Default: 400
-
--unit UNIT -
Valid units for radial range: 2th_deg, 2th_rad, q_nm^-1, q_A^-1, r_mm. Default: 2th_deg
-
--no-gui -
force the program to run without a Graphical interface
-
--no-interactive -
force the program to run and exit without prompting for refinements
-
-r, --reconstruct -
Reconstruct image where data are masked or <0 (for Pilatus detectors or detectors with modules)
-
-g GAUSSIAN, --gaussian GAUSSIAN -
Size of the gaussian kernel. Size of the gap (in pixels) between two consecutive rings, by default 100 Increase the value if the arc is not complete; decrease the value if arcs are mixed together.
-
--square -
Use square kernel shape for neighbor search instead of diamond shape
-
-p PIXEL, --pixel PIXEL -
size of the pixel in micron
The output of this program is a "PONI" file containing the detector description and the 6 refined parameters (distance, center, rotation) and wavelength. An 1D and 2D diffraction patterns are also produced. (.dat and .azim files)
Releases
5 releases since Debian 7 (Wheezy); the text changed 4 times.
--background since Debian 8 (Jessie);
--calibrant since Debian 8 (Jessie);
--dark since Debian 8 (Jessie);
--detector since Debian 8 (Jessie);
--dist since Debian 9 (Stretch);
--distance since Debian 8 (Jessie);
--energy since Debian 8 (Jessie);
--filter since Debian 8 (Jessie);
--fix-dist since Debian 8 (Jessie);
--fix-poni1 since Debian 8 (Jessie);
--fix-poni2 since Debian 8 (Jessie);
--fix-rot1 since Debian 8 (Jessie);
--fix-rot2 since Debian 8 (Jessie);
--fix-rot3 since Debian 8 (Jessie);
--fix-wavelength since Debian 8 (Jessie);
--flat since Debian 8 (Jessie);
--free-dist since Debian 8 (Jessie);
--free-poni1 since Debian 8 (Jessie);
--free-poni2 since Debian 8 (Jessie);
--free-rot1 since Debian 8 (Jessie);
--free-rot2 since Debian 8 (Jessie);
--free-rot3 since Debian 8 (Jessie);
--free-wavelength since Debian 8 (Jessie);
--gaussian since Debian 8 (Jessie);
--help since Debian 8 (Jessie);
--mask since Debian 8 (Jessie);
--no-gui since Debian 8 (Jessie);
--no-interactive since Debian 8 (Jessie);
--no-tilt since Debian 9 (Stretch);
--npt since Debian 8 (Jessie);
--npt-azim since Debian 8 (Jessie);
--npt-rad since Debian 8 (Jessie);
--out since Debian 8 (Jessie);
--pixel since Debian 8 (Jessie);
--polarization since Debian 8 (Jessie);
--poni since Debian 9 (Stretch);
--poni1 since Debian 8 (Jessie);
--poni2 since Debian 8 (Jessie);
--pt since Debian 8 (Jessie);
--reconstruct since Debian 8 (Jessie);
--rot1 since Debian 8 (Jessie);
--rot2 since Debian 8 (Jessie);
--rot3 since Debian 8 (Jessie);
--saturation since Debian 8 (Jessie);
--spline since Debian 8 (Jessie);
--square since Debian 8 (Jessie);
--tilt since Debian 9 (Stretch);
--unit since Debian 8 (Jessie);
--verbose since Debian 8 (Jessie);
--version since Debian 9 (Stretch);
--wavelength since Debian 8 (Jessie);
--weighted since Debian 8 (Jessie);
-D since Debian 8 (Jessie);
-P since Debian 8 (Jessie);
-V since Debian 9 (Stretch);
-b since Debian 8 (Jessie);
-c since Debian 8 (Jessie);
-d since Debian 8 (Jessie);
-e since Debian 8 (Jessie);
-f since Debian 8 (Jessie);
-g since Debian 8 (Jessie);
-h since Debian 8 (Jessie);
-i since Debian 9 (Stretch);
-l since Debian 8 (Jessie);
-m since Debian 8 (Jessie);
-n since Debian 8 (Jessie);
-o since Debian 8 (Jessie);
-p since Debian 8 (Jessie);
-r since Debian 8 (Jessie);
-s since Debian 8 (Jessie);
-v since Debian 8 (Jessie);
-w since Debian 8 (Jessie).