X-ray polarization

By default, BornAgain computes scalar waves, as for unpolarized neutrons. For x-rays, this approximation neglects polarization. Setting an x-ray polarization makes beam or scan an x-ray beam or scan:

# GISAXS:
beam.setXrayPolarization(angle, axis_ratio, degree)
# specular, offspec, depthprobe:
scan.setXrayPolarization(angle, axis_ratio, degree)

The electric field describes an ellipse in the basis of the s and p waves, which have their electric field perpendicular to the plane of incidence and in it. All three arguments are required:

  • angle: angle of the major axis from s toward p, in radians;
  • axis_ratio: ratio of minor to major axis in $[-1, 1]$, 0 for linear and $\pm 1$ for circular polarization, positive if the field rotates from s toward p;
  • degree: degree of polarization in $[0, 1]$.

The direction of s is $\hat z \times \mathbf{k}$, that of p is $\hat{\mathbf{k}} \times s$, for wavevector $\mathbf{k}$ and surface normal $\hat z$.

For example:

beam.setXrayPolarization(angle=0, axis_ratio=0, degree=1)       # s
beam.setXrayPolarization(angle=90*deg, axis_ratio=0, degree=1)  # p
beam.setXrayPolarization(angle=45*deg, axis_ratio=0, degree=1)  # linear, 45°
beam.setXrayPolarization(angle=0, axis_ratio=1, degree=1)       # circular
beam.setXrayPolarization(angle=0, axis_ratio=0, degree=0)       # unpolarized

Unpolarized x-rays, as from a lab source, have degree 0, whatever the ellipse. In general,

beam.setXrayPolarization(angle=30*deg, axis_ratio=0.5, degree=0.8)

describes a beam in which 80 % of the intensity is in a pure elliptical state and 20 % is unpolarized. In the pure state, the electric field traces an ellipse whose major axis is rotated by 30° from s toward p, and whose minor axis is half as long; the field runs along the ellipse from s toward p. With axis_ratio=-0.5, it runs the other way round on the same ellipse. For circular polarization, the angle has no effect.

The polarization setter chooses the radiation: setPolarization makes beam or scan neutrons, setXrayPolarization x-rays; the last call counts.

An analyzer selects a pure polarization, given by the same ellipse, whose angle and axis_ratio are required:

# GISAXS and offspec:
detector.setXrayAnalyzer(
    angle, axis_ratio,
    transmission_selected=1, transmission_suppressed=0,
    frame="local"  # or "specular"
)
# specular reflectivity:
scan.setXrayAnalyzer(
    angle, axis_ratio,
    transmission_selected=1, transmission_suppressed=0
)

It transmits the fraction transmission_selected (optional, default 1) of the selected polarization, and transmission_suppressed (optional, default 0) of the orthogonal polarization. An x-ray beam requires an x-ray analyzer, if any, and vice versa; setAnalyzer sets a neutron analyzer.

The analyzer ellipse uses s and p of a wave: s is perpendicular to the plane through its wavevector and the surface normal, while p lies in that plane. In GISAXS and offspec, the optional frame chooses this wave:

  • "local" (default): the analyzer faces each outgoing ray, with its own s and p axes;
  • "specular": one fixed analyzer faces the specular ray of the nominal beam, without divergence or resolution, and also receives the scattered rays. For each ray, it selects the normalized projection of its selected field perpendicular to that ray.

Both frames agree on the specular wave. Away from it, the specular frame can turn circular into elliptical polarization. Where the selected field is parallel to an outgoing ray, the simulation raises an error unless the transmissions are equal. The specular frame is an idealization: a real analyzer responds differently to oblique rays.

Outside the plane of incidence, scattering converts s waves to p waves and vice versa.

Depthprobe yields the intensity of the electric field, which depends only on the intensities of the s and p waves; for s or p waves also its modulus, and the phase of the scalar field, which is the electric field for s waves and the magnetic field for p waves. Depthprobe does not support an analyzer.

Material magnetization is ignored for x-rays, so that the same sample model serves for neutrons and x-rays. Qz scans support only s waves, since p waves depend on the wavelength.

Examples