Debian Codegraph @

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

raw
1 +++
2 title = "HorizontalCylinder"
3 +++
4
5 ### HorizontalCylinder
6
7 A horizontal truncated circular cylinder along x-axis
8
9 <img src="/img/draw/ff/3d/HorizontalCylinder.png" width="30%" >
10 <img src="/img/draw/ff/2d/HorizontalCylinder_xz.svg" width="30%">
11 <img src="/img/draw/ff/2d/HorizontalCylinder_yz.svg" width="30%">
12
13 #### Constructor
14
15 Full form
16 ```python
17 HorizontalCylinder(R, H, t, b)
18 ```
19 and short form
20 ```python
21 HorizontalCylinder(R, H) == HorizontalCylinder(R, H, 0, 0)
22 ```
23
24 Parameters:
25 - $ R $, radius
26 - $ H $, height
27 - $ t $, cut from top
28 - $ b $, cut from bottom
29
30 Constraint:
31
32 $ 2R - t - b \ge 0 $
33
34 #### Usage
35
36 As for any other [Form factor](/ref/sample/particle/ff).
37
38 #### Implementation
39
40 Class {{% ref-class "Sample/HardParticle" "HorizontalCylinder" %}} inherits from the interface class
41 {{% ref-class "Sample/Particle" "Formfactor" %}}.
42
43 Form factor is computed as
44
45 $$ F(\mathbf{q})=2 L \space \text{sinc}\Big(q_x\dfrac{L}{2}\Big) \exp\[iq_z(R-b)\]
46 \int_{-R+b}^{R-t} \text{d}z \space \sqrt{R^2-z^2} \space \text{sinc}(q_y\sqrt{R^2-z^2}) \exp\[iq_z z\] , $$
47
48 Volume [has been validated]({{% url-src %}}/Tests/Unit/Sample/FormfactorBasicTest.cpp)
49 against
50 $$V=L \Big\( (R-t)\sqrt{2Rt-t^2}- (R-b)\sqrt{2Rb-b^2} + R^2 \Big\[\text{asin}\Big(1-\frac{t}{R}\Big) + \text{asin}\Big(1-\frac{b}{R}\Big) \Big\]
51 \Big\).$$
52
53 #### Related shapes
54
55 More general:
56 - [Cylinder](/ref/sample/particle/ff/hard/cylinder), if vertical and non-truncated.
57
58 #### Example
59
60 Scattering by uncorrelated, oriented horizontal truncated cylinders for horizontal incidence. Rotation around $z$ axis:
61
62 <img src="/img/auto/ff/HorizontalCylinder.png">
63
64 Generated by {{% ref-ex "sas/sas-ff.py" %}} (`particle_geometry=HorizontalCylinder`).
65
66 #### History
67
68 Introduced in BornAgain 1.20.
69
70 API has changed in v24.