rustmatrix 2.1.1

Rust-backed T-matrix scattering for nonspherical particles (port of pytmatrix)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

[build-system]
requires = ["maturin>=1.5,<2.0"]
build-backend = "maturin"

[project]
name = "rustmatrix"
version = "2.1.1"
description = "Rust-backed T-matrix scattering for nonspherical particles (port of pytmatrix)"
readme = "README.md"
license = { text = "MIT" }
authors = [
    { name = "Stephen Nesbitt", email = "snesbitt@illinois.edu" },
]
requires-python = ">=3.9"
classifiers = [
    "Development Status :: 5 - Production/Stable",
    "Intended Audience :: Science/Research",
    "License :: OSI Approved :: MIT License",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.9",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Programming Language :: Python :: 3.13",
    "Programming Language :: Rust",
    "Topic :: Scientific/Engineering :: Physics",
    "Topic :: Scientific/Engineering :: Atmospheric Science",
]
dependencies = [
    "numpy>=1.23",
    "scipy>=1.10",
]

[project.optional-dependencies]
test = [
    "pytest>=7",
    "pytest-xdist",
    # Pinned < 2 because pytmatrix's Fortran extension is built against
    # numpy's 1.x C API (numpy.distutils + f2py). numpy 2.x breaks that
    # ABI. scipy >= 1.14 requires numpy 2, so cap it too.
    "numpy>=1.23,<2",
    "scipy>=1.10,<1.14",
]
dev = [
    "maturin>=1.5",
    "ruff",
]
examples = [
    "matplotlib",
    "jupyter",
    "ipywidgets",
]
docs = [
    "sphinx>=7,<9",
    "myst-parser>=3",
    "myst-nb>=1.1",
    "sphinx-autodoc-typehints",
    "sphinx-design",
    "sphinx-copybutton",
    "pydata-sphinx-theme",
    "sphinxcontrib-bibtex",
    "ipywidgets",
    "jupyter",
    "linkify-it-py",
    "matplotlib",
]
# NOTE: pytmatrix (the original Fortran-backed package used for parity
# testing) is intentionally NOT listed as an extra. It needs gfortran
# and ships a legacy setup.py, which causes uv's universal resolver
# to try (and fail) to build it during `uv sync` or `uv run` even
# when the extra is not requested. Install it manually when you want
# to run the parity tests:
#
#     uv pip install pytmatrix
#
# The [tool.uv.extra-build-dependencies] block below makes that work
# by injecting numpy into pytmatrix's build environment.

[project.urls]
Repository = "https://github.com/swnesbitt/rustmatrix"
Issues = "https://github.com/swnesbitt/rustmatrix/issues"

[tool.maturin]
# Target Python 3.13 (plus back-compat via abi3-py38). The extension
# lives under `python/rustmatrix/` alongside pure-Python modules.
python-source = "python"
module-name = "rustmatrix._core"
features = ["extension-module"]
# Ensure abi3 so a single wheel works across Python versions.
strip = true

[tool.pytest.ini_options]
minversion = "7.0"
testpaths = ["tests"]
python_files = ["test_*.py"]
addopts = "-ra --strict-markers"
markers = [
    "parity: tests that compare rustmatrix to the original pytmatrix",
    "slow: long-running tests",
]

[tool.ruff]
line-length = 100
target-version = "py39"

# pytmatrix ships a legacy setup.py that imports numpy at build time
# without declaring it in build-system.requires. Tell uv to inject
# numpy + setuptools into the build environment so a manual
# `uv pip install pytmatrix` works.
[tool.uv.extra-build-dependencies]
pytmatrix = ["numpy", "setuptools", "wheel"]