surface-plasmon-model 0.1.0__tar.gz

surface_plasmon_model-0.1.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: surface-plasmon-model
+Version: 0.1.0
+Summary: Python tools for modeling surface plasmon polaritons at metal-dielectric interfaces
+Keywords: surface plasmons,surface plasmon polaritons,plasmonics,optics,electromagnetism,Drude model
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: numpy
+Requires-Dist: scipy
+Requires-Dist: matplotlib
+Requires-Dist: pandas
+
+# Surface Plasmon Model
+
+A Python package for modelling surface plasmon polaritons (SPPs) at planar metal–dielectric interfaces.
+
+The project is being developed as part of a study into the electromagnetic behaviour of surface plasmons and the effects of metal and dielectric properties on their propagation.
+
+## Current Features
+
+The package currently includes:
+
+* Drude-model complex dielectric permittivity
+* Surface plasmon polariton wavevector calculation
+* Support for complex-valued electromagnetic quantities
+* Calculation across wavelength and frequency ranges
+
+Future development will include:
+
+* SPP dispersion relations
+* Propagation length
+* Penetration depth into the metal and dielectric
+* Electromagnetic field distributions
+* Comparison of different metals
+* Comparison of different dielectric materials
+* Experimental optical-constant data
+* Drude and Drude–Lorentz material models
+
+## Installation
+
+During development, the package can be installed locally using:
+
+`python -m pip install -e .`
+
+Once released through PyPI, installation will use:
+
+`python -m pip install surface-plasmon-model`
+
+## Basic Usage
+
+```python
+from surface_plasmon_model import (
+    drude_permittivity,
+    spp_wavevector,
+)
+```
+
+The Drude dielectric function is
+
+$$
+\varepsilon_m(\omega)
+=
+\varepsilon_\infty
+-
+\frac{\omega_p^2}
+{\omega^2+i\gamma\omega}.
+$$
+
+The surface plasmon polariton wavevector at a planar metal–dielectric interface is
+
+$$
+k_{\mathrm{SPP}}
+=
+\frac{\omega}{c}
+\sqrt{
+\frac{\varepsilon_m\varepsilon_d}
+{\varepsilon_m+\varepsilon_d}
+}.
+$$
+
+## Project Structure
+
+```text
+Surface_Plasmons/
+├── notebooks/
+├── src/
+│   └── surface_plasmon_model/
+│       ├── __init__.py
+│       ├── drude.py
+│       └── spp.py
+├── pyproject.toml
+└── README.md
+```
+
+## Status
+
+This package is currently under active development and should be considered an early research version.

surface_plasmon_model-0.1.0/README.md

@@ -0,0 +1,85 @@
+# Surface Plasmon Model
+
+A Python package for modelling surface plasmon polaritons (SPPs) at planar metal–dielectric interfaces.
+
+The project is being developed as part of a study into the electromagnetic behaviour of surface plasmons and the effects of metal and dielectric properties on their propagation.
+
+## Current Features
+
+The package currently includes:
+
+* Drude-model complex dielectric permittivity
+* Surface plasmon polariton wavevector calculation
+* Support for complex-valued electromagnetic quantities
+* Calculation across wavelength and frequency ranges
+
+Future development will include:
+
+* SPP dispersion relations
+* Propagation length
+* Penetration depth into the metal and dielectric
+* Electromagnetic field distributions
+* Comparison of different metals
+* Comparison of different dielectric materials
+* Experimental optical-constant data
+* Drude and Drude–Lorentz material models
+
+## Installation
+
+During development, the package can be installed locally using:
+
+`python -m pip install -e .`
+
+Once released through PyPI, installation will use:
+
+`python -m pip install surface-plasmon-model`
+
+## Basic Usage
+
+```python
+from surface_plasmon_model import (
+    drude_permittivity,
+    spp_wavevector,
+)
+```
+
+The Drude dielectric function is
+
+$$
+\varepsilon_m(\omega)
+=
+\varepsilon_\infty
+-
+\frac{\omega_p^2}
+{\omega^2+i\gamma\omega}.
+$$
+
+The surface plasmon polariton wavevector at a planar metal–dielectric interface is
+
+$$
+k_{\mathrm{SPP}}
+=
+\frac{\omega}{c}
+\sqrt{
+\frac{\varepsilon_m\varepsilon_d}
+{\varepsilon_m+\varepsilon_d}
+}.
+$$
+
+## Project Structure
+
+```text
+Surface_Plasmons/
+├── notebooks/
+├── src/
+│   └── surface_plasmon_model/
+│       ├── __init__.py
+│       ├── drude.py
+│       └── spp.py
+├── pyproject.toml
+└── README.md
+```
+
+## Status
+
+This package is currently under active development and should be considered an early research version.

surface_plasmon_model-0.1.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "surface-plasmon-model"
+version = "0.1.0"
+
+description = "Python tools for modeling surface plasmon polaritons at metal-dielectric interfaces"
+
+readme = "README.md"
+
+requires-python = ">=3.10"
+
+keywords = [
+    "surface plasmons",
+    "surface plasmon polaritons",
+    "plasmonics",
+    "optics",
+    "electromagnetism",
+    "Drude model"
+]
+
+dependencies = [
+    "numpy",
+    "scipy",
+    "matplotlib",
+    "pandas"
+]
+
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Physics"
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["surface_plasmon_model*"]

surface_plasmon_model-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

surface_plasmon_model-0.1.0/src/surface_plasmon_model/__init__.py

@@ -0,0 +1,11 @@
+"""
+Surface Plasmon Model
+
+Tools for modelling surface plasmon polaritons
+at metal-dielectric interfaces.
+"""
+
+from .drude import drude_permittivity
+from .spp import spp_wavevector
+
+__version__ = "0.1.0"

surface_plasmon_model-0.1.0/src/surface_plasmon_model/drude.py

@@ -0,0 +1,35 @@
+import numpy as np
+
+
+def drude_permittivity(omega, epsilon_inf, omega_p, gamma):
+    """
+    Calculate the complex relative permittivity
+    of a metal using the Drude model.
+
+    Parameters
+    ----------
+    omega : float or ndarray
+        Angular frequency in rad/s.
+
+    epsilon_inf : float
+        High-frequency permittivity.
+
+    omega_p : float
+        Plasma frequency in rad/s.
+
+    gamma : float
+        Damping frequency in rad/s.
+
+    Returns
+    -------
+    complex or ndarray
+        Complex relative permittivity.
+    """
+
+    epsilon = (
+        epsilon_inf
+        - omega_p**2 /
+        (omega**2 + 1j * gamma * omega)
+    )
+
+    return epsilon

surface_plasmon_model-0.1.0/src/surface_plasmon_model/spp.py

@@ -0,0 +1,20 @@
+import numpy as np
+
+from scipy.constants import c
+
+
+def spp_wavevector(omega, epsilon_m, epsilon_d):
+    """
+    Calculate the complex wavevector
+    of a surface plasmon polariton.
+    """
+
+    k0 = omega / c
+
+    k_spp = k0 * np.sqrt(
+        (epsilon_m * epsilon_d)
+        /
+        (epsilon_m + epsilon_d)
+    )
+
+    return k_spp

surface_plasmon_model-0.1.0/src/surface_plasmon_model.egg-info/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: surface-plasmon-model
+Version: 0.1.0
+Summary: Python tools for modeling surface plasmon polaritons at metal-dielectric interfaces
+Keywords: surface plasmons,surface plasmon polaritons,plasmonics,optics,electromagnetism,Drude model
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: numpy
+Requires-Dist: scipy
+Requires-Dist: matplotlib
+Requires-Dist: pandas
+
+# Surface Plasmon Model
+
+A Python package for modelling surface plasmon polaritons (SPPs) at planar metal–dielectric interfaces.
+
+The project is being developed as part of a study into the electromagnetic behaviour of surface plasmons and the effects of metal and dielectric properties on their propagation.
+
+## Current Features
+
+The package currently includes:
+
+* Drude-model complex dielectric permittivity
+* Surface plasmon polariton wavevector calculation
+* Support for complex-valued electromagnetic quantities
+* Calculation across wavelength and frequency ranges
+
+Future development will include:
+
+* SPP dispersion relations
+* Propagation length
+* Penetration depth into the metal and dielectric
+* Electromagnetic field distributions
+* Comparison of different metals
+* Comparison of different dielectric materials
+* Experimental optical-constant data
+* Drude and Drude–Lorentz material models
+
+## Installation
+
+During development, the package can be installed locally using:
+
+`python -m pip install -e .`
+
+Once released through PyPI, installation will use:
+
+`python -m pip install surface-plasmon-model`
+
+## Basic Usage
+
+```python
+from surface_plasmon_model import (
+    drude_permittivity,
+    spp_wavevector,
+)
+```
+
+The Drude dielectric function is
+
+$$
+\varepsilon_m(\omega)
+=
+\varepsilon_\infty
+-
+\frac{\omega_p^2}
+{\omega^2+i\gamma\omega}.
+$$
+
+The surface plasmon polariton wavevector at a planar metal–dielectric interface is
+
+$$
+k_{\mathrm{SPP}}
+=
+\frac{\omega}{c}
+\sqrt{
+\frac{\varepsilon_m\varepsilon_d}
+{\varepsilon_m+\varepsilon_d}
+}.
+$$
+
+## Project Structure
+
+```text
+Surface_Plasmons/
+├── notebooks/
+├── src/
+│   └── surface_plasmon_model/
+│       ├── __init__.py
+│       ├── drude.py
+│       └── spp.py
+├── pyproject.toml
+└── README.md
+```
+
+## Status
+
+This package is currently under active development and should be considered an early research version.

surface_plasmon_model-0.1.0/src/surface_plasmon_model.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/surface_plasmon_model/__init__.py
+src/surface_plasmon_model/drude.py
+src/surface_plasmon_model/spp.py
+src/surface_plasmon_model.egg-info/PKG-INFO
+src/surface_plasmon_model.egg-info/SOURCES.txt
+src/surface_plasmon_model.egg-info/dependency_links.txt
+src/surface_plasmon_model.egg-info/requires.txt
+src/surface_plasmon_model.egg-info/top_level.txt

surface_plasmon_model-0.1.0/src/surface_plasmon_model.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

surface_plasmon_model-0.1.0/src/surface_plasmon_model.egg-info/requires.txt

@@ -0,0 +1,4 @@
+numpy
+scipy
+matplotlib
+pandas

surface_plasmon_model-0.1.0/src/surface_plasmon_model.egg-info/top_level.txt

@@ -0,0 +1 @@
+surface_plasmon_model