vibe-viewerDocumentation

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 λ = 2 d sin θ; q = 4π sin θ / λ = 2π / d

Structure factor

F = Σ f_j exp(2πi h·x_j) over all atoms; occupancy 1 and no displacement factor (B = 0) because the model supplies neither

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

(1 + cos² 2θ) / (sin² θ cos θ) for an unpolarized beam without a monochromator

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.

Export

Button

File

Traces CSV

powder-traces.csv: long format with trace, display x, q_inv_A, raw_intensity and display_intensity. # header lines record the axis, scaling, wavelengths, sources and measured column mapping.

Reflections CSV

powder-reflections.csv: group, cluster, representative h k l, all members, d, 2θ, q, multiplicity, |F|², LP, intensity, relative intensity, extinct flag, the line’s FWHM and, with a doublet, its Kα2 2θ and intensity. # header lines record the calculation assumptions, including the radiation and profile.

Figure HTML

powder-comparison.html: the interactive Plotly figure, with its built-in PNG download

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.