Metadata-Version: 2.4
Name: mnpbem
Version: 0.1.2
Summary: Meta-package that installs all MNPBEM Python submodules.
Author-email: GALIH RIDHO UTOMO <g4lihru@students.unnes.ac.id>
License-Expression: GPL-2.0-only
Project-URL: Homepage, https://pypi.org/project/mnpbem/
Project-URL: Repository, https://github.com/galihru/mnpbem/tree/main/mnpbem
Project-URL: Source, https://github.com/galihru/mnpbem
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mnpbem-base>=0.1.0
Requires-Dist: mnpbem-bem>=0.1.0
Requires-Dist: mnpbem-demo>=0.1.0
Requires-Dist: mnpbem-demo-mnpbem>=0.1.0
Requires-Dist: mnpbem-greenfun>=0.1.0
Requires-Dist: mnpbem-help>=0.1.0
Requires-Dist: mnpbem-material>=0.1.0
Requires-Dist: mnpbem-mesh2d>=0.1.0
Requires-Dist: mnpbem-mex>=0.1.0
Requires-Dist: mnpbem-mie>=0.1.0
Requires-Dist: mnpbem-misc>=0.1.0
Requires-Dist: mnpbem-particles>=0.1.0
Requires-Dist: mnpbem-simulation>=0.1.0

# mnpbem

[![PyPI version](https://img.shields.io/pypi/v/mnpbem.svg)](https://pypi.org/project/mnpbem/)
[![Python versions](https://img.shields.io/pypi/pyversions/mnpbem.svg)](https://pypi.org/project/mnpbem/)

`mnpbem` is the umbrella meta-package for the scientific Python conversion of the MNPBEM ecosystem.
Installing `mnpbem` installs all submodules required for boundary-element plasmonics workflows.

## Scientific Overview
The package family targets frequency-domain formulations of nanoplasmonic problems, typically represented as:

```text
\mathbf{A}(\lambda)\,\mathbf{x}(\lambda)=\mathbf{b}(\lambda)
```

where geometry, material dispersion, kernels, and solvers are decomposed into dedicated submodules.

## Installation
```bash
pip install mnpbem
```

## Submodule Map
| Submodule | Scientific role | PyPI |
| --- | --- | --- |
| `mnpbem-base` | Registry and factory for task-dependent solver selection | https://pypi.org/project/mnpbem-base/ |
| `mnpbem-bem` | Linear response solver kernels | https://pypi.org/project/mnpbem-bem/ |
| `mnpbem-demo` | Reproducible spectral-grid demos | https://pypi.org/project/mnpbem-demo/ |
| `mnpbem-demo-mnpbem` | Extended demo orchestration layer | https://pypi.org/project/mnpbem-demo-mnpbem/ |
| `mnpbem-greenfun` | Green-function kernels for wave propagation | https://pypi.org/project/mnpbem-greenfun/ |
| `mnpbem-help` | Documentation and reference module index | https://pypi.org/project/mnpbem-help/ |
| `mnpbem-material` | Dispersive dielectric models and tabulated optical data | https://pypi.org/project/mnpbem-material/ |
| `mnpbem-mesh2d` | Triangle geometry operators for 2D meshes | https://pypi.org/project/mnpbem-mesh2d/ |
| `mnpbem-mex` | Optional acceleration backend probing interface | https://pypi.org/project/mnpbem-mex/ |
| `mnpbem-mie` | Rayleigh/Mie small-particle scattering approximations | https://pypi.org/project/mnpbem-mie/ |
| `mnpbem-misc` | Core linear algebra and unit conversion utilities | https://pypi.org/project/mnpbem-misc/ |
| `mnpbem-particles` | Particle geometry primitives | https://pypi.org/project/mnpbem-particles/ |
| `mnpbem-simulation` | Spectrum orchestration over wavelength grids | https://pypi.org/project/mnpbem-simulation/ |

## Example
Runnable example:
- `examples/basic_usage.py`

Run:
```bash
python examples/basic_usage.py
```

## Author
- GALIH RIDHO UTOMO
- g4lihru@students.unnes.ac.id
