Materials

The optical properties of a homogeneous material can be specified by:

  • RefractiveMaterial, with a refractive index;
  • SLDMaterial, with scattering length density (SLD).

Both classes accept either constant values or a table of wavelength-dependent optical constants.

These constructors take a material name and an RGB color tuple. The color is used only for visualization.

Both representations can describe X-rays or neutrons. For SLDMaterial, BornAgain computes the refractive index from the SLD at the requested wavelength. Use the table constructor when the native optical constants vary significantly over the scan or beam-resolution range.

Material by refractive index

A Material can be created through

color = (0.8, 0.2, 0.2)
material = ba.RefractiveMaterial("name", color, delta, beta)

where name is the arbitrary name of the material associated with its complex refractive index $n = 1 - \delta + i\beta$.

Optionally, the constructor takes an additional magnetization argument.

Material by scattering length density

A Material can also be created through

color = (0.8, 0.2, 0.2)
material = ba.SLDMaterial("name", color, sld_real, sld_imag)

Here sld_real and sld_imag are the real and imaginary parts of the material scattering length density (SLD) according to the following convention (Sears, Neutron News 3, 26 (1992)):

$$SLD = sld_{real} - i \cdot sld_{imag}$$

Here sld_imag is the absorption, which must be nonnegative.

SLD units are inverse square angstroms: Å⁻².

Optionally, the constructor takes an additional magnetization argument.

Magnetization units are ampere per meter: $ A/m $.

Obtaining optical constants

BornAgain contains no material database or chemical formula parser. See Materials from chemical formulas for external calculators and for direct use of the periodictable Python package.

Vacuum

Use the dedicated Vacuum material for ambient layers:

material = ba.Vacuum()
Restrictions and limitations

Constant and tabulated materials can be used in the same sample. Volume averaging preserves the wavelength dependence of each constituent.

SLDMaterial does not account for causes of damping other than nuclear absorption. In particular, incoherent and inelastic scattering are neglected. Usually, such extra damping would change the imaginary part of the refractive index only little compared with the real part; neglecting it therefore should have no big effect upon simulation results.