Powder diffraction comparison¶
The Powder diffraction comparison card in the browser sidebar plots a kinematic X-ray powder pattern of the current 3D periodic structure together with a measured trace that you paste as text. It lists the reflections and links each one to the crystal’s (hkl) plane normal. It is a visual comparison: it does not hunt peaks, index a pattern, identify phases or refine a structure (Pawley, Le Bail and Rietveld fits are out of scope).
Calculate a pattern¶
Enter the wavelength λ (Å), the 2θ range and step, the peak FWHM (degrees 2θ) and the Lorentzian fraction η, then press Calculate pattern. The defaults are Cu Kα1 (1.5406 Å), 5–90° 2θ, a 0.02° step, FWHM 0.1° and η = 0.5. Enter your instrument’s calibrated wavelength when it differs from the customary rounded value.
Kα2 doublet. Enter a Kα2 λ to add the second line of the doublet; leave it blank for a single wavelength. Each reflection then also diffracts at its own Kα2 Bragg angle, with the Lorentz–polarization factor evaluated at that angle, scaled by Kα2/Kα1 intensity (default 0.5, the customary ratio). No Kα2 wavelength is built in: enter the calibrated value for your anode. The reflection table and the 2θ axis keep the Kα1 positions; a q or d axis is converted with the Kα1 wavelength, so the Kα2 shoulder stays visible there too. A reflection whose Kα1 line lies below 2θ min is not enumerated, so its Kα2 line is missing from the very start of the range, as Kα1 tails are.
Peak width. Constant FWHM uses one width at every angle. Caglioti U,
V, W uses FWHM² = U tan² θ + V tan θ + W (degrees² 2θ) per line, the
angle-dependent width of Caglioti, Paoletti and Ricci (1958)
as used for X-ray pseudo-Voigt profiles by Young and Wiles (1982). The
defaults (0.01, −0.005, 0.005) are a placeholder of the right order, not an
instrument calibration: fit U, V and W to a standard measured on your
diffractometer. A U, V, W whose FWHM² is not positive somewhere in the 2θ
range is refused. With U = V = 0 and W = FWHM², the profile equals the
constant-width one. The overlaps within FWHM flag compares two neighbouring
peaks with the mean of their own widths.
The calculation uses the explicit atoms of the shown structure:
Quantity |
Treatment |
|---|---|
d spacing |
1/d is the length of h b1 + k b2 + l b3, from the reciprocal metric of the current cell |
Peak position |
Bragg’s law |
Structure factor |
|
Scattering factors |
Neutral-atom Waasmaier–Kirfel coefficients (Acta Cryst. A51, 416 (1995), doi:10.1107/S0108767394013292), evaluated for sin θ/λ ≤ 2 Å⁻¹; no anomalous dispersion |
Lorentz–polarization |
|
Intensity |
m |F|² LP in arbitrary units; no scale, absorption, extinction or preferred orientation |
Profile |
Area-normalized pseudo-Voigt with one constant FWHM in 2θ, or a Caglioti width per line |
Radiation |
One wavelength, or a Kα1/Kα2 doublet with a supplied second wavelength and intensity ratio |
No space group is detected or assumed. Centring and glide/screw extinctions appear because their structure factors vanish; the summary counts these reflections as extinct and the reflection CSV lists them. A zero that arises by accident in this model is reported the same way, so an extinct row is not a symmetry assignment.
Elements without tabulated coefficients stop the calculation with a message
that names them. The source module and its references are in
vibeviewer.powder_diffraction.
Indices, multiplicity and coincident peaks¶
(hkl) are integers in the basis of the current cell. A primitive cell of an fcc metal therefore labels the same planes with different indices from its conventional cell, and has no centring extinctions.
Multiplicity counts every (hkl) of that basis with the same d spacing and the same |F|² in this model, including Friedel mates. It equals the usual crystal-class multiplicity only when the model has that symmetry.
When reflections with different |F|² share one d spacing, they remain separate rows with the same Group number. Reflections closer than one FWHM are marked overlaps within FWHM. The table shows one representative (hkl) per row, and the reflection CSV lists every member. Neither the table nor the overlay assigns an observed peak to a unique reflection.
Import a measured pattern¶
Paste the measured data into the text box. Columns may be separated by
spaces, tabs, commas or semicolons. Text after # is ignored, and
non-numeric header lines before the first data row are skipped and counted.
A malformed row after data begins is an error.
Choose the 1-based X col and Y col, the X quantity (2θ in degrees,
q in Å⁻¹ or d in Å) and the measured wavelength. A wavelength is required
for 2θ data. Then add the intensity label (for example counts) and a short
source note. Import measured keeps the values exactly as read.
vibe-viewer has no native diffractometer readers; export the scan as text
first.
Compare¶
Plot axis shows 2θ at the calculated wavelength or q. A measured trace recorded at another wavelength, or supplied in q or d, is converted through q. Its intensities are not re-corrected for the other wavelength, and points beyond the 2θ Ewald limit are left out.
Display scaling either shows raw intensities or scales each trace separately so its maximum is 100. Scaling changes only the plotted copy. The measured counts and the calculated profile stay unchanged, and the traces CSV has both raw and displayed columns.
Green ticks under the traces mark the calculated reflections; hover over a tick to see its (hkl), d spacing and group.
Link reflections to the crystal¶
Click a row of the reflection table to mark it on the plot. The camera then looks down that row’s (hkl) plane normal through the crystal viewing directions path, using an orthographic view that keeps the focal point and zoom. The status line repeats the d spacing and multiplicity and lists other reflections in the same peak. The structure, its coordinates and the edit history do not change. If the structure changes after a calculation, recalculate before selecting rows.
Export¶
Button |
File |
|---|---|
Traces CSV |
|
Reflections CSV |
|
Figure HTML |
|
Limits and planned work¶
QVF has no powder-diffraction contract yet, so calculated and measured patterns stay in memory and are not saved to
.qvf. Producer patterns will be read through QVF once qvf releases a contract.The calculation covers X-rays only (no neutron or electron scattering lengths). It uses neutral atoms without ion-specific or anomalous terms, and it ignores occupancy, displacement parameters, absorption, preferred orientation, and instrument zero or sample offsets. Caglioti widths are entered, not fitted; no peak asymmetry or sample-size/strain broadening is modelled.
Background subtraction, peak search, indexing and refinement are not implemented.