Debian Codegraph @

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

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