1 | r""" |
---|
2 | Definition |
---|
3 | ---------- |
---|
4 | |
---|
5 | This model provides the form factor for an elliptical cylinder with a |
---|
6 | core-shell scattering length density profile. Thus this is a variation |
---|
7 | of the core-shell bicelle model, but with an elliptical cylinder for the core. |
---|
8 | Outer shells on the rims and flat ends may be of different thicknesses and |
---|
9 | scattering length densities. The form factor is normalized by the total particle volume. |
---|
10 | |
---|
11 | |
---|
12 | .. figure:: img/core_shell_bicelle_geometry.png |
---|
13 | |
---|
14 | Schematic cross-section of bicelle. Note however that the model here |
---|
15 | calculates for rectangular, not curved, rims as shown below. |
---|
16 | |
---|
17 | .. figure:: img/core_shell_bicelle_parameters.png |
---|
18 | |
---|
19 | Cross section of model used here. Users will have |
---|
20 | to decide how to distribute "heads" and "tails" between the rim, face |
---|
21 | and core regions in order to estimate appropriate starting parameters. |
---|
22 | |
---|
23 | Given the scattering length densities (sld) $\rho_c$, the core sld, $\rho_f$, |
---|
24 | the face sld, $\rho_r$, the rim sld and $\rho_s$ the solvent sld, the |
---|
25 | scattering length density variation along the bicelle axis is: |
---|
26 | |
---|
27 | .. math:: |
---|
28 | |
---|
29 | \rho(r) = |
---|
30 | \begin{cases} |
---|
31 | &\rho_c \text{ for } 0 \lt r \lt R; -L \lt z\lt L \\[1.5ex] |
---|
32 | &\rho_f \text{ for } 0 \lt r \lt R; -(L+2t) \lt z\lt -L; |
---|
33 | L \lt z\lt (L+2t) \\[1.5ex] |
---|
34 | &\rho_r\text{ for } 0 \lt r \lt R; -(L+2t) \lt z\lt -L; L \lt z\lt (L+2t) |
---|
35 | \end{cases} |
---|
36 | |
---|
37 | The form factor for the bicelle is calculated in cylindrical coordinates, where |
---|
38 | $\alpha$ is the angle between the $Q$ vector and the cylinder axis, and $\psi$ is the angle |
---|
39 | for the ellipsoidal cross section core, to give: |
---|
40 | |
---|
41 | .. math:: |
---|
42 | |
---|
43 | I(Q,\alpha,\psi) = \frac{\text{scale}}{V_t} \cdot |
---|
44 | F(Q,\alpha, \psi)^2.sin(\alpha) + \text{background} |
---|
45 | |
---|
46 | where a numerical integration of $F(Q,\alpha, \psi)^2.sin(\alpha)$ is carried out over \alpha and \psi for: |
---|
47 | |
---|
48 | .. math:: |
---|
49 | |
---|
50 | \begin{align} |
---|
51 | F(Q,\alpha,\psi) = &\bigg[ |
---|
52 | (\rho_c - \rho_f) V_c \frac{2J_1(QR'sin \alpha)}{QR'sin\alpha}\frac{sin(QLcos\alpha/2)}{Q(L/2)cos\alpha} \\ |
---|
53 | &+(\rho_f - \rho_r) V_{c+f} \frac{2J_1(QR'sin\alpha)}{QR'sin\alpha}\frac{sin(Q(L/2+t_f)cos\alpha)}{Q(L/2+t_f)cos\alpha} \\ |
---|
54 | &+(\rho_r - \rho_s) V_t \frac{2J_1(Q(R'+t_r)sin\alpha)}{Q(R'+t_r)sin\alpha}\frac{sin(Q(L/2+t_f)cos\alpha)}{Q(L/2+t_f)cos\alpha} |
---|
55 | \bigg] |
---|
56 | \end{align} |
---|
57 | |
---|
58 | where |
---|
59 | |
---|
60 | .. math:: |
---|
61 | |
---|
62 | R'=\frac{R}{\sqrt{2}}\sqrt{(1+X_{core}^{2}) + (1-X_{core}^{2})cos(\psi)} |
---|
63 | |
---|
64 | |
---|
65 | and $V_t = \pi.(R+t_r)(Xcore.R+t_r)^2.(L+2.t_f)$ is the total volume of the bicelle, |
---|
66 | $V_c = \pi.Xcore.R^2.L$ the volume of the core, $V_{c+f} = \pi.Xcore.R^2.(L+2.t_f)$ |
---|
67 | the volume of the core plus the volume of the faces, $R$ is the radius |
---|
68 | of the core, $Xcore$ is the axial ratio of the core, $L$ the length of the core, |
---|
69 | $t_f$ the thickness of the face, $t_r$ the thickness of the rim and $J_1$ the usual |
---|
70 | first order bessel function. The core has radii $R$ and $Xcore.R$ so is circular, |
---|
71 | as for the core_shell_bicelle model, for $Xcore$ =1. Note that you may need to |
---|
72 | limit the range of $Xcore$, especially if using the Monte-Carlo algorithm, as |
---|
73 | setting radius to $R/Xcore$ and axial ratio to $1/Xcore$ gives an equivalent solution! |
---|
74 | |
---|
75 | The output of the 1D scattering intensity function for randomly oriented |
---|
76 | bicelles is then given by integrating over all possible $\alpha$ and $\psi$. |
---|
77 | |
---|
78 | For oriented bicellles the *theta*, *phi* and *psi* orientation parameters only appear when fitting 2D data, |
---|
79 | see the :ref:`elliptical-cylinder` model for further information. |
---|
80 | |
---|
81 | |
---|
82 | .. figure:: img/elliptical_cylinder_angle_definition.jpg |
---|
83 | |
---|
84 | Definition of the angles for the oriented core_shell_bicelle_elliptical model. |
---|
85 | Note that *theta* and *phi* are currently defined differently to those for the core_shell_bicelle model. |
---|
86 | |
---|
87 | |
---|
88 | References |
---|
89 | ---------- |
---|
90 | |
---|
91 | .. [#] |
---|
92 | |
---|
93 | Authorship and Verification |
---|
94 | ---------------------------- |
---|
95 | |
---|
96 | * **Author:** Richard Heenan **Date:** December 14, 2016 |
---|
97 | * **Last Modified by:** Richard Heenan **Date:** December 14, 2016 |
---|
98 | * **Last Reviewed by:** Richard Heenan BEWARE 2d data yet to be checked **Date:** December 14, 2016 |
---|
99 | """ |
---|
100 | |
---|
101 | from numpy import inf, sin, cos |
---|
102 | |
---|
103 | name = "core_shell_bicelle_elliptical" |
---|
104 | title = "Elliptical cylinder with a core-shell scattering length density profile.." |
---|
105 | description = """ |
---|
106 | core_shell_bicelle_elliptical |
---|
107 | Elliptical cylinder core, optional shell on the two flat faces, and shell of |
---|
108 | uniform thickness on its rim (extending around the end faces). |
---|
109 | Please see full documentation for equations and further details. |
---|
110 | Involves a double numerical integral around the ellipsoid diameter |
---|
111 | and the angle of the cylinder axis to Q. |
---|
112 | Compare also the core_shell_bicelle and elliptical_cylinder models. |
---|
113 | """ |
---|
114 | category = "shape:cylinder" |
---|
115 | |
---|
116 | # pylint: disable=bad-whitespace, line-too-long |
---|
117 | # ["name", "units", default, [lower, upper], "type", "description"], |
---|
118 | parameters = [ |
---|
119 | ["radius", "Ang", 30, [0, inf], "volume", "Cylinder core radius"], |
---|
120 | ["x_core", "None", 3, [0, inf], "volume", "axial ratio of core, X = r_polar/r_equatorial"], |
---|
121 | ["thick_rim", "Ang", 8, [0, inf], "volume", "Rim shell thickness"], |
---|
122 | ["thick_face", "Ang", 14, [0, inf], "volume", "Cylinder face thickness"], |
---|
123 | ["length", "Ang", 50, [0, inf], "volume", "Cylinder length"], |
---|
124 | ["sld_core", "1e-6/Ang^2", 4, [-inf, inf], "sld", "Cylinder core scattering length density"], |
---|
125 | ["sld_face", "1e-6/Ang^2", 7, [-inf, inf], "sld", "Cylinder face scattering length density"], |
---|
126 | ["sld_rim", "1e-6/Ang^2", 1, [-inf, inf], "sld", "Cylinder rim scattering length density"], |
---|
127 | ["sld_solvent", "1e-6/Ang^2", 6, [-inf, inf], "sld", "Solvent scattering length density"], |
---|
128 | ["theta", "degrees", 90, [-360, 360], "orientation", "In plane angle"], |
---|
129 | ["phi", "degrees", 0, [-360, 360], "orientation", "Out of plane angle"], |
---|
130 | ["psi", "degrees", 0, [-360, 360], "orientation", "Major axis angle relative to Q"], |
---|
131 | ] |
---|
132 | |
---|
133 | # pylint: enable=bad-whitespace, line-too-long |
---|
134 | |
---|
135 | source = ["lib/sas_Si.c", "lib/polevl.c", "lib/sas_J1.c", "lib/gauss76.c", |
---|
136 | "core_shell_bicelle_elliptical.c"] |
---|
137 | |
---|
138 | demo = dict(scale=1, background=0, |
---|
139 | radius=30.0, |
---|
140 | x_core=3.0, |
---|
141 | thick_rim=8.0, |
---|
142 | thick_face=14.0, |
---|
143 | length=50.0, |
---|
144 | sld_core=4.0, |
---|
145 | sld_face=7.0, |
---|
146 | sld_rim=1.0, |
---|
147 | sld_solvent=6.0, |
---|
148 | theta=90, |
---|
149 | phi=0, |
---|
150 | psi=0) |
---|
151 | |
---|
152 | #qx, qy = 0.4 * cos(pi/2.0), 0.5 * sin(0) |
---|
153 | |
---|
154 | tests = [ |
---|
155 | [{'radius': 30.0, 'x_core': 3.0, 'thick_rim':8.0, 'thick_face':14.0, 'length':50.0}, 'ER', 1], |
---|
156 | [{'radius': 30.0, 'x_core': 3.0, 'thick_rim':8.0, 'thick_face':14.0, 'length':50.0}, 'VR', 1], |
---|
157 | |
---|
158 | [{'radius': 30.0, 'x_core': 3.0, 'thick_rim':8.0, 'thick_face':14.0, 'length':50.0, |
---|
159 | 'sld_core':4.0, 'sld_face':7.0, 'sld_rim':1.0, 'sld_solvent':6.0, 'background':0.0}, |
---|
160 | 0.015, 286.540286], |
---|
161 | ] |
---|