From c529308bde4009a05e3ba1f28681059f6e2cfd06 Mon Sep 17 00:00:00 2001
From: Talley Lambert <talley.lambert@gmail.com>
Date: Tue, 13 Oct 2026 16:25:35 +0200
Subject: [PATCH 1/2] refactor: move microsim.psf to private microsim._psf

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/microsim/{psf.py => _psf.py} | 2 ++
 1 file changed, 2 insertions(+)
 rename src/microsim/{psf.py => _psf.py} (99%)

diff --git a/src/microsim/psf.py b/src/microsim/_psf.py
similarity index 99%
rename from src/microsim/psf.py
rename to src/microsim/_psf.py
index 89ffe554..91c8ae26 100644
--- a/src/microsim/psf.py
+++ b/src/microsim/_psf.py
@@ -1,3 +1,5 @@
+"""Point spread functions: implementation (see `microsim.psf` for the public API)."""
+
 from __future__ import annotations
 
 import os

From 2c0a8a243cd35ec1ec31cb8879c2d9c47b374a62 Mon Sep 17 00:00:00 2001
From: Talley Lambert <talley.lambert@gmail.com>
Date: Tue, 13 Oct 2026 16:26:06 +0200
Subject: [PATCH 2/2] refactor: keep public names in microsim.psf

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/microsim/psf.py                         | 28 +++++++++++++++++++++
 src/microsim/schema/modality/_simple_psf.py |  2 +-
 2 files changed, 29 insertions(+), 1 deletion(-)
 create mode 100644 src/microsim/psf.py

diff --git a/src/microsim/psf.py b/src/microsim/psf.py
new file mode 100644
index 00000000..56b67e49
--- /dev/null
+++ b/src/microsim/psf.py
@@ -0,0 +1,28 @@
+"""Point spread functions.
+
+The implementation lives in `microsim._psf`.
+"""
+
+from microsim._psf import (
+    cached_psf,
+    make_confocal_psf,
+    make_psf,
+    radius_map,
+    rz_to_xyz,
+    simpson,
+    vectorial_psf,
+    vectorial_psf_centered,
+    vectorial_rz,
+)
+
+__all__ = [
+    "cached_psf",
+    "make_confocal_psf",
+    "make_psf",
+    "radius_map",
+    "rz_to_xyz",
+    "simpson",
+    "vectorial_psf",
+    "vectorial_psf_centered",
+    "vectorial_rz",
+]
diff --git a/src/microsim/schema/modality/_simple_psf.py b/src/microsim/schema/modality/_simple_psf.py
index 701e408c..afd0d4e2 100644
--- a/src/microsim/schema/modality/_simple_psf.py
+++ b/src/microsim/schema/modality/_simple_psf.py
@@ -7,8 +7,8 @@
 
 from microsim._data_array import ArrayProtocol, DataArray, xrDataArray
 from microsim._logger import logger, logging_indented
+from microsim._psf import make_psf
 from microsim.fft.convolve import fftconvolve_same_pairs
-from microsim.psf import make_psf
 from microsim.schema._base_model import SimBaseModel
 from microsim.schema.backend import NumpyAPI
 from microsim.schema.dimensions import Axis