Reading and sources
https://xraytools.com/reading
Where to read more, and where every number on this site comes from. Nothing here is a calculator — it is the shelf behind them.
The papers behind each calculation
This list is books, tables and programs. The method papers, by Allen, Bearden, Berglund, Bragg, Caglioti, Chantler, Cochran, Cordero, Cromer, Debye, Fischer, Flack, Foadi, Grosse-Kunstleve, Hall, Karle, Karplus, Klyne, Kramers, Křivý, Le Page, Moseley, Moss, Oszlányi, Patterson, Possolo, Prohaska, Ryan, Sayre, Smith, Sonneveld, Spek, Stokes, Thompson, Trueblood, Visser, Wang, Williamson, Wilson and de Wolff as first authors, are cited on the pages whose calculations they are, in a Where this comes from panel at the foot of each: 64 papers across 27 pages, each with the DOI. A source sits beside the thing it is the source of, which is why they are not repeated here.
Start here
One book, if you are going to read one. It assumes no crystallography and gets as far as space groups and diffraction without ever asking you to take a symmetry argument on trust, which is rarer than it sounds. Its author has kept a blog on the same subject for years, and that is where the book carries on.
- Introduction to Crystallography
- Frank Hoffmann, Springer, 2020
- Symmetry from the ground up: point groups, the 230 space groups, how to read an International Tables page, and what a diffraction pattern is telling you. It is the book to read alongside the space group tables here.
- Faszination Kristalle und Symmetrie
- Frank Hoffmann, Springer Spektrum, 2016
- The German original of the same book, under a different title.
- The Fascination of Crystals and Symmetry
- Frank Hoffmann, Universität Hamburg
- The same author’s blog, named after the German edition above, and the one place on this list that is still being written. Its space group diagrams are worked through group by group, and there is a long run of posts on nets and topology that this site does not touch at all. It is the nearest thing to a commentary on the space group tables here.
Textbooks for the next step
Four books on solving and refining a structure from single-crystal data, and two on powder diffraction. They are where the methods behind the pages here are set out properly, with the experiment around them.
- Crystal Structure Determination
- Werner Massa, Springer, 2nd edition, 2004
- The short route from a crystal to a refined structure, one chapter per step. The best first book after an introduction, and the companion to the structure factor and the sign relations here.
- Crystal Structure Analysis: A Primer
- Jenny Pickworth Glusker and Kenneth N. Trueblood, Oxford University Press, 3rd edition, 2010
- Ideas before algebra: what a diffraction experiment measures and how a structure is got from it, for a reader who will use structures more than solve them.
- Crystal Structure Analysis: Principles and Practice
- William Clegg, Alexander J. Blake, Jacqueline M. Cole, John S. O. Evans, Peter Main, Simon Parsons and David J. Watkin, Oxford University Press, 2nd edition, 2009
- The course of the British Crystallographic Association’s school, written by the people who teach it: symmetry, data collection, Patterson and direct methods, refinement and validation, each by a specialist.
- Crystal Structure Refinement: A Crystallographer’s Guide to SHELXL
- Peter Müller, Regine Herbst-Irmer, Anthony L. Spek, Thomas R. Schneider and Michael R. Sawaya, Oxford University Press, 2006
- Disorder, twinning, restraints and the other things a real refinement runs into, worked through with the program most people use. It is what to read after the agreement factors stop telling you anything.
- Fundamentals of Powder Diffraction and Structural Characterization of Materials
- Peter Y. Zavalij and Vitalij K. Pecharsky, Springer, 3rd edition, 2025
- Powder diffraction from the lattice to a refined structure, with worked examples: indexing, profile fitting, Rietveld refinement. Earlier editions put Pecharsky first. The book behind indexing and peak fitting here.
- Powder Diffraction: Theory and Practice
- Robert E. Dinnebier and Simon J. L. Billinge (editors), Royal Society of Chemistry, 2008
- Chapters by specialists on each part of the method, from the instrument to line-profile analysis and total scattering. The place to go beyond line broadening here.
The tables this site computes from
These are the published sources the calculators are built on. Where a dataset is shipped with the site it was generated from the source below by a script in the repository, never transcribed by hand.
- International Tables for Crystallography
- International Union of Crystallography
- The reference work. Volume A is the 230 space groups — their symmetry operations, general and special positions, and reflection conditions; Volume C carries the atomic scattering factors behind the structure factor.
- spglib
- Atsushi Togo and contributors
- A crystal symmetry library whose database encodes the symmetry operations of all 530 settings the Tables list. It is the machine-readable route to Volume A used here: the operations are read from it, and everything this site says about a space group — the conditions, the elements, the general position — is derived from those operations rather than transcribed.
- Atomic weights and isotopic compositions
- NIST, Physical Measurement Laboratory
- The isotope masses and representative abundances behind the isotope pattern. Every mass on this site that is not a standard atomic weight comes from here.
- Standard atomic weights
- CIAAW, the IUPAC commission
- The atomic weights and their uncertainties, which is what an elemental analysis and a molar mass are built from. For fourteen elements the value is an interval rather than a number, because the isotopic composition of normal materials genuinely varies.
- XrayDB
- Matthew Newville and contributors
- A public-domain compilation of X-ray data, and the route this site takes to Chantler’s relativistic tabulation (NIST FFAST). The anomalous scattering factors f′ and f″ behind the Friedif value, the mass attenuation coefficients behind the absorption calculator, and every absorption-edge energy this site states come from here. It also carries the Elam, Ravel and Sieber tables, which the gate over that data uses as an independent second opinion rather than as a source.
- X-Ray Data Booklet
- Center for X-ray Optics and Advanced Light Source, Lawrence Berkeley National Laboratory
- The pocket reference for X-ray properties of the elements. Its Table 1-3, the emission lines with their relative intensities, gives the Kβ height drawn on the tube spectrum and the starting ratio of the nickel filter on the absorption calculator.
- X-Ray Diffraction Procedures for Polycrystalline and Amorphous Materials
- H. P. Klug and L. E. Alexander, Wiley, 2nd edition, 1974
- The mass absorption coefficients this site shipped until August 2026, for Z up to 83 at three wavelengths; the absorption calculator computes them at any wavelength now and its numbers differ from these by a few per cent. It is also the standard account of powder diffraction as an experiment — specimen preparation, line broadening, quantitative analysis — which is the half this site does not compute, and the reason it stays on this list.
The programs a determination actually uses
Everything on this site computes one quantity from a structure you already have. Getting that structure out of measured intensities, refining it, and deciding whether it is right are jobs for the programs below — which is what a working crystallographer spends the day in, and what this site deliberately does not try to be.
- SHELX
- George M. Sheldrick, Universität Göttingen
- The programs most small-molecule structures are solved and refined with: SHELXT determines the space group and the structure from the intensities, SHELXL refines it. The phase problem that Patterson, direct methods and charge flipping demonstrate here is what SHELXT solves for real, and the difference map is the step SHELXL runs at every refinement cycle.
- A short history of SHELX
- George M. Sheldrick, Acta Cryst. A64, 112 (2008)
- The paper to cite, and a readable account of how the direct-methods era gave way to the dual-space algorithms these programs use now.
- Olex2
- OlexSys, Durham University
- A graphical environment that drives solution, refinement and reporting in one place, with a structure viewer beside the numbers. It is where most people meet SHELX rather than at a command line, and it writes the CIF that the parser here reads.
- OLEX2: a complete structure solution, refinement and analysis program
- Dolomanov, Bourhis, Gildea, Howard & Puschmann, J. Appl. Cryst. 42, 339 (2009)
- The paper to cite.
- PLATON
- Anthony L. Spek, Utrecht University
- The validation program: it checks a finished structure for the mistakes that survive a good refinement. Several pages here answer questions it made standard: the missed-symmetry search on the geometry page is its ADDSYM, and the distances, angles, torsions, hydrogen bonds and solvent-accessible voids beside it are its geometry report. Two it does that this site does not: SQUEEZE, which takes the scattering of disordered solvent out of the data before refinement, and the full set of validation tests behind the IUCr’s checkCIF report — this site borrows a few of its thresholds, not the list.
- Structure validation in chemical crystallography
- Anthony L. Spek, Acta Cryst. D65, 148 (2009)
- The paper to cite, and the argument for validating a structure at all: what an R factor cannot tell you.
Formats, dictionaries and structures
Where to look a definition up, and where to find a structure to put through the calculators here.
- The CIF format
- International Union of Crystallography
- The specification and the data dictionaries for the file format the CIF parser reads.
- Online Dictionary of Crystallography
- International Union of Crystallography
- Short, careful definitions, written by the people who set the terminology. Useful whenever a word on this site is doing more work than it looks like it is.
- Crystallography Open Database
- COD
- Open-access crystal structures, as CIFs. A good source of real files to drop into the parser or the geometry page.
- Cambridge Structural Database
- CCDC
- Organic and metal-organic structures. Single entries can be viewed and downloaded free; the database as a whole, and the software that searches it, are licensed.
- Inorganic Crystal Structure Database
- FIZ Karlsruhe
- Inorganic structures, the counterpart of the Cambridge database for minerals, ceramics and metals. Licensed.
- Powder Diffraction File
- International Centre for Diffraction Data
- The reference patterns search-match software identifies a phase against, which is the usual first thing done with a peak list. Licensed.
Why the sources are listed
A number is only as good as where it came from. Everything this site computes rests on the published work above, and the shipped datasets are generated from it by script — so a value here can be traced to a source, and a correction upstream reaches this site by rerunning a generator rather than by somebody retyping a table.
If a number on this site disagrees with one of these sources, the source is right and this site has a bug — please say so.