Debian Codegraph @

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

raw
1 +++
2 title = "EllipsoidalSegment"
3 +++
4
5 ### EllipsoidalSegment
6
7 A horizontally truncated ellipsoid.
8
9 <img src="/img/draw/ff/3d/EllipsoidalSegment.png" width="30%" >
10 <img src="/img/draw/ff/2d/EllipsoidalSegment_xy.svg" width="30%">
11 <img src="/img/draw/ff/2d/EllipsoidalSegment_xz.svg" width="30%">
12
13 #### Constructor
14
15 ```python
16 EllipsoidalSegment(R_x, R_y, R_z, t, b)
17 ```
18
19 Parameters:
20 - R_x, radius $R_{x}$ in $x$ direction
21 - R_y, radius $R_{y}$ in $y$ direction
22 - R_z, radius $R_{z}$ in $z$ direction
23 - $ t $, cut from top
24 - $ b $, cut from bottom
25
26 #### Usage
27
28 As for any other [Form factor](/ref/sample/particle/ff).
29
30 #### Implementation
31
32 Class {{% ref-class "Sample/HardParticle" "EllipsoidalSegment" %}} inherits from the interface class
33 {{% ref-class "Sample/Particle" "Formfactor" %}}.
34
35 Computation involves numerical integration in vertical direction,
36
37 $$ F(\mathbf{q})=2\pi \exp\[iq_z(R_z-b)\] \int_{-R_z+b}^{R_z-t} \text{d}z \space r_{x,z} r_{y,z} \frac{J_1(\gamma_{z})}{\gamma_{z}} \thinspace \exp(iq_z z) , $$
38
39 with the notation
40
41 $$ r_{x,z}:=R_{x}\sqrt{1-\Big( \dfrac{z}{R_z} \Big)^2}, \quad r_{y,z}:=R_{y}\sqrt{1-\Big( \dfrac{z}{R_z} \Big)^2}, $$
42
43 $$ \quad \gamma_{z} := \sqrt{(q_xr_{x,z})^2 + (q_yr_{y,z})^2}. $$
44
45 Volume [has been validated]({{% url-src %}}/Tests/Unit/Sample/FormfactorBasicTest.cpp)
46 against
47 $$ V=\dfrac{\pi}{3} \frac{R_{x}R_{y}}{R_z^2} \[ 4R_z^3 - 3R_z(t^2+b^2) + (t^3 + b^3) \]. $$
48
49 #### Related shapes
50
51 More special truncated shapes:
52
53 - [SpheroidalSegment](/ref/sample/particle/ff/hard/spheroidalsegment), if $R_x=R_y$.
54 - [SphericalSegment](/ref/sample/particle/ff/hard/sphericalsegment), if $R_x=R_y=R_z$.
55
56 More special full shapes, if $t=b=0$:
57
58 - [Ellipsoid](/ref/sample/particle/ff/hard/ellipsoid)
59 - [Spheroid](/ref/sample/particle/ff/hard/spheroid)
60 - [Sphere](/ref/sample/particle/ff/hard/sphere)
61
62 #### Example
63
64 Scattering by uncorrelated, oriented truncated ellipsoids for horizontal incidence. Rotation around $z$ axis:
65
66 <img src="/img/auto/ff/EllipsoidalSegment.png">
67
68 Generated by {{% ref-ex "sas/sas-ff.py" %}} (`particle_geometry=EllipsoidalSegment`).
69
70 #### History
71
72 Up to v23 the formfactor "HemiEllipsoid" was used, which agreed with the IsGISAXS form factor "Anisotropic hemi-ellipsoid" [Lazzari, IsGISAXS manual v2.6 (2006)](http://www.insp.upmc.fr/oxydes/IsGISAXS/figures/doc/manual.html), Eq. 2.41 with wrong sign in the z-dependent phase factor and "Hemi-spheroid" [Renaud et al, Surf Sci Rep 64, 255 (2009)](https://doi.org/10.1016/j.surfrep.2009.07.002), Eq. 229.