+++
title = "EllipsoidalSegment"
+++
### EllipsoidalSegment
A horizontally truncated ellipsoid.
#### Constructor
```python
EllipsoidalSegment(R_x, R_y, R_z, t, b)
```
Parameters:
- R_x, radius $R_{x}$ in $x$ direction
- R_y, radius $R_{y}$ in $y$ direction
- R_z, radius $R_{z}$ in $z$ direction
- $ t $, cut from top
- $ b $, cut from bottom
#### Usage
As for any other [Form factor](/ref/sample/particle/ff).
#### Implementation
Class {{% ref-class "Sample/HardParticle" "EllipsoidalSegment" %}} inherits from the interface class
{{% ref-class "Sample/Particle" "Formfactor" %}}.
Computation involves numerical integration in vertical direction,
$$ 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) , $$
with the notation
$$ 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}, $$
$$ \quad \gamma_{z} := \sqrt{(q_xr_{x,z})^2 + (q_yr_{y,z})^2}. $$
Volume [has been validated]({{% url-src %}}/Tests/Unit/Sample/FormfactorBasicTest.cpp)
against
$$ 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) \]. $$
#### Related shapes
More special truncated shapes:
- [SpheroidalSegment](/ref/sample/particle/ff/hard/spheroidalsegment), if $R_x=R_y$.
- [SphericalSegment](/ref/sample/particle/ff/hard/sphericalsegment), if $R_x=R_y=R_z$.
More special full shapes, if $t=b=0$:
- [Ellipsoid](/ref/sample/particle/ff/hard/ellipsoid)
- [Spheroid](/ref/sample/particle/ff/hard/spheroid)
- [Sphere](/ref/sample/particle/ff/hard/sphere)
#### Example
Scattering by uncorrelated, oriented truncated ellipsoids for horizontal incidence. Rotation around $z$ axis:
Generated by {{% ref-ex "sas/sas-ff.py" %}} (`particle_geometry=EllipsoidalSegment`).
#### History
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.