lated 0.1.0__tar.gz

lated-0.1.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 0.1.0 (2026-07-08)
+
+Initial public release, accompanying LATED Paper I.
+
+- Transparent fitting engine: power-law continuum + emission lines fitted
+  through real filter transmission curves, with every parameter's role
+  (free / fixed / tied) explicit and user-configurable.
+- Exact numerical parity with the LATED paper pipeline in bootstrap mode;
+  a posterior (truncated-Gaussian Gibbs) sampler as the statistically
+  preferred alternative for upper/lower limits.
+- Balmer-ratio ties from Osterbrock & Ferland (2006) Case A/B tables,
+  selectable by (T_e, n_e); dust via Calzetti or SMC with A_V uncertainty
+  propagation.
+- 46 bundled JWST NIRCam + MIRI and Roman WFI filter curves (SVO).
+- Line-ratio verdicts (measured / 2-sigma upper / lower limit /
+  unconstrained) with per-line flux sensitivities and depth warnings.
+- FastAPI + vanilla-JS web application (`lated serve`): SED and corner
+  plots as publication-ready SVG/PDF, literature one-click examples,
+  full parameter-role controls.
+- Python API quickstart notebook in `examples/`.

lated-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mingyu Li
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lated-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+# sdist extras beyond what setuptools includes automatically
+include CHANGELOG.md
+recursive-include tests *.py
+recursive-include examples *.ipynb

lated-0.1.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: lated
+Version: 0.1.0
+Summary: LATED photometric emission-line recovery: transparent continuum + line fits through real filter curves, with a web application
+Author-email: Mingyu Li <lmytime@hotmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/lmytime/lated
+Project-URL: Repository, https://github.com/lmytime/lated
+Project-URL: Documentation, https://github.com/lmytime/lated#readme
+Keywords: astronomy,astrophysics,photometry,emission-lines,JWST,NIRCam,SED,high-redshift
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+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 :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.20
+Requires-Dist: scipy>=1.7
+Requires-Dist: pydantic>=2.0
+Requires-Dist: fastapi>=0.100
+Requires-Dist: uvicorn>=0.20
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: httpx; extra == "test"
+Dynamic: license-file
+
+# LATED
+
+**Measure emission lines you can't spectroscopically resolve, straight from photometry.**
+
+[![PyPI version](https://img.shields.io/pypi/v/lated.svg)](https://pypi.org/project/lated/)
+[![Python versions](https://img.shields.io/pypi/pyversions/lated.svg)](https://pypi.org/project/lated/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Tests](https://github.com/lmytime/lated/actions/workflows/ci.yml/badge.svg)](https://github.com/lmytime/lated/actions/workflows/ci.yml)
+
+You have JWST (or Roman) photometry of a galaxy, and one of the bands looks
+too bright: an emission line is boosting it. `lated` turns that excess into a
+number. It fits a simple continuum + emission-line model *through the real
+filter curves* and reports the line fluxes, rest-frame equivalent widths and
+line ratios (for example `[O III] 5007 / Hβ`) that the photometry implies.
+
+When a line is genuinely there, you get a measurement with uncertainties.
+When it isn't, you get an **honest upper limit**, not a fabricated value. That
+distinction is the whole point of the tool.
+
+Use it two ways: a point-and-click **web app** (no coding), or a small
+**Python API** for scripting and batch work.
+
+![The lated web workbench](https://raw.githubusercontent.com/lmytime/lated/main/docs/webapp.png)
+
+## Install
+
+```bash
+pip install lated
+```
+
+That is everything: the Python library, the command line, and the web app.
+Python 3.9+ (depends only on NumPy, SciPy, pydantic and FastAPI).
+
+## The web app
+
+```bash
+lated serve            # open http://127.0.0.1:8321
+```
+
+Pick a redshift, tick the bands you have, paste your fluxes, and press run.
+You get a verdict card (measurement or limit), an SED figure and a corner
+plot, all exportable to PDF. Start from one of the built-in literature
+examples to see the whole workflow in a single click. Everything on the board
+is editable: the line list, which lines are free / tied / off, the nebular
+conditions that set the Balmer ratios (Osterbrock & Ferland 2006 Case A/B by
+temperature and density), the continuum slope, dust, and the error budget.
+
+## From Python
+
+```python
+from lated import FitConfig, fit
+
+photometry = {"F200W": (0.0136, 0.0019),   # {band: (flux, error)} in microJansky
+              "F277W": (0.0249, 0.0016),
+              "F356W": (0.0040, 0.0014)}
+
+res = fit(photometry, FitConfig.three_band(z=3.193))
+print(res.ratios[0].status)                # 'upper_limit', 'measured', ...
+```
+
+That is the whole idea. The [example notebook](examples/quickstart.ipynb)
+walks through reading the results, plotting the SED and corner, editing line
+roles, choosing nebular conditions, and the posterior error budget.
+
+## What you get back
+
+Every line ratio carries a **status**, so a number is never mistaken for a
+measurement it isn't:
+
+| status | meaning | quote |
+|---|---|---|
+| `measured` | both lines detected | the value with 16/50/84 percentiles |
+| `upper_limit` | numerator consistent with zero | `< p97.5` (2σ) |
+| `lower_limit` | denominator consistent with zero | `> p2.5` |
+| `unconstrained` | no band covers the line | nothing usable |
+
+Each line also reports the faintest flux your photometry could have detected,
+so every non-detection comes with its depth.
+
+## How it works
+
+Per band, the predicted flux is the photon-weighted mean of
+
+```
+f_λ(λ) = C (λ/λ0)^β  +  Σ_l  F_l · δ(λ − λ_l (1+z))
+```
+
+integrated through the real transmission curve and compared to your photometry
+with a Gaussian likelihood; amplitudes are solved by error-weighted
+non-negative least squares over a grid of slopes. Every parameter has an
+explicit role (free, fixed, or tied) that you can change, and invalid setups
+(unknown bands, tie cycles, non-positive errors, under-constrained fits) are
+raised as errors rather than silently ignored.
+
+## Command line
+
+```bash
+lated serve                 # run the web app
+lated fit input.json        # fit from a JSON file
+lated bands                 # list the bundled filter curves
+lated lines                 # show the default line registry
+```
+
+The web app also exposes a small REST API (`/api/meta`,
+`/api/filters/{name}`, `/api/fit`) with interactive docs at `/docs`.
+
+## Citing
+
+If `lated` contributes to your research, please cite Li et al. (2026, LATED
+Paper I).
+
+## Development
+
+```bash
+git clone https://github.com/lmytime/lated
+cd lated
+pip install -e ".[test]"
+PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 pytest tests/ -q
+```
+
+Issues and contributions are welcome at
+[github.com/lmytime/lated](https://github.com/lmytime/lated).
+Released under the [MIT License](LICENSE).

lated-0.1.0/README.md

@@ -0,0 +1,123 @@
+# LATED
+
+**Measure emission lines you can't spectroscopically resolve, straight from photometry.**
+
+[![PyPI version](https://img.shields.io/pypi/v/lated.svg)](https://pypi.org/project/lated/)
+[![Python versions](https://img.shields.io/pypi/pyversions/lated.svg)](https://pypi.org/project/lated/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Tests](https://github.com/lmytime/lated/actions/workflows/ci.yml/badge.svg)](https://github.com/lmytime/lated/actions/workflows/ci.yml)
+
+You have JWST (or Roman) photometry of a galaxy, and one of the bands looks
+too bright: an emission line is boosting it. `lated` turns that excess into a
+number. It fits a simple continuum + emission-line model *through the real
+filter curves* and reports the line fluxes, rest-frame equivalent widths and
+line ratios (for example `[O III] 5007 / Hβ`) that the photometry implies.
+
+When a line is genuinely there, you get a measurement with uncertainties.
+When it isn't, you get an **honest upper limit**, not a fabricated value. That
+distinction is the whole point of the tool.
+
+Use it two ways: a point-and-click **web app** (no coding), or a small
+**Python API** for scripting and batch work.
+
+![The lated web workbench](https://raw.githubusercontent.com/lmytime/lated/main/docs/webapp.png)
+
+## Install
+
+```bash
+pip install lated
+```
+
+That is everything: the Python library, the command line, and the web app.
+Python 3.9+ (depends only on NumPy, SciPy, pydantic and FastAPI).
+
+## The web app
+
+```bash
+lated serve            # open http://127.0.0.1:8321
+```
+
+Pick a redshift, tick the bands you have, paste your fluxes, and press run.
+You get a verdict card (measurement or limit), an SED figure and a corner
+plot, all exportable to PDF. Start from one of the built-in literature
+examples to see the whole workflow in a single click. Everything on the board
+is editable: the line list, which lines are free / tied / off, the nebular
+conditions that set the Balmer ratios (Osterbrock & Ferland 2006 Case A/B by
+temperature and density), the continuum slope, dust, and the error budget.
+
+## From Python
+
+```python
+from lated import FitConfig, fit
+
+photometry = {"F200W": (0.0136, 0.0019),   # {band: (flux, error)} in microJansky
+              "F277W": (0.0249, 0.0016),
+              "F356W": (0.0040, 0.0014)}
+
+res = fit(photometry, FitConfig.three_band(z=3.193))
+print(res.ratios[0].status)                # 'upper_limit', 'measured', ...
+```
+
+That is the whole idea. The [example notebook](examples/quickstart.ipynb)
+walks through reading the results, plotting the SED and corner, editing line
+roles, choosing nebular conditions, and the posterior error budget.
+
+## What you get back
+
+Every line ratio carries a **status**, so a number is never mistaken for a
+measurement it isn't:
+
+| status | meaning | quote |
+|---|---|---|
+| `measured` | both lines detected | the value with 16/50/84 percentiles |
+| `upper_limit` | numerator consistent with zero | `< p97.5` (2σ) |
+| `lower_limit` | denominator consistent with zero | `> p2.5` |
+| `unconstrained` | no band covers the line | nothing usable |
+
+Each line also reports the faintest flux your photometry could have detected,
+so every non-detection comes with its depth.
+
+## How it works
+
+Per band, the predicted flux is the photon-weighted mean of
+
+```
+f_λ(λ) = C (λ/λ0)^β  +  Σ_l  F_l · δ(λ − λ_l (1+z))
+```
+
+integrated through the real transmission curve and compared to your photometry
+with a Gaussian likelihood; amplitudes are solved by error-weighted
+non-negative least squares over a grid of slopes. Every parameter has an
+explicit role (free, fixed, or tied) that you can change, and invalid setups
+(unknown bands, tie cycles, non-positive errors, under-constrained fits) are
+raised as errors rather than silently ignored.
+
+## Command line
+
+```bash
+lated serve                 # run the web app
+lated fit input.json        # fit from a JSON file
+lated bands                 # list the bundled filter curves
+lated lines                 # show the default line registry
+```
+
+The web app also exposes a small REST API (`/api/meta`,
+`/api/filters/{name}`, `/api/fit`) with interactive docs at `/docs`.
+
+## Citing
+
+If `lated` contributes to your research, please cite Li et al. (2026, LATED
+Paper I).
+
+## Development
+
+```bash
+git clone https://github.com/lmytime/lated
+cd lated
+pip install -e ".[test]"
+PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 pytest tests/ -q
+```
+
+Issues and contributions are welcome at
+[github.com/lmytime/lated](https://github.com/lmytime/lated).
+Released under the [MIT License](LICENSE).