Metadata-Version: 2.4
Name: mieroots
Version: 0.5.0
Summary: Resonances and anapoles of spherical particles as polynomial roots in the permittivity
Project-URL: Homepage, https://github.com/claudio-sc/mieroots
Project-URL: Documentation, https://claudio-sc.github.io/mieroots
Project-URL: Repository, https://github.com/claudio-sc/mieroots
Project-URL: Issues, https://github.com/claudio-sc/mieroots/issues
Project-URL: Changelog, https://github.com/claudio-sc/mieroots/blob/main/CHANGELOG.md
Author: A. Bruyant
Author-email: "C. Silvestre Castro" <claudio.silvestre.castro@gmail.com>, "R. Vincent" <remi.vincent@utt.fr>
Maintainer-email: "C. Silvestre Castro" <claudio.silvestre.castro@gmail.com>
License-Expression: MIT
License-File: LICENSE
Keywords: anapole,computational-physics,electromagnetic-scattering,mie-theory,nanophotonics,permittivity,resonance
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Physics
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: numpy>=1.26
Requires-Dist: scipy>=1.11
Description-Content-Type: text/markdown

# mieroots

[![CI](https://github.com/claudio-sc/mieroots/actions/workflows/ci.yml/badge.svg)](https://github.com/claudio-sc/mieroots/actions/workflows/ci.yml)
[![PyPI](https://img.shields.io/pypi/v/mieroots.svg)](https://pypi.org/project/mieroots/)
[![Python](https://img.shields.io/pypi/pyversions/mieroots.svg)](https://pypi.org/project/mieroots/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

**Resonances and anapoles of spherical particles are roots of a polynomial. Here they are.**

The zeros and poles of the standard Mie multipolar coefficients of a sphere are roots of explicit
polynomials in the relative permittivity `ε = εp/ε1`, with coefficients that depend only on the size
parameter. `mieroots` builds those polynomials and solves them — no auxiliary eigenvalue problems,
no biorthogonal modal bases, no scanning a transcendental expression for a sign change.

Two families of intrinsic, excitation-independent material quantities follow:

- **Anapole permittivities** — the numerator roots: the contrasts at which a multipolar channel is
  *exactly* extinguished. Because the scattering cross-section is a sum of strictly non-negative
  multipolar terms, suppression can only happen channel by channel, so these roots are the complete
  algebraic inventory of radiationless conditions.
- **Resonant permittivities** — the denominator roots, whose imaginary part encodes the radiative
  decay of each channel.

> **Status: pre-alpha.** The repository scaffolding is in place; the physics is being ported from
> the research code. The API sketched below is the target, not yet the shipped surface.

## Installation

```bash
pip install mieroots
```

## Quick look

```python
import mieroots  # noqa: F401

print(mieroots.__version__)
```

## Citation

If you use `mieroots` in academic work, please cite both the software and the paper:

> C. Silvestre Castro, A. Bruyant and R. Vincent, *Anapole and resonant permittivities of
> spherical particles as polynomial roots*, Optics Letters (submitted).

Machine-readable metadata is in [`CITATION.cff`](CITATION.cff).

## Documentation

<https://claudio-sc.github.io/mieroots>

## Contributing

See [`CONTRIBUTING.md`](CONTRIBUTING.md). Commits follow
[Conventional Commits](https://www.conventionalcommits.org/); releases are automated with
[python-semantic-release](https://python-semantic-release.readthedocs.io/) and **gated on a green
test run of the same commit** — lint, `mypy --strict`, the full Python/OS test matrix and the docs
build all run as a job the release `needs:`, so a red run blocks the version bump, the GitHub
release and the PyPI upload.

## Funding

Graduate School NANO-PHOT (ANR-18-EURE-0013) and Agence Nationale de la Recherche
(ANR-19-CE42-0008).

## License

MIT — see [`LICENSE`](LICENSE).
