scatt

Output example: Field distribution inside layered Si\Ag\Si sphere and Poynting vector distribution in Ag sphere with poweflow lines calculated with Scattnlay (scripts field-SiAgSi-flow.py and field-Ag-flow.py from example section as revision ).

Discuss:

Try to join our Gitter chat:

Fill the issue here: Issues.

How to use scattnlay

Table of contents:

• Compile code
• Binary install
• Use
• Papers
• Acknowledgment
• License

Compile Code:

To compile the source you will need C++11 capable compiler. To use MultiPrecision feature you need to install Boost.Multiprecision library (at least 1.58 ver).

To compile the Python extension you also need the following packages:

• python-numpy (>= 1.0)
• dh-python
• python-all-dev (any version)
• python-numpy-dev (any version)

To compile the Debian package you also need the following packages:

• debhelper (>=7.0.0)
• cdbs (>= 0.4.49)

Compilation options

• make source - Create source package for Python extension
• make cython - Convert Cython code to C++
• make python_ext - Create Python extension using C++ code
• make cython_ext - Create Python extension using Cython code
• make install - Install Python extension on local system
• make buildrpm - Generate a rpm package for Python extension
• make builddeb - Generate a deb package for Python extension
• make standalone - Create standalone programs (scattnlay and fieldnlay)
• make clean - Delete temporal files

Binary install:

Binary files for Ubuntu 14.04 and derivative distributions can be found at Launchpad To install it you must configure the repository:

sudo add-apt-repository ppa:ovidio/scattering
sudo apt-get update

and then you simply install the package:

sudo apt-get install python-scattnlay

For other versions of Ubuntu you can download the *.deb file for your OS (e.g. it can be python-scattnlay_2.0.1-1_amd64.deb for 64-bit OS) and install it using:

sudo dpkg -i python-scattnlay_2.0.1-1_amd64.deb

In Ubuntu 16.04 you may need to download and manually install python-support package beforehand (it depends on your OS) to satisfy the dependencies.

sudo dpkg -i python-support_1.0.15_all.deb

Use:

1. Python library
   • Use scattnlay directly
     

from scattnlay import scattnlay, fieldnlay
...
x = ...
m = ...
coords = ...
terms, Qext, Qsca, Qabs, Qbk, Qpr, g, Albedo, S1, S2 = scattnlay(x, m)
terms, E, H = fieldnlay(x, m, coords)
...

• Execute some of the test scripts (located in the folder 'tests/python') Example:
  

./test01.py

1. Standalone program
   • Execute scattnlay directly:

scattnlay -l Layers x1 m1.r m1.i [x2 m2.r m2.i ...] [-t ti tf nt] [-c comment]

• Execute fieldnlay directly:

fieldnlay -l Layers x1 m1.r m1.i [x2 m2.r m2.i ...] -p xi xf nx yi yf ny zi zf nz [-c comment]

• Execute some of the test scripts (located in the folder 'tests/shell'):

./test01.sh > test01.csv

1. C++ library

Scattnlay "Hello world!" example:

    try {
      nmie::MultiLayerMieApplied<double> multi_layer_mie;  
      multi_layer_mie.AddTargetLayer(core_width, index_Si);
      multi_layer_mie.AddTargetLayer(inner_width, index_Ag);
      multi_layer_mie.AddTargetLayer(outer_width, index_Si);
      multi_layer_mie.SetWavelength(WL);
      multi_layer_mie.RunMieCalculation();
      double Qabs = multi_layer_mie.GetQabs();
      printf("Qabs = %g\n", Qabs);
    } catch( const std::invalid_argument& ia ) {
      // Will catch if  multi_layer_mie fails or other errors.
      std::cerr << "Invalid argument: " << ia.what() << std::endl;
      return -1;
    }

The complete example-minimal.cc and a bit more complicated example-get-Mie.cc can be found in example directory along with go-cc-examples.sh script with build commands.

example-get-Mie.cc can be compiled using double precision or multiple precision (just include -DMULTI_PRECISION=200 to use 200 digits for calculations).

Papers

1. "Scattering of electromagnetic radiation by a multilayered sphere" O. Pena and U. Pal, Computer Physics Communications, vol. 180, Nov. 2009, pp. 2348-2354. http://dx.doi.org/10.1016/j.cpc.2009.07.010

2. "Reduction of scattering using thin all-dielectric shells designed by stochastic optimizer" Konstantin Ladutenko, Ovidio Peña-Rodríguez, Irina Melchakova, Ilya Yagupov, and Pavel Belov J. Appl. Phys., vol. 116, pp. 184508, 2014 http://dx.doi.org/10.1063/1.4900529

3. "Superabsorption of light by nanoparticles" Konstantin Ladutenko, Pavel Belov, Ovidio Peña-Rodríguez, Ali Mirzaei, Andrey E. Miroshnichenko and Ilya V. Shadrivov Nanoscale, 2015,7, 18897-18901 http://dx.doi.org/10.1039/C5NR05468K

Acknowledgment

We expect that all publications describing work using this software, or all commercial products using it, cite the following reference:

O. Pena and U. Pal, "Scattering of electromagnetic radiation by a multilayered sphere," Computer Physics Communications, vol. 180, Nov. 2009, pp. 2348-2354.

License

GPL v3+