dsgbr 0.1.0__tar.gz

dsgbr-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Ricardo Frantz
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

dsgbr-0.1.0/PKG-INFO

@@ -0,0 +1,252 @@
+Metadata-Version: 2.4
+Name: dsgbr
+Version: 0.1.0
+Summary: Dual Savitzky–Golay Baseline Ratio (DSGBR) spectral peak detector
+Author: Ricardo Frantz
+Maintainer: Ricardo Frantz
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/ricardofrantz/dsgbr
+Project-URL: Source, https://github.com/ricardofrantz/dsgbr
+Project-URL: Tracker, https://github.com/ricardofrantz/dsgbr/issues
+Project-URL: Documentation, https://github.com/ricardofrantz/dsgbr#readme
+Keywords: spectral-analysis,peak-detection,signal-processing,savitzky-golay,power-spectral-density,fluid-dynamics
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: scipy>=1.10
+Provides-Extra: plotting
+Requires-Dist: matplotlib>=3.7; extra == "plotting"
+Provides-Extra: tests
+Requires-Dist: coverage[toml]>=7.5.3; extra == "tests"
+Requires-Dist: hypothesis>=6.100; extra == "tests"
+Requires-Dist: pytest-cov>=5.0.0; extra == "tests"
+Requires-Dist: pytest>=8.2.2; extra == "tests"
+Provides-Extra: tests-extra
+Requires-Dist: pytest-randomly==3.16.0; extra == "tests-extra"
+Requires-Dist: pytest-rerunfailures==15.1; extra == "tests-extra"
+Requires-Dist: pytest-xdist==3.8.0; extra == "tests-extra"
+Provides-Extra: qa
+Requires-Dist: codespell>=2.4.1; extra == "qa"
+Requires-Dist: mypy>=1.11.0; extra == "qa"
+Requires-Dist: pre-commit>=3.8.0; extra == "qa"
+Requires-Dist: ruff>=0.7.0; extra == "qa"
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: coverage[toml]>=7.5.3; extra == "dev"
+Requires-Dist: codespell>=2.4.1; extra == "dev"
+Requires-Dist: hypothesis>=6.100; extra == "dev"
+Requires-Dist: mypy>=1.11.0; extra == "dev"
+Requires-Dist: pre-commit>=3.8.0; extra == "dev"
+Requires-Dist: pytest>=8.2.2; extra == "dev"
+Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
+Requires-Dist: pytest-randomly==3.16.0; extra == "dev"
+Requires-Dist: pytest-rerunfailures==15.1; extra == "dev"
+Requires-Dist: pytest-xdist==3.8.0; extra == "dev"
+Requires-Dist: ruff>=0.7.0; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# DSGBR
+
+[![CI](https://github.com/ricardofrantz/dsgbr/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/ricardofrantz/dsgbr/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/ricardofrantz/dsgbr/branch/master/graph/badge.svg)](https://codecov.io/gh/ricardofrantz/dsgbr)
+[![PyPI](https://img.shields.io/pypi/v/dsgbr.svg)](https://pypi.org/project/dsgbr/)
+[![Python](https://img.shields.io/pypi/pyversions/dsgbr.svg)](https://pypi.org/project/dsgbr/)
+[![License](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](LICENSE)
+
+**Dual Savitzky-Golay Baseline Ratio (DSGBR)** is a spectral peak detector
+for frequency-domain signals. It was designed for robust detection in dense,
+noisy power spectra common in fluid dynamics, vibration analysis, and other
+experimental sciences.
+
+## Algorithm
+
+```
+PSD ──► SEARCH (short-scale SG smooth)
+            │
+            ▼
+        BASELINE (long-scale SG smooth)
+            │
+            ▼
+        RATIO = SEARCH / BASELINE
+            │
+            ▼
+        peaks where RATIO ≥ threshold
+            │
+            ├──► spacing rules
+            ├──► ULF guardrail
+            └──► band selection (if > max_peaks)
+            │
+            ▼
+        (peak_frequencies, peak_heights)
+```
+
+The detector builds a short-scale **SEARCH** signal and a longer-scale
+**BASELINE** signal using Savitzky-Golay filtering. A peak is accepted
+when `SEARCH / BASELINE` exceeds a configurable ratio threshold, subject
+to spacing constraints and an ultra-low-frequency guardrail.
+
+## Install
+
+```bash
+pip install dsgbr
+```
+
+For development:
+
+```bash
+git clone https://github.com/ricardofrantz/dsgbr.git
+cd dsgbr
+uv pip install -e ".[dev]"
+```
+
+## Quick start
+
+```python
+import numpy as np
+from dsgbr import dsgbr_detector
+
+# Synthetic PSD with known peaks
+frequencies = np.linspace(0.001, 1.0, 2048)
+psd = np.ones_like(frequencies)
+psd[400] = 12.0  # inject a peak
+psd[1200] = 8.0  # inject another
+
+peak_f, peak_h = dsgbr_detector(
+    frequencies, psd,
+    case_info={"ratio_threshold": 1.5, "baseline_window": 61},
+)
+print(f"Detected {peak_f.size} peaks at f = {peak_f}")
+```
+
+## Configuration
+
+All parameters are set through `DetectionConfig` or passed as a dictionary
+via the `case_info` argument. Short aliases (RT, SW, BWF, etc.) are
+supported for concise configuration.
+
+| Parameter | Alias | Default | Description |
+|-----------|-------|---------|-------------|
+| `ratio_threshold` | RT | 1.8 | Min SEARCH/BASELINE ratio for acceptance |
+| `smooth_window` | SW | 3 | Savitzky-Golay window for SEARCH (odd, >= 3) |
+| `baseline_window_frac` | BWF | 0.001 | Baseline window as fraction of data length |
+| `distance_low` | DL | 2 | Min bin separation below `switch_frequency` |
+| `distance_high` | DH | 1 | Min bin separation above `switch_frequency` |
+| `switch_frequency` | SF | 0.02 | Frequency threshold for spacing rules |
+| `max_peaks` | MP | 25 | Maximum peaks returned |
+| `smooth_polyorder` | — | 2 | Polynomial order for SG filter |
+| `smooth_on_log` | — | True | Smooth log10(PSD) instead of linear |
+| `baseline_window` | — | None | Fixed baseline window (overrides BWF) |
+| `baseline_on_log` | — | True | Baseline smoothing in log domain |
+| `band_strategy` | — | proportional | Band allocation: proportional or equal |
+| `n_bands` | — | 10 | Number of logarithmic frequency bands |
+| `ulf_fmax` | — | 0.001 | ULF band upper frequency limit |
+| `ulf_min_q` | — | 9.0 | Minimum Q-factor for ULF peaks |
+| `ulf_max_points` | — | 5 | Maximum ULF peaks to retain |
+
+## Advanced usage
+
+### Support series for visualization
+
+```python
+from dsgbr import compute_support_series
+
+support = compute_support_series(frequencies, psd, case_info={"RT": 2.0})
+
+# Plot SEARCH vs BASELINE overlay
+import matplotlib.pyplot as plt
+plt.semilogy(frequencies, support["search_series"], label="SEARCH")
+plt.semilogy(frequencies, support["baseline_series"], label="BASELINE")
+plt.semilogy(frequencies, support["rthreshold"], "--", label="Threshold")
+plt.legend()
+plt.show()
+```
+
+### Band-balanced peak selection
+
+```python
+from dsgbr import select_peaks_by_frequency_bands
+
+# Reduce 100 peaks to 15, spread across frequency bands
+sel_f, sel_h = select_peaks_by_frequency_bands(
+    peak_frequencies, peak_heights,
+    max_peaks=15, strategy="proportional", n_bands=8,
+)
+```
+
+### Configuration via dataclass
+
+```python
+from dsgbr import DetectionConfig
+
+cfg = DetectionConfig(ratio_threshold=2.5, smooth_window=7, max_peaks=10)
+print(cfg.to_metadata())
+```
+
+## API reference
+
+| Function / Class | Description |
+|-----------------|-------------|
+| `dsgbr_detector(f, psd, *, case_info, return_support)` | Main detection pipeline |
+| `compute_support_series(f, psd, case_info)` | Return intermediate arrays for visualization |
+| `select_peaks_by_frequency_bands(f, h, *, max_peaks, strategy, n_bands)` | Band-balanced down-selection |
+| `find_nearest_frequency(target, frequencies, heights)` | Closest detected frequency lookup |
+| `DetectionConfig` | Frozen dataclass with 17 parameters |
+| `detect_peaks_case_adaptive(...)` | Deprecated alias for `dsgbr_detector` |
+| `DSGBR_PARAM_ALIASES` | Short-to-long parameter name mapping |
+
+## Examples
+
+See [`examples/`](examples/) for runnable scripts:
+
+- **`basic_usage.py`** — minimal detection example
+- **`parameter_tuning.py`** — sweep ratio_threshold, compare peak counts
+- **`visualization.py`** — SEARCH/BASELINE overlay plot
+
+## How it works
+
+DSGBR applies two Savitzky-Golay passes at different scales to separate
+sharp spectral peaks from the slowly varying baseline. The ratio between
+these two series naturally highlights peaks above the local background,
+making the detector robust to spectral slope and broadband noise. For a
+detailed description, see [`docs/algorithm.md`](docs/algorithm.md).
+
+## Citation
+
+If you use DSGBR in your research, please cite:
+
+```bibtex
+@software{dsgbr2026,
+  author = {Frantz, Ricardo},
+  title = {{DSGBR}: Dual Savitzky--Golay Baseline Ratio spectral peak detector},
+  year = {2026},
+  url = {https://github.com/ricardofrantz/dsgbr},
+}
+```
+
+## License
+
+BSD 3-Clause. See [LICENSE](LICENSE).
+
+## Contributing
+
+Contributions are welcome. Please open an issue to discuss changes before
+submitting a pull request. Run the full QA suite before submitting:
+
+```bash
+uv pip install -e ".[dev]"
+pre-commit run --all-files
+pytest --cov=dsgbr
+```

dsgbr-0.1.0/README.md

@@ -0,0 +1,192 @@
+# DSGBR
+
+[![CI](https://github.com/ricardofrantz/dsgbr/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/ricardofrantz/dsgbr/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/ricardofrantz/dsgbr/branch/master/graph/badge.svg)](https://codecov.io/gh/ricardofrantz/dsgbr)
+[![PyPI](https://img.shields.io/pypi/v/dsgbr.svg)](https://pypi.org/project/dsgbr/)
+[![Python](https://img.shields.io/pypi/pyversions/dsgbr.svg)](https://pypi.org/project/dsgbr/)
+[![License](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](LICENSE)
+
+**Dual Savitzky-Golay Baseline Ratio (DSGBR)** is a spectral peak detector
+for frequency-domain signals. It was designed for robust detection in dense,
+noisy power spectra common in fluid dynamics, vibration analysis, and other
+experimental sciences.
+
+## Algorithm
+
+```
+PSD ──► SEARCH (short-scale SG smooth)
+            │
+            ▼
+        BASELINE (long-scale SG smooth)
+            │
+            ▼
+        RATIO = SEARCH / BASELINE
+            │
+            ▼
+        peaks where RATIO ≥ threshold
+            │
+            ├──► spacing rules
+            ├──► ULF guardrail
+            └──► band selection (if > max_peaks)
+            │
+            ▼
+        (peak_frequencies, peak_heights)
+```
+
+The detector builds a short-scale **SEARCH** signal and a longer-scale
+**BASELINE** signal using Savitzky-Golay filtering. A peak is accepted
+when `SEARCH / BASELINE` exceeds a configurable ratio threshold, subject
+to spacing constraints and an ultra-low-frequency guardrail.
+
+## Install
+
+```bash
+pip install dsgbr
+```
+
+For development:
+
+```bash
+git clone https://github.com/ricardofrantz/dsgbr.git
+cd dsgbr
+uv pip install -e ".[dev]"
+```
+
+## Quick start
+
+```python
+import numpy as np
+from dsgbr import dsgbr_detector
+
+# Synthetic PSD with known peaks
+frequencies = np.linspace(0.001, 1.0, 2048)
+psd = np.ones_like(frequencies)
+psd[400] = 12.0  # inject a peak
+psd[1200] = 8.0  # inject another
+
+peak_f, peak_h = dsgbr_detector(
+    frequencies, psd,
+    case_info={"ratio_threshold": 1.5, "baseline_window": 61},
+)
+print(f"Detected {peak_f.size} peaks at f = {peak_f}")
+```
+
+## Configuration
+
+All parameters are set through `DetectionConfig` or passed as a dictionary
+via the `case_info` argument. Short aliases (RT, SW, BWF, etc.) are
+supported for concise configuration.
+
+| Parameter | Alias | Default | Description |
+|-----------|-------|---------|-------------|
+| `ratio_threshold` | RT | 1.8 | Min SEARCH/BASELINE ratio for acceptance |
+| `smooth_window` | SW | 3 | Savitzky-Golay window for SEARCH (odd, >= 3) |
+| `baseline_window_frac` | BWF | 0.001 | Baseline window as fraction of data length |
+| `distance_low` | DL | 2 | Min bin separation below `switch_frequency` |
+| `distance_high` | DH | 1 | Min bin separation above `switch_frequency` |
+| `switch_frequency` | SF | 0.02 | Frequency threshold for spacing rules |
+| `max_peaks` | MP | 25 | Maximum peaks returned |
+| `smooth_polyorder` | — | 2 | Polynomial order for SG filter |
+| `smooth_on_log` | — | True | Smooth log10(PSD) instead of linear |
+| `baseline_window` | — | None | Fixed baseline window (overrides BWF) |
+| `baseline_on_log` | — | True | Baseline smoothing in log domain |
+| `band_strategy` | — | proportional | Band allocation: proportional or equal |
+| `n_bands` | — | 10 | Number of logarithmic frequency bands |
+| `ulf_fmax` | — | 0.001 | ULF band upper frequency limit |
+| `ulf_min_q` | — | 9.0 | Minimum Q-factor for ULF peaks |
+| `ulf_max_points` | — | 5 | Maximum ULF peaks to retain |
+
+## Advanced usage
+
+### Support series for visualization
+
+```python
+from dsgbr import compute_support_series
+
+support = compute_support_series(frequencies, psd, case_info={"RT": 2.0})
+
+# Plot SEARCH vs BASELINE overlay
+import matplotlib.pyplot as plt
+plt.semilogy(frequencies, support["search_series"], label="SEARCH")
+plt.semilogy(frequencies, support["baseline_series"], label="BASELINE")
+plt.semilogy(frequencies, support["rthreshold"], "--", label="Threshold")
+plt.legend()
+plt.show()
+```
+
+### Band-balanced peak selection
+
+```python
+from dsgbr import select_peaks_by_frequency_bands
+
+# Reduce 100 peaks to 15, spread across frequency bands
+sel_f, sel_h = select_peaks_by_frequency_bands(
+    peak_frequencies, peak_heights,
+    max_peaks=15, strategy="proportional", n_bands=8,
+)
+```
+
+### Configuration via dataclass
+
+```python
+from dsgbr import DetectionConfig
+
+cfg = DetectionConfig(ratio_threshold=2.5, smooth_window=7, max_peaks=10)
+print(cfg.to_metadata())
+```
+
+## API reference
+
+| Function / Class | Description |
+|-----------------|-------------|
+| `dsgbr_detector(f, psd, *, case_info, return_support)` | Main detection pipeline |
+| `compute_support_series(f, psd, case_info)` | Return intermediate arrays for visualization |
+| `select_peaks_by_frequency_bands(f, h, *, max_peaks, strategy, n_bands)` | Band-balanced down-selection |
+| `find_nearest_frequency(target, frequencies, heights)` | Closest detected frequency lookup |
+| `DetectionConfig` | Frozen dataclass with 17 parameters |
+| `detect_peaks_case_adaptive(...)` | Deprecated alias for `dsgbr_detector` |
+| `DSGBR_PARAM_ALIASES` | Short-to-long parameter name mapping |
+
+## Examples
+
+See [`examples/`](examples/) for runnable scripts:
+
+- **`basic_usage.py`** — minimal detection example
+- **`parameter_tuning.py`** — sweep ratio_threshold, compare peak counts
+- **`visualization.py`** — SEARCH/BASELINE overlay plot
+
+## How it works
+
+DSGBR applies two Savitzky-Golay passes at different scales to separate
+sharp spectral peaks from the slowly varying baseline. The ratio between
+these two series naturally highlights peaks above the local background,
+making the detector robust to spectral slope and broadband noise. For a
+detailed description, see [`docs/algorithm.md`](docs/algorithm.md).
+
+## Citation
+
+If you use DSGBR in your research, please cite:
+
+```bibtex
+@software{dsgbr2026,
+  author = {Frantz, Ricardo},
+  title = {{DSGBR}: Dual Savitzky--Golay Baseline Ratio spectral peak detector},
+  year = {2026},
+  url = {https://github.com/ricardofrantz/dsgbr},
+}
+```
+
+## License
+
+BSD 3-Clause. See [LICENSE](LICENSE).
+
+## Contributing
+
+Contributions are welcome. Please open an issue to discuss changes before
+submitting a pull request. Run the full QA suite before submitting:
+
+```bash
+uv pip install -e ".[dev]"
+pre-commit run --all-files
+pytest --cov=dsgbr
+```

dsgbr-0.1.0/pyproject.toml

@@ -0,0 +1,123 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dsgbr"
+version = "0.1.0"
+description = "Dual Savitzky–Golay Baseline Ratio (DSGBR) spectral peak detector"
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.10"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+authors = [{ name = "Ricardo Frantz" }]
+maintainers = [{ name = "Ricardo Frantz" }]
+dependencies = [
+    "numpy>=1.24",
+    "scipy>=1.10",
+]
+keywords = [
+    "spectral-analysis",
+    "peak-detection",
+    "signal-processing",
+    "savitzky-golay",
+    "power-spectral-density",
+    "fluid-dynamics",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Education",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering",
+    "Typing :: Typed",
+]
+
+[project.optional-dependencies]
+plotting = [
+    "matplotlib>=3.7",
+]
+tests = [
+    "coverage[toml]>=7.5.3",
+    "hypothesis>=6.100",
+    "pytest-cov>=5.0.0",
+    "pytest>=8.2.2",
+]
+tests-extra = [
+    "pytest-randomly==3.16.0",
+    "pytest-rerunfailures==15.1",
+    "pytest-xdist==3.8.0",
+]
+qa = [
+    "codespell>=2.4.1",
+    "mypy>=1.11.0",
+    "pre-commit>=3.8.0",
+    "ruff>=0.7.0",
+]
+dev = [
+    "build",
+    "coverage[toml]>=7.5.3",
+    "codespell>=2.4.1",
+    "hypothesis>=6.100",
+    "mypy>=1.11.0",
+    "pre-commit>=3.8.0",
+    "pytest>=8.2.2",
+    "pytest-cov>=5.0.0",
+    "pytest-randomly==3.16.0",
+    "pytest-rerunfailures==15.1",
+    "pytest-xdist==3.8.0",
+    "ruff>=0.7.0",
+    "twine",
+]
+
+[project.urls]
+Homepage = "https://github.com/ricardofrantz/dsgbr"
+Source = "https://github.com/ricardofrantz/dsgbr"
+Tracker = "https://github.com/ricardofrantz/dsgbr/issues"
+Documentation = "https://github.com/ricardofrantz/dsgbr#readme"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+extend-exclude = ["docs/conf.py"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP", "SIM", "RUF", "D"]
+ignore = ["E501", "D100", "D104"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "numpy"
+
+[tool.ruff.lint.extend-per-file-ignores]
+"__init__.py" = ["F401"]
+"tests/*" = ["D"]
+"examples/*" = ["D"]
+
+[tool.mypy]
+pretty = true
+strict = true
+python_version = "3.10"
+exclude = ["docs/conf.py"]
+
+[tool.codespell]
+skip = "docs/conf.py"
+check-filenames = true
+
+[tool.coverage.run]
+branch = true
+relative_files = true
+source = ["dsgbr"]
+omit = ["*/__pycache__/*"]
+
+[tool.coverage.report]
+fail_under = 90
+precision = 2
+show_missing = true

dsgbr-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dsgbr-0.1.0/src/dsgbr/DSGBR.py

@@ -0,0 +1,29 @@
+"""Backward-compatibility shim for ``from dsgbr.DSGBR import ...``.
+
+This module re-exports the full public API so that existing call sites
+(e.g. ``from dsgbr.DSGBR import dsgbr_detector``) continue to work
+unchanged after the package restructure.
+"""
+
+from dsgbr._compat import (
+    DSGBR_PARAM_ALIASES,
+    DSGBRDetectionConfig,
+    detect_peaks_case_adaptive,
+)
+from dsgbr._config import DetectionConfig
+from dsgbr._detector import compute_support_series, dsgbr_detector
+from dsgbr._selection import (
+    find_nearest_frequency,
+    select_peaks_by_frequency_bands,
+)
+
+__all__ = [
+    "DSGBR_PARAM_ALIASES",
+    "DSGBRDetectionConfig",
+    "DetectionConfig",
+    "compute_support_series",
+    "detect_peaks_case_adaptive",
+    "dsgbr_detector",
+    "find_nearest_frequency",
+    "select_peaks_by_frequency_bands",
+]

dsgbr-0.1.0/src/dsgbr/__init__.py

@@ -0,0 +1,35 @@
+"""Dual Savitzky-Golay Baseline Ratio (DSGBR) spectral peak detector.
+
+The DSGBR detector applies two Savitzky-Golay smoothing passes -- one to build
+the SEARCH series, another to obtain a broader BASELINE -- and accepts peaks
+where the SEARCH/BASELINE ratio exceeds a configurable threshold.
+
+Public API
+----------
+.. autosummary::
+    DetectionConfig
+    dsgbr_detector
+    compute_support_series
+    select_peaks_by_frequency_bands
+    find_nearest_frequency
+    detect_peaks_case_adaptive
+    DSGBRDetectionConfig
+    DSGBR_PARAM_ALIASES
+"""
+
+from dsgbr._compat import DSGBR_PARAM_ALIASES, DSGBRDetectionConfig, detect_peaks_case_adaptive
+from dsgbr._config import DetectionConfig
+from dsgbr._detector import compute_support_series, dsgbr_detector
+from dsgbr._selection import find_nearest_frequency, select_peaks_by_frequency_bands
+
+__version__ = "0.1.0"
+__all__ = [
+    "DSGBR_PARAM_ALIASES",
+    "DSGBRDetectionConfig",
+    "DetectionConfig",
+    "compute_support_series",
+    "detect_peaks_case_adaptive",
+    "dsgbr_detector",
+    "find_nearest_frequency",
+    "select_peaks_by_frequency_bands",
+]