aspire-inference 0.1.0a7__py3-none-any.whl → 0.1.0a9__py3-none-any.whl

aspire/__init__.py

@@ -6,6 +6,7 @@ import logging
 from importlib.metadata import PackageNotFoundError, version
 
 from .aspire import Aspire
+from .samples import Samples
 
 try:
     __version__ = version("aspire")
@@ -16,4 +17,5 @@ logging.getLogger(__name__).addHandler(logging.NullHandler())
 
 __all__ = [
     "Aspire",
+    "Samples",
 ]

aspire/flows/__init__.py

@@ -1,5 +1,31 @@
-def get_flow_wrapper(backend: str = "zuko", flow_matching: bool = False):
-    """Get the wrapper for the flow implementation."""
+import logging
+from typing import Any
+
+logger = logging.getLogger(__name__)
+
+
+def get_flow_wrapper(
+    backend: str = "zuko", flow_matching: bool = False
+) -> tuple[type, Any]:
+    """Get the wrapper for the flow implementation.
+
+    Parameters
+    ----------
+    backend : str
+        The backend to use. Options are "zuko" (PyTorch), "flowjax" (JAX), or
+        any other registered flow class via entry points. Default is "zuko".
+    flow_matching : bool, optional
+        Whether to use flow matching variant of the flow. Default is False.
+
+    Returns
+    -------
+    FlowClass : type
+        The flow class corresponding to the specified backend.
+    xp : module
+        The array API module corresponding to the specified backend.
+    """
+    from importlib.metadata import entry_points
+
     if backend == "zuko":
         import array_api_compat.torch as torch_api
 
@@ -20,11 +46,12 @@ def get_flow_wrapper(backend: str = "zuko", flow_matching: bool = False):
             )
         return FlowJax, jnp
     else:
-        from importlib.metadata import entry_points
-
+        if flow_matching:
+            logger.warning(
+                "Flow matching option is ignored for external backends."
+            )
         eps = {
-            ep.name.lower(): ep
-            for ep in entry_points().get("aspire.flows", [])
+            ep.name.lower(): ep for ep in entry_points(group="aspire.flows")
         }
         if backend in eps:
             FlowClass = eps[backend].load()
@@ -35,6 +62,7 @@ def get_flow_wrapper(backend: str = "zuko", flow_matching: bool = False):
                 )
             return FlowClass, xp
         else:
+            known_backends = ["zuko", "flowjax"] + list(eps.keys())
             raise ValueError(
-                f"Unknown flow class: {backend}. Available classes: {list(eps.keys())}"
+                f"Unknown backend '{backend}'. Available backends: {known_backends}"
             )

aspire/samplers/smc/blackjax.py

@@ -220,7 +220,9 @@ class BlackJAXSMC(SMCSampler):
 
         elif algorithm == "nuts":
             # Initialize step size and mass matrix if not provided
-            inverse_mass_matrix = self.sampler_kwargs["inverse_mass_matrix"]
+            inverse_mass_matrix = self.sampler_kwargs.get(
+                "inverse_mass_matrix"
+            )
             if inverse_mass_matrix is None:
                 inverse_mass_matrix = jax.numpy.eye(self.dims)
 
@@ -258,8 +260,13 @@ class BlackJAXSMC(SMCSampler):
             z_final = final_states.position
 
             # Calculate acceptance rates
-            acceptance_rates = jax.numpy.mean(all_infos.is_accepted, axis=1)
-            mean_acceptance = jax.numpy.mean(acceptance_rates)
+            try:
+                acceptance_rates = jax.numpy.mean(
+                    all_infos.is_accepted, axis=1
+                )
+                mean_acceptance = jax.numpy.mean(acceptance_rates)
+            except AttributeError:
+                mean_acceptance = np.nan
 
         elif algorithm == "hmc":
             # Initialize HMC sampler
@@ -294,8 +301,13 @@ class BlackJAXSMC(SMCSampler):
 
             final_states, all_infos = jax.vmap(init_and_sample)(keys, z_jax)
             z_final = final_states.position
-            acceptance_rates = jax.numpy.mean(all_infos.is_accepted, axis=1)
-            mean_acceptance = jax.numpy.mean(acceptance_rates)
+            try:
+                acceptance_rates = jax.numpy.mean(
+                    all_infos.is_accepted, axis=1
+                )
+                mean_acceptance = jax.numpy.mean(acceptance_rates)
+            except AttributeError:
+                mean_acceptance = np.nan
 
         else:
             raise ValueError(f"Unsupported algorithm: {algorithm}")

aspire/transforms.py

@@ -332,6 +332,7 @@ class CompositeTransform(BaseTransform):
             prior_bounds=self.prior_bounds,
             bounded_to_unbounded=self.bounded_to_unbounded,
             bounded_transform=self.bounded_transform,
+            affine_transform=self.affine_transform,
             device=self.device,
             xp=xp or self.xp,
             eps=self.eps,
@@ -684,7 +685,7 @@ class FlowPreconditioningTransform(BaseTransform):
             self.flow_kwargs.setdefault("dtype", dtype)
         self.fit_kwargs = dict(fit_kwargs or {})
 
-        FlowClass = get_flow_wrapper(
+        FlowClass, xp = get_flow_wrapper(
             backend=flow_backend, flow_matching=flow_matching
         )
         transform = CompositeTransform(
@@ -695,7 +696,7 @@ class FlowPreconditioningTransform(BaseTransform):
             bounded_transform=bounded_transform,
             affine_transform=affine_transform,
             device=device,
-            xp=FlowClass.xp,
+            xp=xp,
             eps=eps,
             dtype=dtype,
         )

aspire_inference-0.1.0a9.dist-info/METADATA

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: aspire-inference
+Version: 0.1.0a9
+Summary: Accelerate Sequential Posterior Inference via REuse
+Author-email: "Michael J. Williams" <michaeljw1@googlemail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/mj-will/aspire
+Project-URL: Documentation, https://aspire.readthedocs.io/
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: matplotlib
+Requires-Dist: numpy
+Requires-Dist: array-api-compat
+Requires-Dist: wrapt
+Requires-Dist: h5py
+Provides-Extra: scipy
+Requires-Dist: scipy; extra == "scipy"
+Provides-Extra: jax
+Requires-Dist: jax; extra == "jax"
+Requires-Dist: jaxlib; extra == "jax"
+Requires-Dist: flowjax; extra == "jax"
+Provides-Extra: torch
+Requires-Dist: torch; extra == "torch"
+Requires-Dist: zuko; extra == "torch"
+Requires-Dist: tqdm; extra == "torch"
+Provides-Extra: minipcn
+Requires-Dist: minipcn; extra == "minipcn"
+Provides-Extra: emcee
+Requires-Dist: emcee; extra == "emcee"
+Provides-Extra: blackjax
+Requires-Dist: blackjax; extra == "blackjax"
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-requires; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Dynamic: license-file
+
+# aspire: Accelerated Sequential Posterior Inference via REuse
+
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.15658747.svg)](https://doi.org/10.5281/zenodo.15658747)
+[![PyPI](https://img.shields.io/pypi/v/aspire-inference)](https://pypi.org/project/aspire-inference/)
+[![Documentation Status](https://readthedocs.org/projects/aspire/badge/?version=latest)](https://aspire.readthedocs.io/en/latest/?badge=latest)
+![tests](https://github.com/mj-will/aspire/actions/workflows/tests.yml/badge.svg)
+
+
+aspire is a framework for reusing existing posterior samples to obtain new results at a reduced cost.
+
+## Installation
+
+aspire can be installed from PyPI using `pip`
+
+```
+pip install aspire-inference
+```
+
+**Important:** the name of `aspire` on PyPI is `aspire-inference` but once installed
+the package can be imported and used as `aspire`.
+
+## Quickstart
+
+```python
+import numpy as np
+from aspire import Aspire, Samples
+
+# Define a log-likelihood and log-prior
+def log_likelihood(samples):
+    x = samples.x
+    return -0.5 * np.sum(x**2, axis=-1)
+
+def log_prior(samples):
+    return -0.5 * np.sum(samples.x**2, axis=-1)
+
+# Create the initial samples
+init = Samples(np.random.normal(size=(2_000, 4)))
+
+# Define the aspire object
+aspire = Aspire(
+    log_likelihood=log_likelihood,
+    log_prior=log_prior,
+    dims=4,
+    parameters=[f"x{i}" for i in range(4)],
+)
+
+# Fit the normalizing flow
+aspire.fit(init, n_epochs=20)
+
+# Sample the posterior
+posterior = aspire.sample_posterior(
+    sampler="smc",
+    n_samples=500,
+    sampler_kwargs=dict(n_steps=100),
+)
+
+# Plot the posterior distribution
+posterior.plot_corner()
+```
+
+## Documentation
+
+See the [documentation on ReadTheDocs][docs].
+
+## Citation
+
+If you use `aspire` in your work please cite the [DOI][DOI] and [paper][paper].
+
+
+[docs]: https://aspire.readthedocs.io/
+[DOI]: https://doi.org/10.5281/zenodo.15658747
+[paper]: https://arxiv.org/abs/2511.04218

{aspire_inference-0.1.0a7.dist-info → aspire_inference-0.1.0a9.dist-info}/RECORD

@@ -1,11 +1,11 @@
-aspire/__init__.py,sha256=45R0xWaLg0aJEPK5zoTK0aIek0KOwpHwQWS1jLCDhIE,365
+aspire/__init__.py,sha256=B2IETvlpB0oBh57prRYLdi8jB5yFGw8qVviGdf1NcnE,409
 aspire/aspire.py,sha256=M5o-QxLthE_5daa1trgUfWxPz-g4rmpEUKimKosw4lw,17400
 aspire/history.py,sha256=l_j-riZKbTWK7Wz9zvvD_mTk9psNCKItiveYhr_pYv8,4313
 aspire/plot.py,sha256=oXwUDOb_953_ADm2KLk41JIfpE3JeiiQiSYKvUVwLqw,1423
 aspire/samples.py,sha256=nVQULOr19lQVyGhitI8EgDdCDGx9sExPomQBJrV4rTc,19237
-aspire/transforms.py,sha256=XMbf5MxK49elQeKDsmFraHN-0JeO1AciljdTk7k2ujk,24928
+aspire/transforms.py,sha256=CHrfPQHEyHQ9I0WWiAgUplWwxYypZsD7uCYIHUbSFtY,24974
 aspire/utils.py,sha256=pj8O0chqfP6VS8bpW0wCw8W0P5JNQKvWRz1Rg9AYIhg,22525
-aspire/flows/__init__.py,sha256=3gGXF4HziMlZSmcEdJ_uHtrP-QEC6RXvylm4vtM-Xnk,1306
+aspire/flows/__init__.py,sha256=GUZToPVNJoTwULpbeW10UijfQukNrILoAQ_ubeq7G3w,2110
 aspire/flows/base.py,sha256=5UWKAiXDXLJ6Sg6a380ajLrGFaZSQyOnFEihQiiA4ko,2237
 aspire/flows/jax/__init__.py,sha256=7cmiY_MbEC8RDA8Cmi8HVnNJm0sqFKlBsDethdsy5lA,52
 aspire/flows/jax/flows.py,sha256=1HnVgQ1GUXNcvxiZqEV19H2QI9Th5bWX_QbNfGaUhuA,6625
@@ -18,11 +18,11 @@ aspire/samplers/importance.py,sha256=opn_jY-V8snUz0JztLBtnaTT3WfrZ5OSpHBV5WAuM3M
 aspire/samplers/mcmc.py,sha256=ihHgzqvSoy1oxdFBjyqNUbCuRX7CqWjlshCUZcgEL5E,5151
 aspire/samplers/smc/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 aspire/samplers/smc/base.py,sha256=66f_ORUvcKRqMIW35qjhUc-c0PFuY87lJa91MpSaTZI,10729
-aspire/samplers/smc/blackjax.py,sha256=4L4kgRKlaWl-knTWXXzdJTh-zZBh5BTpy5GaLDzT8Sc,11803
+aspire/samplers/smc/blackjax.py,sha256=IcTguAETiPmgFofmVW2GN40P5HBIxkmyd2VR8AU8f4k,12115
 aspire/samplers/smc/emcee.py,sha256=Wm0vvAlCcRhJMBt7_fU2ZnjDb8SN8jgUOTXLzNstRpA,2516
 aspire/samplers/smc/minipcn.py,sha256=ju1gcgyKHjodLEACPdL3eXA9ai8ZJ9_LwitD_Gmf1Rc,2765
-aspire_inference-0.1.0a7.dist-info/licenses/LICENSE,sha256=DN-eRtBfS9dZyT0Ds0Mdn2Y4nb-ZQ7h71vpASYBm5k4,1076
-aspire_inference-0.1.0a7.dist-info/METADATA,sha256=9TJxm0A3UrOIybNTr2CdJVVX9bbeztLqvFkhVO_pdu0,1617
-aspire_inference-0.1.0a7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aspire_inference-0.1.0a7.dist-info/top_level.txt,sha256=9FRIYEl2xwVFG7jSOBHsElHQ0y3_4fq01Cf4_OyMQn8,7
-aspire_inference-0.1.0a7.dist-info/RECORD,,
+aspire_inference-0.1.0a9.dist-info/licenses/LICENSE,sha256=DN-eRtBfS9dZyT0Ds0Mdn2Y4nb-ZQ7h71vpASYBm5k4,1076
+aspire_inference-0.1.0a9.dist-info/METADATA,sha256=DCcTGComTNt9UFlbUwGPf58itBX6Y-1-edVys0pb2RQ,3187
+aspire_inference-0.1.0a9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aspire_inference-0.1.0a9.dist-info/top_level.txt,sha256=9FRIYEl2xwVFG7jSOBHsElHQ0y3_4fq01Cf4_OyMQn8,7
+aspire_inference-0.1.0a9.dist-info/RECORD,,

aspire_inference-0.1.0a7.dist-info/METADATA

@@ -1,52 +0,0 @@
-Metadata-Version: 2.4
-Name: aspire-inference
-Version: 0.1.0a7
-Summary: Accelerate Sequential Posterior Inference via REuse
-Author-email: "Michael J. Williams" <michaeljw1@googlemail.com>
-License: MIT
-Project-URL: Homepage, https://github.com/mj-will/aspire
-Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: matplotlib
-Requires-Dist: numpy
-Requires-Dist: array-api-compat
-Requires-Dist: wrapt
-Requires-Dist: h5py
-Provides-Extra: scipy
-Requires-Dist: scipy; extra == "scipy"
-Provides-Extra: jax
-Requires-Dist: jax; extra == "jax"
-Requires-Dist: jaxlib; extra == "jax"
-Requires-Dist: flowjax; extra == "jax"
-Provides-Extra: torch
-Requires-Dist: torch; extra == "torch"
-Requires-Dist: zuko; extra == "torch"
-Requires-Dist: tqdm; extra == "torch"
-Provides-Extra: minipcn
-Requires-Dist: minipcn; extra == "minipcn"
-Provides-Extra: emcee
-Requires-Dist: emcee; extra == "emcee"
-Provides-Extra: blackjax
-Requires-Dist: blackjax; extra == "blackjax"
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Requires-Dist: pytest-requires; extra == "test"
-Requires-Dist: pytest-cov; extra == "test"
-Dynamic: license-file
-
-# aspire: Accelerated Sequential Posterior Inference via REuse
-
-aspire is a framework for reusing existing posterior samples to obtain new results at a reduced code.
-
-## Installation
-
-aspire can be installed from PyPI using `pip`
-
-```
-pip install aspire-inference
-```
-
-**Important:** the name of `aspire` on PyPI is `aspire-inference` but once installed
-the package can be imported and used as `aspire`.