xraytools.

Displacement Parameters and NPD Atoms

Single-crystal data

A refined structure does not give an atom a position, it gives it a probability cloud — and the symmetry of the site decides what shape that cloud may have. Give a cell, a space group and the asymmetric unit: every site says how many of the six components of U a refinement could vary and what the rest are forced to be, and every tensor is drawn as the ellipsoid it describes. Paste measured values in and it also says whether they describe anything possible.

Before this
A refined atom is a probability cloud described by six numbers, and the symmetry of its site decides how many of them can vary independently. Site symmetry is the idea behind that.
You supply
A unit cell, a space group and one atom per line of the asymmetric unit — the same notation the geometry and structure factor pages read. Displacement parameters are optional: without them each site still shows what its symmetry allows, and every site is drawn.
Reading it
This site ships no measured displacement parameters for any structure, so with the box empty the values shown — and the ellipsoids drawn from them — are a generic tensor projected onto each site: they demonstrate the checks and measure nothing. Every ellipsoid is drawn at a stated probability level, because an unlabelled one is unreadable.

Worked examples: a sphere: one value, isotropic · stretched along c: only U33 raised · the same three displacements, tilted by U23 alone · not a possible atom: U23 pushed too far

Earlier on the path: Interatomic Distances and Angles Next on the path: Refinement Statistics and R Factors On How to read a published structure, step 3 of 4

Notation here: U, B — what each one means here

Terms here: asymmetric unit · general position · multiplicity · setting · site symmetry · zone

See also: Difference Map · Interatomic Distances and Angles · Refinement Statistics and R Factors

What each input changes
Displacement parameters
The six displacement components. Change one and the ellipsoid changes shape; push it too far and the tensor stops describing anything physical, which the page will say.
Space group
The site symmetry, which decides how many of the six a refinement could vary at all. The rest are not zero — they are forced.
Teaching with this page
Objective
After this page a learner can say what a displacement ellipsoid describes and recognise a tensor that describes nothing physical.
Start from
this worked example
Ask first
One atom’s ellipsoid is far larger than its neighbours’. Is that atom moving more?
Watch for
“Yes — that is what a displacement parameter measures”
Then
Refinement Statistics and R Factors
Check yourself: One atom’s ellipsoid is far larger than its neighbours’. Is that atom moving more?

Not established — disorder and a wrong element look the same Yes — that is what a displacement parameter measures

A displacement parameter measures the spread of electron density about the site, averaged over the whole crystal and the whole exposure. Thermal motion produces it; so does static disorder over two nearby positions, and so does the wrong element at the site, which puts the wrong number of electrons where the model expects them. The shape carries more than the size, and this page shows which shapes the site symmetry permits at all.

Unit cell
Å
Å
Å
°
°
°
Space group

Conditions belong to a setting, not to a space group number. Pnma, Pbnm and Pmcn are one space group with its axes labelled three ways, and the three tables differ: the glide that empties hk0 in one of them empties 0kl in another — a glide, because it is the fractional translation that makes a whole zone cancel, and a pure mirror carries none and empties nothing. Every setting in the International Tables is here with its own operations, so P21/n and P21/a answer for themselves.

Atoms in the asymmetric unit

The same notation the structure factor and geometry pages read, so a list works on any of the three. Only the coordinates matter here — a site is fixed by where it sits, not by what sits there.

Displacement parameters

Optional, and left empty every site still shows what its symmetry allows. One atom per line in this order, which is the order a CIF’s _atom_site_aniso_U_* loop writes them — so rows paste straight out of a file, brackets and all. A line carrying one value instead of six is an isotropic atom.

What the symmetry allows

A site is fixed by the operations that carry it onto itself, and a displacement tensor is allowed only where those same operations leave it unchanged — U = W U WT for every W that fixes the site. So the number of parameters a refinement can vary is a property of the position, not of the atom, and it is six only at a general position.

The independent components of U at each site. CSV
Atom Site symmetry Operations Multiplicity Free Independent Forced by the site
Si 2 2 3 4 U11, U22, U33, U23 U13 = U23/2, U12 = U22/2
O 1 1 6 6 U11, U22, U33, U23, U13, U12 nothing — a general position

The tensors

These values are constructed, not measured. The site ships no displacement parameters for any structure, so each row here is a generic tensor projected onto what its own site allows — which is why every relation in the table above already holds. Paste your own into the box on the left and the checks below become about your structure.

The six components, and the equivalent isotropic parameter they average to. CSV
Atom U11 U22 U33 U23 U13 U12 Ueq
Si 0.01725 0.01970 0.02710 0.00890 0.00445 0.00985 0.02108
O 0.01310 0.01970 0.02710 0.00890 0.00230 0.00570 0.02108

Every value is in Å2. Ueq is one third of the trace of the tensor in a Cartesian frame, which is what makes it independent of how the cell is set up — and it is not the average of U11, U22 and U33 unless the cell is orthogonal. The next panel has the formula and the size of the difference on this cell.

Why Ueq is not the average of the diagonal

Ueq is the mean-square displacement averaged over every direction, and the six Uij are components on the reciprocal basis — so averaging the three diagonal ones treats a*, b* and c* as though they were three perpendicular unit vectors. The published closed form does not:

Ueq = ⅓ ∑i ∑j Uij a*i a*j (ai · aj)

Everything in that sum except Uij is fixed by the cell, so it collapses to six weights wij = a*i a*j (ai · aj), and Ueq is ⅓ of their weighted sum. Averaging the diagonal is the special case where every weight is 1 or 0. For the cell above they are:

The weights this cell puts on each component. A property of the cell alone — no displacement parameter enters them. CSV
w11 w22 w33 w23 w13 w12
1.3333 1.3333 1.0000 0.0000 0.0000 −0.6667

They are not the identity, so the average of the diagonal is not Ueq on this cell. It is out by −5.27 % on O. The three diagonal weights are never below 1 — a*i · ai is 1 by definition, so the product of their lengths is 1/cos of the angle between them — while the cross weights carry the sign of the cosine of a cell angle and go either way. The error is therefore not a bias anyone could correct for: it lands on either side depending on which components are large.

The two averages, on the cell above and on a second basis for the same lattice. CSV
Atom ⅓(U11+U22+U33) Ueq Out by ⅓∑Uii, second basis Ueq, second basis
Si 0.02135 0.02108 +1.29 % 0.02116 0.02108
O 0.01997 0.02108 −5.27 % 0.02101 0.02108

The second basis is a’ = a, b’ = b, c’ = a + c — integer entries, determinant 1, so it spans the same lattice and describes the same atoms. Its constants are 4.9134 Å, 4.9134 Å, 7.3046 Å, 109.6529°, 47.7287°, 120.0000°. Nobody would choose it, and that is the point: being inconvenient is not a reason a physical quantity may change. The last column is unchanged to every digit printed. The one before it moves by +5.21 % on O, on the same atom, from the same measurement — because the trace of Uij is not a property of the atom at all. It transforms as P−T U P−1, which preserves no trace; a linear map, which does, would transform as P U P−1. Six numbers in Å2 laid out as a symmetric matrix look like something whose diagonal can be averaged. They are not.

Both rows above are the same generic tensor projected onto each site’s own allowed subspace, which is why their Ueq agree exactly: the projection averages over the site symmetry, every operation of which is an isometry, and an average over directions cannot see a rotation. What the projection does change is the six components, and with them ⅓(U11 + U22 + U33) — so on this page the wrong average disagrees between two atoms the right one calls identical.

The ellipsoid, drawn

A displacement parameter is a shape, and six numbers are not one. The surface below encloses a stated share of the atom’s probability: U11, U22 and U33 stretch it along the cell axes, and U23, U13 and U12 tilt it away from them. That is the whole distinction the table above cannot show — two tensors with the same three principal displacements can point in quite different directions.

Probability 50 %90 %99 % Seen from a general directiondown adown bdown c
Si: the shortest principal axis, 0.1173 ÅSi: the middle principal axis, 0.1282 ÅSi: the longest principal axis, 0.1818 Å
Si
O: the shortest principal axis, 0.1088 ÅO: the middle principal axis, 0.1307 ÅO: the longest principal axis, 0.1852 Å
O
ac
The cell axes

Every picture is drawn at one scale, so a wide ellipsoid beside a narrow one is a real difference and not a framing one, and at 90 % probability — the surface 90 atoms in 100 would be found inside, which is 2.5003 times each root-mean-square displacement. An ellipsoid with no level stated is not a drawing anybody can read: the crystallographic convention is 50 %, and the same atom at one standard deviation looks identical while being a third smaller. The dashed circle is the sphere of the same Ueq — the atom this would be if it were isotropic. The three arcs are the principal sections and the straight segments the principal axes. The cell axes seen down b. b points at the reader and is drawn as a ring. The axis directions are drawn as directions only, at a fixed length that says nothing about the cell constants.

The shape of the ellipsoid

The eigenvalues of U in a Cartesian frame are the mean-square displacements along its three principal axes, so their square roots are lengths a reader can picture. A tensor is physically possible only if all three are positive — the test is Sylvester’s criterion, which is an exact statement about the matrix and has no tolerance in it. What it does not carry is the uncertainty of the numbers that went in: a refined U has standard uncertainties of its own, so a tensor that fails by a hair is a flag to go and look rather than a proven impossibility, while one that fails by a wide margin is a fault in the refinement.

The rest of this site works in B, and the two are one quantity in two conventions: B = 8π²U, so B = 1 Å² is U = 0.0127 Å² and the factor between them is about 79. A CIF writes whichever its refinement used, which is why _atom_site_aniso_U_* and _atom_site_B_iso_or_equiv both exist. The relation holds as written for the isotropic and the equivalent isotropic values, and it holds component by component for the anisotropic ones too: _atom_site_aniso_B_ij = 8π² Uij. What does not scale that way is βij, the third convention a CIF may carry — βij = 2π²a*ia*jUij, which drags the reciprocal axis lengths in with it, so a β tensor multiplied through by 8π² is wrong by whatever those lengths are. Check which of the three a source used; the arithmetic itself is not in doubt.

Principal root-mean-square displacements, smallest first. CSV
Atom Smallest Middle Largest Anisotropy Possible?
Si 0.1173 0.1282 0.1818 2.40 yes
O 0.1088 0.1307 0.1852 2.90 yes

Displacements are in Å. The anisotropy is the ratio of the largest mean-square displacement to the smallest: 1 is a sphere. A row whose tensor is not possible shows no displacement along the offending axis, because the square root of a negative eigenvalue is not a length.

Sylvester’s criterion

A real symmetric matrix is positive definite exactly when its three leading principal minors are all greater than zero. That is the whole test — no eigenvalue solver, no threshold, and nothing to choose. An atom that fails it is the NPD atom a validation report flags: its ellipsoid has an imaginary axis, which is a sign that something in the refinement is wrong rather than merely uncertain.

The three leading principal minors. CSV
Atom U11 U11U22 − U122 det U
Si 1.725e-2 2.428e-4 5.604e-6
O 1.310e-2 2.256e-4 5.205e-6

Where this comes from