move python helpers

.github/workflows/ci.yml

@@ -45,7 +45,7 @@ jobs:
     - name: Python
       run: |
         cd python
-        python petsird_generator.py | python petsird_analysis.py
+        python -m petsird.helpers.generator | python -m petsird.helpers.analysis
     - name: cpp
       run: |
         mkdir cpp/build

python/README.md

@@ -30,12 +30,13 @@ pip install --editable ../python
 The Python code shows piping the compact binary format to standard out and
 reading it from standard in. This can be used as follows:
 
-1. From the repo root `cd python`
-1. `python petsird_generator.py | python petsird_analysis.py`
+```sh
+python -m petsird.helpers.generator | python -m petsird.helpers.analysis
+```
 
 There is also a very basic utility to plot the scanner geometry. For instance
 
 ```sh
-python petsird_generator.py > test.bin
-python petsird_plot_scanner.py < test.bin
+python -m petsird.helpers.generator > test.bin
+python -m petsird.helpers.plot_scanner < test.bin
 ```

python/petsird_analysis.py → python/petsird/helpers/analysis.py

@@ -2,12 +2,11 @@
 #  Copyright (C) 2023-2024 University College London
 #
 #  SPDX-License-Identifier: Apache-2.0
-
 import sys
 
 import petsird
-from petsird_helpers import (get_detection_efficiency, get_module_and_element,
-                             get_num_det_els)
+
+from . import get_detection_efficiency, get_module_and_element, get_num_det_els
 
 if __name__ == "__main__":
     with petsird.BinaryPETSIRDReader(sys.stdin.buffer) as reader:

python/petsird_generator.py → python/petsird/helpers/generator.py

@@ -2,15 +2,15 @@
 #  Copyright (C) 2023-2024 University College London
 #
 #  SPDX-License-Identifier: Apache-2.0
-
 import math
 import random
 import sys
 from collections.abc import Iterator
 
 import numpy
 import petsird
-from petsird_helpers import get_module_and_element, get_num_det_els
+
+from . import get_module_and_element, get_num_det_els
 
 # these are constants for now
 NUMBER_OF_ENERGY_BINS = 3

python/petsird_plot_scanner.py → python/petsird/helpers/plot_scanner.py

@@ -4,7 +4,6 @@
 
 # basic plotting of the scanner geometry
 # preliminary code!
-
 import sys
 
 import matplotlib.pyplot as plt