Installation¶
Note
About version 2.0.0 and earlier releases
libparallelproj version 2.0.0 introduced a significant restructuring of the project. Versions earlier than 2.0.0 came from a different repository called parallelproj, which provided a mixed package containing both:
A minimal C and Python API for core 3D projection functions
Higher-level Python tools for scanner geometry, sinogram handling, and image reconstruction
Starting with version 2.0.0, libparallelproj focuses exclusively on the core projection functions and their APIs. The parallelproj-core package provides the minimal Python API to the core projectors using the stable Python ABI (python-abi3), ensuring compatibility across Python versions, without the need for recompilation.
Future versions of the existing parallelproj python package (v>= 2.0) will build upon parallelproj-core as the standard API to the projectors, providing higher-level tools for scanner geometry, sinogram handling, and image reconstruction.
The project consolidation provides a cleaner separation of concerns and improved maintainability. Version 2.0.0 and later are the recommended versions for all new projects and updates.
Option 1 (recommended): install pre-compiled package from conda-forge¶
C-API only¶
Install the conda-forge package libparallelproj (version >= 2.0.0):
mamba install -c conda-forge "libparallelproj>=2.0.0"
conda install -c conda-forge "libparallelproj>=2.0.0"
Python API (includes C-API)¶
Install the conda-forge package parallelproj-core:
mamba install -c conda-forge "parallelproj-core"
conda install -c conda-forge "parallelproj-core"
Option 2: compile from source¶
For source builds, follow the instructions in the GitHub project README