Pyramid3

A truncated pyramid (frustum) with trigonal base.

Constructor

Pyramid3(L, H, alpha)

Parameters:

  • L, edge length of the trigonal base
  • H, height
  • alpha, dihedral angle $\alpha$ between the base and a side face.

Constraint:

$H \le \dfrac{\tan\alpha}{2\sqrt3} L$

The orthographic projection also shows the angle $\beta$ between the base and a side edge. It is related to the dihedral angle through $\tan\alpha = 2\tan\beta$.

Usage

As for any other Form factor.

Implementation

Class Pyramid3 inherits from the interface class Formfactor.

Form factor computation is based on the generic form factor of a polyhedron provided by libformfactor .

Volume has been validated against $$ V=\dfrac{L^3\tan\alpha}{24}\Big[1-\Big(1-\dfrac{2\sqrt3H}{L\tan\alpha}\Big)^3\Big]. $$

More special:

Example

Scattering by uncorrelated, oriented pyramids for horizontal incidence. Rotation around $z$ axis:

Generated by Examples/sas/sas-ff.py (particle_geometry=Pyramid3).

History

Was incorrectly named “Tetrahedron” up to BornAgain 1.19.

Corresponds to “Tetrahedron” in IsGISAXS Lazzari, IsGISAXS manual v2.6 (2006), Eq. 2.29; Renaud et al, Surf Sci Rep 64, 255 (2009), Eq. 220 and “Truncated tetrahedron” in FitGISAXS Babonneau, FitGISAXS v130531 (2013). In BornAgain 1.6, redefined to let the $x$ axis lie in a mirror plane (rotated by $30^{\circ}$ with respect to the previous version).

Up to BornAgain 1.5, we computed the form factor by numeric integration, as in IsGISAXS. Since BornAgain 1.6 higher speed and accuracy are achieved by using the generic form factor of a polyhedron Wuttke, J Appl Cryst 54, 580 (2021) with series expansions near singularities.