optixstuff 2.0.0__tar.gz → 4.0.0__tar.gz

optixstuff-4.0.0/.codespellrc

@@ -0,0 +1,4 @@
+[codespell]
+skip = .git,*.ipynb,uv.lock,*/_build,*.fits
+# add domain words only if codespell flags them (clean on the libraries sampled)
+# ignore-words-list =

optixstuff-4.0.0/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.{yml,yaml,json,toml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

optixstuff-4.0.0/.gitattributes

@@ -0,0 +1,10 @@
+* text=auto eol=lf
+*.ipynb  text eol=lf linguist-documentation
+docs/**  linguist-documentation
+*.fits   binary
+*.npy    binary
+*.npz    binary
+*.png    binary
+*.pdf    binary
+uv.lock  linguist-generated -diff
+CHANGELOG.md linguist-generated

{optixstuff-2.0.0 → optixstuff-4.0.0}/.gitignore

@@ -163,4 +163,9 @@ cython_debug/
 input/
 output/
 scripts/
+!.github/scripts/
 *.png
+
+.claude/
+.jax_cache/
+.ruff_cache/

{optixstuff-2.0.0 → optixstuff-4.0.0}/.pre-commit-config.yaml

@@ -15,13 +15,17 @@ repos:
         args: [--pytest-test-first]
       - id: end-of-file-fixer
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.2
+    rev: v0.17.3
     hooks:
       - id: ruff-check
         args: [--fix]
       - id: ruff-format
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+      - id: codespell
   - repo: https://github.com/compilerla/conventional-pre-commit
-    rev: v4.3.0
+    rev: v4.4.0
     hooks:
       - id: conventional-pre-commit
         stages: [commit-msg]

{optixstuff-2.0.0 → optixstuff-4.0.0}/.zenodo.json

@@ -3,7 +3,7 @@
   "creators": [
     {
       "orcid": "0000-0002-3138-0240",
-      "affiliation": "NASA Goddard Space Flight Center, Greenbelt, MD",
+      "affiliation": "University of Maryland, Baltimore County; NASA Goddard Space Flight Center; CRESST II",
       "name": "Spohn, Corey"
     }
   ],

{optixstuff-2.0.0 → optixstuff-4.0.0}/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [4.0.0](https://github.com/CoreySpohn/optixstuff/compare/v3.0.0...v4.0.0) (2026-11-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* **coronagraph:** AbstractCoronagraph.core_mean_intensity implementations must accept the keyword-only stellar_diam_lod argument.
+* **coronagraph:** YippyCoronagraph.core_mean_intensity and noise_floor_ayo now return values per (lambda/D)^2, the AbstractCoronagraph contract, instead of yippy's per-pixel fraction of the star's light; both grow by 1/pixel_scale_lod**2 (16x at 0.25 lambda/D pixels). Multiply either by core_area for the fraction in the aperture, and stop dividing by pixel_scale_lod**2 downstream.
+* American spelling throughout, rename segment_centres_m to segment_centers_m
+
+### Features
+
+* **coronagraph:** add stellar_diam_lod to core_mean_intensity and noise floor ([8cd9749](https://github.com/CoreySpohn/optixstuff/commit/8cd97496c3434ea7bd4effaf2b6f2f1fb095a294))
+* **speckle:** exposure-averaged realization on the speckle-field contract ([d163bf6](https://github.com/CoreySpohn/optixstuff/commit/d163bf6a0a821b1d31bed46925ef63a4c19145de))
+
+
+### Bug Fixes
+
+* American spelling throughout, rename segment_centres_m to segment_centers_m ([ccf79e1](https://github.com/CoreySpohn/optixstuff/commit/ccf79e14d8aee487d1dcabd2cf08b4a3893b2a36))
+* **coronagraph:** report the yippy AYO noise floor per (lambda/D)^2 ([3add7c7](https://github.com/CoreySpohn/optixstuff/commit/3add7c7c79f8153cfafa0a7409b0ed497c001ee4))
+* **coronagraph:** report yippy core mean intensity per (lambda/D)^2 ([dc55aaa](https://github.com/CoreySpohn/optixstuff/commit/dc55aaaca375bb5e45b34d93df0ff9ad5c16fbd5))
+
+## [3.0.0](https://github.com/CoreySpohn/optixstuff/compare/v2.0.0...v3.0.0) (2026-07-20)
+
+
+### ⚠ BREAKING CHANGES
+
+* **coronagraph:** sampling-explicit image contract -- wavelength-explicit stellar_map/source_psfs/background_transmission/extended_scene, table SPI base, MultiBandCoronagraph
+
+### Features
+
+* **coronagraph:** sampling-explicit image contract -- wavelength-explicit stellar_map/source_psfs/background_transmission/extended_scene, table SPI base, MultiBandCoronagraph ([76c578b](https://github.com/CoreySpohn/optixstuff/commit/76c578be46ee79281dbb24ef44e3af4708fd7155))
+
 ## [2.0.0](https://github.com/CoreySpohn/optixstuff/compare/v1.5.0...v2.0.0) (2026-07-10)
 
 

{optixstuff-2.0.0 → optixstuff-4.0.0}/CITATION.cff

@@ -7,7 +7,7 @@ authors:
   - family-names: Spohn
     given-names: Corey
     orcid: "https://orcid.org/0000-0002-3138-0240"
-    affiliation: "NASA Goddard Space Flight Center"
+    affiliation: "University of Maryland, Baltimore County; NASA Goddard Space Flight Center; CRESST II"
 repository-code: "https://github.com/CoreySpohn/optixstuff"
 license: MIT
 doi: "10.5281/zenodo.20819379"

{optixstuff-2.0.0 → optixstuff-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: optixstuff
-Version: 2.0.0
+Version: 4.0.0
 Summary: Hardware abstractions for the HWO direct imaging simulation suite
 Project-URL: Homepage, https://github.com/CoreySpohn/optixstuff
 Project-URL: Issues, https://github.com/CoreySpohn/optixstuff/issues
@@ -32,28 +32,35 @@ Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Scientific/Engineering :: Astronomy
-Requires-Python: >=3.11
-Requires-Dist: equinox>=0.12.0
-Requires-Dist: interpax
-Requires-Dist: jax>=0.4.1
-Requires-Dist: jaxlib>=0.4.1
-Requires-Dist: yippy
+Requires-Python: >=3.12
+Requires-Dist: equinox>=0.13.2
+Requires-Dist: hwoutils>=1.10.0
+Requires-Dist: interpax>=0.3.12
+Requires-Dist: jax>=0.8.1
+Requires-Dist: jaxlib>=0.8.1
+Requires-Dist: jaxtyping>=0.3.3
+Requires-Dist: yippy>=2.10.6
 Provides-Extra: dev
-Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pre-commit>=3.5; extra == 'dev'
 Provides-Extra: docs
-Requires-Dist: ipython; extra == 'docs'
-Requires-Dist: matplotlib; extra == 'docs'
-Requires-Dist: myst-nb; extra == 'docs'
-Requires-Dist: sphinx; extra == 'docs'
-Requires-Dist: sphinx-autoapi; extra == 'docs'
-Requires-Dist: sphinx-autodoc-typehints; extra == 'docs'
-Requires-Dist: sphinx-book-theme; extra == 'docs'
-Requires-Dist: sphinxcontrib-mermaid; extra == 'docs'
+Requires-Dist: ipython>=8.18; extra == 'docs'
+Requires-Dist: matplotlib>=3.10.7; extra == 'docs'
+Requires-Dist: myst-nb>=1.0; extra == 'docs'
+Requires-Dist: sphinx-autoapi>=3.0; extra == 'docs'
+Requires-Dist: sphinx-book-theme>=1.1; extra == 'docs'
+Requires-Dist: sphinx>=7.2; extra == 'docs'
+Requires-Dist: sphinxcontrib-mermaid>=0.9; extra == 'docs'
 Provides-Extra: test
-Requires-Dist: hypothesis; extra == 'test'
-Requires-Dist: nox; extra == 'test'
-Requires-Dist: pytest; extra == 'test'
-Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: hypothesis>=6.79.1; extra == 'test'
+Requires-Dist: numpy>=2.0; extra == 'test'
+Requires-Dist: psutil>=5.9.4; extra == 'test'
+Requires-Dist: pytest-cov>=1.0; extra == 'test'
+Requires-Dist: pytest-fail-slow>=0.1.0; extra == 'test'
+Requires-Dist: pytest-markdown-docs>=0.5.0; extra == 'test'
+Requires-Dist: pytest-testmon>=2.0.7; extra == 'test'
+Requires-Dist: pytest-timeout>=1.3.1; extra == 'test'
+Requires-Dist: pytest-xdist>=2.5; extra == 'test'
+Requires-Dist: pytest>=7.3.2; extra == 'test'
 Description-Content-Type: text/markdown
 
 # optixstuff

optixstuff-4.0.0/SECURITY.md

@@ -0,0 +1,9 @@
+# Security policy
+
+This is research software maintained by one person. Please report a vulnerability, for
+example a leaked credential, a malicious dependency, or a workflow that could be abused, through
+GitHub private vulnerability reporting: use "Report a vulnerability" on the Security tab of this
+repository. If that is unavailable, email corey.a.spohn@nasa.gov with "SECURITY" in the subject.
+
+Expect an acknowledgement within a week. Only the latest release receives fixes. Incorrect
+numerical results are not security issues; please open an ordinary issue for those.

optixstuff-4.0.0/pyproject.toml

@@ -0,0 +1,111 @@
+[build-system]
+requires = ['hatchling>=1.26.3', "hatch-fancy-pypi-readme>=24.1.0", "hatch-vcs>=0.4"]
+build-backend = "hatchling.build"
+
+[project]
+name = "optixstuff"
+description = "Hardware abstractions for the HWO direct imaging simulation suite"
+authors = [{ name = "Corey Spohn", email = "corey.a.spohn@nasa.gov" }]
+dynamic = ['readme', 'version']
+requires-python = ">=3.12"
+license = { file = "LICENSE" }
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Scientific/Engineering :: Astronomy",
+]
+dependencies = [
+    "equinox>=0.13.2",
+    "hwoutils>=1.10.0",
+    "interpax>=0.3.12",
+    "jax>=0.8.1",
+    "jaxlib>=0.8.1",
+    "jaxtyping>=0.3.3",
+    "yippy>=2.10.6",
+]
+
+[project.optional-dependencies]
+dev = ["pre-commit>=3.5"]
+docs = [
+    "sphinx>=7.2",
+    "myst-nb>=1.0",
+    "sphinx-book-theme>=1.1",
+    "sphinx-autoapi>=3.0",
+    "sphinxcontrib-mermaid>=0.9",
+    "ipython>=8.18",
+    "matplotlib>=3.10.7",
+]
+test = [
+    "pytest>=7.3.2",
+    "hypothesis>=6.79.1",
+    "pytest-cov>=1.0",
+    "pytest-xdist>=2.5",
+    "pytest-testmon>=2.0.7",
+    "pytest-markdown-docs>=0.5.0",
+    "pytest-timeout>=1.3.1",
+    "pytest-fail-slow>=0.1.0",
+    # The optional hwoutils budget plugin uses psutil for portable RSS sampling.
+    "psutil>=5.9.4",
+    "numpy>=2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/CoreySpohn/optixstuff"
+Issues = "https://github.com/CoreySpohn/optixstuff/issues"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "src/optixstuff/_version.py"
+
+[tool.hatch.metadata.hooks.fancy-pypi-readme]
+content-type = "text/markdown"
+
+[[tool.hatch.metadata.hooks.fancy-pypi-readme.fragments]]
+path = "README.md"
+
+[tool.ruff.lint]
+select = ["B", "D", "E", "F", "I", "UP", "RUF"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["D"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/optixstuff"]
+
+[tool.hatch.build.targets.sdist]
+exclude = ["/scripts", "/docs", "/tests", "/.github"]
+
+[tool.pytest.ini_options]
+filterwarnings = ["error"]
+markers = [
+    "medium: tests with a 30-second default time budget",
+    "slow: tests with a 300-second default time budget, run nightly",
+]
+
+[tool.testbudget]
+library = "optixstuff"
+mode = "report"
+unit_s = 5
+medium_s = 30
+slow_s = 300
+
+[tool.deptry]
+known_first_party = ["optixstuff"]
+optional_dependencies_dev_groups = ["dev", "docs", "test"]
+
+[tool.deptry.per_rule_ignores]
+# JAX loads its compiled backend; keep the explicit minimum version constraint.
+DEP002 = ["jaxlib"]
+
+[tool.ty.environment]
+python-version = "3.11"
+
+[tool.ty.src]
+include = ["src/optixstuff"]

{optixstuff-2.0.0 → optixstuff-4.0.0}/src/optixstuff/__init__.py

@@ -1,7 +1,12 @@
 """optixstuff -- Hardware abstractions for the HWO simulation suite."""
 
 from optixstuff._version import __version__
-from optixstuff.coronagraph import AbstractCoronagraph, AbstractScalarCoronagraph
+from optixstuff.coronagraph import (
+    AbstractCoronagraph,
+    AbstractScalarCoronagraph,
+    AbstractTableCoronagraph,
+    MultiBandCoronagraph,
+)
 from optixstuff.detector import (
     AbstractDetector,
     Detector,
@@ -31,12 +36,14 @@ __all__ = [
     "AbstractPrimary",
     "AbstractScalarCoronagraph",
     "AbstractSpeckleField",
+    "AbstractTableCoronagraph",
     "AbstractUniformElement",
     "ConstantThroughput",
     "Detector",
     "ExposureConfig",
     "IdealDetector",
     "LensletDisperser",
+    "MultiBandCoronagraph",
     "OpticalPath",
     "SegmentedPrimary",
     "SimplePrimary",

{optixstuff-2.0.0 → optixstuff-4.0.0}/src/optixstuff/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '2.0.0'
-__version_tuple__ = version_tuple = (2, 0, 0)
+__version__ = version = '4.0.0'
+__version_tuple__ = version_tuple = (4, 0, 0)
 
 __commit_id__ = commit_id = None