nmie-wrapper.cc 54 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147
  1. ///
  2. /// @file nmie-wrapper.cc
  3. /// @author Ladutenko Konstantin <kostyfisik at gmail (.) com>
  4. /// @date Tue Sep 3 00:38:27 2013
  5. /// @copyright 2013 Ladutenko Konstantin
  6. ///
  7. /// nmie-wrapper is free software: you can redistribute it and/or modify
  8. /// it under the terms of the GNU General Public License as published by
  9. /// the Free Software Foundation, either version 3 of the License, or
  10. /// (at your option) any later version.
  11. ///
  12. /// nmie-wrapper is distributed in the hope that it will be useful,
  13. /// but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. /// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15. /// GNU General Public License for more details.
  16. ///
  17. /// You should have received a copy of the GNU General Public License
  18. /// along with nmie-wrapper. If not, see <http://www.gnu.org/licenses/>.
  19. ///
  20. /// nmie-wrapper uses nmie.c from scattnlay by Ovidio Pena
  21. /// <ovidio@bytesfall.com> as a linked library. He has an additional condition to
  22. /// his library:
  23. // The only additional condition is that we expect that all publications //
  24. // describing work using this software , or all commercial products //
  25. // using it, cite the following reference: //
  26. // [1] O. Pena and U. Pal, "Scattering of electromagnetic radiation by //
  27. // a multilayered sphere," Computer Physics Communications, //
  28. // vol. 180, Nov. 2009, pp. 2348-2354. //
  29. ///
  30. /// @brief Wrapper class around nMie function for ease of use
  31. ///
  32. #include "nmie-wrapper.h"
  33. //#include "nmie.h"
  34. #include <array>
  35. #include <algorithm>
  36. #include <cstdio>
  37. #include <cstdlib>
  38. #include <stdexcept>
  39. #include <vector>
  40. namespace nmie {
  41. //helpers
  42. template<class T> inline T pow2(const T value) {return value*value;}
  43. #define round(x) ((x) >= 0 ? (int)((x) + 0.5):(int)((x) - 0.5))
  44. // ********************************************************************** //
  45. // ********************************************************************** //
  46. // ********************************************************************** //
  47. //emulate C call.
  48. int nMie_wrapper(int L, const std::vector<double>& x, const std::vector<std::complex<double> >& m,
  49. int nTheta, const std::vector<double>& Theta,
  50. double *Qext, double *Qsca, double *Qabs, double *Qbk, double *Qpr, double *g, double *Albedo,
  51. std::vector<std::complex<double> >& S1, std::vector<std::complex<double> >& S2) {
  52. if (x.size() != L || m.size() != L)
  53. throw std::invalid_argument("Declared number of layers do not fit x and m!");
  54. if (Theta.size() != nTheta)
  55. throw std::invalid_argument("Declared number of sample for Theta is not correct!");
  56. try {
  57. MultiLayerMie multi_layer_mie;
  58. multi_layer_mie.SetWidthSP(x);
  59. multi_layer_mie.SetIndexSP(m);
  60. multi_layer_mie.SetAngles(Theta);
  61. multi_layer_mie.RunMieCalculations();
  62. *Qext = multi_layer_mie.GetQext();
  63. *Qsca = multi_layer_mie.GetQsca();
  64. *Qabs = multi_layer_mie.GetQabs();
  65. *Qbk = multi_layer_mie.GetQbk();
  66. *Qpr = multi_layer_mie.GetQpr();
  67. *g = multi_layer_mie.GetAsymmetryFactor();
  68. *Albedo = multi_layer_mie.GetAlbedo();
  69. S1 = multi_layer_mie.GetS1();
  70. S2 = multi_layer_mie.GetS2();
  71. } catch( const std::invalid_argument& ia ) {
  72. // Will catch if multi_layer_mie fails or other errors.
  73. std::cerr << "Invalid argument: " << ia.what() << std::endl;
  74. return -1;
  75. }
  76. return 0;
  77. }
  78. // ********************************************************************** //
  79. // ********************************************************************** //
  80. // ********************************************************************** //
  81. double MultiLayerMie::GetQext() {
  82. if (!isMieCalculated_)
  83. throw std::invalid_argument("You should run calculations before result reques!");
  84. return Qext_;
  85. }
  86. // ********************************************************************** //
  87. // ********************************************************************** //
  88. // ********************************************************************** //
  89. double MultiLayerMie::GetQabs() {
  90. if (!isMieCalculated_)
  91. throw std::invalid_argument("You should run calculations before result reques!");
  92. return Qabs_;
  93. }
  94. // ********************************************************************** //
  95. // ********************************************************************** //
  96. // ********************************************************************** //
  97. double MultiLayerMie::GetQsca() {
  98. if (!isMieCalculated_)
  99. throw std::invalid_argument("You should run calculations before result reques!");
  100. return Qsca_;
  101. }
  102. // ********************************************************************** //
  103. // ********************************************************************** //
  104. // ********************************************************************** //
  105. double MultiLayerMie::GetQbk() {
  106. if (!isMieCalculated_)
  107. throw std::invalid_argument("You should run calculations before result reques!");
  108. return Qbk_;
  109. }
  110. // ********************************************************************** //
  111. // ********************************************************************** //
  112. // ********************************************************************** //
  113. double MultiLayerMie::GetQpr() {
  114. if (!isMieCalculated_)
  115. throw std::invalid_argument("You should run calculations before result reques!");
  116. return Qpr_;
  117. }
  118. // ********************************************************************** //
  119. // ********************************************************************** //
  120. // ********************************************************************** //
  121. double MultiLayerMie::GetAsymmetryFactor() {
  122. if (!isMieCalculated_)
  123. throw std::invalid_argument("You should run calculations before result reques!");
  124. return asymmetry_factor_;
  125. }
  126. // ********************************************************************** //
  127. // ********************************************************************** //
  128. // ********************************************************************** //
  129. double MultiLayerMie::GetAlbedo() {
  130. if (!isMieCalculated_)
  131. throw std::invalid_argument("You should run calculations before result reques!");
  132. return albedo_;
  133. }
  134. // ********************************************************************** //
  135. // ********************************************************************** //
  136. // ********************************************************************** //
  137. std::vector<std::complex<double> > MultiLayerMie::GetS1() {
  138. return S1_;
  139. }
  140. // ********************************************************************** //
  141. // ********************************************************************** //
  142. // ********************************************************************** //
  143. std::vector<std::complex<double> > MultiLayerMie::GetS2() {
  144. return S2_;
  145. }
  146. // ********************************************************************** //
  147. // ********************************************************************** //
  148. // ********************************************************************** //
  149. void MultiLayerMie::SetAngles(const std::vector<double>& angles) {
  150. isMieCalculated_ = false;
  151. theta_ = angles;
  152. // theta_.clear();
  153. // for (auto value : angles) theta_.push_back(value);
  154. } // end of SetAngles()
  155. // ********************************************************************** //
  156. // ********************************************************************** //
  157. // ********************************************************************** //
  158. void MultiLayerMie::SetWidthSP(const std::vector<double>& size_parameter) {
  159. isMieCalculated_ = false;
  160. size_parameter_.clear();
  161. double prev_size_parameter = 0.0;
  162. for (auto layer_size_parameter : size_parameter) {
  163. if (layer_size_parameter <= 0.0)
  164. throw std::invalid_argument("Size parameter should be positive!");
  165. if (prev_size_parameter > layer_size_parameter)
  166. throw std::invalid_argument
  167. ("Size parameter for next layer should be larger than the previous one!");
  168. prev_size_parameter = layer_size_parameter;
  169. size_parameter_.push_back(layer_size_parameter);
  170. }
  171. }
  172. // end of void MultiLayerMie::SetWidthSP(...);
  173. // ********************************************************************** //
  174. // ********************************************************************** //
  175. // ********************************************************************** //
  176. void MultiLayerMie::SetIndexSP(const std::vector< std::complex<double> >& index) {
  177. isMieCalculated_ = false;
  178. //index_.clear();
  179. index_ = index;
  180. // for (auto value : index) index_.push_back(value);
  181. } // end of void MultiLayerMie::SetIndexSP(...);
  182. // ********************************************************************** //
  183. // ********************************************************************** //
  184. // ********************************************************************** //
  185. void MultiLayerMie::SetPEC(int layer_position) {
  186. if (layer_position < 0)
  187. throw std::invalid_argument("Error! Layers are numbered from 0!");
  188. PEC_layer_position_ = layer_position;
  189. }
  190. // ********************************************************************** //
  191. // ********************************************************************** //
  192. // ********************************************************************** //
  193. void MultiLayerMie::SetMaxTermsNumber(int nmax) {
  194. nmax_ = nmax;
  195. }
  196. // ********************************************************************** //
  197. // ********************************************************************** //
  198. // ********************************************************************** //
  199. void MultiLayerMie::GenerateSizeParameter() {
  200. size_parameter_.clear();
  201. double radius = 0.0;
  202. for (auto width : target_width_) {
  203. radius += width;
  204. size_parameter_.push_back(2*PI*radius / wavelength_);
  205. }
  206. for (auto width : coating_width_) {
  207. radius += width;
  208. size_parameter_.push_back(2*PI*radius / wavelength_);
  209. }
  210. total_radius_ = radius;
  211. } // end of void MultiLayerMie::GenerateSizeParameter();
  212. // ********************************************************************** //
  213. // ********************************************************************** //
  214. // ********************************************************************** //
  215. double MultiLayerMie::GetTotalRadius() {
  216. if (total_radius_ == 0) GenerateSizeParameter();
  217. return total_radius_;
  218. } // end of double MultiLayerMie::GetTotalRadius();
  219. // ********************************************************************** //
  220. // ********************************************************************** //
  221. // ********************************************************************** //
  222. std::vector< std::array<double,5> >
  223. MultiLayerMie::GetSpectra(double from_WL, double to_WL, int samples) {
  224. std::vector< std::array<double,5> > spectra;
  225. double step_WL = (to_WL - from_WL)/ static_cast<double>(samples);
  226. double wavelength_backup = wavelength_;
  227. long fails = 0;
  228. for (double WL = from_WL; WL < to_WL; WL += step_WL) {
  229. double Qext, Qsca, Qabs, Qbk;
  230. wavelength_ = WL;
  231. try {
  232. RunMieCalculations();
  233. } catch( const std::invalid_argument& ia ) {
  234. fails++;
  235. continue;
  236. }
  237. //printf("%3.1f ",WL);
  238. spectra.push_back({wavelength_, Qext, Qsca, Qabs, Qbk});
  239. } // end of for each WL in spectra
  240. printf("fails %li\n",fails);
  241. wavelength_ = wavelength_backup;
  242. return spectra;
  243. }
  244. // ********************************************************************** //
  245. // ********************************************************************** //
  246. // ********************************************************************** //
  247. // Calculate Nstop - equation (17)
  248. //
  249. void MultiLayerMie::Nstop() {
  250. const double& xL = size_parameter_.back();
  251. if (xL <= 8) {
  252. nmax_ = round(xL + 4*pow(xL, 1/3) + 1);
  253. } else if (xL <= 4200) {
  254. nmax_ = round(xL + 4.05*pow(xL, 1/3) + 2);
  255. } else {
  256. nmax_ = round(xL + 4*pow(xL, 1/3) + 2);
  257. }
  258. }
  259. // ********************************************************************** //
  260. // ********************************************************************** //
  261. // ********************************************************************** //
  262. void MultiLayerMie::Nmax(int first_layer) {
  263. int ri, riM1;
  264. const std::vector<double>& x = size_parameter_;
  265. const std::vector<std::complex<double> >& m = index_;
  266. const int& pl = PEC_layer_position_;
  267. Nstop(); // Set initial nmax_ value
  268. for (int i = first_layer; i < x.size(); i++) {
  269. if (i > PEC_layer_position_)
  270. ri = round(std::abs(x[i]*m[i]));
  271. else
  272. ri = 0;
  273. nmax_ = std::max(nmax_, ri);
  274. // first layer is pec, if pec is present
  275. if ((i > first_layer) && ((i - 1) > PEC_layer_position_))
  276. riM1 = round(std::abs(x[i - 1]* m[i]));
  277. else
  278. riM1 = 0;
  279. nmax_ = std::max(nmax_, riM1);
  280. }
  281. nmax_ += 15; // Final nmax_ value
  282. }
  283. //**********************************************************************************//
  284. // This function calculates the spherical Bessel (jn) and Hankel (h1n) functions //
  285. // and their derivatives for a given complex value z. See pag. 87 B&H. //
  286. // //
  287. // Input parameters: //
  288. // z: Real argument to evaluate jn and h1n //
  289. // nmax_: Maximum number of terms to calculate jn and h1n //
  290. // //
  291. // Output parameters: //
  292. // jn, h1n: Spherical Bessel and Hankel functions //
  293. // jnp, h1np: Derivatives of the spherical Bessel and Hankel functions //
  294. // //
  295. // The implementation follows the algorithm by I.J. Thompson and A.R. Barnett, //
  296. // Comp. Phys. Comm. 47 (1987) 245-257. //
  297. // //
  298. // Complex spherical Bessel functions from n=0..nmax_-1 for z in the upper half //
  299. // plane (Im(z) > -3). //
  300. // //
  301. // j[n] = j/n(z) Regular solution: j[0]=sin(z)/z //
  302. // j'[n] = d[j/n(z)]/dz //
  303. // h1[n] = h[0]/n(z) Irregular Hankel function: //
  304. // h1'[n] = d[h[0]/n(z)]/dz h1[0] = j0(z) + i*y0(z) //
  305. // = (sin(z)-i*cos(z))/z //
  306. // = -i*exp(i*z)/z //
  307. // Using complex CF1, and trigonometric forms for n=0 solutions. //
  308. //**********************************************************************************//
  309. void MultiLayerMie::sbesjh(std::complex<double> z,
  310. std::vector<std::complex<double> >& jn,
  311. std::vector<std::complex<double> >& jnp,
  312. std::vector<std::complex<double> >& h1n,
  313. std::vector<std::complex<double> >& h1np) {
  314. const int limit = 20000;
  315. const double accur = 1.0e-12;
  316. const double tm30 = 1e-30;
  317. double absc;
  318. std::complex<double> zi, w;
  319. std::complex<double> pl, f, b, d, c, del, jn0, jndb, h1nldb, h1nbdb;
  320. absc = std::abs(std::real(z)) + std::abs(std::imag(z));
  321. if ((absc < accur) || (std::imag(z) < -3.0)) {
  322. throw std::invalid_argument("TODO add error description for condition if ((absc < accur) || (std::imag(z) < -3.0))");
  323. }
  324. zi = 1.0/z;
  325. w = zi + zi;
  326. pl = double(nmax_)*zi;
  327. f = pl + zi;
  328. b = f + f + zi;
  329. d = 0.0;
  330. c = f;
  331. for (int n = 0; n < limit; n++) {
  332. d = b - d;
  333. c = b - 1.0/c;
  334. absc = std::abs(std::real(d)) + std::abs(std::imag(d));
  335. if (absc < tm30) {
  336. d = tm30;
  337. }
  338. absc = std::abs(std::real(c)) + std::abs(std::imag(c));
  339. if (absc < tm30) {
  340. c = tm30;
  341. }
  342. d = 1.0/d;
  343. del = d*c;
  344. f = f*del;
  345. b += w;
  346. absc = std::abs(std::real(del - 1.0)) + std::abs(std::imag(del - 1.0));
  347. if (absc < accur) {
  348. // We have obtained the desired accuracy
  349. break;
  350. }
  351. }
  352. if (absc > accur) {
  353. throw std::invalid_argument("We were not able to obtain the desired accuracy");
  354. }
  355. jn[nmax_ - 1] = tm30;
  356. jnp[nmax_ - 1] = f*jn[nmax_ - 1];
  357. // Downward recursion to n=0 (N.B. Coulomb Functions)
  358. for (int n = nmax_ - 2; n >= 0; n--) {
  359. jn[n] = pl*jn[n + 1] + jnp[n + 1];
  360. jnp[n] = pl*jn[n] - jn[n + 1];
  361. pl = pl - zi;
  362. }
  363. // Calculate the n=0 Bessel Functions
  364. jn0 = zi*std::sin(z);
  365. h1n[0] = std::exp(std::complex<double>(0.0, 1.0)*z)*zi*(-std::complex<double>(0.0, 1.0));
  366. h1np[0] = h1n[0]*(std::complex<double>(0.0, 1.0) - zi);
  367. // Rescale j[n], j'[n], converting to spherical Bessel functions.
  368. // Recur h1[n], h1'[n] as spherical Bessel functions.
  369. w = 1.0/jn[0];
  370. pl = zi;
  371. for (int n = 0; n < nmax_; n++) {
  372. jn[n] = jn0*(w*jn[n]);
  373. jnp[n] = jn0*(w*jnp[n]) - zi*jn[n];
  374. if (n != 0) {
  375. h1n[n] = (pl - zi)*h1n[n - 1] - h1np[n - 1];
  376. // check if hankel is increasing (upward stable)
  377. if (std::abs(h1n[n]) < std::abs(h1n[n - 1])) {
  378. jndb = z;
  379. h1nldb = h1n[n];
  380. h1nbdb = h1n[n - 1];
  381. }
  382. pl += zi;
  383. h1np[n] = -(pl*h1n[n]) + h1n[n - 1];
  384. }
  385. }
  386. }
  387. //**********************************************************************************//
  388. // This function calculates the spherical Bessel functions (bj and by) and the //
  389. // logarithmic derivative (bd) for a given complex value z. See pag. 87 B&H. //
  390. // //
  391. // Input parameters: //
  392. // z: Complex argument to evaluate bj, by and bd //
  393. // nmax_: Maximum number of terms to calculate bj, by and bd //
  394. // //
  395. // Output parameters: //
  396. // bj, by: Spherical Bessel functions //
  397. // bd: Logarithmic derivative //
  398. //**********************************************************************************//
  399. void MultiLayerMie::sphericalBessel(std::complex<double> z,
  400. std::vector<std::complex<double> >& bj,
  401. std::vector<std::complex<double> >& by,
  402. std::vector<std::complex<double> >& bd) {
  403. std::vector<std::complex<double> > jn(nmax_), jnp(nmax_), h1n(nmax_), h1np(nmax_);
  404. sbesjh(z, jn, jnp, h1n, h1np);
  405. for (int n = 0; n < nmax_; n++) {
  406. bj[n] = jn[n];
  407. by[n] = (h1n[n] - jn[n])/std::complex<double>(0.0, 1.0);
  408. bd[n] = jnp[n]/jn[n] + 1.0/z;
  409. }
  410. }
  411. // ********************************************************************** //
  412. // ********************************************************************** //
  413. // ********************************************************************** //
  414. // Calculate an - equation (5)
  415. std::complex<double> MultiLayerMie::calc_an(int n, double XL, std::complex<double> Ha, std::complex<double> mL,
  416. std::complex<double> PsiXL, std::complex<double> ZetaXL,
  417. std::complex<double> PsiXLM1, std::complex<double> ZetaXLM1) {
  418. std::complex<double> Num = (Ha/mL + n/XL)*PsiXL - PsiXLM1;
  419. std::complex<double> Denom = (Ha/mL + n/XL)*ZetaXL - ZetaXLM1;
  420. return Num/Denom;
  421. }
  422. // ********************************************************************** //
  423. // ********************************************************************** //
  424. // ********************************************************************** //
  425. // Calculate bn - equation (6)
  426. std::complex<double> MultiLayerMie::calc_bn(int n, double XL, std::complex<double> Hb, std::complex<double> mL,
  427. std::complex<double> PsiXL, std::complex<double> ZetaXL,
  428. std::complex<double> PsiXLM1, std::complex<double> ZetaXLM1) {
  429. std::complex<double> Num = (mL*Hb + n/XL)*PsiXL - PsiXLM1;
  430. std::complex<double> Denom = (mL*Hb + n/XL)*ZetaXL - ZetaXLM1;
  431. return Num/Denom;
  432. }
  433. // ********************************************************************** //
  434. // ********************************************************************** //
  435. // ********************************************************************** //
  436. // Calculates S1 - equation (25a)
  437. std::complex<double> MultiLayerMie::calc_S1(int n, std::complex<double> an, std::complex<double> bn,
  438. double Pi, double Tau) {
  439. return double(n + n + 1)*(Pi*an + Tau*bn)/double(n*n + n);
  440. }
  441. // ********************************************************************** //
  442. // ********************************************************************** //
  443. // ********************************************************************** //
  444. // Calculates S2 - equation (25b) (it's the same as (25a), just switches Pi and Tau)
  445. std::complex<double> MultiLayerMie::calc_S2(int n, std::complex<double> an, std::complex<double> bn,
  446. double Pi, double Tau) {
  447. return calc_S1(n, an, bn, Tau, Pi);
  448. }
  449. //**********************************************************************************//
  450. // This function calculates the Riccati-Bessel functions (Psi and Zeta) for a //
  451. // real argument (x). //
  452. // Equations (20a) - (21b) //
  453. // //
  454. // Input parameters: //
  455. // x: Real argument to evaluate Psi and Zeta //
  456. // nmax: Maximum number of terms to calculate Psi and Zeta //
  457. // //
  458. // Output parameters: //
  459. // Psi, Zeta: Riccati-Bessel functions //
  460. //**********************************************************************************//
  461. void MultiLayerMie::calcPsiZeta(double x,
  462. std::vector<std::complex<double> > D1,
  463. std::vector<std::complex<double> > D3,
  464. std::vector<std::complex<double> >& Psi,
  465. std::vector<std::complex<double> >& Zeta) {
  466. //Upward recurrence for Psi and Zeta - equations (20a) - (21b)
  467. Psi[0] = std::complex<double>(sin(x), 0);
  468. Zeta[0] = std::complex<double>(sin(x), -cos(x));
  469. for (int n = 1; n <= nmax_; n++) {
  470. Psi[n] = Psi[n - 1]*(n/x - D1[n - 1]);
  471. Zeta[n] = Zeta[n - 1]*(n/x - D3[n - 1]);
  472. }
  473. }
  474. //**********************************************************************************//
  475. // Function CONFRA ported from MIEV0.f (Wiscombe,1979)
  476. // Ref. to NCAR Technical Notes, Wiscombe, 1979
  477. /*
  478. c Compute Bessel function ratio A-sub-N from its
  479. c continued fraction using Lentz method
  480. c ZINV = Reciprocal of argument of A
  481. c I N T E R N A L V A R I A B L E S
  482. c ------------------------------------
  483. c CAK Term in continued fraction expansion of A (Eq. R25)
  484. c a_k
  485. c CAPT Factor used in Lentz iteration for A (Eq. R27)
  486. c T_k
  487. c CNUMER Numerator in capT ( Eq. R28A )
  488. c N_k
  489. c CDENOM Denominator in capT ( Eq. R28B )
  490. c D_k
  491. c CDTD Product of two successive denominators of capT factors
  492. c ( Eq. R34C )
  493. c xi_1
  494. c CNTN Product of two successive numerators of capT factors
  495. c ( Eq. R34B )
  496. c xi_2
  497. c EPS1 Ill-conditioning criterion
  498. c EPS2 Convergence criterion
  499. c KK Subscript k of cAk ( Eq. R25B )
  500. c k
  501. c KOUNT Iteration counter ( used to prevent infinite looping )
  502. c MAXIT Max. allowed no. of iterations
  503. c MM + 1 and - 1, alternately
  504. */
  505. std::complex<double> MultiLayerMie::calcD1confra(const int N, const std::complex<double> z) {
  506. // NTMR -> nmax_ -1 \\TODO nmax_ ?
  507. //int N = nmax_ - 1;
  508. int KK, KOUNT, MAXIT = 10000, MM;
  509. double EPS1=1.0e-2, EPS2=1.0e-8;
  510. std::complex<double> CAK, CAPT, CDENOM, CDTD, CNTN, CNUMER;
  511. std::complex<double> one = std::complex<double>(1.0,0.0);
  512. std::complex<double> ZINV = one/z;
  513. // c ** Eq. R25a
  514. std::complex<double> CONFRA = static_cast<std::complex<double> >(N+1)*ZINV;
  515. MM = -1;
  516. KK = 2*N +3;
  517. // c ** Eq. R25b, k=2
  518. CAK = static_cast<std::complex<double> >(MM*KK) * ZINV;
  519. CDENOM = CAK;
  520. CNUMER = CDENOM + one / CONFRA;
  521. KOUNT = 1;
  522. //10 CONTINUE
  523. do { ++KOUNT;
  524. if (KOUNT > MAXIT) { printf("re(%g):im(%g)\t\n", CONFRA.real(), CONFRA.imag()); break;
  525. throw std::invalid_argument("ConFra--Iteration failed to converge!\n"); }
  526. MM *= -1; KK += 2;
  527. CAK = static_cast<std::complex<double> >(MM*KK) * ZINV; // ** Eq. R25b
  528. // //c ** Eq. R32 Ill-conditioned case -- stride two terms instead of one
  529. // if (std::abs( CNUMER / CAK ) >= EPS1 || std::abs( CDENOM / CAK ) >= EPS1) {
  530. // //c ** Eq. R34
  531. // CNTN = CAK * CNUMER + 1.0;
  532. // CDTD = CAK * CDENOM + 1.0;
  533. // CONFRA = ( CNTN / CDTD ) * CONFRA; // ** Eq. R33
  534. // MM *= -1; KK += 2;
  535. // CAK = static_cast<std::complex<double> >(MM*KK) * ZINV; // ** Eq. R25b
  536. // //c ** Eq. R35
  537. // CNUMER = CAK + CNUMER / CNTN;
  538. // CDENOM = CAK + CDENOM / CDTD;
  539. // ++KOUNT;
  540. // //GO TO 10
  541. // continue;
  542. // } else { //c *** Well-conditioned case
  543. {
  544. CAPT = CNUMER / CDENOM; // ** Eq. R27
  545. // printf("re(%g):im(%g)**\t", CAPT.real(), CAPT.imag());
  546. CONFRA = CAPT * CONFRA; // ** Eq. R26
  547. // if (N == 0) {output=true;printf(" re:");prn(CONFRA.real());printf(" im:"); prn(CONFRA.imag());output=false;};
  548. //c ** Check for convergence; Eq. R31
  549. if ( std::abs(CAPT.real() - 1.0) >= EPS2 || std::abs(CAPT.imag()) >= EPS2 ) {
  550. //c ** Eq. R30
  551. CNUMER = CAK + one/CNUMER;
  552. CDENOM = CAK + one/CDENOM;
  553. continue;
  554. //GO TO 10
  555. } // end of if < eps2
  556. }
  557. break;
  558. } while(1);
  559. //printf(" return confra\n");
  560. return CONFRA;
  561. }
  562. //**********************************************************************************//
  563. // This function calculates the logarithmic derivatives of the Riccati-Bessel //
  564. // functions (D1 and D3) for a complex argument (z). //
  565. // Equations (16a), (16b) and (18a) - (18d) //
  566. // //
  567. // Input parameters: //
  568. // z: Complex argument to evaluate D1 and D3 //
  569. // nmax_: Maximum number of terms to calculate D1 and D3 //
  570. // //
  571. // Output parameters: //
  572. // D1, D3: Logarithmic derivatives of the Riccati-Bessel functions //
  573. //**********************************************************************************//
  574. void MultiLayerMie::calcD1D3(const std::complex<double> z,
  575. std::vector<std::complex<double> >& D1,
  576. std::vector<std::complex<double> >& D3) {
  577. // Downward recurrence for D1 - equations (16a) and (16b)
  578. //D1[nmax_] = std::complex<double>(0.0, 0.0);
  579. D1[nmax_] = calcD1confra(nmax_, z);
  580. const std::complex<double> zinv = std::complex<double>(1.0, 0.0)/z;
  581. // printf(" D:");prn((D1[nmax_]).real()); printf("\t diff:");
  582. // prn((D1[nmax_] + double(nmax_)*zinv).real());
  583. for (int n = nmax_; n > 0; n--) {
  584. //D1[n - 1] = double(n)*zinv - 1.0/(D1[n] + double(n)*zinv);
  585. D1[n-1] = calcD1confra(n-1, z);
  586. // printf(" D:");prn((D1[n-1]).real()); printf("\t diff:");
  587. // prn((D1[n] + double(n)*zinv).real());
  588. }
  589. // printf("\n\n"); iformat=0;
  590. // Upward recurrence for PsiZeta and D3 - equations (18a) - (18d)
  591. PsiZeta_[0] = 0.5*(1.0 - std::complex<double>(cos(2.0*z.real()), sin(2.0*z.real()))*exp(-2.0*z.imag()));
  592. D3[0] = std::complex<double>(0.0, 1.0);
  593. for (int n = 1; n <= nmax_; n++) {
  594. PsiZeta_[n] = PsiZeta_[n - 1]*(static_cast<double>(n)*zinv - D1[n - 1])*(static_cast<double>(n)*zinv- D3[n - 1]);
  595. D3[n] = D1[n] + std::complex<double>(0.0, 1.0)/PsiZeta_[n];
  596. }
  597. }
  598. //**********************************************************************************//
  599. // This function calculates Pi and Tau for all values of Theta. //
  600. // Equations (26a) - (26c) //
  601. // //
  602. // Input parameters: //
  603. // nmax_: Maximum number of terms to calculate Pi and Tau //
  604. // nTheta: Number of scattering angles //
  605. // Theta: Array containing all the scattering angles where the scattering //
  606. // amplitudes will be calculated //
  607. // //
  608. // Output parameters: //
  609. // Pi, Tau: Angular functions Pi and Tau, as defined in equations (26a) - (26c) //
  610. //**********************************************************************************//
  611. void MultiLayerMie::calcPiTau(std::vector< std::vector<double> >& Pi,
  612. std::vector< std::vector<double> >& Tau) {
  613. //****************************************************//
  614. // Equations (26a) - (26c) //
  615. //****************************************************//
  616. std::vector<double> costheta(theta_.size(), 0.0);
  617. for (int t = 0; t < theta_.size(); t++) {
  618. costheta[t] = cos(theta_[t]);
  619. }
  620. for (int n = 0; n < nmax_; n++) {
  621. for (int t = 0; t < theta_.size(); t++) {
  622. if (n == 0) {
  623. // Initialize Pi and Tau
  624. Pi[n][t] = 1.0;
  625. Tau[n][t] = (n + 1)*costheta[t];
  626. } else {
  627. // Calculate the actual values
  628. Pi[n][t] = ((n == 1) ? ((n + n + 1)*costheta[t]*Pi[n - 1][t]/n)
  629. : (((n + n + 1)*costheta[t]*Pi[n - 1][t]
  630. - (n + 1)*Pi[n - 2][t])/n));
  631. Tau[n][t] = (n + 1)*costheta[t]*Pi[n][t] - (n + 2)*Pi[n - 1][t];
  632. }
  633. }
  634. }
  635. }
  636. //**********************************************************************************//
  637. // This function calculates the scattering coefficients required to calculate //
  638. // both the near- and far-field parameters. //
  639. // //
  640. // Input parameters: //
  641. // L: Number of layers //
  642. // pl: Index of PEC layer. If there is none just send -1 //
  643. // x: Array containing the size parameters of the layers [0..L-1] //
  644. // m: Array containing the relative refractive indexes of the layers [0..L-1] //
  645. // nmax: Maximum number of multipolar expansion terms to be used for the //
  646. // calculations. Only use it if you know what you are doing, otherwise //
  647. // set this parameter to -1 and the function will calculate it. //
  648. // //
  649. // Output parameters: //
  650. // an, bn: Complex scattering amplitudes //
  651. // //
  652. // Return value: //
  653. // Number of multipolar expansion terms used for the calculations //
  654. //**********************************************************************************//
  655. void MultiLayerMie::ScattCoeffs(std::vector<std::complex<double> >& an,
  656. std::vector<std::complex<double> >& bn) {
  657. //************************************************************************//
  658. // Calculate the index of the first layer. It can be either 0 (default) //
  659. // or the index of the outermost PEC layer. In the latter case all layers //
  660. // below the PEC are discarded. //
  661. //************************************************************************//
  662. const std::vector<double>& x = size_parameter_;
  663. const std::vector<std::complex<double> >& m = index_;
  664. const int& pl = PEC_layer_position_;
  665. const int L = index_.size();
  666. // TODO, is it possible for PEC to have a zero index? If yes than is should be:
  667. // int fl = (pl > -1) ? pl : 0;
  668. int fl = (pl > 0) ? pl : 0;
  669. if (nmax_ <= 0) Nmax(fl);
  670. std::complex<double> z1, z2;
  671. //**************************************************************************//
  672. // Note that since Fri, Nov 14, 2014 all arrays start from 0 (zero), which //
  673. // means that index = layer number - 1 or index = n - 1. The only exception //
  674. // are the arrays for representing D1, D3 and Q because they need a value //
  675. // for the index 0 (zero), hence it is important to consider this shift //
  676. // between different arrays. The change was done to optimize memory usage. //
  677. //**************************************************************************//
  678. // Allocate memory to the arrays
  679. std::vector<std::complex<double> > D1_mlxl(nmax_ + 1), D1_mlxlM1(nmax_ + 1),
  680. D3_mlxl(nmax_ + 1), D3_mlxlM1(nmax_ + 1);
  681. std::vector<std::vector<std::complex<double> > > Q(L), Ha(L), Hb(L);
  682. for (int l = 0; l < L; l++) {
  683. // D1_mlxl[l].resize(nmax_ + 1);
  684. // D1_mlxlM1[l].resize(nmax_ + 1);
  685. // D3_mlxl[l].resize(nmax_ + 1);
  686. // D3_mlxlM1[l].resize(nmax_ + 1);
  687. Q[l].resize(nmax_ + 1);
  688. Ha[l].resize(nmax_);
  689. Hb[l].resize(nmax_);
  690. }
  691. an.resize(nmax_);
  692. bn.resize(nmax_);
  693. PsiZeta_.resize(nmax_ + 1);
  694. std::vector<std::complex<double> > D1XL(nmax_ + 1), D3XL(nmax_ + 1),
  695. PsiXL(nmax_ + 1), ZetaXL(nmax_ + 1);
  696. //*************************************************//
  697. // Calculate D1 and D3 for z1 in the first layer //
  698. //*************************************************//
  699. if (fl == pl) { // PEC layer
  700. for (int n = 0; n <= nmax_; n++) {
  701. D1_mlxl[n] = std::complex<double>(0.0, -1.0);
  702. D3_mlxl[n] = std::complex<double>(0.0, 1.0);
  703. }
  704. } else { // Regular layer
  705. z1 = x[fl]* m[fl];
  706. // Calculate D1 and D3
  707. calcD1D3(z1, D1_mlxl, D3_mlxl);
  708. }
  709. // do { \
  710. // ++iformat;\
  711. // if (iformat%5 == 0) printf("%24.16e",z1.real()); \
  712. // } while (false);
  713. //******************************************************************//
  714. // Calculate Ha and Hb in the first layer - equations (7a) and (8a) //
  715. //******************************************************************//
  716. for (int n = 0; n < nmax_; n++) {
  717. Ha[fl][n] = D1_mlxl[n + 1];
  718. Hb[fl][n] = D1_mlxl[n + 1];
  719. }
  720. //*****************************************************//
  721. // Iteration from the second layer to the last one (L) //
  722. //*****************************************************//
  723. std::complex<double> Temp, Num, Denom;
  724. std::complex<double> G1, G2;
  725. for (int l = fl + 1; l < L; l++) {
  726. //************************************************************//
  727. //Calculate D1 and D3 for z1 and z2 in the layers fl+1..L //
  728. //************************************************************//
  729. z1 = x[l]*m[l];
  730. z2 = x[l - 1]*m[l];
  731. //Calculate D1 and D3 for z1
  732. calcD1D3(z1, D1_mlxl, D3_mlxl);
  733. //Calculate D1 and D3 for z2
  734. calcD1D3(z2, D1_mlxlM1, D3_mlxlM1);
  735. // prn(z1.real());
  736. // for ( auto i : D1_mlxl) { prn(i.real());
  737. // // prn(i.imag());
  738. // } printf("\n");
  739. //*********************************************//
  740. //Calculate Q, Ha and Hb in the layers fl+1..L //
  741. //*********************************************//
  742. // Upward recurrence for Q - equations (19a) and (19b)
  743. Num = exp(-2.0*(z1.imag() - z2.imag()))
  744. * std::complex<double>(cos(-2.0*z2.real()) - exp(-2.0*z2.imag()), sin(-2.0*z2.real()));
  745. Denom = std::complex<double>(cos(-2.0*z1.real()) - exp(-2.0*z1.imag()), sin(-2.0*z1.real()));
  746. Q[l][0] = Num/Denom;
  747. for (int n = 1; n <= nmax_; n++) {
  748. Num = (z1*D1_mlxl[n] + double(n))*(double(n) - z1*D3_mlxl[n - 1]);
  749. Denom = (z2*D1_mlxlM1[n] + double(n))*(double(n) - z2*D3_mlxlM1[n - 1]);
  750. Q[l][n] = ((pow2(x[l - 1]/x[l])* Q[l][n - 1])*Num)/Denom;
  751. }
  752. // Upward recurrence for Ha and Hb - equations (7b), (8b) and (12) - (15)
  753. for (int n = 1; n <= nmax_; n++) {
  754. //Ha
  755. if ((l - 1) == pl) { // The layer below the current one is a PEC layer
  756. G1 = -D1_mlxlM1[n];
  757. G2 = -D3_mlxlM1[n];
  758. } else {
  759. G1 = (m[l]*Ha[l - 1][n - 1]) - (m[l - 1]*D1_mlxlM1[n]);
  760. G2 = (m[l]*Ha[l - 1][n - 1]) - (m[l - 1]*D3_mlxlM1[n]);
  761. } // end of if PEC
  762. Temp = Q[l][n]*G1;
  763. Num = (G2*D1_mlxl[n]) - (Temp*D3_mlxl[n]);
  764. Denom = G2 - Temp;
  765. Ha[l][n - 1] = Num/Denom;
  766. //Hb
  767. if ((l - 1) == pl) { // The layer below the current one is a PEC layer
  768. G1 = Hb[l - 1][n - 1];
  769. G2 = Hb[l - 1][n - 1];
  770. } else {
  771. G1 = (m[l - 1]*Hb[l - 1][n - 1]) - (m[l]*D1_mlxlM1[n]);
  772. G2 = (m[l - 1]*Hb[l - 1][n - 1]) - (m[l]*D3_mlxlM1[n]);
  773. } // end of if PEC
  774. Temp = Q[l][n]*G1;
  775. Num = (G2*D1_mlxl[n]) - (Temp* D3_mlxl[n]);
  776. Denom = (G2- Temp);
  777. Hb[l][n - 1] = (Num/ Denom);
  778. } // end of for Ha and Hb terms
  779. } // end of for layers iteration
  780. //**************************************//
  781. //Calculate D1, D3, Psi and Zeta for XL //
  782. //**************************************//
  783. // Calculate D1XL and D3XL
  784. calcD1D3(x[L - 1], D1XL, D3XL);
  785. //printf("%5.20f\n",Ha[L-1][0].real());
  786. // Calculate PsiXL and ZetaXL
  787. calcPsiZeta(x[L - 1], D1XL, D3XL, PsiXL, ZetaXL);
  788. //*********************************************************************//
  789. // Finally, we calculate the scattering coefficients (an and bn) and //
  790. // the angular functions (Pi and Tau). Note that for these arrays the //
  791. // first layer is 0 (zero), in future versions all arrays will follow //
  792. // this convention to save memory. (13 Nov, 2014) //
  793. //*********************************************************************//
  794. for (int n = 0; n < nmax_; n++) {
  795. //********************************************************************//
  796. //Expressions for calculating an and bn coefficients are not valid if //
  797. //there is only one PEC layer (ie, for a simple PEC sphere). //
  798. //********************************************************************//
  799. if (pl < (L - 1)) {
  800. an[n] = calc_an(n + 1, x[L - 1], Ha[L - 1][n], m[L - 1], PsiXL[n + 1], ZetaXL[n + 1], PsiXL[n], ZetaXL[n]);
  801. bn[n] = calc_bn(n + 1, x[L - 1], Hb[L - 1][n], m[L - 1], PsiXL[n + 1], ZetaXL[n + 1], PsiXL[n], ZetaXL[n]);
  802. } else {
  803. an[n] = calc_an(n + 1, x[L - 1], std::complex<double>(0.0, 0.0), std::complex<double>(1.0, 0.0), PsiXL[n + 1], ZetaXL[n + 1], PsiXL[n], ZetaXL[n]);
  804. bn[n] = PsiXL[n + 1]/ZetaXL[n + 1];
  805. }
  806. } // end of for an and bn terms
  807. } // end of void MultiLayerMie::ScattCoeffs(...)
  808. // ********************************************************************** //
  809. // ********************************************************************** //
  810. // ********************************************************************** //
  811. void MultiLayerMie::InitMieCalculations() {
  812. // Initialize the scattering parameters
  813. Qext_ = 0;
  814. Qsca_ = 0;
  815. Qabs_ = 0;
  816. Qbk_ = 0;
  817. Qpr_ = 0;
  818. asymmetry_factor_ = 0;
  819. albedo_ = 0;
  820. // Initialize the scattering amplitudes
  821. std::vector<std::complex<double> > tmp1(theta_.size(),std::complex<double>(0.0, 0.0));
  822. S1_.swap(tmp1);
  823. S2_ = S1_;
  824. }
  825. // ********************************************************************** //
  826. // ********************************************************************** //
  827. // ********************************************************************** //
  828. //**********************************************************************************//
  829. // This function calculates the actual scattering parameters and amplitudes //
  830. // //
  831. // Input parameters: //
  832. // L: Number of layers //
  833. // pl: Index of PEC layer. If there is none just send -1 //
  834. // x: Array containing the size parameters of the layers [0..L-1] //
  835. // m: Array containing the relative refractive indexes of the layers [0..L-1] //
  836. // nTheta: Number of scattering angles //
  837. // Theta: Array containing all the scattering angles where the scattering //
  838. // amplitudes will be calculated //
  839. // nmax_: Maximum number of multipolar expansion terms to be used for the //
  840. // calculations. Only use it if you know what you are doing, otherwise //
  841. // set this parameter to -1 and the function will calculate it //
  842. // //
  843. // Output parameters: //
  844. // Qext: Efficiency factor for extinction //
  845. // Qsca: Efficiency factor for scattering //
  846. // Qabs: Efficiency factor for absorption (Qabs = Qext - Qsca) //
  847. // Qbk: Efficiency factor for backscattering //
  848. // Qpr: Efficiency factor for the radiation pressure //
  849. // g: Asymmetry factor (g = (Qext-Qpr)/Qsca) //
  850. // Albedo: Single scattering albedo (Albedo = Qsca/Qext) //
  851. // S1, S2: Complex scattering amplitudes //
  852. // //
  853. // Return value: //
  854. // Number of multipolar expansion terms used for the calculations //
  855. //**********************************************************************************//
  856. void MultiLayerMie::RunMieCalculations() {
  857. if (size_parameter_.size() != index_.size())
  858. throw std::invalid_argument("Each size parameter should have only one index!");
  859. std::vector<std::complex<double> > an, bn;
  860. std::complex<double> Qbktmp(0.0, 0.0);
  861. const std::vector<double>& x = size_parameter_;
  862. const std::vector<std::complex<double> >& m = index_;
  863. // Calculate scattering coefficients
  864. ScattCoeffs(an, bn);
  865. // std::vector< std::vector<double> > Pi(nmax_), Tau(nmax_);
  866. std::vector< std::vector<double> > Pi, Tau;
  867. Pi.resize(nmax_);
  868. Tau.resize(nmax_);
  869. for (int i =0; i< nmax_; ++i) {
  870. Pi[i].resize(theta_.size());
  871. Tau[i].resize(theta_.size());
  872. }
  873. calcPiTau(Pi, Tau);
  874. InitMieCalculations();
  875. // By using downward recurrence we avoid loss of precision due to float rounding errors
  876. // See: https://docs.oracle.com/cd/E19957-01/806-3568/ncg_goldberg.html
  877. // http://en.wikipedia.org/wiki/Loss_of_significance
  878. for (int i = nmax_ - 2; i >= 0; i--) {
  879. int n = i + 1;
  880. // Equation (27)
  881. Qext_ += (n + n + 1)*(an[i].real() + bn[i].real());
  882. // Equation (28)
  883. Qsca_ += (n + n + 1)*(an[i].real()*an[i].real() + an[i].imag()*an[i].imag()
  884. + bn[i].real()*bn[i].real() + bn[i].imag()*bn[i].imag());
  885. // Equation (29) TODO We must check carefully this equation. If we
  886. // remove the typecast to double then the result changes. Which is
  887. // the correct one??? Ovidio (2014/12/10) With cast ratio will
  888. // give double, without cast (n + n + 1)/(n*(n + 1)) will be
  889. // rounded to integer. Tig (2015/02/24)
  890. Qpr_ += ((n*(n + 2)/(n + 1))*((an[i]*std::conj(an[n]) + bn[i]*std::conj(bn[n])).real())
  891. + ((double)(n + n + 1)/(n*(n + 1)))*(an[i]*std::conj(bn[i])).real());
  892. // Equation (33)
  893. Qbktmp = Qbktmp + (double)(n + n + 1)*(1 - 2*(n % 2))*(an[i]- bn[i]);
  894. // Calculate the scattering amplitudes (S1 and S2) //
  895. // Equations (25a) - (25b) //
  896. for (int t = 0; t < theta_.size(); t++) {
  897. S1_[t] += calc_S1(n, an[i], bn[i], Pi[i][t], Tau[i][t]);
  898. S2_[t] += calc_S2(n, an[i], bn[i], Pi[i][t], Tau[i][t]);
  899. }
  900. }
  901. double x2 = pow2(x.back());
  902. Qext_ = 2*(Qext_)/x2; // Equation (27)
  903. Qsca_ = 2*(Qsca_)/x2; // Equation (28)
  904. Qpr_ = Qext_ - 4*(Qpr_)/x2; // Equation (29)
  905. Qabs_ = Qext_ - Qsca_; // Equation (30)
  906. albedo_ = Qsca_ / Qext_; // Equation (31)
  907. asymmetry_factor_ = (Qext_ - Qpr_) / Qsca_; // Equation (32)
  908. Qbk_ = (Qbktmp.real()*Qbktmp.real() + Qbktmp.imag()*Qbktmp.imag())/x2; // Equation (33)
  909. isMieCalculated_ = true;
  910. //return nmax;
  911. }
  912. // ********************************************************************** //
  913. // ********************************************************************** //
  914. // ********************************************************************** //
  915. // external scattering field = incident + scattered
  916. // BH p.92 (4.37), 94 (4.45), 95 (4.50)
  917. // assume: medium is non-absorbing; refim = 0; Uabs = 0
  918. void MultiLayerMie::fieldExt(double Rho, double Phi, double Theta, std::vector<double> Pi, std::vector<double> Tau,
  919. std::vector<std::complex<double> > an, std::vector<std::complex<double> > bn,
  920. std::vector<std::complex<double> >& E, std::vector<std::complex<double> >& H) {
  921. double rn = 0.0;
  922. std::complex<double> zn, xxip, encap;
  923. std::vector<std::complex<double> > vm3o1n, vm3e1n, vn3o1n, vn3e1n;
  924. vm3o1n.resize(3);
  925. vm3e1n.resize(3);
  926. vn3o1n.resize(3);
  927. vn3e1n.resize(3);
  928. std::vector<std::complex<double> > Ei, Hi, Es, Hs;
  929. Ei.resize(3);
  930. Hi.resize(3);
  931. Es.resize(3);
  932. Hs.resize(3);
  933. for (int i = 0; i < 3; i++) {
  934. Ei[i] = std::complex<double>(0.0, 0.0);
  935. Hi[i] = std::complex<double>(0.0, 0.0);
  936. Es[i] = std::complex<double>(0.0, 0.0);
  937. Hs[i] = std::complex<double>(0.0, 0.0);
  938. }
  939. std::vector<std::complex<double> > bj, by, bd;
  940. bj.resize(nmax_);
  941. by.resize(nmax_);
  942. bd.resize(nmax_);
  943. // Calculate spherical Bessel and Hankel functions
  944. sphericalBessel(Rho, bj, by, bd);
  945. for (int n = 0; n < nmax_; n++) {
  946. rn = double(n + 1);
  947. zn = bj[n] + std::complex<double>(0.0, 1.0)*by[n];
  948. xxip = Rho*(bj[n] + std::complex<double>(0.0, 1.0)*by[n]) - rn*zn;
  949. vm3o1n[0] = std::complex<double>(0.0, 0.0);
  950. vm3o1n[1] = std::cos(Phi)*Pi[n]*zn;
  951. vm3o1n[2] = -(std::sin(Phi)*Tau[n]*zn);
  952. vm3e1n[0] = std::complex<double>(0.0, 0.0);
  953. vm3e1n[1] = -(std::sin(Phi)*Pi[n]*zn);
  954. vm3e1n[2] = -(std::cos(Phi)*Tau[n]*zn);
  955. vn3o1n[0] = std::sin(Phi)*rn*(rn + 1.0)*std::sin(Theta)*Pi[n]*zn/Rho;
  956. vn3o1n[1] = std::sin(Phi)*Tau[n]*xxip/Rho;
  957. vn3o1n[2] = std::cos(Phi)*Pi[n]*xxip/Rho;
  958. vn3e1n[0] = std::cos(Phi)*rn*(rn + 1.0)*std::sin(Theta)*Pi[n]*zn/Rho;
  959. vn3e1n[1] = std::cos(Phi)*Tau[n]*xxip/Rho;
  960. vn3e1n[2] = -(std::sin(Phi)*Pi[n]*xxip/Rho);
  961. // scattered field: BH p.94 (4.45)
  962. encap = std::pow(std::complex<double>(0.0, 1.0), rn)*(2.0*rn + 1.0)/(rn*(rn + 1.0));
  963. for (int i = 0; i < 3; i++) {
  964. Es[i] = Es[i] + encap*(std::complex<double>(0.0, 1.0)*an[n]*vn3e1n[i] - bn[n]*vm3o1n[i]);
  965. Hs[i] = Hs[i] + encap*(std::complex<double>(0.0, 1.0)*bn[n]*vn3o1n[i] + an[n]*vm3e1n[i]);
  966. }
  967. }
  968. // incident E field: BH p.89 (4.21); cf. p.92 (4.37), p.93 (4.38)
  969. // basis unit vectors = er, etheta, ephi
  970. std::complex<double> eifac = std::exp(std::complex<double>(0.0, 1.0)*Rho*std::cos(Theta));
  971. Ei[0] = eifac*std::sin(Theta)*std::cos(Phi);
  972. Ei[1] = eifac*std::cos(Theta)*std::cos(Phi);
  973. Ei[2] = -(eifac*std::sin(Phi));
  974. // magnetic field
  975. double hffact = 1.0/(cc*mu);
  976. for (int i = 0; i < 3; i++) {
  977. Hs[i] = hffact*Hs[i];
  978. }
  979. // incident H field: BH p.26 (2.43), p.89 (4.21)
  980. std::complex<double> hffacta = hffact;
  981. std::complex<double> hifac = eifac*hffacta;
  982. Hi[0] = hifac*std::sin(Theta)*std::sin(Phi);
  983. Hi[1] = hifac*std::cos(Theta)*std::sin(Phi);
  984. Hi[2] = hifac*std::cos(Phi);
  985. for (int i = 0; i < 3; i++) {
  986. // electric field E [V m-1] = EF*E0
  987. E[i] = Ei[i] + Es[i];
  988. H[i] = Hi[i] + Hs[i];
  989. }
  990. }
  991. // ********************************************************************** //
  992. // ********************************************************************** //
  993. // ********************************************************************** //
  994. //**********************************************************************************//
  995. // This function calculates complex electric and magnetic field in the surroundings //
  996. // and inside (TODO) the particle. //
  997. // //
  998. // Input parameters: //
  999. // L: Number of layers //
  1000. // pl: Index of PEC layer. If there is none just send 0 (zero) //
  1001. // x: Array containing the size parameters of the layers [0..L-1] //
  1002. // m: Array containing the relative refractive indexes of the layers [0..L-1] //
  1003. // nmax: Maximum number of multipolar expansion terms to be used for the //
  1004. // calculations. Only use it if you know what you are doing, otherwise //
  1005. // set this parameter to 0 (zero) and the function will calculate it. //
  1006. // ncoord: Number of coordinate points //
  1007. // Coords: Array containing all coordinates where the complex electric and //
  1008. // magnetic fields will be calculated //
  1009. // //
  1010. // Output parameters: //
  1011. // E, H: Complex electric and magnetic field at the provided coordinates //
  1012. // //
  1013. // Return value: //
  1014. // Number of multipolar expansion terms used for the calculations //
  1015. //**********************************************************************************//
  1016. // int MultiLayerMie::nField(int L, int pl, std::vector<double> x, std::vector<std::complex<double> > m, int nmax,
  1017. // int ncoord, std::vector<double> Xp, std::vector<double> Yp, std::vector<double> Zp,
  1018. // std::vector<std::vector<std::complex<double> > >& E, std::vector<std::vector<std::complex<double> > >& H) {
  1019. // double Rho, Phi, Theta;
  1020. // std::vector<std::complex<double> > an, bn;
  1021. // // This array contains the fields in spherical coordinates
  1022. // std::vector<std::complex<double> > Es, Hs;
  1023. // Es.resize(3);
  1024. // Hs.resize(3);
  1025. // // Calculate scattering coefficients
  1026. // ScattCoeffs(L, pl, an, bn);
  1027. // std::vector<double> Pi, Tau;
  1028. // Pi.resize(nmax_);
  1029. // Tau.resize(nmax_);
  1030. // for (int c = 0; c < ncoord; c++) {
  1031. // // Convert to spherical coordinates
  1032. // Rho = sqrt(Xp[c]*Xp[c] + Yp[c]*Yp[c] + Zp[c]*Zp[c]);
  1033. // if (Rho < 1e-3) {
  1034. // // Avoid convergence problems
  1035. // Rho = 1e-3;
  1036. // }
  1037. // Phi = acos(Xp[c]/sqrt(Xp[c]*Xp[c] + Yp[c]*Yp[c]));
  1038. // Theta = acos(Xp[c]/Rho);
  1039. // calcPiTau(Theta, Pi, Tau);
  1040. // //*******************************************************//
  1041. // // external scattering field = incident + scattered //
  1042. // // BH p.92 (4.37), 94 (4.45), 95 (4.50) //
  1043. // // assume: medium is non-absorbing; refim = 0; Uabs = 0 //
  1044. // //*******************************************************//
  1045. // // Firstly the easiest case: the field outside the particle
  1046. // if (Rho >= x[L - 1]) {
  1047. // fieldExt(Rho, Phi, Theta, Pi, Tau, an, bn, Es, Hs);
  1048. // } else {
  1049. // // TODO, for now just set all the fields to zero
  1050. // for (int i = 0; i < 3; i++) {
  1051. // Es[i] = std::complex<double>(0.0, 0.0);
  1052. // Hs[i] = std::complex<double>(0.0, 0.0);
  1053. // }
  1054. // }
  1055. // //Now, convert the fields back to cartesian coordinates
  1056. // E[c][0] = std::sin(Theta)*std::cos(Phi)*Es[0] + std::cos(Theta)*std::cos(Phi)*Es[1] - std::sin(Phi)*Es[2];
  1057. // E[c][1] = std::sin(Theta)*std::sin(Phi)*Es[0] + std::cos(Theta)*std::sin(Phi)*Es[1] + std::cos(Phi)*Es[2];
  1058. // E[c][2] = std::cos(Theta)*Es[0] - std::sin(Theta)*Es[1];
  1059. // H[c][0] = std::sin(Theta)*std::cos(Phi)*Hs[0] + std::cos(Theta)*std::cos(Phi)*Hs[1] - std::sin(Phi)*Hs[2];
  1060. // H[c][1] = std::sin(Theta)*std::sin(Phi)*Hs[0] + std::cos(Theta)*std::sin(Phi)*Hs[1] + std::cos(Phi)*Hs[2];
  1061. // H[c][2] = std::cos(Theta)*Hs[0] - std::sin(Theta)*Hs[1];
  1062. // }
  1063. // return nmax;
  1064. // } // end of int nField()
  1065. } // end of namespace nmie