Debian Codegraph @

hugo/content/ref/sample/particle/ff/hard/pyramid3.md

raw
1 +++
2 title = "Pyramid3"
3 +++
4
5 ### Pyramid3
6
7 A truncated pyramid (frustum) with trigonal base.
8
9 <img src="/img/draw/ff/3d/Pyramid3.png" width="30%" >
10 <img src="/img/draw/ff/2d/Pyramid3_xy.svg" width="30%">
11 <img src="/img/draw/ff/2d/Pyramid3_xz.svg" width="30%">
12
13 #### Constructor
14
15 ```python
16 Pyramid3(L, H, alpha)
17 ```
18
19 Parameters:
20 - L, edge length of the trigonal base
21 - H, height
22 - alpha, dihedral angle $\alpha$ between the base and a side face.
23
24 Constraint:
25
26 $H \le \dfrac{\tan\alpha}{2\sqrt3} L$
27
28 The orthographic projection also shows the angle $\beta$ between the base and a side edge.
29 It is related to the dihedral angle through $\tan\alpha = 2\tan\beta$.
30
31 #### Usage
32
33 As for any other [Form factor](/ref/sample/particle/ff).
34
35 #### Implementation
36
37 Class [Pyramid3]({{% url-src %}}/Sample/HardParticle/Polyhedra.h) inherits from the interface class
38 {{% ref-class "Sample/Particle" "Formfactor" %}}.
39
40 Form factor computation is based on the generic form factor of a polyhedron
41 provided by {{% link-libformfactor %}}.
42
43 Volume [has been validated]({{% url-src %}}/Tests/Unit/Sample/FormfactorBasicTest.cpp)
44 against
45 $$ V=\dfrac{L^3\tan\alpha}{24}\Big[1-\Big(1-\dfrac{2\sqrt3H}{L\tan\alpha}\Big)^3\Big]. $$
46
47 #### Related shapes
48
49 More special:
50 - [Prism3](/ref/sample/particle/ff/hard/prism3), if $\alpha=90^{\circ}$.
51 - [PlatonicTetrahedron](/ref/sample/particle/ff/hard/platonictetrahedron), if regular and not truncated.
52
53 #### Example
54
55 Scattering by uncorrelated, oriented pyramids for horizontal incidence. Rotation around $z$ axis:
56
57 <img src="/img/auto/ff/Pyramid3.png">
58
59 Generated by {{% ref-ex "sas/sas-ff.py" %}} (`particle_geometry=Pyramid3`).
60
61 #### History
62
63 Was incorrectly named "Tetrahedron" up to BornAgain 1.19.
64
65 Corresponds to "Tetrahedron" in IsGISAXS [Lazzari, IsGISAXS manual v2.6 (2006)](http://www.insp.upmc.fr/oxydes/IsGISAXS/figures/doc/manual.html), Eq. 2.29;
66 [Renaud et al, Surf Sci Rep 64, 255 (2009)](https://doi.org/10.1016/j.surfrep.2009.07.002), Eq. 220 and "Truncated tetrahedron" in FitGISAXS [Babonneau, FitGISAXS v130531 (2013)](https://pprime.fr/wp-content/uploads/2020/01/FitGISAXS_130531.zip). 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).
67
68 Up to BornAgain 1.5, we computed the form factor by numeric integration, as in
69 IsGISAXS. Since BornAgain 1.6 higher speed and accuracy are achieved by using the
70 generic form factor of a polyhedron [Wuttke, J Appl Cryst 54, 580 (2021)](https://doi.org/10.1107/S1600576721001710) with series expansions near singularities.