hebog 0.22.0__tar.gz

hebog-0.22.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Gemma Danks
+
+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.

hebog-0.22.0/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: hebog
+Version: 0.22.0
+Summary: A scalable source finder for radio continuum images
+Author: Gemma Danks
+Author-email: Gemma Danks <gemma.danks@skao.int>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Dist: astropy>=8.0.1,<9
+Requires-Dist: distributed>=2026.7.1,<2027
+Requires-Dist: numpy>=2.0.2,<3
+Requires-Dist: pydantic>=2.12,<3
+Requires-Dist: scipy>=1.15,<2
+Requires-Dist: zarr>=3.2,<3.3
+Requires-Python: >=3.12
+Project-URL: Homepage, https://open-research.gemmadanks.com/hebog/
+Project-URL: Documentation, https://open-research.gemmadanks.com/hebog/
+Project-URL: Repository, https://github.com/gemmadanks/hebog
+Project-URL: Issues, https://github.com/gemmadanks/hebog/issues
+Project-URL: Changelog, https://github.com/gemmadanks/hebog/releases
+Description-Content-Type: text/markdown
+
+# Hebog
+
+[![CI](https://github.com/gemmadanks/hebog/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/gemmadanks/hebog/actions/workflows/ci.yaml)
+[![release-please](https://github.com/gemmadanks/hebog/actions/workflows/release-please.yaml/badge.svg)](https://github.com/gemmadanks/hebog/actions/workflows/release-please.yaml)
+[![Docs](https://github.com/gemmadanks/hebog/actions/workflows/docs-pages.yaml/badge.svg)](https://open-research.gemmadanks.com/hebog/)
+[![codecov](https://codecov.io/gh/gemmadanks/hebog/graph/badge.svg)](https://codecov.io/gh/gemmadanks/hebog)
+[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://github.com/gemmadanks/hebog/blob/main/LICENSE)
+
+Hebog is a scalable source finder for radio continuum images. It is
+**experimental**, and runs in a single process or on a Dask cluster. For each FITS image it:
+
+1. estimates the background and noise;
+2. detects compact and extended emission;
+3. separates, fits and measures sources; and
+4. publishes a source catalogue, a noise (RMS) image, a source mask and
+   diagnostics.
+
+[How Hebog finds sources](https://open-research.gemmadanks.com/hebog/explanation/how-hebog-works/)
+explains each step with diagrams.
+
+Hebog aims to be a fast, scalable source finder that is easily integrated into
+next generation radio astronomy data processing pipelines such as
+[Rapthor](https://github.com/darafferty/rapthor). It can also be used on its own from Python.
+
+## Status
+
+- **Experimental.** Releases are `0.x` and may change the API or output
+  formats. Pin an exact version and read the
+  [release notes](https://github.com/gemmadanks/hebog/releases) before
+  upgrading.
+- **Not yet scientifically qualified.** Hebog is compared against
+  [PyBDSF](https://github.com/lofar-astron/PyBDSF) and
+  [Aegean](https://github.com/PaulHancock/Aegean) on simulated images with
+  known sources, but these checks are development evidence rather than qualification
+  for survey use. See
+  [scientific status](https://open-research.gemmadanks.com/hebog/reference/release-status/#scientific-status).
+- **Supported inputs:** one FITS image in `Jy/beam` with ICRS or FK5 J2000 sky
+  coordinates and at most 15,402 pixels on each side.
+
+[Current capability and release status](https://open-research.gemmadanks.com/hebog/reference/release-status/)
+lists the full input requirements and known limitations, and
+[progress against goals](https://open-research.gemmadanks.com/hebog/reference/progress-against-goals/)
+summarises on one page where development stands against the project's
+telescope, Rapthor, science, performance, scalability and release goals.
+
+## Installation
+
+Hebog is experimental: `0.x` releases can change the API, the outputs and
+the measurements, so pin the exact version. Install it from
+[PyPI](https://pypi.org/project/hebog/) into a Python 3.12 to 3.14
+environment (releases before 0.22.0 are on GitHub only):
+
+<!-- x-release-please-start-version -->
+
+```shell
+pip install hebog==0.22.0
+```
+
+<!-- x-release-please-end -->
+
+## Example
+
+```python
+from pathlib import Path
+
+from hebog import SourceFinderConfig, SourceFinderRequest, find_sources
+from hebog.executors import SerialExecutor
+
+request = SourceFinderRequest(
+    image_path=Path("image.fits"),
+    output_directory=Path("output"),
+    run_id="example",
+)
+config = SourceFinderConfig(
+    detection_threshold_sigma=5.0,
+    island_threshold_sigma=3.0,
+    minimum_island_pixels=7,
+)
+result = find_sources(request, config, SerialExecutor())
+print(result.catalogue_path, result.source_count)
+```
+
+The output directory must not already exist; running the same request again
+returns the products already there. The
+[source-finding tutorial](https://open-research.gemmadanks.com/hebog/tutorials/find-sources/)
+explains the settings, the products and how to run on Dask.
+
+## Documentation
+
+- [FAQ for astronomers](https://open-research.gemmadanks.com/hebog/explanation/astronomer-faq/)
+- [Find sources in a FITS image](https://open-research.gemmadanks.com/hebog/tutorials/find-sources/)
+- [How Hebog finds sources](https://open-research.gemmadanks.com/hebog/explanation/how-hebog-works/)
+- [Hebog and other source finders](https://open-research.gemmadanks.com/hebog/explanation/source-finder-comparison/)
+- [Catalogue, image and diagnostic outputs](https://open-research.gemmadanks.com/hebog/reference/public-products/)
+- [Interactive notebooks](https://open-research.gemmadanks.com/hebog/how-to/notebooks/)
+- [FAQ for developers and architects](https://open-research.gemmadanks.com/hebog/explanation/developer-faq/)
+- [Architecture](https://open-research.gemmadanks.com/hebog/architecture/)
+- [How Hebog distributes work](https://open-research.gemmadanks.com/hebog/architecture/distributed-execution/)
+- [Integrate Hebog into a pipeline](https://open-research.gemmadanks.com/hebog/how-to/integrate-into-a-pipeline/)
+- [API reference](https://open-research.gemmadanks.com/hebog/reference/)
+
+## Development
+
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and
+[just](https://just.systems/), then:
+
+```shell
+git clone https://github.com/gemmadanks/hebog.git
+cd hebog
+uv sync --all-groups
+just check    # formatting, linting, type checks and fast tests
+just --list   # all test, documentation and packaging commands
+```
+
+Contributions use [Conventional Commits](https://www.conventionalcommits.org/).
+[AGENTS.md](https://github.com/gemmadanks/hebog/blob/main/AGENTS.md) describes
+the project's working rules, test suites and review checklist.
+
+## Citation and licence
+
+If Hebog contributes to your research, please cite it using
+[CITATION.cff](https://github.com/gemmadanks/hebog/blob/main/CITATION.cff).
+Hebog is distributed under the
+[BSD 3-Clause License](https://github.com/gemmadanks/hebog/blob/main/LICENSE).

hebog-0.22.0/README.md

@@ -0,0 +1,124 @@
+# Hebog
+
+[![CI](https://github.com/gemmadanks/hebog/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/gemmadanks/hebog/actions/workflows/ci.yaml)
+[![release-please](https://github.com/gemmadanks/hebog/actions/workflows/release-please.yaml/badge.svg)](https://github.com/gemmadanks/hebog/actions/workflows/release-please.yaml)
+[![Docs](https://github.com/gemmadanks/hebog/actions/workflows/docs-pages.yaml/badge.svg)](https://open-research.gemmadanks.com/hebog/)
+[![codecov](https://codecov.io/gh/gemmadanks/hebog/graph/badge.svg)](https://codecov.io/gh/gemmadanks/hebog)
+[![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://github.com/gemmadanks/hebog/blob/main/LICENSE)
+
+Hebog is a scalable source finder for radio continuum images. It is
+**experimental**, and runs in a single process or on a Dask cluster. For each FITS image it:
+
+1. estimates the background and noise;
+2. detects compact and extended emission;
+3. separates, fits and measures sources; and
+4. publishes a source catalogue, a noise (RMS) image, a source mask and
+   diagnostics.
+
+[How Hebog finds sources](https://open-research.gemmadanks.com/hebog/explanation/how-hebog-works/)
+explains each step with diagrams.
+
+Hebog aims to be a fast, scalable source finder that is easily integrated into
+next generation radio astronomy data processing pipelines such as
+[Rapthor](https://github.com/darafferty/rapthor). It can also be used on its own from Python.
+
+## Status
+
+- **Experimental.** Releases are `0.x` and may change the API or output
+  formats. Pin an exact version and read the
+  [release notes](https://github.com/gemmadanks/hebog/releases) before
+  upgrading.
+- **Not yet scientifically qualified.** Hebog is compared against
+  [PyBDSF](https://github.com/lofar-astron/PyBDSF) and
+  [Aegean](https://github.com/PaulHancock/Aegean) on simulated images with
+  known sources, but these checks are development evidence rather than qualification
+  for survey use. See
+  [scientific status](https://open-research.gemmadanks.com/hebog/reference/release-status/#scientific-status).
+- **Supported inputs:** one FITS image in `Jy/beam` with ICRS or FK5 J2000 sky
+  coordinates and at most 15,402 pixels on each side.
+
+[Current capability and release status](https://open-research.gemmadanks.com/hebog/reference/release-status/)
+lists the full input requirements and known limitations, and
+[progress against goals](https://open-research.gemmadanks.com/hebog/reference/progress-against-goals/)
+summarises on one page where development stands against the project's
+telescope, Rapthor, science, performance, scalability and release goals.
+
+## Installation
+
+Hebog is experimental: `0.x` releases can change the API, the outputs and
+the measurements, so pin the exact version. Install it from
+[PyPI](https://pypi.org/project/hebog/) into a Python 3.12 to 3.14
+environment (releases before 0.22.0 are on GitHub only):
+
+<!-- x-release-please-start-version -->
+
+```shell
+pip install hebog==0.22.0
+```
+
+<!-- x-release-please-end -->
+
+## Example
+
+```python
+from pathlib import Path
+
+from hebog import SourceFinderConfig, SourceFinderRequest, find_sources
+from hebog.executors import SerialExecutor
+
+request = SourceFinderRequest(
+    image_path=Path("image.fits"),
+    output_directory=Path("output"),
+    run_id="example",
+)
+config = SourceFinderConfig(
+    detection_threshold_sigma=5.0,
+    island_threshold_sigma=3.0,
+    minimum_island_pixels=7,
+)
+result = find_sources(request, config, SerialExecutor())
+print(result.catalogue_path, result.source_count)
+```
+
+The output directory must not already exist; running the same request again
+returns the products already there. The
+[source-finding tutorial](https://open-research.gemmadanks.com/hebog/tutorials/find-sources/)
+explains the settings, the products and how to run on Dask.
+
+## Documentation
+
+- [FAQ for astronomers](https://open-research.gemmadanks.com/hebog/explanation/astronomer-faq/)
+- [Find sources in a FITS image](https://open-research.gemmadanks.com/hebog/tutorials/find-sources/)
+- [How Hebog finds sources](https://open-research.gemmadanks.com/hebog/explanation/how-hebog-works/)
+- [Hebog and other source finders](https://open-research.gemmadanks.com/hebog/explanation/source-finder-comparison/)
+- [Catalogue, image and diagnostic outputs](https://open-research.gemmadanks.com/hebog/reference/public-products/)
+- [Interactive notebooks](https://open-research.gemmadanks.com/hebog/how-to/notebooks/)
+- [FAQ for developers and architects](https://open-research.gemmadanks.com/hebog/explanation/developer-faq/)
+- [Architecture](https://open-research.gemmadanks.com/hebog/architecture/)
+- [How Hebog distributes work](https://open-research.gemmadanks.com/hebog/architecture/distributed-execution/)
+- [Integrate Hebog into a pipeline](https://open-research.gemmadanks.com/hebog/how-to/integrate-into-a-pipeline/)
+- [API reference](https://open-research.gemmadanks.com/hebog/reference/)
+
+## Development
+
+Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and
+[just](https://just.systems/), then:
+
+```shell
+git clone https://github.com/gemmadanks/hebog.git
+cd hebog
+uv sync --all-groups
+just check    # formatting, linting, type checks and fast tests
+just --list   # all test, documentation and packaging commands
+```
+
+Contributions use [Conventional Commits](https://www.conventionalcommits.org/).
+[AGENTS.md](https://github.com/gemmadanks/hebog/blob/main/AGENTS.md) describes
+the project's working rules, test suites and review checklist.
+
+## Citation and licence
+
+If Hebog contributes to your research, please cite it using
+[CITATION.cff](https://github.com/gemmadanks/hebog/blob/main/CITATION.cff).
+Hebog is distributed under the
+[BSD 3-Clause License](https://github.com/gemmadanks/hebog/blob/main/LICENSE).

hebog-0.22.0/pyproject.toml

@@ -0,0 +1,143 @@
+[project]
+name = "hebog"
+version = "0.22.0"
+description = "A scalable source finder for radio continuum images"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+readme = "README.md"
+requires-python = ">=3.12"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Astronomy",
+]
+dependencies = [
+    "astropy>=8.0.1,<9",
+    "distributed>=2026.7.1,<2027",
+    "numpy>=2.0.2,<3",
+    "pydantic>=2.12,<3",
+    "scipy>=1.15,<2",
+    "zarr>=3.2,<3.3",
+]
+
+[[project.authors]]
+name = "Gemma Danks"
+email = "gemma.danks@skao.int"
+
+[project.urls]
+Homepage = "https://open-research.gemmadanks.com/hebog/"
+Documentation = "https://open-research.gemmadanks.com/hebog/"
+Repository = "https://github.com/gemmadanks/hebog"
+Issues = "https://github.com/gemmadanks/hebog/issues"
+Changelog = "https://github.com/gemmadanks/hebog/releases"
+
+[project.scripts]
+hebog = "hebog.cli:main"
+
+[dependency-groups]
+dev = [
+    "marimo>=0.23.15",
+    "pytest>=9.1.1,<10.0.0",
+    "pytest-benchmark>=5.1,<6",
+    "ruff>=0.16.0,<0.17.0",
+    "pre-commit>=4.6.1,<5.0.0",
+    "pyright>=1.1.411,<2.0.0",
+    "pytest-cov>=7.1.0,<8.0.0",
+    "pytest-mock>=3.15,<4",
+    "hypothesis>=6.163.0,<7",
+    "matplotlib>=3.11,<4",
+    "pytest-xdist>=3.8,<4",
+    "pytest-split>=0.11,<0.12",
+]
+docs = [
+    "mkdocs",
+    "mkdocstrings[python]",
+    "mkdocs-material",
+]
+
+[tool.coverage.run]
+branch = true
+source = ["src/hebog"]
+omit = [
+    "tests/*",
+    "conftest.py",
+]
+
+[tool.coverage.report]
+fail_under = 80
+show_missing = true
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers"
+testpaths = ["tests"]
+xfail_strict = true
+filterwarnings = [
+    "error",
+    "ignore:Benchmarks are automatically disabled:pytest_benchmark.logger.PytestBenchmarkWarning",
+    "ignore:Creating scratch directories is taking a surprisingly long time:UserWarning",
+]
+markers = [
+    "acceptance: Rapthor-facing behaviour scenarios",
+    "benchmark: performance regression and scaling tests",
+    "contract: scheduler-independent public behaviour and product contracts",
+    "equivalence: scientific comparisons with PyBDSF reference products",
+    "integration: Dask, FITS, and Rapthor integration tests",
+    "qualification: held-out scientific validation for milestone and release gates",
+    "requires_data: tests requiring external or non-redistributable datasets",
+    "scalability: controlled large-image and multi-node scaling tests",
+    "slow: tests excluded from the fast development and pull-request suites",
+]
+
+[tool.pyright]
+include = [
+    "src",
+    "tests",
+]
+pythonVersion = "3.12"
+typeCheckingMode = "strict"
+
+[tool.ruff]
+line-length = 79
+src = [
+    "src",
+    "tests",
+]
+extend-exclude = ["benchmark-results"]
+
+[tool.ruff.lint]
+select = [
+    "ARG",
+    "B",
+    "C4",
+    "C90",
+    "E",
+    "F",
+    "I",
+    "N",
+    "PERF",
+    "PL",
+    "RUF",
+    "SIM",
+    "W",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["hebog"]
+
+[tool.ruff.lint.per-file-ignores]
+"notebooks/**" = [
+    "PLC0415",
+    "PLR0913",
+    "PLR0917",
+    "PLR1711",
+]
+"tests/**" = ["PLR2004"]
+
+[tool.uv.build-backend]
+module-name = "hebog"
+module-root = "src"
+wheel-exclude = ["hebog/validation"]
+
+[build-system]
+requires = ["uv-build>=0.12.1,<0.13"]
+build-backend = "uv_build"

hebog-0.22.0/pyproject.toml.orig

@@ -0,0 +1,143 @@
+[project]
+name = "hebog"
+version = "0.22.0"
+description = "A scalable source finder for radio continuum images"
+authors = [
+    {name = "Gemma Danks", email = "gemma.danks@skao.int"},
+]
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+readme = "README.md"
+requires-python = ">=3.12"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Science/Research",
+    "Topic :: Scientific/Engineering :: Astronomy",
+]
+dependencies = [
+    "astropy>=8.0.1,<9",
+    "distributed>=2026.7.1,<2027",
+    "numpy>=2.0.2,<3",
+    "pydantic>=2.12,<3",
+    "scipy>=1.15,<2",
+    "zarr>=3.2,<3.3",
+]
+
+[project.urls]
+Homepage = "https://open-research.gemmadanks.com/hebog/"
+Documentation = "https://open-research.gemmadanks.com/hebog/"
+Repository = "https://github.com/gemmadanks/hebog"
+Issues = "https://github.com/gemmadanks/hebog/issues"
+Changelog = "https://github.com/gemmadanks/hebog/releases"
+
+[project.scripts]
+hebog = "hebog.cli:main"
+
+[dependency-groups]
+dev = [
+    "marimo>=0.23.15",
+    "pytest>=9.1.1,<10.0.0",
+    "pytest-benchmark>=5.1,<6",
+    "ruff>=0.16.0,<0.17.0",
+    "pre-commit>=4.6.1,<5.0.0",
+    "pyright>=1.1.411,<2.0.0",
+    "pytest-cov>=7.1.0,<8.0.0",
+    "pytest-mock>=3.15,<4",
+    "hypothesis>=6.163.0,<7",
+    "matplotlib>=3.11,<4",
+    "pytest-xdist>=3.8,<4",
+    "pytest-split>=0.11,<0.12",
+]
+
+docs = [
+    "mkdocs",
+    "mkdocstrings[python]",
+    "mkdocs-material"
+]
+
+
+[tool.coverage.run]
+branch = true
+source = ["src/hebog"]
+omit = [
+    "tests/*",
+    "conftest.py"
+]
+
+[tool.coverage.report]
+fail_under = 80
+show_missing = true
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers"
+testpaths = ["tests"]
+xfail_strict = true
+filterwarnings = [
+    "error",
+    # pytest-benchmark warns at start-up that xdist disables it. No test
+    # uses its fixture.
+    "ignore:Benchmarks are automatically disabled:pytest_benchmark.logger.PytestBenchmarkWarning",
+    # Distributed warns when a worker's scratch directory takes over a second
+    # to create, which depends on the machine's load, not on the test.
+    "ignore:Creating scratch directories is taking a surprisingly long time:UserWarning",
+]
+markers = [
+    "acceptance: Rapthor-facing behaviour scenarios",
+    "benchmark: performance regression and scaling tests",
+    "contract: scheduler-independent public behaviour and product contracts",
+    "equivalence: scientific comparisons with PyBDSF reference products",
+    "integration: Dask, FITS, and Rapthor integration tests",
+    "qualification: held-out scientific validation for milestone and release gates",
+    "requires_data: tests requiring external or non-redistributable datasets",
+    "scalability: controlled large-image and multi-node scaling tests",
+    "slow: tests excluded from the fast development and pull-request suites",
+]
+
+[tool.pyright]
+include = ["src", "tests"]
+pythonVersion = "3.12"
+typeCheckingMode = "strict"
+
+[tool.ruff]
+line-length = 79
+src = ["src", "tests"]
+extend-exclude = ["benchmark-results"]
+
+[tool.ruff.lint]
+select = [
+    "ARG",
+    "B",
+    "C4",
+    "C90",
+    "E",
+    "F",
+    "I",
+    "N",
+    "PERF",
+    "PL",
+    "RUF",
+    "SIM",
+    "W",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["hebog"]
+
+[tool.ruff.lint.per-file-ignores]
+"notebooks/**" = ["PLC0415", "PLR0913", "PLR0917", "PLR1711"]
+"tests/**" = ["PLR2004"]
+
+[build-system]
+# uv_build 0.13 writes source distributions as PAX tar archives, which uv
+# releases before 0.13 cannot extract, so building or installing the sdist
+# with an older uv fails. Lift the cap only when every supported installer
+# reads them.
+requires = ["uv-build>=0.12.1,<0.13"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "hebog"
+module-root = "src"
+# Campaign and comparison tooling runs from a source checkout with the
+# development dependencies; it is not part of the installed source finder.
+wheel-exclude = ["hebog/validation"]

hebog-0.22.0/src/hebog/__init__.py

@@ -0,0 +1,43 @@
+"""A scalable source finder for radio continuum images."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from hebog.config import SourceFinderConfig
+from hebog.data_models import (
+    SourceFinderRequest,
+    SourceFinderResult,
+    SuppliedImageMetadata,
+)
+from hebog.pipeline import (
+    InvalidSourceFinderInputError,
+    SourceFinderError,
+    SourceFinderImageTooLargeError,
+    SourceFinderOutputExistsError,
+    SourceFinderStagingWarning,
+    UnsupportedSourceFinderConfigurationError,
+    analysis_memory_bytes,
+    expected_source_count,
+    find_sources,
+)
+
+try:
+    __version__ = version("hebog")
+except PackageNotFoundError:
+    __version__ = "0.22.0"
+
+__all__ = [
+    "InvalidSourceFinderInputError",
+    "SourceFinderConfig",
+    "SourceFinderError",
+    "SourceFinderImageTooLargeError",
+    "SourceFinderOutputExistsError",
+    "SourceFinderRequest",
+    "SourceFinderResult",
+    "SourceFinderStagingWarning",
+    "SuppliedImageMetadata",
+    "UnsupportedSourceFinderConfigurationError",
+    "__version__",
+    "analysis_memory_bytes",
+    "expected_source_count",
+    "find_sources",
+]

hebog-0.22.0/src/hebog/__main__.py

@@ -0,0 +1,5 @@
+"""Run the Hebog command-line interface."""
+
+from hebog.cli import main
+
+raise SystemExit(main())

hebog-0.22.0/src/hebog/adapters/__init__.py

@@ -0,0 +1,17 @@
+"""Workflow compatibility boundaries built on Hebog's scientific API."""
+
+from hebog.adapters.rapthor import (
+    RapthorBlankedImageError,
+    RapthorCompatibilityConfig,
+    RapthorSourceFindingRequest,
+    RapthorSourceFindingResult,
+    find_sector_sources,
+)
+
+__all__ = [
+    "RapthorBlankedImageError",
+    "RapthorCompatibilityConfig",
+    "RapthorSourceFindingRequest",
+    "RapthorSourceFindingResult",
+    "find_sector_sources",
+]