| 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. |