pytorch-hexagdly 0.1.0__tar.gz

pytorch_hexagdly-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,45 @@
+name: Publish to PyPI
+
+# Triggered by pushing a tag like v0.1.0. Uses PyPI Trusted Publishing (OIDC):
+# no API token is stored anywhere -- PyPI verifies this workflow's identity
+# directly. See https://docs.pypi.org/trusted-publishers/ to register it
+# (one-time setup on pypi.org, no code change needed here).
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Build sdist and wheel
+        run: |
+          pip install build
+          python -m build
+      - name: Check distribution metadata
+        run: |
+          pip install twine
+          twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # required for Trusted Publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

pytorch_hexagdly-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: Test
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install pytorch-hexagdly + dev deps
+        run: |
+          pip install torch --index-url https://download.pytorch.org/whl/cpu
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install ruff
+        run: pip install ruff
+      - name: Ruff check
+        run: ruff check src/ tests/
+      - name: Ruff format check
+        run: ruff format --check src/ tests/

pytorch_hexagdly-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+*.egg-info/
+build/
+dist/
+.pytest_cache/
+.ipynb_checkpoints/
+*.h5
+.venv/
+.ruff_cache/

pytorch_hexagdly-0.1.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [0.1.0] - 2026-07-02
+
+Initial release of `pytorch-hexagdly`, a fork of
+[HexagDLy](https://github.com/ai4iacts/hexagdly).
+
+### Added
+
+- `share_neighbors` parameter on `Conv2d` and `Conv3d`: ties hexagonal kernel
+  weights by ring (ring 0 = center, ring *r* = the 6*r* cells at hex-distance
+  *r*) instead of giving every cell an independent weight, like TDSCAN.
+- `depth_padding` parameter on `Conv3d`: `"same"` zero-pads the depth/time
+  axis so the temporal kernel is centred and output depth equals input depth,
+  instead of upstream's `"valid"`-only behaviour.
+- `ring_maps_2d(n)`: utility function returning the per-sub-kernel ring-index
+  maps for kernel size `n`, derived empirically via impulse responses.
+- PyPI packaging: `pyproject.toml` with hatchling backend, proper package
+  layout under `src/pytorch_hexagdly/`, `__version__`, and `__all__`.
+- GitHub Actions CI: test workflow (Python 3.10/3.11/3.12) and publish workflow
+  (tag-triggered, PyPI Trusted Publishing / OIDC).

pytorch_hexagdly-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2018 ai4iacts (HexagDLy authors: Tim Lukas Holch, Constantin Steppa)
+Copyright (c) 2026 Tanguy Dietrich, HEPIA, SST-1M Collaboration (pytorch-hexagdly fork)
+
+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.

pytorch_hexagdly-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+prune tests

pytorch_hexagdly-0.1.0/NOTICE.md

@@ -0,0 +1,45 @@
+# Notice
+
+`pytorch-hexagdly` is a fork of
+[HexagDLy](https://github.com/ai4iacts/hexagdly) by Tim Lukas Holch and
+Constantin Steppa (ai4iacts), originally developed for hexagonal convolution
+and pooling on PyTorch in the context of Imaging Atmospheric Cherenkov
+Telescope analysis with H.E.S.S.
+
+This package extends the original `HexBase` sub-kernel decomposition with two
+new features that have no equivalent in upstream HexagDLy:
+
+- `share_neighbors`: ties the weights of a hexagonal kernel by ring (ring 0 =
+  center, ring *r* = the 6*r* cells at hex-distance *r*), instead of giving
+  every cell its own weight.
+- `depth_padding` (`Conv3d` only): `"same"` zero-pads the depth/time axis so
+  the temporal kernel is centred and output depth equals input depth, instead of
+  HexagDLy's `"valid"`-only behaviour.
+
+This work was developed as part of the SST-1M Collaboration / HEPIA TDSCAN
+triggering project.
+
+## License
+
+Both the original HexagDLy code and this fork are distributed under the MIT
+license; see [LICENSE](LICENSE). The original copyright notice
+(Copyright (c) 2018 ai4iacts) is preserved alongside the copyright notice for
+this fork, as required by the MIT license.
+
+## Citing
+
+If you use this package, please cite the original HexagDLy paper:
+
+```bibtex
+@article{hexagdly_paper,
+    title = "HexagDLy—Processing hexagonally sampled data with CNNs in PyTorch",
+    author = "Constantin Steppa and Tim L. Holch",
+    journal = "SoftwareX",
+    volume = "9",
+    pages = "193 - 198",
+    year = "2019",
+    issn = "2352-7110",
+    doi = "https://doi.org/10.1016/j.softx.2019.02.010",
+    url = "https://www.sciencedirect.com/science/article/pii/S2352711018302723",
+}
+```

pytorch_hexagdly-0.1.0/PKG-INFO

@@ -0,0 +1,238 @@
+Metadata-Version: 2.4
+Name: pytorch-hexagdly
+Version: 0.1.0
+Summary: Hexagonal convolution and pooling layers for PyTorch — an extended HexagDLy fork
+Project-URL: Homepage, https://github.com/YugnatD/pytorch-hexagdly
+Project-URL: Source, https://github.com/YugnatD/pytorch-hexagdly
+Project-URL: Issues, https://github.com/YugnatD/pytorch-hexagdly/issues
+Project-URL: Changelog, https://github.com/YugnatD/pytorch-hexagdly/blob/master/CHANGELOG.md
+Project-URL: Original (HexagDLy), https://github.com/ai4iacts/hexagdly
+Author: Tanguy Dietrich
+License: MIT License
+        
+        Copyright (c) 2018 ai4iacts (HexagDLy authors: Tim Lukas Holch, Constantin Steppa)
+        Copyright (c) 2026 Tanguy Dietrich, HEPIA, SST-1M Collaboration (pytorch-hexagdly fork)
+        
+        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.
+License-File: LICENSE
+License-File: NOTICE.md
+Keywords: astroparticle-physics,cherenkov,cnn,convolution,deep-learning,equivariant,geometric-deep-learning,hexagdly,hexagonal,hexagonal-convolution,hexagonal-grid,iact,neural-networks,pytorch,torch
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+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: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Image Recognition
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.9
+Requires-Dist: numpy
+Requires-Dist: torch
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pytorch-hexagdly — Hexagonal Convolutions for PyTorch
+
+`pytorch-hexagdly` is a fork of [HexagDLy](https://github.com/ai4iacts/hexagdly)
+that extends the original hexagonal convolution and pooling layers for PyTorch with
+two new features: **ring-shared weights** (`share_neighbors`) and **depth-axis same-padding**
+(`depth_padding="same"` on `Conv3d`).
+
+- [Getting Started](#getting-started)
+- [New Features](#new-features)
+- [Preparing the Data](#preparing-the-data)
+- [How to use pytorch-hexagdly](#how-to-use-pytorch-hexagdly)
+- [General Concept](#general-concept)
+- [Disclaimer](#disclaimer)
+- [Citing HexagDLy](#citation)
+
+
+## Getting Started
+
+### Pip Installation
+
+```
+pip install pytorch-hexagdly
+```
+
+```python
+import pytorch_hexagdly
+```
+
+To get the dependencies needed to run the provided [unit tests](tests) and
+[notebooks](notebooks), add the `dev` option:
+
+```
+pip install pytorch-hexagdly[dev]
+```
+
+### Manual Installation
+
+Requires a working installation of [PyTorch](https://github.com/pytorch/pytorch).
+Clone the repository and install in editable mode:
+
+```
+git clone https://github.com/YugnatD/pytorch-hexagdly
+cd pytorch-hexagdly
+pip install -e .
+```
+
+
+## New Features
+
+### `share_neighbors` — ring-shared kernel weights
+
+Available on `Conv2d` and `Conv3d`. When set to `True`, all cells at the same
+hexagonal ring distance share a single weight, reducing the number of learnable
+parameters. Ring 0 is the center pixel; ring *r* covers the 6*r* cells at
+hex-distance *r*. This mirrors the TDSCAN triggering approach.
+
+```python
+import torch
+import pytorch_hexagdly
+
+conv = pytorch_hexagdly.Conv2d(1, 8, kernel_size=2, stride=1, share_neighbors=True)
+x = torch.randn(1, 1, 21, 21)
+print(conv(x).shape)
+```
+
+### `depth_padding="same"` — temporal same-padding for `Conv3d`
+
+When `depth_padding="same"`, the depth/time axis is zero-padded symmetrically so
+the output depth equals the input depth. The default is `"valid"` (upstream behaviour).
+
+```python
+conv3d = pytorch_hexagdly.Conv3d(1, 4, kernel_size=(3, 1), stride=1,
+                                  depth_padding="same")
+x = torch.randn(1, 1, 10, 21, 21)
+print(conv3d(x).shape)  # depth dimension preserved
+```
+
+
+## How to use pytorch-hexagdly
+
+As `pytorch-hexagdly` is based on PyTorch, it is of advantage to be familiar with
+PyTorch's functionalities and concepts. Before applying it, ensure that the input
+data has the correct hexagonal layout. An [example notebook](notebooks/how_to_apply_adressing_scheme.ipynb)
+illustrates the steps to get data into the correct format.
+
+Basic example:
+
+```python
+import torch
+import pytorch_hexagdly
+
+kernel_size, stride = 1, 4
+in_channels, out_channels = 1, 3
+
+hexconv = pytorch_hexagdly.Conv2d(in_channels, out_channels, kernel_size, stride)
+input = torch.rand(1, 1, 21, 21)
+output = hexconv(input)
+```
+
+HexagDLy uses an addressing scheme to map hexagonal grid data to a square tensor.
+The layout from top to bottom (along tensor index 2) must be of zig-zag-edge shape
+and from left to right (along tensor index 3) of armchair-edge shape.
+
+Additional examples for basic use-cases are shown in the [notebooks](notebooks) folder.
+
+
+## General Concept
+
+As common deep learning frameworks process data on square grids, hexagonally sampled
+data must be mapped to a square tensor. This conversion is non-trivial due to the
+different symmetries of square (4-fold) vs hexagonal (6-fold) grids.
+
+HexagDLy solves this by splitting each convolution kernel into sub-kernels that
+together cover the true neighbours of a data point in the hexagonal grid. A full
+hexagonal convolution with size 1 (next-neighbour kernel) decomposes into three
+sub-convolutions with two different sub-kernels applied to three differently padded
+versions of the input.
+
+![kerne size+stride](figures/kernel_size+stride.png "Examples of different kernels of different size and strides.")
+
+**Please note**: Operations are only performed where the center point of a kernel is
+located within the input tensor. This could result in output columns of different
+length; in such cases the output will be sliced according to the shortest column.
+
+![violating_symmetry](figures/violating_symmetry.png "Squeezing hexagonal data in a square grid and applying square convolution kernels disregards the symmetry of the hexagonal lattice.")
+
+![explicit_next_neighbour_conv](figures/explicit_next_neighbour_conv.png "Schematic description of the individual sub-convolutions and combination of the individual outputs to perform a hexagonal convolution.")
+
+
+## Disclaimer
+
+`pytorch-hexagdly` is built as an easy-to-use prototyping tool to design convolutional
+neural networks for hexagonally sampled data. The implemented methods aim for
+flexibility rather than performance. Once a model is optimized, hard-coding kernel
+size, stride and input dimensions will make the implementation faster.
+
+
+## Authors
+
+**Fork (`pytorch-hexagdly`)**
+* **Tanguy Dietrich** — HEPIA / SST-1M Collaboration
+
+**Original HexagDLy**
+* **Tim Lukas Holch**
+* **Constantin Steppa**
+
+See [NOTICE.md](NOTICE.md) for full attribution.
+
+
+## License
+
+MIT license — see [LICENSE](LICENSE).
+
+
+## Citation
+
+If this work has helped your research, please cite the original HexagDLy paper:
+
+```bibtex
+@article{hexagdly_paper,
+    title = "HexagDLy—Processing hexagonally sampled data with CNNs in PyTorch",
+    author = "Constantin Steppa and Tim L. Holch",
+    journal = "SoftwareX",
+    volume = "9",
+    pages = "193 - 198",
+    year = "2019",
+    issn = "2352-7110",
+    doi = "https://doi.org/10.1016/j.softx.2019.02.010",
+    url = "https://www.sciencedirect.com/science/article/pii/S2352711018302723",
+    keywords = "Convolutional neural networks, Hexagonal grid, PyTorch, Astroparticle physics",
+    abstract = "HexagDLy is a Python-library extending the PyTorch deep learning framework with convolution and pooling operations on hexagonal grids. It aims to ease the access to convolutional neural networks for applications that rely on hexagonally sampled data as, for example, commonly found in ground-based astroparticle physics experiments."
+}
+```
+
+HexagDLy was developed as part of a research study in ground-based gamma-ray astronomy
+published in [Astroparticle Physics](https://doi.org/10.1016/j.astropartphys.2018.10.003).
+
+
+## Acknowledgments
+
+The original HexagDLy project evolved by exploring new analysis techniques for Imaging
+Atmospheric Cherenkov Telescopes with H.E.S.S. The fork was developed in the context of
+the SST-1M Collaboration / HEPIA TDSCAN triggering project.

pytorch_hexagdly-0.1.0/README.md

@@ -0,0 +1,183 @@
+# pytorch-hexagdly — Hexagonal Convolutions for PyTorch
+
+`pytorch-hexagdly` is a fork of [HexagDLy](https://github.com/ai4iacts/hexagdly)
+that extends the original hexagonal convolution and pooling layers for PyTorch with
+two new features: **ring-shared weights** (`share_neighbors`) and **depth-axis same-padding**
+(`depth_padding="same"` on `Conv3d`).
+
+- [Getting Started](#getting-started)
+- [New Features](#new-features)
+- [Preparing the Data](#preparing-the-data)
+- [How to use pytorch-hexagdly](#how-to-use-pytorch-hexagdly)
+- [General Concept](#general-concept)
+- [Disclaimer](#disclaimer)
+- [Citing HexagDLy](#citation)
+
+
+## Getting Started
+
+### Pip Installation
+
+```
+pip install pytorch-hexagdly
+```
+
+```python
+import pytorch_hexagdly
+```
+
+To get the dependencies needed to run the provided [unit tests](tests) and
+[notebooks](notebooks), add the `dev` option:
+
+```
+pip install pytorch-hexagdly[dev]
+```
+
+### Manual Installation
+
+Requires a working installation of [PyTorch](https://github.com/pytorch/pytorch).
+Clone the repository and install in editable mode:
+
+```
+git clone https://github.com/YugnatD/pytorch-hexagdly
+cd pytorch-hexagdly
+pip install -e .
+```
+
+
+## New Features
+
+### `share_neighbors` — ring-shared kernel weights
+
+Available on `Conv2d` and `Conv3d`. When set to `True`, all cells at the same
+hexagonal ring distance share a single weight, reducing the number of learnable
+parameters. Ring 0 is the center pixel; ring *r* covers the 6*r* cells at
+hex-distance *r*. This mirrors the TDSCAN triggering approach.
+
+```python
+import torch
+import pytorch_hexagdly
+
+conv = pytorch_hexagdly.Conv2d(1, 8, kernel_size=2, stride=1, share_neighbors=True)
+x = torch.randn(1, 1, 21, 21)
+print(conv(x).shape)
+```
+
+### `depth_padding="same"` — temporal same-padding for `Conv3d`
+
+When `depth_padding="same"`, the depth/time axis is zero-padded symmetrically so
+the output depth equals the input depth. The default is `"valid"` (upstream behaviour).
+
+```python
+conv3d = pytorch_hexagdly.Conv3d(1, 4, kernel_size=(3, 1), stride=1,
+                                  depth_padding="same")
+x = torch.randn(1, 1, 10, 21, 21)
+print(conv3d(x).shape)  # depth dimension preserved
+```
+
+
+## How to use pytorch-hexagdly
+
+As `pytorch-hexagdly` is based on PyTorch, it is of advantage to be familiar with
+PyTorch's functionalities and concepts. Before applying it, ensure that the input
+data has the correct hexagonal layout. An [example notebook](notebooks/how_to_apply_adressing_scheme.ipynb)
+illustrates the steps to get data into the correct format.
+
+Basic example:
+
+```python
+import torch
+import pytorch_hexagdly
+
+kernel_size, stride = 1, 4
+in_channels, out_channels = 1, 3
+
+hexconv = pytorch_hexagdly.Conv2d(in_channels, out_channels, kernel_size, stride)
+input = torch.rand(1, 1, 21, 21)
+output = hexconv(input)
+```
+
+HexagDLy uses an addressing scheme to map hexagonal grid data to a square tensor.
+The layout from top to bottom (along tensor index 2) must be of zig-zag-edge shape
+and from left to right (along tensor index 3) of armchair-edge shape.
+
+Additional examples for basic use-cases are shown in the [notebooks](notebooks) folder.
+
+
+## General Concept
+
+As common deep learning frameworks process data on square grids, hexagonally sampled
+data must be mapped to a square tensor. This conversion is non-trivial due to the
+different symmetries of square (4-fold) vs hexagonal (6-fold) grids.
+
+HexagDLy solves this by splitting each convolution kernel into sub-kernels that
+together cover the true neighbours of a data point in the hexagonal grid. A full
+hexagonal convolution with size 1 (next-neighbour kernel) decomposes into three
+sub-convolutions with two different sub-kernels applied to three differently padded
+versions of the input.
+
+![kerne size+stride](figures/kernel_size+stride.png "Examples of different kernels of different size and strides.")
+
+**Please note**: Operations are only performed where the center point of a kernel is
+located within the input tensor. This could result in output columns of different
+length; in such cases the output will be sliced according to the shortest column.
+
+![violating_symmetry](figures/violating_symmetry.png "Squeezing hexagonal data in a square grid and applying square convolution kernels disregards the symmetry of the hexagonal lattice.")
+
+![explicit_next_neighbour_conv](figures/explicit_next_neighbour_conv.png "Schematic description of the individual sub-convolutions and combination of the individual outputs to perform a hexagonal convolution.")
+
+
+## Disclaimer
+
+`pytorch-hexagdly` is built as an easy-to-use prototyping tool to design convolutional
+neural networks for hexagonally sampled data. The implemented methods aim for
+flexibility rather than performance. Once a model is optimized, hard-coding kernel
+size, stride and input dimensions will make the implementation faster.
+
+
+## Authors
+
+**Fork (`pytorch-hexagdly`)**
+* **Tanguy Dietrich** — HEPIA / SST-1M Collaboration
+
+**Original HexagDLy**
+* **Tim Lukas Holch**
+* **Constantin Steppa**
+
+See [NOTICE.md](NOTICE.md) for full attribution.
+
+
+## License
+
+MIT license — see [LICENSE](LICENSE).
+
+
+## Citation
+
+If this work has helped your research, please cite the original HexagDLy paper:
+
+```bibtex
+@article{hexagdly_paper,
+    title = "HexagDLy—Processing hexagonally sampled data with CNNs in PyTorch",
+    author = "Constantin Steppa and Tim L. Holch",
+    journal = "SoftwareX",
+    volume = "9",
+    pages = "193 - 198",
+    year = "2019",
+    issn = "2352-7110",
+    doi = "https://doi.org/10.1016/j.softx.2019.02.010",
+    url = "https://www.sciencedirect.com/science/article/pii/S2352711018302723",
+    keywords = "Convolutional neural networks, Hexagonal grid, PyTorch, Astroparticle physics",
+    abstract = "HexagDLy is a Python-library extending the PyTorch deep learning framework with convolution and pooling operations on hexagonal grids. It aims to ease the access to convolutional neural networks for applications that rely on hexagonally sampled data as, for example, commonly found in ground-based astroparticle physics experiments."
+}
+```
+
+HexagDLy was developed as part of a research study in ground-based gamma-ray astronomy
+published in [Astroparticle Physics](https://doi.org/10.1016/j.astropartphys.2018.10.003).
+
+
+## Acknowledgments
+
+The original HexagDLy project evolved by exploring new analysis techniques for Imaging
+Atmospheric Cherenkov Telescopes with H.E.S.S. The fork was developed in the context of
+the SST-1M Collaboration / HEPIA TDSCAN triggering project.

pytorch_hexagdly-0.1.0/conftest.py

@@ -0,0 +1,6 @@
+import sys
+from pathlib import Path
+
+# Allow running the test suite without an editable install (`pip install -e .`).
+sys.path.insert(0, str(Path(__file__).parent / "src"))
+sys.path.insert(0, str(Path(__file__).parent / "tests"))