simind-python-connector 1.1.0__tar.gz → 1.1.2__tar.gz

simind_python_connector-1.1.2/.dockerignore

@@ -0,0 +1,17 @@
+.git
+.venv
+simind
+dist
+build
+*.egg-info
+*.tar.gz
+.pytest_cache
+.ruff_cache
+.uv-cache
+.uv-tools
+.coverage
+.coverage.*
+coverage.xml
+docs/_build
+output
+results

simind_python_connector-1.1.2/MANIFEST.in

@@ -0,0 +1,24 @@
+include README.md
+include LICENSE
+include .dockerignore
+recursive-include simind_python_connector/data *.atn
+recursive-include simind_python_connector/data *.json
+recursive-include simind_python_connector/configs *.smc *.yaml
+recursive-include docs *.rst *.py
+include docs/_static/.gitkeep
+recursive-include tests *.py
+recursive-include tests/fixtures *.smc
+recursive-include examples *.py *.sh
+recursive-include scripts *.py *.sh
+recursive-include docker Dockerfile *.md *.txt *.yaml *.yml *.py *.sh
+exclude AGENTS.md
+exclude opencode.jsonc
+exclude CLAUDE.md
+exclude simind_manual.pdf
+prune simind
+prune docs/superpowers
+prune docs/_build
+prune docs/_generated
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude .DS_Store

{simind_python_connector-1.1.0/simind_python_connector.egg-info → simind_python_connector-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: simind-python-connector
-Version: 1.1.0
+Version: 1.1.2
 Summary: Python SIMIND Monte Carlo connector with STIR/SIRF/PyTomography adaptors
 Author-email: Sam Porter <sam.porter.18@ucl.ac.uk>, Rebecca Gillen <rebecca.gillen.18@ucl.ac.uk>, "Efstathios (Stahis) Varzakis" <efstathios.varzakis.22@ucl.ac.uk>
 Maintainer-email: Sam Porter <sam.porter.18@ucl.ac.uk>
@@ -15,14 +15,13 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Science/Research
 Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
 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
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: numpy>=1.20.0
+Requires-Dist: numpy<2.0,>=1.20.0
 Requires-Dist: pydicom>=2.0.0
 Requires-Dist: pyyaml>=5.4.0
 Provides-Extra: dev
@@ -48,7 +47,7 @@ Python SIMIND Monte Carlo Connector.
 [![Tests](https://github.com/samdporter/simind-python-connector/workflows/Tests/badge.svg)](https://github.com/samdporter/simind-python-connector/actions)
 [![Documentation Status](https://readthedocs.org/projects/simind-python-connector/badge/?version=latest)](https://simind-python-connector.readthedocs.io/en/latest/?badge=latest)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 
 A Python toolkit that lets you run SIMIND from Python and use the outputs in
 common reconstruction ecosystems (STIR, SIRF, PyTomography).
@@ -99,6 +98,12 @@ For example plotting dependencies:
 pip install "simind-python-connector[examples]"
 ```
 
+**NumPy**: the package requires `numpy>=1.20.0,<2.0`. The `<2.0` cap is a
+binary-ABI / backend-compatibility guard for the legacy 1.1.x line: the STIR
+and SIRF bindings are compiled against NumPy 1.x and crash with NumPy 2, so the
+cap applies package-wide. It is not a Python-version constraint; interpreter
+support is stated separately as Python 3.10+.
+
 ### Adaptor Dependencies
 
 `SimindPythonConnector` works without SIRF/STIR/PyTomography.
@@ -116,7 +121,7 @@ Install from conda:
 conda install -c conda-forge stir "numpy<2.0"
 ```
 
-**Important**: As of November 2025, the STIR conda package (v6.3.0) requires NumPy < 2.0 due to binary compatibility issues with NumPy 2.x. The package was compiled against NumPy 1.x and will crash with memory errors if NumPy 2.x is installed. This should be resolved in future STIR releases.
+**Important**: As of November 2025, the STIR conda package (v6.3.0) requires NumPy < 2.0 due to binary compatibility issues with NumPy 2.x. The package was compiled against NumPy 1.x and will crash with memory errors if NumPy 2.x is installed. This should be resolved in future STIR releases. Like the package-wide pin, this is a backend binary-ABI compatibility guard, not a Python-version constraint.
 
 Or build from source:
 ```bash
@@ -182,6 +187,7 @@ executable is available as `simind` on `PATH`.
 import numpy as np
 from simind_python_connector import SimindPythonConnector
 from simind_python_connector.configs import get
+from simind_python_connector.core.types import DEFAULT_QUANTIZATION_SCALE
 
 source = np.zeros((32, 32, 32), dtype=np.float32)  # z, y, x
 source[12:20, 12:20, 12:20] = 1.0
@@ -192,7 +198,7 @@ connector = SimindPythonConnector(
     config_source=get("Example.yaml"),
     output_dir="output/basic",
     output_prefix="case01",
-    quantization_scale=0.05,
+    quantization_scale=0.05 * DEFAULT_QUANTIZATION_SCALE,
 )
 
 connector.configure_voxel_phantom(
@@ -247,11 +253,20 @@ For minimal toy runs with smaller projection/image settings, use
 `quantization_scale` controls source integer quantization before writing SIMIND
 `.smi` files:
 
-- `1.0`: uses full internal source integer range (best numeric precision)
-- `< 1.0`: reduces integer scale for faster toy runs but increases rounding error
-
-SIMIND treats source maps as integer weights; absolute activity/time scaling is
-controlled separately by simulation settings.
+- the default (`500 / 32767`) preserves the legacy 500-weight source budget;
+- `1.0` uses the full signed 16-bit source range (`32767`), the best numeric
+  precision;
+- `< 1.0` reduces the integer scale for faster toy runs but increases rounding
+  error.
+
+SIMIND reads the source and density maps as signed 16-bit integers, so values
+of `32768` and above wrap negative and silently corrupt the map; the connector
+caps both maps at `32767`. Explicit `quantization_scale` values are used as
+given, with no automatic migration of scales calibrated for the former
+500-weight maximum: rescale an old scale with
+`old_scale * DEFAULT_QUANTIZATION_SCALE`. SIMIND treats source maps as integer
+weights; absolute activity/time scaling is controlled separately by simulation
+settings.
 
 ## Docker Environments
 

{simind_python_connector-1.1.0 → simind_python_connector-1.1.2}/README.md

@@ -5,7 +5,7 @@ Python SIMIND Monte Carlo Connector.
 [![Tests](https://github.com/samdporter/simind-python-connector/workflows/Tests/badge.svg)](https://github.com/samdporter/simind-python-connector/actions)
 [![Documentation Status](https://readthedocs.org/projects/simind-python-connector/badge/?version=latest)](https://simind-python-connector.readthedocs.io/en/latest/?badge=latest)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Python Version](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![Python Version](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
 
 A Python toolkit that lets you run SIMIND from Python and use the outputs in
 common reconstruction ecosystems (STIR, SIRF, PyTomography).
@@ -56,6 +56,12 @@ For example plotting dependencies:
 pip install "simind-python-connector[examples]"
 ```
 
+**NumPy**: the package requires `numpy>=1.20.0,<2.0`. The `<2.0` cap is a
+binary-ABI / backend-compatibility guard for the legacy 1.1.x line: the STIR
+and SIRF bindings are compiled against NumPy 1.x and crash with NumPy 2, so the
+cap applies package-wide. It is not a Python-version constraint; interpreter
+support is stated separately as Python 3.10+.
+
 ### Adaptor Dependencies
 
 `SimindPythonConnector` works without SIRF/STIR/PyTomography.
@@ -73,7 +79,7 @@ Install from conda:
 conda install -c conda-forge stir "numpy<2.0"
 ```
 
-**Important**: As of November 2025, the STIR conda package (v6.3.0) requires NumPy < 2.0 due to binary compatibility issues with NumPy 2.x. The package was compiled against NumPy 1.x and will crash with memory errors if NumPy 2.x is installed. This should be resolved in future STIR releases.
+**Important**: As of November 2025, the STIR conda package (v6.3.0) requires NumPy < 2.0 due to binary compatibility issues with NumPy 2.x. The package was compiled against NumPy 1.x and will crash with memory errors if NumPy 2.x is installed. This should be resolved in future STIR releases. Like the package-wide pin, this is a backend binary-ABI compatibility guard, not a Python-version constraint.
 
 Or build from source:
 ```bash
@@ -139,6 +145,7 @@ executable is available as `simind` on `PATH`.
 import numpy as np
 from simind_python_connector import SimindPythonConnector
 from simind_python_connector.configs import get
+from simind_python_connector.core.types import DEFAULT_QUANTIZATION_SCALE
 
 source = np.zeros((32, 32, 32), dtype=np.float32)  # z, y, x
 source[12:20, 12:20, 12:20] = 1.0
@@ -149,7 +156,7 @@ connector = SimindPythonConnector(
     config_source=get("Example.yaml"),
     output_dir="output/basic",
     output_prefix="case01",
-    quantization_scale=0.05,
+    quantization_scale=0.05 * DEFAULT_QUANTIZATION_SCALE,
 )
 
 connector.configure_voxel_phantom(
@@ -204,11 +211,20 @@ For minimal toy runs with smaller projection/image settings, use
 `quantization_scale` controls source integer quantization before writing SIMIND
 `.smi` files:
 
-- `1.0`: uses full internal source integer range (best numeric precision)
-- `< 1.0`: reduces integer scale for faster toy runs but increases rounding error
-
-SIMIND treats source maps as integer weights; absolute activity/time scaling is
-controlled separately by simulation settings.
+- the default (`500 / 32767`) preserves the legacy 500-weight source budget;
+- `1.0` uses the full signed 16-bit source range (`32767`), the best numeric
+  precision;
+- `< 1.0` reduces the integer scale for faster toy runs but increases rounding
+  error.
+
+SIMIND reads the source and density maps as signed 16-bit integers, so values
+of `32768` and above wrap negative and silently corrupt the map; the connector
+caps both maps at `32767`. Explicit `quantization_scale` values are used as
+given, with no automatic migration of scales calibrated for the former
+500-weight maximum: rescale an old scale with
+`old_scale * DEFAULT_QUANTIZATION_SCALE`. SIMIND treats source maps as integer
+weights; absolute activity/time scaling is controlled separately by simulation
+settings.
 
 ## Docker Environments
 

simind_python_connector-1.1.2/docker/README.md

@@ -0,0 +1,92 @@
+Docker Environments
+===================
+
+This directory provides dedicated container setups for:
+
+- Core Python workflows (no SIRF/STIR/PyTomography)
+- STIR workflows
+- SIRF workflows
+- PyTomography workflows
+
+Quick start
+-----------
+
+Build and run a specific environment:
+
+```bash
+docker compose -f docker/compose.yaml build stir
+docker compose -f docker/compose.yaml run --rm stir
+```
+
+Run the dedicated connector + OSEM examples directly:
+
+```bash
+docker compose -f docker/compose.yaml run --rm stir python examples/07A_stir_adaptor_osem.py
+docker compose -f docker/compose.yaml run --rm sirf python examples/07B_sirf_adaptor_osem.py
+docker compose -f docker/compose.yaml run --rm pytomography python examples/07C_pytomography_adaptor_osem.py
+```
+
+Run the containerized test matrix:
+
+```bash
+bash scripts/run_container_validation.sh
+```
+
+Include SIMIND-dependent examples/integration tests:
+
+```bash
+bash scripts/run_container_validation.sh --with-simind
+```
+
+Run selected example groups:
+
+```bash
+bash scripts/run_container_examples.sh --only-core
+bash scripts/run_container_examples.sh --only-pytomography
+bash scripts/run_container_examples.sh --only-osem
+```
+
+Set a specific Docker platform when needed:
+
+```bash
+bash scripts/run_container_examples.sh --only-core --docker-platform linux/amd64
+bash scripts/run_container_validation.sh --with-simind --docker-platform linux/amd64
+```
+
+Require SIMIND explicitly (fail fast if missing):
+
+```bash
+bash scripts/run_container_examples.sh --only-osem --require-simind
+bash scripts/run_container_validation.sh --with-simind --require-simind
+```
+
+Services
+--------
+
+- `python`: Core Python image for non-backend examples/tests.
+- `stir`: STIR-focused image (based on `synerbi/sirf`) with this repository installed.
+- `sirf`: SIRF-focused image (based on `synerbi/sirf`) with this repository installed.
+- `pytomography`: Python image with PyTomography + this repository installed.
+- Each service enables an import guard so only its target library is importable
+  during tests/examples (`stir`, `sirf.STIR`, or `pytomography` respectively;
+  `python` blocks all three backend libraries).
+
+Notes
+-----
+
+- The SIRF container build arg is `SIRF_BASE_IMAGE`.
+- The STIR container build arg is `STIR_BASE_IMAGE`.
+- Install SIMIND by following the official installation instructions on the SIMIND website.
+- For quick local use with these containers, put SIMIND at `./simind` in this repo
+  so the executable is available as `./simind/simind`.
+- SIMIND-dependent examples require the `simind` executable inside the container.
+  Runner scripts now auto-check `./simind/simind` and skip SIMIND-dependent checks
+  when missing (or fail fast if `--require-simind` is used).
+- For mixed host/runtime architectures, the runner scripts auto-detect SIMIND
+  binary architecture (`x86_64`/`aarch64`) and set Docker platform automatically;
+  use `--docker-platform` to override.
+- `input.smc` is bundled in `simind_python_connector/configs`; SIMIND runtime checks
+  only gate external executable availability.
+- The toy adaptor examples use `simind_python_connector/configs/Example.yaml`,
+  a reduced projection-space profile derived from `AnyScan.yaml`.
+- These images are intended to run examples and interactive exploration.

simind_python_connector-1.1.2/docker/compose.yaml

@@ -0,0 +1,72 @@
+services:
+  python:
+    build:
+      context: ..
+      dockerfile: docker/python/Dockerfile
+    image: simind-python-connector/python:dev
+    working_dir: /workspace
+    environment:
+      SIMIND_CONNECTOR_BACKEND: python
+      SIMIND_ROOT: /workspace/simind
+      SIMIND_BIN: ${SIMIND_BIN:-/workspace/simind/simind}
+      SIMIND_MPI_BIN: ${SIMIND_MPI_BIN:-/workspace/simind/simind_mpi}
+      SIMIND_SMC_DIR: ${SIMIND_SMC_DIR:-/workspace/simind/smc_dir/}
+      SIMIND_DATA_DIR: /workspace/simind/smc_dir/
+      SMC_DIR: /workspace/simind/smc_dir/
+    volumes:
+      - ..:/workspace
+    command: python examples/06_schneider_density_conversion.py
+
+  stir:
+    build:
+      context: ..
+      dockerfile: docker/stir/Dockerfile
+    image: simind-python-connector/stir:dev
+    working_dir: /workspace
+    environment:
+      SIMIND_CONNECTOR_BACKEND: stir
+      SIMIND_ROOT: /workspace/simind
+      SIMIND_BIN: ${SIMIND_BIN:-/workspace/simind/simind}
+      SIMIND_MPI_BIN: ${SIMIND_MPI_BIN:-/workspace/simind/simind_mpi}
+      SIMIND_SMC_DIR: ${SIMIND_SMC_DIR:-/workspace/simind/smc_dir/}
+      SIMIND_DATA_DIR: /workspace/simind/smc_dir/
+      SMC_DIR: /workspace/simind/smc_dir/
+    volumes:
+      - ..:/workspace
+    command: python examples/07A_stir_adaptor_osem.py
+
+  sirf:
+    build:
+      context: ..
+      dockerfile: docker/sirf/Dockerfile
+    image: simind-python-connector/sirf:dev
+    working_dir: /workspace
+    environment:
+      SIMIND_CONNECTOR_BACKEND: sirf
+      SIMIND_ROOT: /workspace/simind
+      SIMIND_BIN: ${SIMIND_BIN:-/workspace/simind/simind}
+      SIMIND_MPI_BIN: ${SIMIND_MPI_BIN:-/workspace/simind/simind_mpi}
+      SIMIND_SMC_DIR: ${SIMIND_SMC_DIR:-/workspace/simind/smc_dir/}
+      SIMIND_DATA_DIR: /workspace/simind/smc_dir/
+      SMC_DIR: /workspace/simind/smc_dir/
+    volumes:
+      - ..:/workspace
+    command: python examples/07B_sirf_adaptor_osem.py
+
+  pytomography:
+    build:
+      context: ..
+      dockerfile: docker/pytomography/Dockerfile
+    image: simind-python-connector/pytomography:dev
+    working_dir: /workspace
+    environment:
+      SIMIND_CONNECTOR_BACKEND: pytomography
+      SIMIND_ROOT: /workspace/simind
+      SIMIND_BIN: ${SIMIND_BIN:-/workspace/simind/simind}
+      SIMIND_MPI_BIN: ${SIMIND_MPI_BIN:-/workspace/simind/simind_mpi}
+      SIMIND_SMC_DIR: ${SIMIND_SMC_DIR:-/workspace/simind/smc_dir/}
+      SIMIND_DATA_DIR: /workspace/simind/smc_dir/
+      SMC_DIR: /workspace/simind/smc_dir/
+    volumes:
+      - ..:/workspace
+    command: python examples/07C_pytomography_adaptor_osem.py

simind_python_connector-1.1.2/docker/constraints.txt

@@ -0,0 +1,6 @@
+# Version constraints shared by backend Dockerfiles.
+# NumPy is capped below 2.x: the STIR/SIRF binaries in the synerbi/sirf base
+# images are compiled against NumPy 1.x and crash with NumPy 2 (see README
+# "NumPy ABI" notes).
+numpy<2.0
+pytest==8.4.2

simind_python_connector-1.1.2/docker/import_guard/sitecustomize.py

@@ -0,0 +1,52 @@
+"""
+Import guard used by backend-isolated Docker environments.
+
+Set SIMIND_PYTHON_CONNECTOR_BLOCK_IMPORTS to a comma-separated list of top-level module
+names. Any import matching one of those module roots will raise ImportError.
+"""
+
+from __future__ import annotations
+
+import builtins
+import importlib.abc
+import os
+import sys
+
+
+BLOCKED_IMPORTS = {
+    entry.strip()
+    for entry in os.environ.get("SIMIND_PYTHON_CONNECTOR_BLOCK_IMPORTS", "").split(",")
+    if entry.strip()
+}
+
+if BLOCKED_IMPORTS:
+    _ORIGINAL_IMPORT = builtins.__import__
+
+    class _BlockedModuleFinder(importlib.abc.MetaPathFinder):
+        """Prevent loading blocked module roots through all import paths."""
+
+        def find_spec(self, fullname, path=None, target=None):
+            root = fullname.split(".", 1)[0]
+            if root in BLOCKED_IMPORTS:
+                raise ModuleNotFoundError(
+                    f"Module '{root}' is blocked in this backend-isolated container.",
+                    name=root,
+                )
+            return None
+
+    for module_name in list(sys.modules):
+        if module_name.split(".", 1)[0] in BLOCKED_IMPORTS:
+            del sys.modules[module_name]
+
+    sys.meta_path.insert(0, _BlockedModuleFinder())
+
+    def _guarded_import(name, globals=None, locals=None, fromlist=(), level=0):
+        root = name.split(".", 1)[0]
+        if root in BLOCKED_IMPORTS:
+            raise ModuleNotFoundError(
+                f"Module '{root}' is blocked in this backend-isolated container.",
+                name=root,
+            )
+        return _ORIGINAL_IMPORT(name, globals, locals, fromlist, level)
+
+    builtins.__import__ = _guarded_import

simind_python_connector-1.1.2/docker/python/Dockerfile

@@ -0,0 +1,39 @@
+ARG PYTHON_BASE_IMAGE=python:3.12-slim
+FROM ${PYTHON_BASE_IMAGE}
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+ENV SIMIND_ROOT=/workspace/simind
+ENV SIMIND_BIN=${SIMIND_ROOT}/simind
+ENV SIMIND_MPI_BIN=${SIMIND_ROOT}/simind_mpi
+ENV SIMIND_SMC_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SIMIND_DATA_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SMC_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SIMIND_PYTHON_CONNECTOR_BLOCK_IMPORTS=sirf,stir,stirextra,pytomography
+ENV PYTHONPATH=/workspace/docker/import_guard:${PYTHONPATH}
+ENV PATH=${SIMIND_ROOT}/bin:${SIMIND_ROOT}:${PATH}
+
+# MPICH runtime for SIMIND's MPI binary; the compat script exposes the library
+# names that binary was built against. See docker/python/install_mpich_compat.sh.
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends mpich \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY docker/python/install_mpich_compat.sh /usr/local/bin/install_mpich_compat.sh
+RUN chmod +x /usr/local/bin/install_mpich_compat.sh \
+    && install_mpich_compat.sh
+
+WORKDIR /workspace
+
+COPY . /workspace
+
+RUN python -m pip install --upgrade pip \
+    && pip install --constraint /workspace/docker/constraints.txt -e ".[dev,examples]" \
+    && python - <<'PY'
+import importlib
+for module in ("numpy", "matplotlib", "pytest"):
+    importlib.import_module(module)
+print("Core Python modules available")
+PY
+
+CMD ["python", "examples/06_schneider_density_conversion.py"]

simind_python_connector-1.1.2/docker/python/install_mpich_compat.sh

@@ -0,0 +1,22 @@
+#!/bin/sh
+# SIMIND's Linux binary links against the historical MPICH names
+# libmpi.so.12 / libmpifort.so.12. Debian's mpich package ships
+# libmpich.so.12 / libmpichfort.so.12; expose the expected names when the
+# loader cannot find them.
+set -eu
+
+multiarch="$(python3 -c 'import sysconfig; print(sysconfig.get_config_var("MULTIARCH"))')"
+libdir="/usr/lib/${multiarch}"
+
+link_if_missing() {
+    target="$1"
+    link_name="$2"
+    if [ ! -e "${libdir}/${link_name}" ] && [ -e "${libdir}/${target}" ]; then
+        ln -s "${target}" "${libdir}/${link_name}"
+    fi
+}
+
+link_if_missing libmpich.so.12 libmpi.so.12
+link_if_missing libmpichfort.so.12 libmpifort.so.12
+
+ldconfig

simind_python_connector-1.1.2/docker/pytomography/Dockerfile

@@ -0,0 +1,34 @@
+ARG PYTOMO_BASE_IMAGE=synerbi/sirf:latest
+FROM ${PYTOMO_BASE_IMAGE}
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+ENV SIRF_INSTALL_PATH=/opt/SIRF-SuperBuild/INSTALL
+ENV SIMIND_ROOT=/workspace/simind
+ENV SIMIND_BIN=${SIMIND_ROOT}/simind
+ENV SIMIND_MPI_BIN=${SIMIND_ROOT}/simind_mpi
+ENV SIMIND_SMC_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SIMIND_DATA_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SMC_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SIMIND_PYTHON_CONNECTOR_BLOCK_IMPORTS=sirf,stir,stirextra
+ENV PYTHONPATH=/workspace/docker/import_guard:${SIRF_INSTALL_PATH}/python
+ENV LD_LIBRARY_PATH=/opt/conda/lib:${SIRF_INSTALL_PATH}/lib:${SIRF_INSTALL_PATH}/lib64:${LD_LIBRARY_PATH}
+ENV PATH=${SIMIND_ROOT}/bin:${SIMIND_ROOT}:${SIRF_INSTALL_PATH}/bin:${PATH}
+
+WORKDIR /workspace
+
+COPY --chown=1000:100 . /workspace
+
+RUN python -m pip install --upgrade pip \
+    && pip install --index-url https://download.pytorch.org/whl/cpu torch \
+    && pip install pytomography --no-deps \
+    && pip install fft-conv-pytorch kornia pydicom rt-utils torchrbf uproot \
+    && pip install --constraint /workspace/docker/constraints.txt -e ".[dev,examples]" \
+    && python - <<'PY'
+import importlib
+for module in ("torch", "pytomography", "pytest"):
+    importlib.import_module(module)
+print("PyTomography modules available")
+PY
+
+CMD ["python", "examples/07C_pytomography_adaptor_osem.py"]

simind_python_connector-1.1.2/docker/sirf/Dockerfile

@@ -0,0 +1,31 @@
+ARG SIRF_BASE_IMAGE=synerbi/sirf:latest
+FROM ${SIRF_BASE_IMAGE}
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+ENV SIRF_INSTALL_PATH=/opt/SIRF-SuperBuild/INSTALL
+ENV SIMIND_ROOT=/workspace/simind
+ENV SIMIND_BIN=${SIMIND_ROOT}/simind
+ENV SIMIND_MPI_BIN=${SIMIND_ROOT}/simind_mpi
+ENV SIMIND_SMC_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SIMIND_DATA_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SMC_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SIMIND_PYTHON_CONNECTOR_BLOCK_IMPORTS=stir,stirextra,pytomography
+ENV PYTHONPATH=/workspace/docker/import_guard:${SIRF_INSTALL_PATH}/python:${PYTHONPATH}
+ENV LD_LIBRARY_PATH=/opt/conda/lib:${SIRF_INSTALL_PATH}/lib:${SIRF_INSTALL_PATH}/lib64:${LD_LIBRARY_PATH}
+ENV PATH=${SIMIND_ROOT}/bin:${SIMIND_ROOT}:${SIRF_INSTALL_PATH}/bin:${PATH}
+
+WORKDIR /workspace
+
+COPY --chown=1000:100 . /workspace
+
+RUN python -m pip install --upgrade pip \
+    && pip install --constraint /workspace/docker/constraints.txt -e ".[dev,examples]" \
+    && python - <<'PY'
+import importlib
+for module in ("sirf.STIR", "pytest"):
+    importlib.import_module(module)
+print("SIRF Python modules available")
+PY
+
+CMD ["python", "examples/07B_sirf_adaptor_osem.py"]

simind_python_connector-1.1.2/docker/stir/Dockerfile

@@ -0,0 +1,33 @@
+ARG STIR_BASE_IMAGE=synerbi/sirf:latest
+FROM ${STIR_BASE_IMAGE}
+
+ENV PYTHONDONTWRITEBYTECODE=1
+ENV PYTHONUNBUFFERED=1
+ENV SIRF_INSTALL_PATH=/opt/SIRF-SuperBuild/INSTALL
+ENV SIMIND_ROOT=/workspace/simind
+ENV SIMIND_BIN=${SIMIND_ROOT}/simind
+ENV SIMIND_MPI_BIN=${SIMIND_ROOT}/simind_mpi
+ENV SIMIND_SMC_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SIMIND_DATA_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SMC_DIR=${SIMIND_ROOT}/smc_dir/
+ENV SIMIND_PYTHON_CONNECTOR_BLOCK_IMPORTS=sirf,pytomography
+ENV PYTHONPATH=/workspace/docker/import_guard:${SIRF_INSTALL_PATH}/python:${PYTHONPATH}
+ENV LD_LIBRARY_PATH=/opt/conda/lib:${SIRF_INSTALL_PATH}/lib:${SIRF_INSTALL_PATH}/lib64:${LD_LIBRARY_PATH}
+ENV PATH=${SIMIND_ROOT}/bin:${SIMIND_ROOT}:${SIRF_INSTALL_PATH}/bin:${PATH}
+
+WORKDIR /workspace
+
+COPY --chown=1000:100 . /workspace
+
+RUN python -m pip install --upgrade pip \
+    && pip install --constraint /workspace/docker/constraints.txt -e ".[dev,examples]" \
+    && python - <<'PY'
+import stir  # noqa: F401
+import pytest  # noqa: F401
+from simind_python_connector.utils.import_helpers import _import_stir_extra
+
+_import_stir_extra()
+print("STIR Python modules available")
+PY
+
+CMD ["python", "examples/07A_stir_adaptor_osem.py"]

{simind_python_connector-1.1.0 → simind_python_connector-1.1.2}/docs/backends.rst

@@ -16,7 +16,8 @@ Dependency Matrix
    * - ``SimindPythonConnector``
      - SIMIND executable on ``PATH`` (no SIRF/STIR/PyTomography requirement)
    * - ``StirSimindAdaptor``
-     - STIR Python (``stir``)
+     - STIR Python (``stir`` plus ``stir.extra``, with the legacy ``stirextra``
+       module as a fallback)
    * - ``SirfSimindAdaptor``
      - SIRF (``sirf.STIR``)
    * - ``PyTomographySimindAdaptor``