gluex-lumi 0.1.3__cp39-abi3-manylinux_2_17_i686.manylinux2014_i686.whl

gluex_lumi/__init__.py

@@ -0,0 +1,5 @@
+from .gluex_lumi import *
+
+__doc__ = gluex_lumi.__doc__
+if hasattr(gluex_lumi, "__all__"):
+    __all__ = gluex_lumi.__all__

gluex_lumi/__init__.pyi

@@ -0,0 +1,42 @@
+"""Typed interface for the gluex_lumi Python bindings."""
+
+from __future__ import annotations
+
+from collections.abc import Mapping, Sequence
+
+class Histogram:
+    counts: list[float]
+    edges: list[float]
+    errors: list[float]
+
+    def __init__(
+        self, counts: list[float], edges: list[float], errors: list[float]
+    ) -> None: ...
+    def as_dict(self) -> dict[str, list[float]]: ...
+
+class FluxHistograms:
+    tagged_flux: Histogram
+    tagm_flux: Histogram
+    tagh_flux: Histogram
+    tagged_luminosity: Histogram
+
+    def __init__(
+        self,
+        tagged_flux: Histogram,
+        tagm_flux: Histogram,
+        tagh_flux: Histogram,
+        tagged_luminosity: Histogram,
+    ) -> None: ...
+    def as_dict(self) -> dict[str, dict[str, list[float]]]: ...
+
+def get_flux_histograms(
+    run_periods: Mapping[str, int | None],
+    edges: Sequence[float],
+    *,
+    coherent_peak: bool = False,
+    polarized: bool = False,
+    rcdb: str | None = None,
+    ccdb: str | None = None,
+    exclude_runs: Sequence[int] | None = None,
+) -> FluxHistograms: ...
+def cli() -> None: ...

gluex_lumi-0.1.3.dist-info/METADATA

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: gluex-lumi
+Version: 0.1.3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Dist: matplotlib>=3 ; extra == 'plot'
+Requires-Dist: pytest ; extra == 'tests'
+Provides-Extra: plot
+Provides-Extra: tests
+Summary: Python bindings for GlueX luminosity calculations
+Keywords: gluex,luminosity,physics
+Home-Page: https://github.com/denehoffman/gluex-rs
+Author-email: Nathaniel Dene Hoffman <dene@cmu.edu>
+License: Apache-2.0 OR MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Documentation, https://github.com/denehoffman/gluex-rs/tree/main/crates/gluex-lumi-py
+Project-URL: Homepage, https://github.com/denehoffman/gluex-rs
+Project-URL: Issues, https://github.com/denehoffman/gluex-rs/issues
+Project-URL: Repository, https://github.com/denehoffman/gluex-rs
+
+# gluex-lumi (Python)
+
+Python bindings for the GlueX luminosity calculators. The package exposes `get_flux_histograms`
+from the Rust crate and an entrypoint for the `gluex-lumi` CLI. Use `--plot=path.png` to save
+a matplotlib figure when running from the CLI.
+
+## Installation
+
+Add to an existing Python project:
+
+```bash
+uv pip install gluex-lumi
+```
+
+or install as a CLI tool:
+
+```bash
+uv tool install gluex-lumi
+```
+
+To write a plot image from the CLI:
+
+```bash
+gluex-lumi --plot=flux.png --run f18=0 --bins=40 --coherent-peak --polarized \
+  --rcdb=rcdb.sqlite --ccdb=ccdb.sqlite --min=8.0 --max=9.0
+```
+
+## Example
+
+```python
+import gluex_lumi as lumi
+
+edges = [7.5 + 0.05 * i for i in range(21)]
+histos = lumi.get_flux_histograms(
+    {"f18": None}, # uses current timestamp rather than REST version
+    edges,
+    coherent_peak=True,
+    rcdb="/data/rcdb.sqlite",
+    ccdb="/data/ccdb.sqlite",
+    exclude_runs=[50000, 50001],
+)
+
+luminosity = histos.tagged_luminosity.as_dict()
+print("bin edges:", luminosity["edges"])
+print("counts:", luminosity["counts"])
+```
+
+## License
+
+Dual-licensed under Apache-2.0 or MIT.
+

gluex_lumi-0.1.3.dist-info/RECORD

@@ -0,0 +1,8 @@
+gluex_lumi/__init__.py,sha256=G8xtlIObMIUOV9Fz9L1aE2JVH8ldMKwbu2Tcmj5_0y4,123
+gluex_lumi/__init__.pyi,sha256=T_d8pfoT6kzVfY3u0IkdOod0nj6RvgoqzmOacCqccyA,1094
+gluex_lumi/gluex_lumi.abi3.so,sha256=nrvYmqJb5UetJgBUKKF5eZhwR2Hw29u9lFajeGRD3vg,4357112
+gluex_lumi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+gluex_lumi-0.1.3.dist-info/METADATA,sha256=yb4Z98yCDCG7Tw4fM9fltCMk2qhd7hQQdL_-HWNRXwg,2515
+gluex_lumi-0.1.3.dist-info/WHEEL,sha256=DXMOaY2lz3w9wym7AwU59JL7in2Qxv3Lir_p1J8ixdE,139
+gluex_lumi-0.1.3.dist-info/entry_points.txt,sha256=zvGv9pN2XpOzRnWHUH2aRvXYDnkGnlqKCLRiIXXwDiA,44
+gluex_lumi-0.1.3.dist-info/RECORD,,

gluex_lumi-0.1.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: maturin (1.11.5)
+Root-Is-Purelib: false
+Tag: cp39-abi3-manylinux_2_17_i686
+Tag: cp39-abi3-manylinux2014_i686

gluex_lumi-0.1.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gluex-lumi=gluex_lumi:cli