Skip to main content
Help the Python Software Foundation raise $60,000 USD by December 31st!  Building the PSF Q4 Fundraiser

LSPR-library is a Python 3 scientific package for modelling UV-Vis spectral behaviour of metallic nanoparticle-dieletric composites.

Project description

What is LSPR-library?

LSPR-library is a Python 3 scientific package for modelling UV-Vis spectral behaviour of metallic nanoparticle-dieletric composites.


To run LSPR-library smoothly you will need:

  1. Python 3.4+
  2. Pandas 1.0.3+
  3. NumPy 1.18.1+
  4. SciPy 1.4.1+
  5. Statsmodels 0.11.0+
  6. Matplotlib 3.1.3+

What does LSPR-library enable?

LSPR-library enables one to approximate some spectroscopic features of metallic nanoparticle-dielectric composites, e.g. transmittance, absorbance, scattering cross-section. The model utilizes dipole approximation of Mie solution to Maxwell equations, described in more detail in article by Olson et al.1

To perform a simulation, one needs to construct a composite, so matrix and metallic nanoparticles, so for each a set of refractive index and extinction coefficient data for simulated spectral range are necessary. The model does not take into account possible interactions at the nanoparticle/matrix interface, i.e. the composite absorbance is a simple sum of matrix and nanoparticle absorbances calculated for pristine materials.

1 Optical Characterization of Single Plasmonic Nanoparticles - J. Olson, S. Dominguez-Medina, A. Hoggard, L.-Y. Wang, W.-Sh. Chang, S. Link; Chem Soc Rev. 2015 January 7; 44(1): 40-57. doi: 10.1039/c4cs00131a.

How to get it running?

To install lspr_library package use pip package manager:

pip install lspr_library


More examples on how to use the lspr_library and specific methods can be found in the documentation. The transmittance of 31nm silver nanoparticles homogeneously distributed in vacuum with concentration 5.8 · 1013 cm-3

import lspr_library as lpl

# Get the csv file with n,k values for silver in range 200-1000nm
# spaced evenly every 1nm
Ag = lpl.OpticalMaterial(name = "Silver",source = "n-k_Silver_200-1000nm_(1nm).csv")

# Get n,k values for vacuum
Vacuum = lpl.OpticalMaterial(name = "Vacuum",
                         source = "n-k_data_for_vacuum_200-1000nm_(1nm).csv")

# Create Ag nanoparticles with mean size of 31nm, standard deviation of 1nm
# and concentration of 5.8e13 cm^-3
nAg = lpl.Nanoparticle(name = "Silver nanoparticles", material=Ag,
                   size=31, concentration=5.8e13)

# Set the transmittance measurement of a 1 micron thick sample of the composite
(silver nanoparticles dispersed in vacuum); use "T_corr" for reflectance corrected result
Transmittance = lpl.SpectralMeasurement("Measure the transmittance",
                                    matrix=Vacuum, nanoparticle=nAg,

The result is a preformatted plot of the reflectance corrected transmittance


lspr_library is distributed under MIT license.


If issue is spotted please open an issue on the GitHub repo of the project. For changes, upgrades and simillar refer to the project's wiki site.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for lspr-library-Piast-Kolodziej, version 0.20.6
Filename, size File type Python version Upload date Hashes
Filename, size lspr_library_Piast_Kolodziej-0.20.6-py3-none-any.whl (3.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size lspr_library-Piast-Kolodziej-0.20.6.tar.gz (2.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page